Twilio Segment konnektor

Csatlakoztasd a Twilio Segmentet a Brevóhoz a Tajo segítségével, hogy egységesítsd az ügyfél-adat pipeline-t, bármely forrásból irányítsd az eseményeket a Brevóba, és használd ki a Segment identitásfeloldását a gazdagabb marketingautomatizáláshoz.

Áttekintés

Funkciók

• Univerzális adatgyűjtés – Eseménygyűjtés webhelyekről, mobilalkalmazásokból és szerverekről Segment SDK-kon keresztül
• Forrás irányítás – 400+ forrásból érkező adatok irányítása a Brevóba a Tajo segítségével
• Identitásfeloldás – Anonim és ismert felhasználói profilok automatikus összevonása
• Közönség-szinkronizáció – Segment számított tulajdonságok és közönségek küldése Brevo listákra
• Esemény-streaming – Valós idejű esemény-továbbítás a Segment Connections keretrendszerén keresztül
• Fordított ETL – Tárházadatok visszaszinkronizálása a Brevóba Segment Reverse ETL segítségével
• Séma-érvényesítés – Esemény-sémák validálása a Segment Protocols segítségével szinkronizálás előtt

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Twilio Segment munkaterülettel konfigurált forrással
2. A forrás Segment Write Key-jével
3. Egy Brevo fiókkal API-hozzáféréssel
4. Egy Tajo fiókkal API hitelesítő adatokkal

Hitelesítés

Segment Write Key

A Segment a forrásokat Write Key segítségével hitelesíti, amely minden forráshoz egyedi azonosító.

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

Tajo API Token

Konfiguráld a Tajo konnektort a hitelesítő adataiddal:

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

Konfiguráció

Alapbeállítás

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

Esemény-leképezés

Képezd le a Segment track eseményeket Brevo esemény típusokhoz:

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"

Tulajdonság-leképezés

Képezd le a Segment identify tulajdonságokat Brevo kapcsolat-attribútumokhoz:

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

API végpontok

Kódpéldák

Segment inicializálása Tajo céllomással

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

Események követése Segment segítségével

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

Szerver oldali esemény-továbbítás (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();

Ráta-korlátok

Hibaelhárítás

Legjobb gyakorlatok

1. Az identify-t használd a track előtt – Mindig hívd meg az identify-t a track előtt, hogy az események a megfelelő felhasználóhoz legyenek rendelve
2. Implementálj követési tervet – Használd a Segment Protocols protokollt az esemény-sémák érvényesítéséhez
3. Kötegelj szerver oldali hívásokat – Szerver oldali integrációkhoz a batch API-t használd az HTTP terhelés csökkentéséhez
4. Képezd le explicit módon a tulajdonságokat – Definiálj tulajdonság-attribútum leképezéseket az alapértelmezettekre támaszkodás helyett
5. Használj Segment Functionst – Alakítsd át az eseményeket menet közben, mielőtt elérik a Brevót
6. Figyeld az esemény-kézbesítést – Ellenőrizd a Segment Event Delivery dashboardját a sikertelen eseményekhez
7. Állíts be Replay-t – Engedélyezd a Segment Replay-t a korábbi események újrafeldolgozásához

Biztonság

• TLS titkosítás – Minden adat HTTPS/TLS 1.2+-on keresztül kerül átvitelre
• Write Key izoláció – Minden forrásnak saját Write Key-je van
• GDPR megfelelőség – A Segment támogatja az adattörlési és elnyomási kérelmeket
• SOC 2 Type II – A Segment SOC 2 Type II tanúsítvánnyal rendelkezik
• Regionális adattárolás – EU munkaterület opció az adatrezidencia megfelelőséghez

Kapcsolódó források

• Amplitude konnektor
• Mixpanel konnektor
• Ügyfél-szinkronizáció Skill
• Brevo Events API