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

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

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

# Customer.io کنیکٹر

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

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

متحدہ گاہک ڈیٹا، کراس پلیٹ فارم مہم تعاون، اور یکجا engagement اینالیٹکس کے لیے اپنے Customer.io پیغام رسانی پلیٹ فارم کو Brevo سے منسلک کریں۔

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Customer.io |
| **زمرہ** | مارکیٹنگ |
| **سیٹ اپ کی پیچیدگی** | درمیانی |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | لوگ، ایونٹس، مہمات، سیگمنٹس |
| **استعمال شدہ APIs** | Track API, App API, Pipelines API |
| **تصدیق** | Site ID + API Key / App API Key |
| **بنیادی URLs** | `track.customer.io`, `api.customer.io` |

## خصوصیات

- **لوگوں کا سنک** - Brevo رابطوں کے ساتھ دو طرفہ گاہک پروفائل سنکرونائزیشن
- **ایونٹ فارورڈنگ** - رویاتی ایونٹس ٹریک کریں اور آٹومیشن ٹرگرز کے لیے Brevo کو فارورڈ کریں
- **مہم اینالیٹکس** - متحدہ رپورٹنگ کے لیے مہم کارکردگی میٹرکس سنک کریں
- **ورک فلو ڈیٹا** - Customer.io ورک فلو حالات کو Brevo رابطہ خصوصیات میں مرور کریں
- **سیگمنٹ نقل** - Customer.io سیگمنٹس کو Brevo فہرستوں کے طور پر نقل کریں
- **آبجیکٹ ڈیٹا سنک** - غیر لوگوں کے آبجیکٹس اور تعلق ڈیٹا سنک کریں

## شرائط

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

1. API رسائی کے ساتھ Customer.io اکاؤنٹ
2. آپ کا Site ID اور Track API Key (Settings > API Credentials میں ملتا ہے)
3. مہم اور سیگمنٹ ڈیٹا پڑھنے کے لیے App API key
4. API رسائی کے ساتھ Brevo اکاؤنٹ
5. فعال سبسکرپشن کے ساتھ Tajo اکاؤنٹ

## تصدیق

Customer.io دو الگ APIs کو مختلف تصدیقی طریقوں کے ساتھ استعمال کرتا ہے:

### Track API (رویاتی ڈیٹا)

لوگوں، ایونٹس، اور ڈیوائس ڈیٹا بھیجنے کے لیے استعمال ہوتا ہے۔ Basic Auth کے ذریعے Site ID اور API Key کے ساتھ تصدیق کرتا ہے۔

```bash
# Basic Auth: Site ID as username, API Key as password
curl -X POST https://track.customer.io/api/v1/customers/user123 \
  -u "$SITE_ID:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
```

### App API (ڈیٹا پڑھنا)

مہمات، سیگمنٹس، اور گاہک ڈیٹا حاصل کرنے کے لیے استعمال ہوتا ہے۔ Bearer ٹوکن کے ساتھ تصدیق کرتا ہے۔

```bash
curl -X GET https://api.customer.io/v1/campaigns \
  -H "Authorization: Bearer $APP_API_KEY"
```

API Key علیحدگی

Track API key اور App API key مختلف کریڈینشلز ہیں۔ Track API key ڈیٹا لکھنے کے لیے استعمال ہوتی ہے، جبکہ App API key ڈیٹا پڑھنے کے لیے ہے۔ مکمل Tajo انٹیگریشن کے لیے دونوں درکار ہیں۔

### Tajo سے منسلک ہونا

```bash
tajo connectors install customerio \
  --site-id $CIO_SITE_ID \
  --track-api-key $CIO_TRACK_API_KEY \
  --app-api-key $CIO_APP_API_KEY
```

## تشکیل

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

```yaml
connectors:
  customerio:
    enabled: true
    region: "us"  # or "eu" for EU data center

    sync:
      people: true
      events: true
      campaigns: true
      segments: true
      objects: false

    lists:
      all_contacts: 12
      active_subscribers: 13
      churned: 14
```

