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

EgenskapVerdi
PlattformTwilio Segment
KategoriDataplattform (Custom)
OppsettskompleksitetModerat
Offisiell integrasjonNei
Synkroniserte dataHendelser, kunder, traits, målgrupper
Tilgjengelige ferdigheter8

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:

  1. Et Twilio Segment-arbeidsområde med en kilde konfigurert
  2. Din Segment Write Key for kilden
  3. En Brevo-konto med API-tilgang
  4. 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 Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");

Tajo API-token

Konfigurer Tajo-koblingen med påloggingsdetaljene dine:

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

Konfigurasjon

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: 7

Hendelsesmapping

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: LTV

API-endepunkter

MetodeEndepunktBeskrivelse
POST/v1/identifyIdentifiser en bruker med traits
POST/v1/trackSpor en hendelse
POST/v1/pageRegistrer en sidevisning
POST/v1/screenRegistrer en skjermvisning
POST/v1/groupKnytt en bruker til en gruppe
POST/v1/aliasSlå sammen to brukeridentiteter
POST/v1/batchSend flere meldinger i en batch
POST/v1/importBulkimport 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-kilde
await tajo.connectors.connect('segment', {
writeKey: process.env.SEGMENT_WRITE_KEY,
workspaceSlug: 'your-workspace'
});

Spor hendelser via Segment

// Identifiser en bruker - synkroniseres til Brevo-kontakter
analytics.identify("user_123", {
firstName: "Jane",
lastName: "Kim",
plan: "premium",
lifetimeValue: 450.00
});
// Spor en hendelse - videresendes til Brevo
analytics.track("Order Completed", {
orderId: "ORD-1234",
revenue: 89.99,
currency: "USD",
products: [
{ id: "SKU-001", name: "Widget", price: 89.99 }
]
});
// Sporing av sidevisning
analytics.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 din
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
}
});
}
// Tøm køen
await analytics.flush();

Ratebegrensninger

NivåGrenseVindu
Free1 000 hendelser/sekPer kilde
Team10 000 hendelser/sekPer kilde
BusinessTilpassetPer arbeidsområde
Batch APIMaks 500 KBPer forespørsel
Maks batchstørrelse100 hendelserPer 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ÅrsakLøsning
Hendelser vises ikke i BrevoDestinasjon ikke aktivertAktiver Tajo-destinasjonen i Segment
Brukerattributter synkroniseres ikkeMangler e-postidentifikatorSørg for at email-trait er inkludert i identify-kall
DuplikatkontakterFlere anonyme ID-erImplementer riktige alias-kall for identitetssammenslåing
Forsinkede hendelserStor køSjekk Segments hendelsesleveransedashbord
SkjemabruddUplanlagte hendelserGjennomgå Segment Protocols-sporingsplan
429 ratebegrensningsfeilFor mange forespørslerImplementer batching eller reduser hendelsesfrekvens

Beste praksis

  1. Bruk identify før track - Kall alltid identify før track for å sikre at hendelser tilskrives riktig bruker
  2. Implementer en sporingsplan - Bruk Segment Protocols for å håndheve hendelsesskjemaer
  3. Batch tjenerside-kall - Bruk batch-API for tjensersideintegrasjoner for å redusere HTTP-overhead
  4. Mapp traits eksplisitt - Definer trait-til-attributt-mappinger i stedet for å stole på standarder
  5. Bruk Segment Functions - Transformer hendelser underveis før de når Brevo
  6. Overvåk hendelseslevering - Sjekk Segments Event Delivery-dashbord for mislykkede hendelser
  7. 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

Relaterte ressurser

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AI-assistent

Hei! Spør meg om dokumentasjonen.