---
title: "موصل Braze"
description: "دليل تكامل Braze الشامل لمزامنة بيانات تفاعل العملاء، والحملات، وأحداث الرسائل مع Brevo عبر Tajo."
url: https://tajo.io/ar/docs/connectors/marketing/braze/
markdown: https://tajo.io/ar/docs/connectors/marketing/braze.md
lang: ar-SA
robots: noindex
---

اطلب الوصول المبكر

أدخل اسمك الأول وعنوان بريدك الإلكتروني للعمل. سنرسل إليك رابطًا لتأكيد طلب الوصول إلى Tajo.

# موصل Braze

حالة الموصل: مخطط له لم يُبنَ بعد. لا يشغّل Tajo هذا الموصل اليوم.

| حقل المصدر | حقل الوجهة | قيمة نموذجية |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

اربط منصة تفاعل Braze الخاصة بك مع Brevo لملفات عملاء موحدة، وتنسيق حملات عبر القنوات، وتحليلات تسويقية مدمجة.

## نظرة عامة

| الخاصية | القيمة |
| --- | --- |
| **المنصة** | Braze |
| **الفئة** | التسويق |
| **تعقيد الإعداد** | متوسط |
| **تكامل رسمي** | لا |
| **البيانات المُزامَنة** | عملاء، أحداث، حملات، رسائل |
| **نوع واجهة البرمجة** | REST API |
| **المصادقة** | مفتاح API |
| **عنوان URL الأساسي** | `https://rest.iad-XX.braze.com` (خاص بالمثيل) |

## الميزات

- **مزامنة ملفات المستخدمين** - مزامنة ثنائية الاتجاه لسمات العملاء بين Braze وBrevo
- **تتبع أحداث الحملات** - تتبع فتح البريد الإلكتروني والنقرات والتحويلات وإلغاءات الاشتراك
- **بيانات تدفقات Canvas** - مزامنة بيانات رحلة الحملات متعددة الخطوات للتقارير الموحدة
- **مرآة الشرائح** - نسخ شرائح Braze كقوائم Brevo للاستهداف عبر المنصات
- **أحداث الإشعارات الفورية** - إعادة توجيه بيانات تفاعل الإشعارات إلى جداول Brevo الزمنية
- **مزامنة الكتالوج** - مزامنة كتالوجات المنتجات للتوصيات المخصصة

## المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. حساب Braze مع تفعيل وصول API
2. مفتاح Braze REST API بصلاحيات مناسبة
3. عنوان URL لمثيل Braze الخاص بك (مثلاً، `rest.iad-01.braze.com`)
4. حساب Brevo مع وصول إلى API
5. حساب Tajo مع اشتراك نشط

## المصادقة

يستخدم Braze مصادقة مفتاح API. يمكن تحديد نطاق كل مفتاح API لنقاط نهاية محددة.

### إنشاء مفتاح API

1. سجّل الدخول إلى لوحة Braze
2. انتقل إلى **Settings** > **API Keys**
3. انقر على **Create New API Key**
4. سمّه “Tajo Integration”
5. فعّل الصلاحيات التالية:

```
users.track
users.export.ids
users.export.segment
campaigns.list
campaigns.data_series
canvas.list
canvas.data_series
segments.list
segments.data_series
email.status
subscription.status.set
catalogs.list_items
```

أمان مفتاح API

خزّن مفتاح Braze API الخاص بك بأمان. لا تكشف عنه أبدًا في الكود من جانب العميل أو المستودعات العامة. يشفّر Tajo جميع بيانات اعتماد API في حالة السكون باستخدام AES-256.

### الاتصال بـ Tajo

```bash
tajo connectors install braze \
  --api-key $BRAZE_API_KEY \
  --instance-url rest.iad-01.braze.com
```

## الإعداد

### الإعداد الأساسي

```yaml
connectors:
  braze:
    enabled: true
    instance_url: "rest.iad-01.braze.com"
    api_version: "v1"

    sync:
      users: true
      campaigns: true
      canvases: true
      segments: true
      events: true

    lists:
      engaged_users: 10
      dormant_users: 11
```

### تعيين الحقول

ربط سمات مستخدم Braze بسمات جهات اتصال Brevo:

```yaml
field_mapping:
  # Standard fields
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Custom attributes
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE
```

## نقاط نهاية واجهة البرمجة

يتكامل Tajo مع نقاط نهاية Braze REST API التالية:

| نقطة النهاية | الطريقة | الغرض |
| --- | --- | --- |
| `/users/track` | POST | إرسال سمات المستخدم والأحداث والمشتريات |
| `/users/export/ids` | POST | تصدير ملفات المستخدمين بالمعرّفات الخارجية |
| `/users/export/segment` | POST | تصدير المستخدمين من شريحة |
| `/campaigns/list` | GET | استرجاع قائمة الحملات |
| `/campaigns/data_series` | GET | تحليلات الحملة بمرور الوقت |
| `/canvas/list` | GET | استرجاع قائمة تدفقات Canvas |
| `/canvas/data_series` | GET | تحليلات Canvas بمرور الوقت |
| `/segments/list` | GET | استرجاع قائمة الشرائح |
| `/email/status` | POST | تغيير حالة اشتراك البريد الإلكتروني |
| `/subscription/status/set` | POST | تعيين حالة مجموعة الاشتراك |
| `/catalogs/{catalog_name}/items` | GET | استرجاع عناصر الكتالوج |

