Amplitude کنیکٹر

مارکیٹنگ آٹومیشن کے لیے پروڈکٹ اینالیٹکس ڈیٹا کا فائدہ اٹھانے کے لیے Amplitude کو Tajo کے ذریعے Brevo سے منسلک کریں۔ ٹارگٹڈ مہمات کو طاقت دینے کے لیے رویّاتی کوہارٹس، صارف کی خصوصیات، اور پروڈکٹ ایونٹس کو سنک کریں۔

جائزہ

خصوصیات

• ایونٹ فارورڈنگ - مارکیٹنگ آٹومیشن ٹرگرز کے لیے Amplitude track ایونٹس کو Brevo کو بھیجیں
• کوہارٹ سنک - Amplitude رویّاتی کوہارٹس کو Brevo رابطہ فہرستوں کے طور پر ایکسپورٹ کریں
• صارف کی خصوصیت سنک - Amplitude صارف خصوصیات کو Brevo رابطہ خصوصیات سے میپ کریں
• آمدنی ٹریکنگ - صارف کی عمر بھر کی قدر کے تجزیے کے لیے آمدنی ایونٹس سنک کریں
• رویّاتی سیگمنٹیشن - Brevo سیگمنٹس میں Amplitude کی مصروفیت کا ڈیٹا استعمال کریں
• HTTP V2 API انٹیگریشن - Amplitude کے HTTP V2 ingestion API کے ساتھ براہ راست انٹیگریشن

ضروریات

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. پروجیکٹ تخلیق کے ساتھ Amplitude اکاؤنٹ
2. آپ کی Amplitude API Key اور Secret Key
3. API رسائی کے ساتھ Brevo اکاؤنٹ
4. API اسناد کے ساتھ Tajo اکاؤنٹ

توثیق

Amplitude API کیز

Amplitude توثیق کے لیے API Key اور Secret Key کے جوڑے استعمال کرتا ہے۔ API Key آپ کے پروجیکٹ کی شناخت کرتی ہے، جبکہ Secret Key سرور سائیڈ درخواستوں کی توثیق کرتی ہے۔

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

HTTP V2 API توثیق

HTTP V2 API درخواست کے مواد میں API key استعمال کرتا ہے:

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

// Amplitude پروجیکٹ منسلک کریں
await tajo.connectors.connect('amplitude', {
  apiKey: process.env.AMPLITUDE_API_KEY,
  secretKey: process.env.AMPLITUDE_SECRET_KEY,
  dataCenter: 'US'
});

HTTP V2 API کے ذریعے ایونٹس بھیجیں

// Amplitude کو ایونٹس بھیجیں (خودکار طور پر 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 فہرست میں سنک کریں

// ایک Amplitude کوہارٹ ایکسپورٹ کریں اور 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 استعمال کریں - بہتر توثیق اور ایرر ریسپانسز کے لیے لیگیسی HTTP API پر V2 API کو ترجیح دیں
2. ایونٹس کو بیچ کریں - بہترین تھرو پٹ کے لیے 1,000 تک کے بیچوں میں ایونٹس بھیجیں
3. ایونٹس پر صارف کی خصوصیات سیٹ کریں - identify کالز کو کم کرنے کے لیے track ایونٹس پر user_properties شامل کریں
4. سیگمنٹیشن کے لیے کوہارٹس استعمال کریں - پیچیدہ سیگمنٹیشن منطق کی نقل کرنے کے بجائے رویّاتی کوہارٹس کو سنک کریں
5. آمدنی ایونٹس کو درست طریقے سے ٹریک کریں - درست آمدنی ٹریکنگ کے لیے revenue، price، اور productId فیلڈز استعمال کریں
6. ingestion صحت کی نگرانی کریں - ایونٹ کی توثیق کی خرابیوں کے لیے Amplitude کا Ingestion Debugger چیک کریں
7. سرور سائیڈ ٹریکنگ نافذ کریں - قابل اعتماد ایونٹ ڈیلیوری کے لیے سرور سائیڈ SDKs استعمال کریں

سیکیورٹی

• صرف HTTPS - تمام API مواصلات TLS 1.2+ کی ضرورت ہوتی ہے
• API key کی گردش - Amplitude سیٹنگز کے ذریعے وقتاً فوقتاً Secret Keys کو گردش کریں
• IP allowlisting - Enterprise پلانز پر دستیاب
• SOC 2 Type II - Amplitude SOC 2 Type II سند یافتہ ہے
• GDPR/CCPA - صارف کے ڈیٹا کی حذف اور ایکسپورٹ کی درخواستوں کے لیے حمایت
• EU ڈیٹا رہائش - EU ڈیٹا سینٹر آپشن دستیاب

متعلقہ وسائل

• Segment کنیکٹر
• Mixpanel کنیکٹر
• Customer Sync Skill
• Brevo Events API