Σύνδεσμος Twilio Segment

Συνδέστε το Twilio Segment με το Brevo μέσω Tajo για ενοποίηση του pipeline δεδομένων πελατών, δρομολόγηση εκδηλώσεων από οποιαδήποτε πηγή στο Brevo και αξιοποίηση της ανάλυσης ταυτότητας Segment για πλουσιότερη αυτοματοποίηση marketing.

Επισκόπηση

ΙδιότηταΤιμή
ΠλατφόρμαTwilio Segment
ΚατηγορίαΠλατφόρμα Δεδομένων (Προσαρμοσμένο)
Πολυπλοκότητα ΡύθμισηςΜεσαία
Επίσημη ΕνσωμάτωσηΌχι
Δεδομένα που ΣυγχρονίζονταιΕκδηλώσεις, Πελάτες, Χαρακτηριστικά, Κοινά
Διαθέσιμες Δεξιότητες8

Χαρακτηριστικά

  • Καθολική συλλογή δεδομένων - Συλλογή εκδηλώσεων από ιστότοπους, εφαρμογές mobile και servers μέσω SDK Segment
  • Δρομολόγηση πηγής - Δρομολόγηση δεδομένων από 400+ πηγές στο Brevo μέσω Tajo
  • Ανάλυση ταυτότητας - Αυτόματη συγχώνευση ανώνυμων και γνωστών προφίλ χρηστών
  • Συγχρονισμός κοινού - Αποστολή υπολογισμένων χαρακτηριστικών και κοινών Segment σε λίστες Brevo
  • Ροή εκδηλώσεων - Προώθηση εκδηλώσεων σε πραγματικό χρόνο μέσω του πλαισίου Connections του Segment
  • Reverse ETL - Συγχρονισμός δεδομένων αποθήκης πίσω στο Brevo χρησιμοποιώντας Segment Reverse ETL
  • Επιβολή σχήματος - Επικύρωση σχημάτων εκδηλώσεων με Segment Protocols πριν τον συγχρονισμό

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

  1. Χώρο εργασίας Twilio Segment με ρυθμισμένη πηγή
  2. Κλειδί Write Key Segment για την πηγή
  3. Λογαριασμό Brevo με πρόσβαση API
  4. Λογαριασμό Tajo με διαπιστευτήρια API

Πιστοποίηση

Κλειδί Write Key Segment

Το Segment πιστοποιεί πηγές χρησιμοποιώντας Write Key, που είναι ένα μοναδικό αναγνωριστικό συνδεδεμένο με κάθε πηγή.

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

Token API Tajo

Ρυθμίστε τον σύνδεσμο Tajo με τα διαπιστευτήριά σας:

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

Διαμόρφωση

Βασική Ρύθμιση

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

Αντιστοίχιση Εκδηλώσεων

Αντιστοίχηση εκδηλώσεων track Segment σε τύπους εκδηλώσεων 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"

Αντιστοίχιση Χαρακτηριστικών

Αντιστοίχηση χαρακτηριστικών identify Segment σε χαρακτηριστικά επαφών Brevo:

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

Endpoints API

ΜέθοδοςEndpointΠεριγραφή
POST/v1/identifyΑναγνώριση χρήστη με χαρακτηριστικά
POST/v1/trackΠαρακολούθηση εκδήλωσης
POST/v1/pageΚαταγραφή προβολής σελίδας
POST/v1/screenΚαταγραφή προβολής οθόνης
POST/v1/groupΣυσχέτιση χρήστη με ομάδα
POST/v1/aliasΣυγχώνευση δύο ταυτοτήτων χρήστη
POST/v1/batchΑποστολή πολλαπλών μηνυμάτων σε batch
POST/v1/importΜαζική εισαγωγή ιστορικών δεδομένων

Παραδείγματα Κώδικα

Αρχικοποίηση Segment με Προορισμό 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'
});

Παρακολούθηση Εκδηλώσεων μέσω Segment

// Identify a user - syncs to Brevo contacts
analytics.identify("user_123", {
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"
});

Προώθηση Εκδηλώσεων Πλευράς 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();

Όρια Ρυθμού

