Conector Twilio Segment

Conectați Twilio Segment la Brevo prin Tajo pentru a unifica pipeline-ul de date al clienților, a ruta evenimentele din orice sursă la Brevo și a valorifica rezoluția identității Segment pentru automatizare de marketing mai bogată.

Prezentare generală

Funcționalități

• Colectare universală de date - Colectați evenimente de pe site-uri web, aplicații mobile și servere prin SDK-urile Segment
• Rutare surse - Rutați date din 400+ surse în Brevo prin Tajo
• Rezoluție identitate - Combinați automat profilurile utilizatorilor anonimi și cunoscuți
• Sincronizare audiențe - Trimiteți trăsăturile și audiențele calculate Segment la listele Brevo
• Streaming evenimente - Redirecționare evenimente în timp real prin framework-ul Connections al Segment
• Reverse ETL - Sincronizați datele din depozit înapoi la Brevo folosind Segment Reverse ETL
• Aplicare schemă - Validați schemele de evenimente cu Segment Protocols înainte de sincronizare

Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un spațiu de lucru Twilio Segment cu o sursă configurată
2. Cheia de scriere Segment pentru sursă
3. Un cont Brevo cu acces API
4. Un cont Tajo cu credențiale API

Autentificare

Cheie de scriere Segment

Segment autentifică sursele folosind o Cheie de scriere, care este un identificator unic legat de fiecare sursă.

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

Token API Tajo

Configurați conectorul Tajo cu credențialele dvs.:

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

Configurare

Configurare de bază

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

Mapare evenimente

Mapați evenimentele de urmărire Segment la tipurile de evenimente Brevo:

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"

Mapare trăsături

Mapați trăsăturile de identificare Segment la atributele de contact Brevo:

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

Puncte finale API

Exemple de cod

Inițializare Segment cu destinație Tajo

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

Urmărire evenimente prin 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"
});

Redirecționare evenimente pe server (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();

Limite de rată

Depanare

Bune practici

1. Utilizați identify înainte de track - Apelați întotdeauna identify înainte de track pentru a asigura atribuirea corectă a evenimentelor
2. Implementați un plan de urmărire - Utilizați Segment Protocols pentru a impune scheme de evenimente
3. Grupați apelurile pe server - Utilizați batch API pentru integrări pe server pentru a reduce sarcina HTTP
4. Mapați trăsăturile explicit - Definiți mapările trăsătură-la-atribut în loc să vă bazați pe valorile implicite
5. Utilizați Segment Functions - Transformați evenimentele în tranzit înainte să ajungă la Brevo
6. Monitorizați livrarea evenimentelor - Verificați tabloul de bord Event Delivery al Segment pentru evenimentele eșuate
7. Configurați Replay - Activați Segment Replay pentru reprocesarea evenimentelor istorice

Securitate

• Criptare TLS - Toate datele transmise prin HTTPS/TLS 1.2+
• Izolare cheie de scriere - Fiecare sursă are propria sa Cheie de scriere
• Conformitate GDPR - Segment suportă cereri de ștergere și suprimare a datelor
• SOC 2 Tip II - Segment este certificat SOC 2 Tip II
• Găzduire regională date - Opțiune spațiu de lucru EU pentru conformitate rezidență date

Resurse conexe

• Conector Amplitude
• Conector Mixpanel
• Skill Sincronizare clienți
• API Evenimente Brevo