Twilio Segment-kobling
Koble Twilio Segment til Brevo gjennom Tajo for å forene kundedatapipelinen din, rute hendelser fra enhver kilde til Brevo og utnytte Segments identitetsoppløsning for rikere markedsføringsautomatisering.
Oversikt
| Egenskap | Verdi |
|---|---|
| Plattform | Twilio Segment |
| Kategori | Dataplattform (Custom) |
| Oppsettskompleksitet | Moderat |
| Offisiell integrasjon | Nei |
| Synkroniserte data | Hendelser, kunder, traits, målgrupper |
| Tilgjengelige ferdigheter | 8 |
Funksjoner
- Universell datainnsamling - Samle hendelser fra nettsteder, mobilapper og tjenere via Segment-SDK-er
- Kilderuting - Rut data fra 400+ kilder til Brevo gjennom Tajo
- Identitetsoppløsning - Slå sammen anonyme og kjente brukerprofiler automatisk
- Målgruppesynkronisering - Send Segments beregnede traits og målgrupper til Brevo-lister
- Hendelsesstrømming - Videresending av hendelser i sanntid via Segments Connections-rammeverk
- Reverse ETL - Synkroniser lagerdata tilbake til Brevo ved hjelp av Segment Reverse ETL
- Skjemahåndheving - Valider hendelsesskjemaer med Segment Protocols før synkronisering
Forutsetninger
Før du begynner, sørg for at du har:
- Et Twilio Segment-arbeidsområde med en kilde konfigurert
- Din Segment Write Key for kilden
- En Brevo-konto med API-tilgang
- En Tajo-konto med API-påloggingsdetaljer
Autentisering
Segment Write Key
Segment autentiserer kilder ved hjelp av en Write Key, som er en unik identifikator knyttet til hver kilde.
// Analytics.js-initialisering med Write Keyanalytics.load("YOUR_SEGMENT_WRITE_KEY");Tajo API-token
Konfigurer Tajo-koblingen med påloggingsdetaljene dine:
tajo connectors install segment \ --write-key $SEGMENT_WRITE_KEY \ --workspace-slug your-workspace \ --brevo-api-key $BREVO_API_KEYKonfigurasjon
Grunnleggende oppsett
connectors: segment: enabled: true write_key: "your-segment-write-key" data_region: "us" # eller "eu" for EU-arbeidsområde
# Synkroniseringsalternativer sync: identify: true track: true page: true group: false
# Tildeling av Brevo-lister lists: all_contacts: 5 active_users: 6 high_value: 7Hendelsesmapping
Mapp Segment-track-hendelser til Brevo-hendelsestyper:
event_mapping: # Segment-hendelse -> Brevo-hendelse "Order Completed": "order_completed" "Product Viewed": "product_viewed" "Cart Updated": "cart_updated" "Signed Up": "customer_created" "Checkout Started": "checkout_started"
# Egendefinerte hendelser "Feature Used": "feature_used" "Plan Upgraded": "plan_upgraded"Trait-mapping
Mapp Segment identify-traits til Brevo-kontaktattributter:
trait_mapping: email: email firstName: FIRSTNAME lastName: LASTNAME phone: SMS plan: PLAN_TYPE company: COMPANY createdAt: SIGNUP_DATE lifetimeValue: LTVAPI-endepunkter
| Metode | Endepunkt | Beskrivelse |
|---|---|---|
POST | /v1/identify | Identifiser en bruker med traits |
POST | /v1/track | Spor en hendelse |
POST | /v1/page | Registrer en sidevisning |
POST | /v1/screen | Registrer en skjermvisning |
POST | /v1/group | Knytt en bruker til en gruppe |
POST | /v1/alias | Slå sammen to brukeridentiteter |
POST | /v1/batch | Send flere meldinger i en batch |
POST | /v1/import | Bulkimport av historiske data |
Kodeeksempler
Initialiser Segment med Tajo-destinasjon
import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY});
// Koble til Segment-kildeawait tajo.connectors.connect('segment', { writeKey: process.env.SEGMENT_WRITE_KEY, workspaceSlug: 'your-workspace'});Spor hendelser via Segment
// Identifiser en bruker - synkroniseres til Brevo-kontakteranalytics.identify("user_123", { firstName: "Jane", lastName: "Kim", plan: "premium", lifetimeValue: 450.00});
// Spor en hendelse - videresendes til Brevoanalytics.track("Order Completed", { orderId: "ORD-1234", revenue: 89.99, currency: "USD", products: [ { id: "SKU-001", name: "Widget", price: 89.99 } ]});
// Sporing av sidevisninganalytics.page("Pricing", { title: "Pricing - Tajo", url: "https://tajo.io/pricing"});Hendelsesvideresending på tjenersiden (Node.js)
const Analytics = require('analytics-node');const analytics = new Analytics(process.env.SEGMENT_WRITE_KEY);
// Batch-identifiser brukere fra databasen dinconst 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 } });}
// Tøm køenawait analytics.flush();Ratebegrensninger
| Nivå | Grense | Vindu |
|---|---|---|
| Free | 1 000 hendelser/sek | Per kilde |
| Team | 10 000 hendelser/sek | Per kilde |
| Business | Tilpasset | Per arbeidsområde |
| Batch API | Maks 500 KB | Per forespørsel |
| Maks batchstørrelse | 100 hendelser | Per batch-kall |
Grenser for batchstørrelse
Hver batch-forespørsel kan inneholde maksimalt 100 hendelser og må ikke overstige 500 KB. For store historiske imports, bruk Segment Bulk Import API.
Feilsøking
| Problem | Årsak | Løsning |
|---|---|---|
| Hendelser vises ikke i Brevo | Destinasjon ikke aktivert | Aktiver Tajo-destinasjonen i Segment |
| Brukerattributter synkroniseres ikke | Mangler e-postidentifikator | Sørg for at email-trait er inkludert i identify-kall |
| Duplikatkontakter | Flere anonyme ID-er | Implementer riktige alias-kall for identitetssammenslåing |
| Forsinkede hendelser | Stor kø | Sjekk Segments hendelsesleveransedashbord |
| Skjemabrudd | Uplanlagte hendelser | Gjennomgå Segment Protocols-sporingsplan |
| 429 ratebegrensningsfeil | For mange forespørsler | Implementer batching eller reduser hendelsesfrekvens |
Beste praksis
- Bruk identify før track - Kall alltid
identifyførtrackfor å sikre at hendelser tilskrives riktig bruker - Implementer en sporingsplan - Bruk Segment Protocols for å håndheve hendelsesskjemaer
- Batch tjenerside-kall - Bruk batch-API for tjensersideintegrasjoner for å redusere HTTP-overhead
- Mapp traits eksplisitt - Definer trait-til-attributt-mappinger i stedet for å stole på standarder
- Bruk Segment Functions - Transformer hendelser underveis før de når Brevo
- Overvåk hendelseslevering - Sjekk Segments Event Delivery-dashbord for mislykkede hendelser
- Sett opp Replay - Aktiver Segment Replay for å reprosessere historiske hendelser
Sikkerhet
- TLS-kryptering - Alle data overføres over HTTPS/TLS 1.2+
- Write Key-isolasjon - Hver kilde har sin egen Write Key
- GDPR-samsvar - Segment støtter forespørsler om datasletting og undertrykking
- SOC 2 Type II - Segment er SOC 2 Type II-sertifisert
- Regional datavert - EU-arbeidsområdealternativ for databotilholdssamsvar