Customer.io کنیکٹر

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

جائزہ

خصوصیات

• لوگوں کا سنک - 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 کے ساتھ تصدیق کرتا ہے۔

# 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": "[email protected]"}'

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

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

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

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

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

تشکیل

بنیادی سیٹ اپ

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

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

ایونٹ میپنگ

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 اینڈ پوائنٹس کے ساتھ انٹیگریٹ ہوتا ہے:

کوڈ کی مثالیں

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

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 میں سنک کریں

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

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

// 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');
});

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

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 مختلف شرح کی حدود نافذ کرتا ہے:

ٹربل شوٹنگ

عام مسائل

ڈیبگ موڈ

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

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

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 کنیکٹر
• Iterable کنیکٹر
• گاہک سنک اسکل
• Brevo Contacts API