موصل Amplitude

اربط Amplitude بـ Brevo عبر Tajo للاستفادة من بيانات تحليلات المنتج لأتمتة التسويق. زامن المجموعات السلوكية وخصائص المستخدم وأحداث المنتج لتشغيل حملات مستهدفة.

نظرة عامة

الميزات

• إعادة توجيه الأحداث - أرسل أحداث تتبع Amplitude إلى Brevo لتشغيل أتمتة التسويق
• مزامنة المجموعات - صدِّر المجموعات السلوكية في Amplitude كقوائم جهات اتصال Brevo
• مزامنة خصائص المستخدم - اربط خصائص مستخدم Amplitude بسمات جهات اتصال Brevo
• تتبع الإيرادات - زامن أحداث الإيرادات لتحليل قيمة العميل مدى الحياة
• التقسيم السلوكي - استخدم بيانات تفاعل Amplitude في قطاعات Brevo
• تكامل HTTP V2 API - تكامل مباشر مع API الاستيعاب HTTP V2 في Amplitude

المتطلبات المسبقة

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

1. حساب Amplitude مع مشروع مُنشأ
2. مفتاح Amplitude API والمفتاح السري
3. حساب Brevo مع وصول API
4. حساب Tajo مع بيانات اعتماد API

المصادقة

مفاتيح Amplitude API

يستخدم Amplitude أزواج مفاتيح API ومفتاح سري للمصادقة. يُعَرِّف مفتاح API مشروعك، بينما يُصادق المفتاح السري الطلبات من جانب الخادم.

# Find your keys in Amplitude:
# Settings > Projects > [Your Project] > General

مصادقة HTTP V2 API

يستخدم HTTP V2 API مفتاح API في جسم الطلب:

curl -X POST https://api2.amplitude.com/2/httpapi \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_AMPLITUDE_API_KEY",
    "events": [...]
  }'

الإعداد

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

connectors:
  amplitude:
    enabled: true
    api_key: "your-amplitude-api-key"
    secret_key: "your-amplitude-secret-key"
    data_center: "US"  # or "EU"

    # Data sync options
    sync:
      events: true
      user_properties: true
      cohorts: true
      revenue: true

    # Brevo list assignment
    lists:
      active_users: 10
      power_users: 11
      churning_users: 12

ربط الأحداث

اربط أحداث Amplitude بمشغلات أتمتة Brevo:

event_mapping:
  # Amplitude event -> Brevo event
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "Feature Click": "feature_used"

  # Revenue events
  "Revenue": "revenue_event"
  "Subscription Started": "subscription_created"

ربط خصائص المستخدم

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

property_mapping:
  # Amplitude property -> Brevo attribute
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  plan_type: PLAN
  signup_date: SIGNUP_DATE
  total_purchases: ORDER_COUNT
  lifetime_revenue: LTV
  last_active: LAST_ACTIVE
  device_type: DEVICE

نقاط نهاية API

أمثلة البرمجة

تهيئة موصل Amplitude

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

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

// Connect Amplitude project
await tajo.connectors.connect('amplitude', {
  apiKey: process.env.AMPLITUDE_API_KEY,
  secretKey: process.env.AMPLITUDE_SECRET_KEY,
  dataCenter: 'US'
});

إرسال الأحداث عبر HTTP V2 API

// Send events to Amplitude (automatically forwarded to Brevo)
const response = await fetch('https://api2.amplitude.com/2/httpapi', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: process.env.AMPLITUDE_API_KEY,
    events: [
      {
        user_id: "user_123",
        event_type: "Purchase",
        event_properties: {
          revenue: 89.99,
          product_id: "SKU-001",
          product_name: "Widget Pro"
        },
        user_properties: {
          $set: {
            email: "[email protected]",
            plan_type: "premium"
          }
        },
        time: Date.now()
      }
    ]
  })
});

// Expected response: { "code": 200, "events_ingested": 1 }

مزامنة المجموعة إلى قائمة Brevo

// Export an Amplitude cohort and sync to Brevo
const cohort = await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'abc123',
  targetList: 11,  // Brevo list ID
  syncMode: 'mirror'  // mirror, append, or remove
});

console.log(cohort);
// {
//   cohortName: "Power Users",
//   membersCount: 2450,
//   syncedToBrevo: 2450,
//   listId: 11
// }

حدود المعدل

استكشاف الأخطاء

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

1. استخدم HTTP V2 API - فضّل V2 API على HTTP API القديم للحصول على تحقق أفضل واستجابات خطأ أفضل
2. جمّع الأحداث - أرسل الأحداث في دُفعات تصل إلى 1,000 لأفضل إنتاجية
3. اضبط خصائص المستخدم على الأحداث - أدرج user_properties على أحداث التتبع لتقليل استدعاءات identify
4. استخدم المجموعات للتقسيم - زامن المجموعات السلوكية بدلاً من تكرار منطق تقسيم معقد
5. تتبع أحداث الإيرادات بشكل صحيح - استخدم حقول revenue و price و productId لتتبع إيرادات دقيق
6. راقب صحة الاستيعاب - تحقق من Ingestion Debugger في Amplitude لأخطاء التحقق من الأحداث
7. نفّذ التتبع من جانب الخادم - استخدم SDKs من جانب الخادم لتسليم أحداث موثوق

الأمان

• HTTPS فقط - جميع اتصالات API تتطلب TLS 1.2+
• تدوير مفتاح API - دوّر المفاتيح السرية دوريًا عبر إعدادات Amplitude
• قائمة IP المسموح بها - متاحة في خطط Enterprise
• SOC 2 Type II - Amplitude حاصل على شهادة SOC 2 Type II
• GDPR/CCPA - دعم لطلبات حذف وتصدير بيانات المستخدم
• إقامة البيانات في EU - خيار مركز بيانات EU متاح

موارد ذات صلة

• موصل Segment
• موصل Mixpanel
• مهارة مزامنة العملاء
• Brevo Events API