Twilio Segment konektor

Poveži Twilio Segment sa Brevo putem Tajo za unifikaciju pipelina korisničkih podataka, rutiranje događaja iz bilo kog izvora u Brevo i korišćenje Segment resolucije identiteta za bogatiju marketing automatizaciju.

Pregled

Karakteristike

• Univerzalno prikupljanje podataka - Prikupljanje događaja sa veb sajtova, mobilnih aplikacija i servera putem Segment SDK-ova
• Rutiranje izvora - Rutiranje podataka iz 400+ izvora u Brevo putem Tajo
• Resolucija identiteta - Automatsko spajanje anonimnih i poznatih korisničkih profila
• Sinhronizacija publike - Slanje Segment izračunatih osobina i publike na Brevo liste
• Striming događaja - Prosleđivanje događaja u realnom vremenu putem Segment Connections okvira
• Reverse ETL - Sinhronizacija podataka iz warehouse-a nazad u Brevo koristeći Segment Reverse ETL
• Primena šeme - Validacija šema događaja sa Segment Protocols pre sinhronizacije

Preduslovi

Pre nego što započneš, proveri da imaš:

1. Twilio Segment radni prostor sa konfigurisanim izvorom
2. Segment Write Key za izvor
3. Brevo nalog sa API pristupom
4. Tajo nalog sa API kredencijalima

Autentifikacija

Segment Write Key

Segment autentifikuje izvore koristeći Write Key, koji je jedinstveni identifikator vezan za svaki izvor.

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

Tajo API Token

Konfiguriši Tajo konektor sa tvojim akreditivima:

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

Konfiguracija

Osnovno podešavanje

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

Mapiranje događaja

Mapiranje Segment track događaja na Brevo tipove događaja:

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"

Mapiranje osobina

Mapiranje Segment identify osobina na Brevo atribute kontakta:

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

API endpointi

Primeri koda

Inicijalizacija Segment-a sa Tajo destinacijom

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

Praćenje događaja putem Segment-a

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

Prosleđivanje događaja na server strani (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();

Ograničenja brzine

Rešavanje problema

Najbolje prakse

1. Koristi identify pre track - Uvek pozovi identify pre track da osiguraš da su događaji pripisani ispravnom korisniku
2. Implementiraj plan praćenja - Koristi Segment Protocols za primenu šema događaja
3. Grupiši server-side pozive - Koristi batch API za server-side integracije da smanjiš HTTP opterećenje
4. Eksplicitno mapiraj osobine - Definiši mapiranja osobina na atribute umesto oslanjanja na podrazumevana
5. Koristi Segment Functions - Transformiši događaje u letu pre nego što stignu u Brevo
6. Prati isporuku događaja - Proveri Segment Event Delivery dashboard za neuspele događaje
7. Postavi Replay - Omogući Segment Replay za ponovnu obradu istorijskih događaja

Bezbednost

• TLS enkripcija - Svi podaci preneti putem HTTPS/TLS 1.2+
• Izolacija Write Key-a - Svaki izvor ima sopstveni Write Key
• GDPR usklađenost - Segment podržava zahteve za brisanje i potiskivanje podataka
• SOC 2 Type II - Segment je SOC 2 Type II sertifikovan
• Regionalni hosting podataka - Opcija EU radnog prostora za usklađenost sa rezidencijom podataka

Povezani resursi

• Amplitude konektor
• Mixpanel konektor
• Customer Sync veština
• Brevo Events API