Twilio Segment Connector

เชื่อมต่อ Twilio Segment กับ Brevo ผ่าน Tajo เพื่อรวม customer data pipeline ของคุณ กำหนดเส้นทางเหตุการณ์จากแหล่งใดก็ได้ไปยัง Brevo และใช้ประโยชน์จาก identity resolution ของ Segment สำหรับระบบอัตโนมัติทางการตลาดที่สมบูรณ์ยิ่งขึ้น

ภาพรวม

ฟีเจอร์

• การรวบรวมข้อมูลแบบ Universal - รวบรวมเหตุการณ์จากเว็บไซต์ แอปมือถือ และเซิร์ฟเวอร์ผ่าน Segment SDKs
• การกำหนดเส้นทางแหล่งข้อมูล - กำหนดเส้นทางข้อมูลจาก 400+ แหล่งเข้าสู่ Brevo ผ่าน Tajo
• Identity resolution - รวม anonymous และ known user profiles โดยอัตโนมัติ
• การซิงค์ audience - ส่ง computed traits และ audiences ของ Segment ไปยังรายการ Brevo
• Event streaming - การส่งต่อเหตุการณ์แบบเรียลไทม์ผ่าน Connections framework ของ Segment
• Reverse ETL - ซิงค์ข้อมูล warehouse กลับไปยัง Brevo โดยใช้ Segment Reverse ETL
• Schema enforcement - ตรวจสอบ event schemas ด้วย Segment Protocols ก่อนซิงค์

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. Twilio Segment workspace ที่มีการกำหนดค่า source
2. Segment Write Key สำหรับ source
3. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
4. บัญชี Tajo ที่มีข้อมูลประจำตัว API

การยืนยันตัวตน

Segment Write Key

Segment ยืนยันตัวตน sources โดยใช้ Write Key ซึ่งเป็นตัวระบุที่ไม่ซ้ำกันที่เชื่อมกับแต่ละ source

// Analytics.js initialization with Write Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");

Tajo API Token

กำหนดค่า Tajo connector ด้วยข้อมูลประจำตัวของคุณ:

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 events กับประเภทเหตุการณ์ 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"

การแมป Traits

แมป 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 Endpoints

ตัวอย่างโค้ด

เริ่มต้น Segment กับ Tajo Destination

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

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

// Connect Segment source
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});

ติดตามเหตุการณ์ผ่าน Segment

// Identify a user - syncs to Brevo contacts
analytics.identify("user_123", {
  email: "[email protected]",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Track an event - forwards to Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Page view tracking
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);

// Batch identify users from your database
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 the queue
await analytics.flush();

ขีดจำกัดอัตรา

การแก้ไขปัญหา

แนวทางปฏิบัติที่ดีที่สุด

1. ใช้ identify ก่อน track - เรียก identify เสมอก่อน track เพื่อให้แน่ใจว่าเหตุการณ์ถูกนำไปให้ผู้ใช้ที่ถูกต้อง
2. ใช้ tracking plan - ใช้ Segment Protocols เพื่อบังคับใช้ event schemas
3. Batch การเรียกฝั่งเซิร์ฟเวอร์ - ใช้ batch API สำหรับการผสานรวมฝั่งเซิร์ฟเวอร์เพื่อลด HTTP overhead
4. แมป traits อย่างชัดเจน - กำหนดการแมป trait-to-attribute แทนที่จะพึ่งพาค่าเริ่มต้น
5. ใช้ Segment Functions - แปลงเหตุการณ์ขณะส่งก่อนที่จะถึง Brevo
6. ตรวจสอบการส่งเหตุการณ์ - ตรวจสอบ Event Delivery dashboard ของ Segment สำหรับเหตุการณ์ที่ล้มเหลว
7. ตั้งค่า Replay - เปิดใช้งาน Segment Replay สำหรับการประมวลผลเหตุการณ์ประวัติซ้ำ

ความปลอดภัย

• การเข้ารหัส TLS - ข้อมูลทั้งหมดส่งผ่าน HTTPS/TLS 1.2+
• การแยก Write Key - แต่ละ source มี Write Key ของตัวเอง
• ความสอดคล้องกับ GDPR - Segment รองรับคำขอการลบและระงับข้อมูล
• SOC 2 Type II - Segment ได้รับการรับรอง SOC 2 Type II
• การโฮสต์ข้อมูลตามภูมิภาค - ตัวเลือก EU workspace สำหรับความสอดคล้องด้านการพำนักข้อมูล

แหล่งข้อมูลที่เกี่ยวข้อง

• Amplitude Connector
• Mixpanel Connector
• Customer Sync Skill
• Brevo Events API