---
title: "Mixpanel کنیکٹر"
description: "Tajo کے ذریعے Brevo کے ساتھ پروڈکٹ اینالیٹکس ایونٹس، صارف پروفائلز، اور کوہارٹس کو سنک کرنے کے لیے مکمل Mixpanel انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/custom/mixpanel/
markdown: https://tajo.io/ur/docs/connectors/custom/mixpanel.md
lang: ur-PK
robots: noindex
---

ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

# Mixpanel کنیکٹر

کنیکٹر کی حیثیت: منصوبہ بند ابھی تیار نہیں ہوا۔ Tajo آج یہ کنیکٹر نہیں چلاتا۔

| ماخذ فیلڈ | منزل فیلڈ | نمونہ قدر |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Mixpanel |
| **زمرہ** | اینالیٹکس (حسب ضرورت) |
| **سیٹ اپ کی پیچیدگی** | معتدل |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | ایونٹس، پروفائلز، کوہارٹس، گروپس |
| **دستیاب Skills** | 7 |

## خصوصیات

- **ایونٹ 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 استعمال کرتے ہیں۔

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

### Project Token

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

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

### OAuth (Partner Integrations کے لیے)

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

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

## کنفیگریشن

### بنیادی سیٹ اپ

```yaml
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 ایونٹ اقسام سے میپ کریں:

```yaml
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 رابطہ خصوصیات سے میپ کریں:

```yaml
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 اینڈ پوائنٹس

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `POST` | `/import` | ایونٹس امپورٹ کریں (Ingestion API) |
| `POST` | `/track` | ایونٹس ٹریک کریں (کلائنٹ سائیڈ) |
| `POST` | `/engage#$set` | صارف پروفائل خصوصیات سیٹ کریں |
| `POST` | `/engage#$set_once` | خصوصیات صرف اس صورت میں سیٹ کریں جب پہلے سیٹ نہ ہوں |
| `POST` | `/engage#$delete` | ایک صارف پروفائل حذف کریں |
| `POST` | `/engage#$union` | فہرست خصوصیات کا union |
| `POST` | `/groups` | گروپ پروفائل خصوصیات سیٹ کریں |
| `GET` | `/export` | خام ایونٹ ڈیٹا ایکسپورٹ کریں |
| `POST` | `/cohorts/list` | محفوظ کوہارٹس کی فہرست |
| `POST` | `/engage/query` | صارف پروفائلز کی استفسار |
| `POST` | `/jql` | حسب ضرورت JQL queries چلائیں |
| `GET` | `/segmentation` | segmentation رپورٹس کی استفسار |
| `GET` | `/retention` | retention رپورٹس کی استفسار |
| `GET` | `/funnels` | funnel رپورٹس کی استفسار |

## کوڈ مثالیں

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

```javascript
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 کے ذریعے ایونٹس امپورٹ کریں

```javascript
// 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 سے سنک کریں

```javascript
// 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
// }
```

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

```javascript
// 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: "jane@example.com",
      $first_name: "Jane",
      $last_name: "Kim",
      plan: "premium",
      total_orders: 12,
      lifetime_value: 1250.00
    }
  }])
});
```

## ریٹ کی حدود

| API | حد | تفصیلات |
| --- | --- | --- |
| **Ingestion API** | 2 GB/منٹ | فی پروجیکٹ |
| **Track API** | کوئی سخت حد نہیں | Best-effort delivery |
| **Engage API** | 2,000 اپ ڈیٹس/بیچ | فی پروجیکٹ زیادہ سے زیادہ 2 GB/منٹ |
| **Query API** | 60 درخواستیں/گھنٹہ | فی پروجیکٹ (Service Account) |
| **Export API** | 60 درخواستیں/گھنٹہ | فی استفسار زیادہ سے زیادہ 100 دن |
| **JQL API** | 60 درخواستیں/گھنٹہ | فی پروجیکٹ |
| **Cohort Export** | 60 درخواستیں/گھنٹہ | فی پروجیکٹ |

ایونٹ ڈی ڈپلیکیشن

Mixpanel `$insert_id` پراپرٹی کا استعمال کرتے ہوئے ایونٹس کو ڈی ڈپلیکیٹ کرتا ہے۔ ناکام امپورٹس کی دوبارہ کوشش کرتے وقت ڈپلیکیٹ ایونٹس کو روکنے کے لیے ہمیشہ ایک منفرد `$insert_id` شامل کریں۔

## مسائل کا سراغ

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| ایونٹس ظاہر نہیں ہو رہے | غلط project token | تصدیق کریں کہ ٹوکن ہدف پروجیکٹ سے میل کھاتا ہے |
| پروفائل خصوصیات غائب | غلط API استعمال کرنا | پروفائل خصوصیات کے لیے `/engage#$set` استعمال کریں، `/track` نہیں |
| کوہارٹ ایکسپورٹ ناکام | ناکافی اجازتیں | یقینی بنائیں کہ Service Account کا Admin یا Analyst رول ہے |
| ڈپلیکیٹ ایونٹس | غائب `$insert_id` | ہر ایونٹ پر منفرد `$insert_id` شامل کریں |
| 402 Payment Required | ڈیٹا کی حدود سے تجاوز | Mixpanel پلان کی حدود چیک کریں اور اگر ضرورت ہو تو اپ گریڈ کریں |
| EU ڈیٹا روٹ نہیں ہو رہا | غلط data residency | EU پروجیکٹس کے لیے `api-eu.mixpanel.com` استعمال کریں |
| identity merge مسائل | غلط distinct\_id | Mixpanel کے identity management بہترین طریقوں پر عمل کریں |

## بہترین طریقے

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 کنیکٹر](https://tajo.io/ur/docs/connectors/custom/segment)
- [Amplitude کنیکٹر](https://tajo.io/ur/docs/connectors/custom/amplitude)
- [Customer Sync Skill](https://tajo.io/ur/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/ur/docs/events-engagement/create-event)