Connecteur Twilio Segment

Connectez Twilio Segment à Brevo via Tajo pour unifier votre pipeline de données clients, router les événements depuis n’importe quelle source vers Brevo et exploiter la résolution d’identité de Segment pour une automatisation marketing plus riche.

Vue d’ensemble

Fonctionnalités

• Collecte universelle de données, Collectez les événements depuis sites web, apps mobiles et serveurs via les SDK Segment
• Routage de sources, Routez les données depuis 400+ sources vers Brevo via Tajo
• Résolution d’identité, Fusionnez automatiquement les profils utilisateurs anonymes et connus
• Synchronisation d’audiences, Envoyez les traits et audiences calculés par Segment vers les listes Brevo
• Streaming d’événements, Transfert d’événements en temps réel via le framework Connections de Segment
• Reverse ETL, Synchronisez les données d’entrepôt vers Brevo via Segment Reverse ETL
• Application de schéma, Validez les schémas d’événements avec Segment Protocols avant synchronisation

Prérequis

Avant de commencer, assurez-vous de disposer de :

1. Un workspace Twilio Segment avec une source configurée
2. Votre Write Key Segment pour la source
3. Un compte Brevo avec accès API
4. Un compte Tajo avec identifiants API

Authentification

Segment Write Key

Segment authentifie les sources à l’aide d’un Write Key, un identifiant unique lié à chaque source.

// Initialisation d'Analytics.js avec le Write Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");

Token API Tajo

Configurez le connecteur Tajo avec vos identifiants :

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

Configuration

Configuration de base

connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # ou "eu" pour un workspace UE

    # Options de synchronisation des données
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Attribution de listes Brevo
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7

Mappage des événements

Mappez les événements track Segment vers des types d’événements Brevo :

event_mapping:
  # Événement Segment -> Événement Brevo
  "Order Completed": "order_completed"
  "Product Viewed": "product_viewed"
  "Cart Updated": "cart_updated"
  "Signed Up": "customer_created"
  "Checkout Started": "checkout_started"

  # Événements personnalisés
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"

Mappage des traits

Mappez les traits identify Segment vers les attributs de contact Brevo :

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

Endpoints API

Exemples de code

Initialiser Segment avec une destination Tajo

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connecter la source Segment
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});

Tracker des événements via Segment

// Identifier un utilisateur, synchronise vers les contacts Brevo
analytics.identify("user_123", {
  email: "[email protected]",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Tracker un événement, transféré vers Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Tracking de vue de page
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});

Transfert d’événements côté serveur (Node.js)

const Analytics = require('analytics-node');
const analytics = new Analytics(process.env.SEGMENT_WRITE_KEY);

// Identify en lot des utilisateurs depuis votre base de données
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
    }
  });
}

// Vider la file d'attente
await analytics.flush();

Limites de débit

Dépannage

Bonnes pratiques

1. Identify avant track, Appelez toujours identify avant track pour garantir que les événements sont attribués au bon utilisateur
2. Implémentez un tracking plan, Utilisez Segment Protocols pour faire respecter les schémas d’événements
3. Groupez les appels côté serveur, Utilisez l’API batch pour les intégrations serveur afin de réduire le surcoût HTTP
4. Mappez les traits explicitement, Définissez les mappages trait-vers-attribut plutôt que de vous fier aux valeurs par défaut
5. Utilisez Segment Functions, Transformez les événements en vol avant qu’ils n’atteignent Brevo
6. Surveillez la livraison d’événements, Consultez le tableau de bord Event Delivery de Segment pour les événements échoués
7. Configurez Replay, Activez Segment Replay pour re-traiter les événements historiques

Sécurité

• Chiffrement TLS, Toutes les données transmises via HTTPS/TLS 1.2+
• Isolation des Write Keys, Chaque source a son propre Write Key
• Conformité RGPD, Segment prend en charge les demandes de suppression et de suppression de données
• SOC 2 Type II, Segment est certifié SOC 2 Type II
• Hébergement régional des données, Option de workspace UE pour la conformité de résidence des données

Ressources associées

• Connecteur Amplitude
• Connecteur Mixpanel
• Skill de synchronisation client
• API Events Brevo