---
title: "موصل Amplitude"
description: "دليل التكامل الكامل لـ Amplitude لمزامنة أحداث تحليلات المنتج، وخصائص المستخدمين، والمجموعات السلوكية مع Brevo عبر Tajo."
url: https://tajo.io/ar/docs/connectors/custom/amplitude/
markdown: https://tajo.io/ar/docs/connectors/custom/amplitude.md
lang: ar-SA
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 بـ Brevo عبر Tajo للاستفادة من بيانات تحليلات المنتج لأتمتة التسويق. زامن المجموعات السلوكية وخصائص المستخدم وأحداث المنتج لتشغيل حملات مستهدفة.

## نظرة عامة

| الخاصية | القيمة |
| --- | --- |
| **المنصة** | Amplitude |
| **الفئة** | التحليلات (مخصص) |
| **تعقيد الإعداد** | متوسط |
| **تكامل رسمي** | لا |
| **البيانات المتزامنة** | الأحداث، المستخدمون، المجموعات، الخصائص |
| **المهارات المتاحة** | 6 |

## الميزات

- **إعادة توجيه الأحداث** - أرسل أحداث تتبع 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 مشروعك، بينما يُصادق المفتاح السري الطلبات من جانب الخادم.

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

### مصادقة HTTP V2 API

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

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

// 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

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

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

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

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

## حدود المعدل

| API | الحد | التفاصيل |
| --- | --- | --- |
| **HTTP V2 API** | 1,000 حدث/ثانية | لكل مشروع، مع اندفاع يصل إلى 2,000/ثانية |
| **Batch API** | 1,000 حدث/دفعة | حد أقصى 20 دفعة/ثانية |
| **Identify API** | 1,000 طلب/ثانية | لكل مشروع |
| **Export API** | 360 طلبًا/ساعة | لكل مشروع |
| **Cohort Export** | تصدير متزامن واحد | لكل مجموعة |
| **Dashboard REST API** | 360 طلبًا/ساعة | لكل مشروع |

حدود حجم الحدث

لا يمكن أن تتجاوز حمولة كل حدث 1 MB. يقبل HTTP V2 API ما يصل إلى 2,000 حدث لكل طلب بحجم جسم أقصى 20 MB.

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

| المشكلة | السبب | الحل |
| --- | --- | --- |
| الأحداث تُرجع حالة `invalid` | حقول مطلوبة مفقودة | تأكد من ضبط `user_id` أو `device_id` في كل حدث |
| خصائص المستخدم لا تُزامن | مشغل خاصية خاطئ | استخدم `$set` للضبط، `$setOnce` لقيم اللمسة الأولى |
| تصدير المجموعة فارغ | المجموعة لا تزال تُحسب | انتظر اكتمال حساب المجموعة قبل التصدير |
| 429 Too Many Requests | تجاوز حد المعدل | نفّذ التراجع الأسي واستخدم batch API |
| الإيرادات لا تُتبع | حقول إيرادات مفقودة | أدرج `price` و `quantity` و `revenue` في خصائص الحدث |
| بيانات EU لا تُوجَّه | مركز بيانات خاطئ | اضبط `data_center: "EU"` واستخدم `api.eu.amplitude.com` |

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

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](https://tajo.io/ar/docs/connectors/custom/segment)
- [موصل Mixpanel](https://tajo.io/ar/docs/connectors/custom/mixpanel)
- [مهارة مزامنة العملاء](https://tajo.io/ar/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/ar/docs/events-engagement/create-event)