Mixpanel کنیکٹر

پروڈکٹ اینالیٹکس کو مارکیٹنگ آٹومیشن سے جوڑنے کے لیے Mixpanel کو Tajo کے ذریعے Brevo سے منسلک کریں۔ حقیقی پروڈکٹ استعمال کی بنیاد پر ڈیٹا سے چلنے والی مہمات بنانے کے لیے صارف پروفائلز، رویّاتی ایونٹس، اور کوہارٹس کو سنک کریں۔

جائزہ

خصوصیات

• ایونٹ ingestion - Mixpanel کے Ingestion API کے ذریعے Brevo ورک فلوز میں track ایونٹس امپورٹ کریں
• صارف پروفائل سنک - Mixpanel صارف پروفائل خصوصیات کو Brevo رابطہ خصوصیات سے میپ کریں
• کوہارٹ ایکسپورٹ - ٹارگٹڈ مہمات کے لیے Mixpanel کوہارٹس کو Brevo رابطہ فہرستوں سے سنک کریں
• گروپ اینالیٹکس - B2B اکاؤنٹ پر مبنی مارکیٹنگ کے لیے گروپ-سطح کا ڈیٹا سنک کریں
• شناخت کا انتظام - متحد کسٹمر پروفائلز کے لیے Mixpanel کے identity merge کا فائدہ اٹھائیں
• JQL queries - Brevo کے لیے مخصوص ڈیٹا سیٹس نکالنے کے لیے حسب ضرورت JQL queries چلائیں
• Lookup tables - Mixpanel lookup tables سے enrichment ڈیٹا سنک کریں

ضروریات

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

1. پروجیکٹ تخلیق کے ساتھ Mixpanel اکاؤنٹ
2. کلائنٹ سائیڈ ٹریکنگ کے لیے آپ کا Mixpanel Project Token
3. سرور سائیڈ API رسائی کے لیے مناسب اجازتوں کے ساتھ Service Account
4. API رسائی کے ساتھ Brevo اکاؤنٹ
5. API اسناد کے ساتھ Tajo اکاؤنٹ

توثیق

Service Accounts (تجویز کردہ)

Mixpanel API توثیق کے لیے Service Accounts استعمال کرنے کی سفارش کرتا ہے۔ Service accounts username (service account username) اور password (service account secret) کے ساتھ HTTP Basic Auth استعمال کرتے ہیں۔

# Service Account توثیق
curl https://mixpanel.com/api/app/me \
  -u "SERVICE_ACCOUNT_USERNAME:SERVICE_ACCOUNT_SECRET"

Project Token

Project Token کلائنٹ سائیڈ ایونٹ ٹریکنگ کے لیے استعمال ہوتا ہے اور کلائنٹ کوڈ میں شامل کرنا محفوظ ہے:

// کلائنٹ سائیڈ initialization
mixpanel.init("YOUR_PROJECT_TOKEN");

OAuth (Partner Integrations کے لیے)

متعدد پروجیکٹس تک رسائی حاصل کرنے والی ایپ انٹیگریشنز کے لیے:

curl https://mixpanel.com/api/2.0/engage \
  -H "Authorization: Bearer YOUR_OAUTH_TOKEN"

کنفیگریشن

بنیادی سیٹ اپ

connectors:
  mixpanel:
    enabled: true
    project_token: "your-project-token"
    service_account:
      username: "your-service-account-username"
      secret: "your-service-account-secret"
    project_id: "12345"
    data_residency: "US"  # or "EU"

    # Data sync options
    sync:
      events: true
      profiles: true
      cohorts: true
      groups: false

    # Brevo list assignment
    lists:
      all_users: 15
      engaged_users: 16
      at_risk: 17

ایونٹ میپنگ

Mixpanel ایونٹس کو Brevo ایونٹ اقسام سے میپ کریں:

event_mapping:
  # Mixpanel event -> Brevo event
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "$experiment_started": "experiment_started"

  # Custom events
  "Feature Activated": "feature_used"
  "Subscription Renewed": "subscription_renewed"

پروفائل پراپرٹی میپنگ

Mixpanel صارف خصوصیات کو Brevo رابطہ خصوصیات سے میپ کریں:

property_mapping:
  $email: email
  $first_name: FIRSTNAME
  $last_name: LASTNAME
  $phone: SMS
  $city: CITY
  $region: REGION
  $country_code: COUNTRY
  plan: PLAN_TYPE
  company: COMPANY
  signup_date: SIGNUP_DATE
  total_revenue: LTV

API اینڈ پوائنٹس

