Σύνδεσμος 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 πριν τον συγχρονισμό
Προαπαιτούμενα
Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:
- Χώρο εργασίας Twilio Segment με ρυθμισμένη πηγή
- Κλειδί Write Key Segment για την πηγή
- Λογαριασμό Brevo με πρόσβαση API
- Λογαριασμό Tajo με διαπιστευτήρια API
Πιστοποίηση
Κλειδί Write Key Segment
Το Segment πιστοποιεί πηγές χρησιμοποιώντας Write Key, που είναι ένα μοναδικό αναγνωριστικό συνδεδεμένο με κάθε πηγή.
// Analytics.js initialization with Write Keyanalytics.load("YOUR_SEGMENT_WRITE_KEY");Token API Tajo
Ρυθμίστε τον σύνδεσμο Tajo με τα διαπιστευτήριά σας:
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: LTVEndpoints 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 sourceawait tajo.connectors.connect('segment', { writeKey: process.env.SEGMENT_WRITE_KEY, workspaceSlug: 'your-workspace'});Παρακολούθηση Εκδηλώσεων μέσω Segment
// Identify a user - syncs to Brevo contactsanalytics.identify("user_123", { firstName: "Jane", lastName: "Kim", plan: "premium", lifetimeValue: 450.00});
// Track an event - forwards to Brevoanalytics.track("Order Completed", { orderId: "ORD-1234", revenue: 89.99, currency: "USD", products: [ { id: "SKU-001", name: "Widget", price: 89.99 } ]});
// Page view trackinganalytics.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 databaseconst 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 queueawait analytics.flush();Όρια Ρυθμού
| Επίπεδο | Όριο | Παράθυρο |
|---|---|---|
| Free | 1.000 εκδηλώσεις/δευτ. | Ανά πηγή |
| Team | 10.000 εκδηλώσεις/δευτ. | Ανά πηγή |
| Business | Προσαρμοσμένο | Ανά χώρο εργασίας |
| Batch API | Μέγ. 500 KB | Ανά αίτημα |
| Μέγ. μέγεθος batch | 100 εκδηλώσεις | Ανά κλήση batch |
Όρια Μεγέθους Batch
Κάθε αίτημα batch μπορεί να περιέχει μέγιστο 100 εκδηλώσεις και δεν πρέπει να υπερβαίνει τα 500 KB. Για μεγάλες ιστορικές εισαγωγές, χρησιμοποιήστε το Segment Bulk Import API.
Αντιμετώπιση Προβλημάτων
| Πρόβλημα | Αιτία | Λύση |
|---|---|---|
| Οι εκδηλώσεις δεν εμφανίζονται στο Brevo | Ο προορισμός δεν είναι ενεργοποιημένος | Ενεργοποιήστε τον προορισμό Tajo στο Segment |
| Τα χαρακτηριστικά χρήστη δεν συγχρονίζονται | Λείπει το αναγνωριστικό email | Βεβαιωθείτε ότι το χαρακτηριστικό email περιλαμβάνεται στις κλήσεις identify |
| Διπλές επαφές | Πολλαπλά ανώνυμα IDs | Εφαρμόστε σωστές κλήσεις alias για συγχώνευση ταυτότητας |
| Καθυστέρηση εκδηλώσεων | Ουρά υψηλού όγκου | Ελέγξτε το dashboard παράδοσης εκδηλώσεων Segment |
| Παραβιάσεις σχήματος | Απρογραμμάτιστες εκδηλώσεις | Ελέγξτε το σχέδιο παρακολούθησης Segment Protocols |
| Σφάλματα ορίου ρυθμού 429 | Υπερβολικά πολλά αιτήματα | Εφαρμόστε batching ή μειώστε τη συχνότητα εκδηλώσεων |
Βέλτιστες Πρακτικές
- Χρησιμοποιήστε identify πριν το track - Καλείτε πάντα
identifyπριν τοtrackγια σωστή απόδοση εκδηλώσεων στον χρήστη - Εφαρμόστε σχέδιο παρακολούθησης - Χρησιμοποιήστε Segment Protocols για επιβολή σχημάτων εκδηλώσεων
- Ομαδοποιήστε κλήσεις πλευράς server - Χρησιμοποιήστε το batch API για ενσωματώσεις πλευράς server για μείωση overhead HTTP
- Αντιστοιχίστε χαρακτηριστικά ρητά - Ορίστε αντιστοιχίσεις χαρακτηριστικού-σε-χαρακτηριστικό αντί να βασίζεστε σε προεπιλογές
- Χρησιμοποιήστε Segment Functions - Μετασχηματίστε εκδηλώσεις κατά τη μεταφορά πριν φτάσουν στο Brevo
- Παρακολουθήστε παράδοση εκδηλώσεων - Ελέγξτε το dashboard Event Delivery Segment για αποτυχημένες εκδηλώσεις
- Ρυθμίστε Replay - Ενεργοποιήστε Segment Replay για επανεπεξεργασία ιστορικών εκδηλώσεων
Ασφάλεια
- Κρυπτογράφηση TLS - Όλα τα δεδομένα μεταδίδονται μέσω HTTPS/TLS 1.2+
- Απομόνωση Write Key - Κάθε πηγή έχει δικό της Write Key
- Συμμόρφωση GDPR - Το Segment υποστηρίζει αιτήματα διαγραφής και καταστολής δεδομένων
- SOC 2 Type II - Το Segment είναι πιστοποιημένο SOC 2 Type II
- Περιφερειακή φιλοξενία δεδομένων - Επιλογή χώρου εργασίας EU για συμμόρφωση κατοικίας δεδομένων