Twilio Segment Bağlayıcısı

Müşteri veri hattınızı birleştirmek, herhangi bir kaynaktan gelen olayları Brevo’ya yönlendirmek ve daha zengin pazarlama otomasyonu için Segment’in kimlik çözümlemesinden yararlanmak üzere Twilio Segment’i Tajo aracılığıyla Brevo’ya bağlayın.

Genel Bakış

Özellikler

• Evrensel veri toplama - Segment SDK’ları aracılığıyla web sitelerinden, mobil uygulamalardan ve sunuculardan olay toplayın
• Kaynak yönlendirme - Tajo üzerinden 400’den fazla kaynaktan Brevo’ya veri yönlendirin
• Kimlik çözümleme - Anonim ve bilinen kullanıcı profillerini otomatik olarak birleştirin
• Kitle senkronizasyonu - Segment hesaplanmış özelliklerini ve kitlelerini Brevo listelerine gönderin
• Olay akışı - Segment’in Connections çerçevesi aracılığıyla gerçek zamanlı olay iletimi
• Ters ETL - Segment Reverse ETL kullanarak ambar verilerini Brevo’ya geri senkronize edin
• Şema zorlaması - Senkronize etmeden önce olay şemalarını Segment Protocols ile doğrulayın

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

1. Bir kaynak yapılandırılmış Twilio Segment çalışma alanı
2. Kaynak için Segment Yazma Anahtarınız
3. API erişimi olan bir Brevo hesabı
4. API kimlik bilgilerine sahip bir Tajo hesabı

Kimlik Doğrulama

Segment Yazma Anahtarı

Segment, her kaynağa bağlı benzersiz bir tanımlayıcı olan Yazma Anahtarını kullanarak kaynakların kimliğini doğrular.

// Yazma Anahtarı ile Analytics.js başlatma
analytics.load("YOUR_SEGMENT_WRITE_KEY");

Tajo API Belirteci

Tajo bağlayıcısını kimlik bilgilerinizle yapılandırın:

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

Yapılandırma

Temel Kurulum

connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # veya AB çalışma alanı için "eu"

    # Veri senkronizasyon seçenekleri
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Brevo liste ataması
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7

Olay Eşleştirme

Segment izleme olaylarını Brevo olay türlerine eşleyin:

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

  # Özel olaylar
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"

Özellik Eşleştirme

Segment identify özelliklerini Brevo kişi özniteliklerine eşleyin:

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

API Uç Noktaları

Kod Örnekleri

Segment’i Tajo Hedefi ile Başlatma

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

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

// Segment kaynağını bağla
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});

Segment Aracılığıyla Olayları İzleme

// Bir kullanıcıyı tanımla - Brevo kişilerine senkronize olur
analytics.identify("user_123", {
  email: "[email protected]",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Bir olayı izle - Brevo'ya iletilir
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Sayfa görüntüleme izleme
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});

Sunucu Tarafı Olay İletimi (Node.js)

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

// Veritabanınızdan kullanıcıları toplu olarak tanımla
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
    }
  });
}

// Kuyruğu boşalt
await analytics.flush();

Hız Sınırları

Sorun Giderme

En İyi Uygulamalar

1. Track’ten önce identify kullanın - Olayların doğru kullanıcıya atfedildiğinden emin olmak için her zaman track’ten önce identify çağırın
2. Bir izleme planı uygulayın - Olay şemalarını zorunlu kılmak için Segment Protocols kullanın
3. Sunucu tarafı çağrıları toplu işleyin - HTTP yükünü azaltmak için sunucu tarafı entegrasyonlar için toplu API kullanın
4. Özellikleri açıkça eşleyin - Varsayılanlara güvenmek yerine özellik-öznitelik eşleştirmelerini tanımlayın
5. Segment Functions kullanın - Brevo’ya ulaşmadan önce olayları anlık olarak dönüştürün
6. Olay teslimatını izleyin - Başarısız olaylar için Segment’in Event Delivery panosunu kontrol edin
7. Replay kurun - Geçmiş olayları yeniden işlemek için Segment Replay’i etkinleştirin

Güvenlik

• TLS şifrelemesi - Tüm veriler HTTPS/TLS 1.2+ üzerinden iletilir
• Yazma Anahtarı izolasyonu - Her kaynağın kendi Yazma Anahtarı vardır
• GDPR uyumluluğu - Segment veri silme ve baskılama isteklerini destekler
• SOC 2 Type II - Segment SOC 2 Type II sertifikalıdır
• Bölgesel veri barındırma - Veri ikametgahı uyumluluğu için AB çalışma alanı seçeneği

İlgili Kaynaklar

• Amplitude Bağlayıcısı
• Mixpanel Bağlayıcısı
• Müşteri Senkronizasyonu Yeteneği
• Brevo Olaylar API