### فیلڈ میپنگ

Customer.io شخص خصوصیات کو Brevo رابطہ خصوصیات پر میپ کریں:

```yaml
field_mapping:
  # Standard fields
  id: CIO_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  created_at: SIGNUP_DATE
  last_activity: LAST_ACTIVE
  plan: PLAN_NAME

  # Custom attributes
  company: COMPANY
  role: JOB_TITLE
  mrr: MONTHLY_REVENUE
  lifecycle_stage: LIFECYCLE_STAGE
```

### ایونٹ میپنگ

```yaml
event_mapping:
  # Customer.io event -> Brevo event
  purchase_completed: ORDER_PLACED
  subscription_started: SUBSCRIPTION_START
  feature_activated: FEATURE_USED
  support_ticket_opened: SUPPORT_REQUEST
```

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

Tajo درج ذیل Customer.io API اینڈ پوائنٹس کے ساتھ انٹیگریٹ ہوتا ہے:

| اینڈ پوائنٹ | طریقہ | API | مقصد |
| --- | --- | --- | --- |
| `/api/v1/customers/{id}` | PUT | Track | شخص بنائیں یا اپ ڈیٹ کریں |
| `/api/v1/customers/{id}/events` | POST | Track | شخص ایونٹ ٹریک کریں |
| `/api/v1/events` | POST | Track | گمنام ایونٹس ٹریک کریں |
| `/api/v2/entity` | POST | Track | لوگ/آبجیکٹس بنائیں یا اپ ڈیٹ کریں (Pipelines) |
| `/v1/campaigns` | GET | App | مہمات کی فہرست |
| `/v1/campaigns/{id}/metrics` | GET | App | مہم کارکردگی میٹرکس |
| `/v1/segments` | GET | App | سیگمنٹس کی فہرست |
| `/v1/segments/{id}/membership` | GET | App | سیگمنٹ ممبران حاصل کریں |
| `/v1/customers/{id}/attributes` | GET | App | گاہک خصوصیات حاصل کریں |
| `/v1/customers/{id}/activities` | GET | App | گاہک سرگرمی لاگ حاصل کریں |

## کوڈ کی مثالیں

### کنیکٹر کو انیشیلائز کریں

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

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

await tajo.connectors.connect('customerio', {
  siteId: process.env.CIO_SITE_ID,
  trackApiKey: process.env.CIO_TRACK_API_KEY,
  appApiKey: process.env.CIO_APP_API_KEY,
  region: 'us'
});
```

### لوگوں کو Brevo میں سنک کریں

```javascript
// Incremental sync of Customer.io people
await tajo.connectors.sync('customerio', {
  type: 'incremental',
  resources: ['people'],
  since: '2024-01-01',
  batchSize: 100
});

const status = await tajo.connectors.status('customerio');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T14:20:00Z',
//   peopleCount: 32500,
//   campaignsTracked: 18,
//   eventsProcessed: 87000
// }
```

### ایونٹس فارورڈ کریں

```javascript
// Forward Customer.io reporting webhook events to Brevo
app.post('/webhooks/customerio', async (req, res) => {
  const events = req.body;

  for (const event of events) {
    await tajo.connectors.handleEvent('customerio', {
      type: event.metric,
      payload: {
        customerId: event.data.customer_id,
        campaignId: event.data.campaign_id,
        timestamp: event.timestamp
      }
    });
  }

  res.status(200).send('OK');
});
```

### سیگمنٹ ایکسپورٹ کریں

```javascript
const result = await tajo.connectors.exportSegment('customerio', {
  segmentId: 42,
  targetList: 13,
  includeAttributes: ['email', 'first_name', 'last_name', 'plan']
});

