Twilio Segment Connector

Verbinde Twilio Segment über Tajo mit Brevo, um deine Kundendaten-Pipeline zu vereinheitlichen, Events aus beliebigen Quellen an Brevo weiterzuleiten und die Identitätsauflösung von Segment für umfassendere Marketing-Automation zu nutzen.

Überblick

Funktionen

• Universelle Datenerfassung - Erfasse Events von Websites, Mobile-Apps und Servern über Segment-SDKs
• Source-Routing - Leite Daten aus 400+ Quellen über Tajo in Brevo
• Identitätsauflösung - Merge anonyme und bekannte Nutzer:innen-Profile automatisch
• Audience-Synchronisation - Sende berechnete Traits und Audiences von Segment an Brevo-Listen
• Event-Streaming - Echtzeit-Event-Forwarding über das Connections-Framework von Segment
• Reverse ETL - Synchronisiere Warehouse-Daten zurück in Brevo mit Segment Reverse ETL
• Schema-Enforcement - Validiere Event-Schemas mit Segment Protocols vor der Synchronisation

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

1. Einen Twilio-Segment-Workspace mit konfigurierter Source
2. Deinen Segment Write Key für die Source
3. Ein Brevo-Konto mit API-Zugriff
4. Ein Tajo-Konto mit API-Zugangsdaten

Authentifizierung

Segment Write Key

Segment authentifiziert Sources über einen Write Key – eine eindeutige Kennung, die an jede Source gebunden ist.

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

Tajo API Token

Konfiguriere den Tajo-Connector mit deinen Zugangsdaten:

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

Konfiguration

Grundeinrichtung

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

Event-Mapping

Mappe Segment-Track-Events auf Brevo-Event-Typen:

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-Mapping

Mappe Segment-Identify-Traits auf Brevo-Kontaktattribute:

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

API-Endpoints

Code-Beispiele

Segment mit Tajo-Destination initialisieren

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

Events via Segment tracken

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

Serverseitiges Event-Forwarding (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();

Rate Limits

Fehlerbehebung

Best Practices

1. Identify vor Track nutzen - Rufe immer identify vor track auf, damit Events der richtigen Nutzer:in zugeordnet werden
2. Tracking Plan implementieren - Nutze Segment Protocols, um Event-Schemas durchzusetzen
3. Serverseitige Aufrufe bündeln - Nutze die Batch-API für serverseitige Integrationen, um HTTP-Overhead zu reduzieren
4. Traits explizit mappen - Definiere Trait-zu-Attribut-Mappings, anstatt dich auf Defaults zu verlassen
5. Segment Functions nutzen - Transformiere Events in-flight, bevor sie Brevo erreichen
6. Event-Delivery überwachen - Prüfe das Event-Delivery-Dashboard von Segment auf fehlgeschlagene Events
7. Replay einrichten - Aktiviere Segment Replay, um historische Events neu zu verarbeiten

Sicherheit

• TLS-Verschlüsselung - Alle Daten werden über HTTPS/TLS 1.2+ übertragen
• Write-Key-Isolation - Jede Source hat ihren eigenen Write Key
• DSGVO-Konformität - Segment unterstützt Datenlöschungs- und Sperranfragen
• SOC 2 Type II - Segment ist SOC 2 Type II zertifiziert
• Regionales Data Hosting - EU-Workspace-Option für Datenresidenz-Konformität

Verwandte Ressourcen

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