موصل Braze

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

نظرة عامة

الميزات

• مزامنة ملفات المستخدمين - مزامنة ثنائية الاتجاه لسمات العملاء بين 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

الاتصال بـ Tajo

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

الإعداد

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

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:

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 التالية:

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

تهيئة الموصل

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'
});

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

// مزامنة مستخدمي 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
// }

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

// إعادة توجيه أحداث 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
    }
  }
});

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

// تصدير شريحة 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 حدود المعدل بناءً على خطتك ومثيلك:

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

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

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

وضع التصحيح

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

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

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
• موصل Iterable
• مهارة مزامنة العملاء
• واجهة جهات اتصال Brevo