Twilio Segment Connector

Forbind Twilio Segment til Brevo via Tajo for at forene din kundedatapipeline, rute hændelser fra enhver kilde til Brevo og udnytte Segments identitetsopløsning til rigere marketingautomatisering.

Oversigt

Funktioner

• Universel dataindsamling - Indsaml hændelser fra websites, mobilapps og servere via Segment-SDK’er
• Kilde-rutning - Rut data fra over 400 kilder ind i Brevo via Tajo
• Identitetsopløsning - Flet anonyme og kendte brugerprofiler sammen automatisk
• Målgruppe-synkronisering - Send beregnede Segment-træk og målgrupper til Brevo-lister
• Hændelsesstreaming - Realtidsvideresendelse af hændelser via Segments Connections-framework
• Reverse ETL - Synkronisér data fra dit warehouse tilbage til Brevo med Segment Reverse ETL
• Skemahåndhævelse - Validér hændelsesskemaer med Segment Protocols før synkronisering

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

1. Et Twilio Segment-workspace med en konfigureret kilde
2. Din Segment Write Key for kilden
3. En Brevo-konto med API-adgang
4. En Tajo-konto med API-legitimationsoplysninger

Autentifikation

Segment Write Key

Segment autentificerer kilder via en Write Key, som er en unik identifikator knyttet til hver kilde.

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

Tajo API-token

Konfigurér Tajo-konnektoren med dine legitimationsoplysninger:

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

Konfiguration

Grundlæggende opsætning

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

Hændelsesmapping

Knyt Segment track-hændelser til Brevo-hændelsestyper:

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"

Trækmapping

Knyt Segment identify-træk til Brevo-kontaktattributter:

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

API-endpoints

Kodeeksempler

Initialisér Segment med 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'
});

Spor hændelser 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"
});

Serverside-videresendelse af hændelser (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();

Ratebegrænsninger

Fejlfinding

Best practices

1. Brug identify før track - Kald altid identify før track for at sikre, at hændelser tilskrives den korrekte bruger
2. Implementér en tracking-plan - Brug Segment Protocols til at håndhæve hændelsesskemaer
3. Batch serverside-kald - Brug batch-API’et til serverside-integrationer for at reducere HTTP-overhead
4. Map træk eksplicit - Definér træk-til-attribut-mappings i stedet for at stole på standardværdier
5. Brug Segment Functions - Transformér hændelser i transit, før de når Brevo
6. Overvåg hændelseslevering - Tjek Segments Event Delivery-dashboard for mislykkede hændelser
7. Opsæt Replay - Aktivér Segment Replay til genbehandling af historiske hændelser

Sikkerhed

• TLS-kryptering - Alle data transmitteres over HTTPS/TLS 1.2+
• Write Key-isolering - Hver kilde har sin egen Write Key
• GDPR-overholdelse - Segment understøtter dataslettelse og suppression-anmodninger
• SOC 2 Type II - Segment er SOC 2 Type II-certificeret
• Regional datahosting - EU-workspace-mulighed for overholdelse af datarezidens

Relaterede ressourcer

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