Konektor Twilio Segment

Hubungkan Twilio Segment ke Brevo melalui Tajo untuk menyatukan pipeline data pelanggan Anda, merutekan event dari sumber mana pun ke Brevo, dan memanfaatkan identity resolution milik Segment demi otomatisasi pemasaran yang lebih kaya.

Ikhtisar

Fitur

• Pengumpulan data universal - Kumpulkan event dari situs web, aplikasi mobile, dan server melalui SDK Segment
• Perutean sumber - Rutekan data dari 400+ sumber ke Brevo melalui Tajo
• Identity resolution - Gabungkan profil pengguna anonim dan yang sudah dikenal secara otomatis
• Sinkronisasi audiens - Kirim computed trait dan audiens Segment ke list Brevo
• Streaming event - Penerusan event real-time melalui framework Connections milik Segment
• Reverse ETL - Sinkronkan data warehouse kembali ke Brevo memakai Segment Reverse ETL
• Penegakan skema - Validasi skema event dengan Segment Protocols sebelum sinkronisasi

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Workspace Twilio Segment dengan satu source yang sudah dikonfigurasi
2. Segment Write Key untuk source tersebut
3. Akun Brevo dengan akses API
4. Akun Tajo dengan kredensial API

Autentikasi

Segment Write Key

Segment mengautentikasi source memakai Write Key, yaitu pengenal unik yang terikat pada setiap source.

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

Token API Tajo

Konfigurasikan konektor Tajo dengan kredensial Anda:

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

Konfigurasi

Penyiapan dasar

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

Pemetaan event

Petakan event track Segment ke tipe event 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"

Pemetaan trait

Petakan trait identify Segment ke atribut kontak Brevo:

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

Endpoint API

Contoh kode

Inisialisasi Segment dengan destinasi Tajo

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

Lacak event melalui 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"
});

Penerusan event sisi server (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();

Batas rate

Pemecahan masalah

Praktik terbaik

1. Gunakan identify sebelum track - Selalu panggil identify sebelum track agar event dikaitkan dengan pengguna yang tepat
2. Terapkan tracking plan - Gunakan Segment Protocols untuk menegakkan skema event
3. Kelompokkan panggilan sisi server - Pakai batch API untuk integrasi sisi server agar overhead HTTP berkurang
4. Petakan trait secara eksplisit - Tetapkan pemetaan trait ke atribut, jangan mengandalkan nilai bawaan
5. Gunakan Segment Functions - Transformasikan event saat transit sebelum sampai ke Brevo
6. Pantau pengiriman event - Periksa dashboard Event Delivery Segment untuk event yang gagal
7. Siapkan Replay - Aktifkan Segment Replay untuk memproses ulang event historis

Keamanan

• Enkripsi TLS - Semua data dikirim melalui HTTPS/TLS 1.2+
• Isolasi Write Key - Setiap source memiliki Write Key sendiri
• Kepatuhan GDPR - Segment mendukung permintaan penghapusan dan penekanan data
• SOC 2 Type II - Segment tersertifikasi SOC 2 Type II
• Hosting data regional - Opsi workspace EU untuk kepatuhan residensi data

Sumber daya terkait

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