## أمثلة على الكود

### تهيئة الموصل

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.connectors.connect('braze', {
  apiKey: process.env.BRAZE_API_KEY,
  instanceUrl: 'rest.iad-01.braze.com'
});
```

### مزامنة ملفات المستخدمين

```javascript
// مزامنة مستخدمي Braze مع جهات اتصال Brevo
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// التحقق من حالة المزامنة
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }
```

### تتبع الأحداث المخصصة

```javascript
// إعادة توجيه أحداث Braze إلى Brevo
await tajo.connectors.handleEvent('braze', {
  type: 'user.event',
  payload: {
    external_id: 'user_12345',
    name: 'product_viewed',
    properties: {
      product_id: 'SKU-789',
      category: 'electronics',
      price: 299.99
    }
  }
});
```

### تصدير بيانات الشريحة

```javascript
// تصدير شريحة Braze وإنشاء قائمة Brevo
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Exported ${result.count} users to Brevo list 15`);
```

## حدود المعدل

يفرض Braze حدود المعدل بناءً على خطتك ومثيلك:

| الخطة | حد المعدل | حد الدفعات |
| --- | --- | --- |
| **Starter** | 250,000 طلب/ساعة | لا ينطبق |
| **Pro** | 250,000 طلب/ساعة | لا ينطبق |
| **Enterprise** | مخصص | مخصص |

تحتوي نقطة نهاية `/users/track` على حد افتراضي 50,000 طلب في الدقيقة. يتعامل Tajo تلقائيًا مع تحديد المعدل بالتراجع الأُسّي.

الطلبات المجمّعة

يجمّع Tajo حتى 75 سمة مستخدم، و75 حدثًا، و75 عملية شراء لكل طلب `/users/track` لتعظيم الإنتاجية ضمن حدود المعدل.

## استكشاف الأخطاء وإصلاحها

### المشاكل الشائعة

| المشكلة | السبب | الحل |
| --- | --- | --- |
| 401 Unauthorized | مفتاح API غير صالح أو منتهي | أعد توليد مفتاح API في لوحة Braze |
| المستخدمون لا يتزامنون | عنوان URL للمثيل غير صحيح | تحقق من عنوان URL لمثيل Braze (مثلاً، iad-01، iad-02) |
| سمات مفقودة | نطاق مفتاح API ضيق جدًا | أضف الصلاحيات المطلوبة إلى مفتاح API |
| تجاوز حد المعدل | طلبات متزامنة كثيرة جدًا | قلل حجم الدفعات أو تكرار المزامنة |
| تأخير الأحداث | قائمة انتظار تصدير كبيرة | استخدم المزامنة التزايدية بدلاً من التصدير الكامل |

### وضع التصحيح

```yaml
connectors:
  braze:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### اختبار الاتصال

```bash
tajo connectors test braze
# ✓ API connection successful
# ✓ User export accessible
# ✓ Campaign data readable
# ✓ Segment list accessible
# ✓ Event tracking operational
```

## أفضل الممارسات

1. **استخدم المزامنات التزايدية** - تجنب التصديرات الكاملة؛ زامن السجلات المتغيرة منذ آخر مزامنة فقط
2. **تحديثات المستخدمين بالدفعات** - اجمع تغييرات السمات لتقليل استدعاءات API
3. **حدّد نطاق مفاتيح API بدقة** - فعّل فقط الصلاحيات التي يحتاجها تكاملك
4. **راقب حدود المعدل** - إعداد تنبيهات قبل الوصول إلى حدود معدل Braze
5. **عيّن المعرّفات الخارجية باتساق** - استخدم نفس المعرّف عبر Braze وBrevo
6. **اختبر في sandbox أولاً** - استخدم مساحة عمل اختبار Braze قبل النشر للإنتاج

## الأمان

- **مصادقة مفتاح API** - مفاتيح API مقيدة بنطاقات بصلاحيات دقيقة
- **HTTPS فقط** - جميع اتصالات API مشفرة عبر TLS 1.2+
- **قائمة IP المسموح بها** - قيد IP اختياري للوصول إلى API في Braze
- **تخزين مشفر** - بيانات اعتماد API مشفرة في حالة السكون في Tajo
- **تسجيل المراجعة** - تُسجَّل جميع استدعاءات API للمراجعة الامتثالية

## موارد ذات صلة

- [موصل Customer.io](https://tajo.io/ar/docs/connectors/marketing/customerio)
- [موصل Iterable](https://tajo.io/ar/docs/connectors/marketing/iterable)
- [مهارة مزامنة العملاء](https://tajo.io/ar/docs/skills/data-sync/customer-sync)
- [واجهة جهات اتصال Brevo](https://tajo.io/ar/docs/contact-management)