ΕπίπεδοΌριοΠαράθυρο
Free1.000 εκδηλώσεις/δευτ.Ανά πηγή
Team10.000 εκδηλώσεις/δευτ.Ανά πηγή
BusinessΠροσαρμοσμένοΑνά χώρο εργασίας
Batch APIΜέγ. 500 KBΑνά αίτημα
Μέγ. μέγεθος batch100 εκδηλώσειςΑνά κλήση batch

Όρια Μεγέθους Batch

Κάθε αίτημα batch μπορεί να περιέχει μέγιστο 100 εκδηλώσεις και δεν πρέπει να υπερβαίνει τα 500 KB. Για μεγάλες ιστορικές εισαγωγές, χρησιμοποιήστε το Segment Bulk Import API.

Αντιμετώπιση Προβλημάτων

ΠρόβλημαΑιτίαΛύση
Οι εκδηλώσεις δεν εμφανίζονται στο BrevoΟ προορισμός δεν είναι ενεργοποιημένοςΕνεργοποιήστε τον προορισμό Tajo στο Segment
Τα χαρακτηριστικά χρήστη δεν συγχρονίζονταιΛείπει το αναγνωριστικό emailΒεβαιωθείτε ότι το χαρακτηριστικό email περιλαμβάνεται στις κλήσεις identify
Διπλές επαφέςΠολλαπλά ανώνυμα IDsΕφαρμόστε σωστές κλήσεις alias για συγχώνευση ταυτότητας
Καθυστέρηση εκδηλώσεωνΟυρά υψηλού όγκουΕλέγξτε το dashboard παράδοσης εκδηλώσεων Segment
Παραβιάσεις σχήματοςΑπρογραμμάτιστες εκδηλώσειςΕλέγξτε το σχέδιο παρακολούθησης Segment Protocols
Σφάλματα ορίου ρυθμού 429Υπερβολικά πολλά αιτήματαΕφαρμόστε batching ή μειώστε τη συχνότητα εκδηλώσεων

Βέλτιστες Πρακτικές

  1. Χρησιμοποιήστε identify πριν το track - Καλείτε πάντα identify πριν το track για σωστή απόδοση εκδηλώσεων στον χρήστη
  2. Εφαρμόστε σχέδιο παρακολούθησης - Χρησιμοποιήστε Segment Protocols για επιβολή σχημάτων εκδηλώσεων
  3. Ομαδοποιήστε κλήσεις πλευράς server - Χρησιμοποιήστε το batch API για ενσωματώσεις πλευράς server για μείωση overhead HTTP
  4. Αντιστοιχίστε χαρακτηριστικά ρητά - Ορίστε αντιστοιχίσεις χαρακτηριστικού-σε-χαρακτηριστικό αντί να βασίζεστε σε προεπιλογές
  5. Χρησιμοποιήστε Segment Functions - Μετασχηματίστε εκδηλώσεις κατά τη μεταφορά πριν φτάσουν στο Brevo
  6. Παρακολουθήστε παράδοση εκδηλώσεων - Ελέγξτε το dashboard Event Delivery Segment για αποτυχημένες εκδηλώσεις
  7. Ρυθμίστε Replay - Ενεργοποιήστε Segment Replay για επανεπεξεργασία ιστορικών εκδηλώσεων

Ασφάλεια

  • Κρυπτογράφηση TLS - Όλα τα δεδομένα μεταδίδονται μέσω HTTPS/TLS 1.2+
  • Απομόνωση Write Key - Κάθε πηγή έχει δικό της Write Key
  • Συμμόρφωση GDPR - Το Segment υποστηρίζει αιτήματα διαγραφής και καταστολής δεδομένων
  • SOC 2 Type II - Το Segment είναι πιστοποιημένο SOC 2 Type II
  • Περιφερειακή φιλοξενία δεδομένων - Επιλογή χώρου εργασίας EU για συμμόρφωση κατοικίας δεδομένων

Σχετικοί Πόροι

Subscribe to updates

developer-docs

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

auto-detect
AI Βοηθός

Γεια! Ρωτήστε με οτιδήποτε για την τεκμηρίωση.