کوڈ مثالیں

Mixpanel کنیکٹر کو شروع کریں

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

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

// Mixpanel پروجیکٹ منسلک کریں
await tajo.connectors.connect('mixpanel', {
  projectToken: process.env.MIXPANEL_TOKEN,
  serviceAccountUser: process.env.MIXPANEL_SA_USER,
  serviceAccountSecret: process.env.MIXPANEL_SA_SECRET,
  projectId: process.env.MIXPANEL_PROJECT_ID
});

Ingestion API کے ذریعے ایونٹس امپورٹ کریں

// Mixpanel میں ایونٹس امپورٹ کریں (خودکار طور پر Brevo کو آگے بھیجے جاتے ہیں)
const response = await fetch('https://api.mixpanel.com/import', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Basic ' + btoa(
      `${process.env.MIXPANEL_SA_USER}:${process.env.MIXPANEL_SA_SECRET}`
    )
  },
  body: JSON.stringify([
    {
      event: "Purchase",
      properties: {
        distinct_id: "user_123",
        $insert_id: "evt_abc123",
        time: Math.floor(Date.now() / 1000),
        revenue: 89.99,
        product_id: "SKU-001",
        product_name: "Widget Pro"
      }
    }
  ])
});

// Expected response: { "code": 200, "status": "OK", "num_records_imported": 1 }

کوہارٹ کو Brevo سے سنک کریں

// Mixpanel کوہارٹ ایکسپورٹ کریں اور Brevo فہرست سے سنک کریں
const cohort = await tajo.connectors.syncCohort('mixpanel', {
  cohortId: 12345,
  targetList: 16,
  syncMode: 'mirror'
});

console.log(cohort);
// {
//   cohortName: "Engaged Users (Last 7 Days)",
//   membersCount: 3200,
//   syncedToBrevo: 3200,
//   listId: 16
// }

صارف پروفائل خصوصیات سیٹ کریں

// Engage API کے ذریعے صارف خصوصیات سیٹ کریں
const response = await fetch('https://api.mixpanel.com/engage#$set', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify([{
    $token: process.env.MIXPANEL_TOKEN,
    $distinct_id: "user_123",
    $set: {
      $email: "[email protected]",
      $first_name: "Jane",
      $last_name: "Kim",
      plan: "premium",
      total_orders: 12,
      lifetime_value: 1250.00
    }
  }])
});

ریٹ کی حدود

مسائل کا سراغ

بہترین طریقے

1. Service Accounts استعمال کریں - سرور سائیڈ توثیق کے لیے Project Secret پر Service Accounts کو ترجیح دیں
2. $insert_id شامل کریں - ایونٹ ڈی ڈپلیکیشن کے لیے ہمیشہ ایک منفرد insert ID سیٹ کریں
3. پروفائل اپ ڈیٹس کو بیچ کریں - کارکردگی کے لیے فی درخواست 2,000 تک پروفائل اپ ڈیٹس بھیجیں
4. EU اینڈ پوائنٹس استعمال کریں - EU ڈیٹا رہائش کے لیے، تمام API کالز کے لیے api-eu.mixpanel.com استعمال کریں
5. کوہارٹس کو شیڈول پر سنک کریں - مسلسل پولنگ کے بجائے روزانہ یا ہفتہ وار کوہارٹ سنک سیٹ اپ کریں
6. محفوظ خصوصیات کو میپ کریں - پروفائل ڈیٹا کے لیے Mixpanel کی محفوظ خصوصیات ($email، $first_name) استعمال کریں
7. ingestion کی نگرانی کریں - تصدیق کرنے کے لیے کہ ایونٹس درست طریقے سے موصول ہو رہے ہیں Mixpanel کا Events صفحہ استعمال کریں

سیکیورٹی

• صرف HTTPS - تمام API مواصلات کو TLS encryption کی ضرورت ہوتی ہے
• Service Account تنہائی - رول پر مبنی اجازتوں کے ساتھ فی پروجیکٹ محدود رسائی
• ایونٹ ڈی ڈپلیکیشن - $insert_id کے ذریعے بلٹ ان dedup ڈیٹا کی سالمیت کے مسائل کو روکتا ہے
• SOC 2 Type II - Mixpanel SOC 2 Type II سند یافتہ ہے
• GDPR/CCPA - GDPR API کے ذریعے صارف کے ڈیٹا کی حذف کی حمایت کرتا ہے
• EU ڈیٹا رہائش - یورپی تعمیل کے لیے EU ڈیٹا سینٹر دستیاب

متعلقہ وسائل

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