Twilio Segment-connector

Verbind Twilio Segment met Brevo via Tajo om je klantdata-pipeline te uniformeren, events vanuit elke bron naar Brevo te routeren en gebruik te maken van Segment’s identity resolution voor rijkere marketingautomatisering.

Overzicht

Functies

• Universele dataverzameling - Verzamel events vanuit websites, mobiele apps en servers via Segment SDK’s
• Source-routing - Route data van 400+ bronnen naar Brevo via Tajo
• Identity resolution - Voeg anonieme en bekende gebruikersprofielen automatisch samen
• Audience-synchronisatie - Stuur Segment computed traits en audiences naar Brevo-lijsten
• Event streaming - Realtime event-forwarding via Segment’s Connections-framework
• Reverse ETL - Synchroniseer warehouse-data terug naar Brevo met Segment Reverse ETL
• Schema-handhaving - Valideer event-schema’s met Segment Protocols voordat ze gesynchroniseerd worden

Vereisten

Voordat je begint, zorg dat je beschikt over:

1. Een Twilio Segment-workspace met een geconfigureerde source
2. Je Segment Write Key voor de source
3. Een Brevo-account met API-toegang
4. Een Tajo-account met API-credentials

Authenticatie

Segment Write Key

Segment authenticeert sources via een Write Key, een unieke identifier die aan elke source is gekoppeld.

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

Tajo API Token

Configureer de Tajo-connector met je credentials:

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

Configuratie

Basisinstelling

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

Eventmapping

Map Segment track-events naar Brevo-eventtypes:

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

Map Segment identify-traits naar Brevo-contactattributen:

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

API-endpoints

Codevoorbeelden

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

Events tracken via 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"
});

Server-side 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

Probleemoplossing

Best practices

1. Gebruik identify vóór track - Roep altijd identify aan vóór track om events aan de juiste gebruiker te koppelen
2. Implementeer een tracking plan - Gebruik Segment Protocols om event-schema’s af te dwingen
3. Batch server-side calls - Gebruik de batch-API voor server-side integraties om HTTP-overhead te beperken
4. Map traits expliciet - Definieer trait-naar-attribuut-mappings in plaats van te vertrouwen op defaults
5. Gebruik Segment Functions - Transformeer events in-flight voordat ze Brevo bereiken
6. Monitor event-delivery - Controleer Segment’s Event Delivery dashboard op gefaalde events
7. Stel Replay in - Schakel Segment Replay in voor het herverwerken van historische events

Beveiliging

• TLS-encryptie - Alle data wordt verzonden via HTTPS/TLS 1.2+
• Write Key-isolatie - Elke source heeft zijn eigen Write Key
• GDPR-compliance - Segment ondersteunt verwijderings- en suppressieverzoeken
• SOC 2 Type II - Segment is SOC 2 Type II-gecertificeerd
• Regionale datahosting - EU-workspace-optie voor compliance met data residency

Gerelateerde bronnen

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