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

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

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

# Amplitude کنیکٹر

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

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

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

## جائزہ

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

## خصوصیات

- **ایونٹ فارورڈنگ** - مارکیٹنگ آٹومیشن ٹرگرز کے لیے 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 سرور سائیڈ درخواستوں کی توثیق کرتی ہے۔

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

### HTTP V2 API توثیق

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

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

## کنفیگریشن

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

```yaml
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 آٹومیشن ٹرگرز سے میپ کریں:

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

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

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `POST` | `/2/httpapi` | ایونٹس اپ لوڈ کریں (HTTP V2 API) |
| `POST` | `/batch` | بلک ایونٹس اپ لوڈ کریں (Batch API) |
| `POST` | `/identify` | صارف کی خصوصیات سیٹ کریں |
| `POST` | `/groupidentify` | گروپ کی خصوصیات سیٹ کریں |
| `GET` | `/2/export` | خام ایونٹ ڈیٹا ایکسپورٹ کریں |
| `GET` | `/2/usersearch` | صارفین تلاش کریں |
| `GET` | `/2/useractivity` | صارف کی سرگرمی کی ٹائم لائن حاصل کریں |
| `POST` | `/api/3/cohort/export` | کوہارٹ ممبران ایکسپورٹ کریں |
| `GET` | `/api/3/chart/{chart_id}/query` | محفوظ چارٹ ڈیٹا کی استفسار |

## کوڈ مثالیں

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

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

```javascript
// 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: "jane@example.com",
            plan_type: "premium"
          }
        },
        time: Date.now()
      }
    ]
  })
});

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

### کوہارٹ کو Brevo فہرست میں سنک کریں

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

## ریٹ کی حدود

| API | حد | تفصیلات |
| --- | --- | --- |
| **HTTP V2 API** | 1,000 ایونٹس/سیکنڈ | فی پروجیکٹ، 2,000/سیکنڈ تک برسٹ |
| **Batch API** | 1,000 ایونٹس/بیچ | زیادہ سے زیادہ 20 بیچ/سیکنڈ |
| **Identify API** | 1,000 درخواستیں/سیکنڈ | فی پروجیکٹ |
| **Export API** | 360 درخواستیں/گھنٹہ | فی پروجیکٹ |
| **Cohort Export** | 1 ہم وقت ایکسپورٹ | فی کوہارٹ |
| **Dashboard REST API** | 360 درخواستیں/گھنٹہ | فی پروجیکٹ |

ایونٹ سائز کی حدود

ہر ایونٹ پے لوڈ 1 MB سے زیادہ نہیں ہو سکتا۔ HTTP V2 API فی درخواست 2,000 ایونٹس تک قبول کرتا ہے جس کا زیادہ سے زیادہ باڈی سائز 20 MB ہے۔

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

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| ایونٹس `invalid` اسٹیٹس واپس کرتے ہیں | غائب ضروری فیلڈز | یقینی بنائیں کہ ہر ایونٹ پر `user_id` یا `device_id` سیٹ ہے |
| صارف کی خصوصیات سنک نہیں ہو رہیں | غلط پراپرٹی آپریٹر | سیٹنگ کے لیے `$set`، پہلے ٹچ ویلیوز کے لیے `$setOnce` استعمال کریں |
| کوہارٹ ایکسپورٹ خالی | کوہارٹ ابھی بھی کمپیوٹ ہو رہا ہے | ایکسپورٹ سے پہلے کوہارٹ کمپیوٹیشن مکمل ہونے کا انتظار کریں |
| 429 Too Many Requests | ریٹ کی حد سے تجاوز | exponential backoff نافذ کریں اور batch API استعمال کریں |
| آمدنی ٹریک نہیں ہو رہی | آمدنی فیلڈز غائب | ایونٹ خصوصیات میں `price`، `quantity`، اور `revenue` شامل کریں |
| EU ڈیٹا روٹ نہیں ہو رہا | غلط ڈیٹا سینٹر | `data_center: "EU"` سیٹ کریں اور `api.eu.amplitude.com` استعمال کریں |

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

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 کنیکٹر](https://tajo.io/ur/docs/connectors/custom/segment)
- [Mixpanel کنیکٹر](https://tajo.io/ur/docs/connectors/custom/mixpanel)
- [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)