Twilio Segment کنیکٹر

اپنے کسٹمر ڈیٹا پائپ لائن کو متحد کرنے، کسی بھی ذریعہ سے Brevo کو ایونٹس روٹ کرنے، اور امیر مارکیٹنگ آٹومیشن کے لیے Segment کے identity resolution کا فائدہ اٹھانے کے لیے Twilio Segment کو Tajo کے ذریعے Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• عالمگیر ڈیٹا جمع آوری - Segment SDKs کے ذریعے ویب سائٹس، موبائل ایپس، اور سرورز سے ایونٹس جمع کریں
• Source routing - Tajo کے ذریعے 400+ ذرائع سے ڈیٹا کو Brevo میں روٹ کریں
• Identity resolution - خود بخود گمنام اور معلوم صارف پروفائلز کو ضم کریں
• Audience سنک - Segment کے computed traits اور audiences کو Brevo فہرستوں میں بھیجیں
• ایونٹ اسٹریمنگ - Segment کے Connections framework کے ذریعے ریئل ٹائم ایونٹ فارورڈنگ
• Reverse ETL - Segment Reverse ETL کا استعمال کرتے ہوئے warehouse ڈیٹا کو Brevo میں واپس سنک کریں
• Schema enforcement - سنک کرنے سے پہلے Segment Protocols کے ساتھ ایونٹ schemas کی توثیق کریں

ضروریات

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

1. source کنفیگر شدہ کے ساتھ Twilio Segment ورک اسپیس
2. source کے لیے آپ کا Segment Write Key
3. API رسائی کے ساتھ Brevo اکاؤنٹ
4. API اسناد کے ساتھ Tajo اکاؤنٹ

توثیق

Segment Write Key

Segment sources کی توثیق کے لیے Write Key کا استعمال کرتا ہے، جو ہر source سے منسلک ایک منفرد شناخت کنندہ ہے۔

// Analytics.js کو Write Key کے ساتھ شروع کریں
analytics.load("YOUR_SEGMENT_WRITE_KEY");

Tajo API Token

اپنے Tajo کنیکٹر کو اپنی اسناد کے ساتھ کنفیگر کریں:

tajo connectors install segment \
  --write-key $SEGMENT_WRITE_KEY \
  --workspace-slug your-workspace \
  --brevo-api-key $BREVO_API_KEY

کنفیگریشن

بنیادی سیٹ اپ

connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # or "eu" for EU workspace

    # Data sync options
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Brevo list assignment
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7

ایونٹ میپنگ

Segment track ایونٹس کو Brevo ایونٹ اقسام سے میپ کریں:

event_mapping:
  # Segment event -> Brevo event
  "Order Completed": "order_completed"
  "Product Viewed": "product_viewed"
  "Cart Updated": "cart_updated"
  "Signed Up": "customer_created"
  "Checkout Started": "checkout_started"

  # Custom events
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"

Trait میپنگ

Segment identify traits کو Brevo رابطہ خصوصیات سے میپ کریں:

trait_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS
  plan: PLAN_TYPE
  company: COMPANY
  createdAt: SIGNUP_DATE
  lifetimeValue: LTV

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

کوڈ مثالیں

Segment کو Tajo Destination کے ساتھ شروع کریں

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

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

// Segment source منسلک کریں
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});

Segment کے ذریعے ایونٹس ٹریک کریں

// صارف کی شناخت کریں - Brevo رابطوں میں سنک ہوتا ہے
analytics.identify("user_123", {
  email: "[email protected]",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// ایونٹ ٹریک کریں - Brevo کو آگے بھیجتا ہے
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// صفحہ ویو ٹریکنگ
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});

سرور سائیڈ ایونٹ فارورڈنگ (Node.js)

const Analytics = require('analytics-node');
const analytics = new Analytics(process.env.SEGMENT_WRITE_KEY);

// اپنے ڈیٹا بیس سے صارفین کو بیچ شناخت کریں
const users = await db.query('SELECT * FROM users WHERE updated_at > $1', [lastSync]);

for (const user of users) {
  analytics.identify({
    userId: user.id,
    traits: {
      email: user.email,
      firstName: user.first_name,
      lastName: user.last_name,
      totalOrders: user.order_count,
      lifetimeValue: user.ltv
    }
  });
}

// قطار کو flush کریں
await analytics.flush();

ریٹ کی حدود

مسائل کا سراغ

بہترین طریقے

1. track سے پہلے identify استعمال کریں - ایونٹس کو صحیح صارف سے منسوب کرنے کے لیے ہمیشہ track سے پہلے identify کال کریں
2. ایک tracking plan نافذ کریں - ایونٹ schemas کو نافذ کرنے کے لیے Segment Protocols استعمال کریں
3. سرور سائیڈ کالز کو بیچ کریں - HTTP overhead کم کرنے کے لیے سرور سائیڈ integrations کے لیے batch API استعمال کریں
4. traits کو واضح طور پر میپ کریں - defaults پر انحصار کرنے کے بجائے trait سے attribute میپنگ کی وضاحت کریں
5. Segment Functions استعمال کریں - Brevo تک پہنچنے سے پہلے ایونٹس کو in-flight ٹرانسفارم کریں
6. ایونٹ ڈیلیوری کی نگرانی کریں - ناکام ایونٹس کے لیے Segment کا Event Delivery dashboard چیک کریں
7. Replay سیٹ اپ کریں - تاریخی ایونٹس کو دوبارہ پروسیس کرنے کے لیے Segment Replay فعال کریں

سیکیورٹی

• TLS encryption - تمام ڈیٹا HTTPS/TLS 1.2+ پر منتقل ہوتا ہے
• Write Key تنہائی - ہر source کی اپنی Write Key ہوتی ہے
• GDPR تعمیل - Segment ڈیٹا حذف اور suppression کی درخواستوں کی حمایت کرتا ہے
• SOC 2 Type II - Segment SOC 2 Type II سند یافتہ ہے
• علاقائی ڈیٹا ہوسٹنگ - ڈیٹا رہائش کی تعمیل کے لیے EU ورک اسپیس آپشن

متعلقہ وسائل

• Amplitude کنیکٹر
• Mixpanel کنیکٹر
• Customer Sync Skill
• Brevo Events API