console.log(`Exported ${result.count} people to Brevo list 13`);
```

## شرح کی حدود

Customer.io فی API مختلف شرح کی حدود نافذ کرتا ہے:

| API | شرح کی حد | نوٹس |
| --- | --- | --- |
| **Track API** | ~100 درخواستیں/سیکنڈ | فی workspace |
| **App API** | 10 درخواستیں/سیکنڈ | فی API key |
| **Pipelines API** | 100 درخواستیں/سیکنڈ | بلک ڈیٹا کے لیے تجویز کردہ |
| **Batch endpoint** | 1,000 لوگ فی درخواست | زیادہ سے زیادہ payload 500KB |

بیچ اینڈ پوائنٹس استعمال کریں

بڑے syncs کے لیے، Tajo Customer.io batch endpoint استعمال کرتا ہے تاکہ فی درخواست 1,000 لوگ بھیج سکے، جس سے API کال کا حجم نمایاں طور پر کم ہوتا ہے۔

## ٹربل شوٹنگ

### عام مسائل

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| 401 Unauthorized | غلط Site ID یا API key | Customer.io Settings > API میں کریڈینشلز کی تصدیق کریں |
| لوگ سنک نہیں ہو رہے | غائب شناخت کنندہ | یقینی بنائیں کہ ہر شخص کے پاس `id` یا `email` ہے |
| ایونٹس ٹریک نہیں ہو رہے | غلط API key قسم | ایونٹس کے لیے Track API key استعمال کریں، App API key نہیں |
| EU ڈیٹا قابل رسائی نہیں | غلط region ترتیب | EU workspaces کے لیے region کو `eu` پر سیٹ کریں |
| شرح کی حد کی غلطیاں | بہت زیادہ App API کالز | مہم ڈیٹا کے لیے polling تعدد کم کریں |

### ڈیبگ موڈ

```yaml
connectors:
  customerio:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### کنکشن ٹیسٹ کریں

```bash
tajo connectors test customerio
# ✓ Track API connection successful
# ✓ App API connection successful
# ✓ People accessible
# ✓ Campaigns readable
# ✓ Segments listable
```

## بہترین طرز عمل

1. **بلک ڈیٹا کے لیے Pipelines API استعمال کریں** - نئی Pipelines API اعلی حجم ingestion کے لیے بہتر ہے
2. **رپورٹنگ webhooks سیٹ اپ کریں** - Customer.io ای میل ایونٹس کو ریئل ٹائم میں Tajo کو فارورڈ کریں
3. **lifecycle مراحل میپ کریں** - Customer.io سیگمنٹ رکنیت کو Brevo خصوصیات میں سنک کریں
4. **مستقل شناخت کنندگان استعمال کریں** - Customer.io اور Brevo کے درمیان `id` فیلڈز ملائیں
5. **Incrementally سنک کریں** - مکمل exports سے گریز کریں؛ `last_activity` ٹائم اسٹیمپس کا فائدہ اٹھائیں
6. **Webhook ڈیلیوری کی نگرانی کریں** - ناکام webhook ڈیلیوریوں کے لیے الرٹس سیٹ کریں

## سیکیورٹی

- **Basic Auth** - Track API Site ID اور API Key کے ساتھ تصدیق کرتا ہے
- **Bearer Token** - App API OAuth-style bearer ٹوکنز استعمال کرتا ہے
- **HTTPS صرف** - تمام API مواصلات TLS 1.2+ کے ذریعے انکرپٹڈ
- **علاقائی ڈیٹا سینٹرز** - GDPR کمپلائنس کے لیے EU ڈیٹا سینٹر آپشن
- **انکرپٹڈ اسٹوریج** - تمام کریڈینشلز Tajo میں آرام پر انکرپٹڈ
- **Webhook دستخط** - HMAC دستخطوں کے ساتھ webhook payloads کی توثیق کریں

## متعلقہ وسائل

- [Braze کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/braze)
- [Iterable کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/iterable)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/ur/docs/contact-management)