Σύνδεσμος Customer.io

Συνδέστε την πλατφόρμα μηνυμάτων Customer.io με το Brevo για ενοποιημένα δεδομένα πελατών, συντονισμό καμπανιών διαπλατφόρμων και ενοποιημένα αναλυτικά αφοσίωσης.

Επισκόπηση

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

• Συγχρονισμός ατόμων - Αμφίδρομος συγχρονισμός προφίλ πελατών με επαφές Brevo
• Προώθηση εκδηλώσεων - Παρακολούθηση συμπεριφορικών εκδηλώσεων και προώθηση στο Brevo για triggers αυτοματισμού
• Αναλυτικά καμπάνιας - Συγχρονισμός μετρικών απόδοσης καμπάνιας για ενοποιημένες αναφορές
• Δεδομένα ροής εργασίας - Αντικατοπτρισμός καταστάσεων ροής εργασίας Customer.io σε χαρακτηριστικά επαφών Brevo
• Αναπαραγωγή τμήματος - Αναπαραγωγή τμημάτων Customer.io ως λίστες Brevo
• Συγχρονισμός δεδομένων αντικειμένου - Συγχρονισμός μη-ανθρώπινων αντικειμένων και δεδομένων σχέσεων

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

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

1. Λογαριασμό Customer.io με ενεργοποιημένη πρόσβαση API
2. Το Site ID και το Track API Key σας (βρίσκονται στις Ρυθμίσεις > API Credentials)
3. Κλειδί App API για ανάγνωση δεδομένων καμπάνιας και τμήματος
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με ενεργή συνδρομή

Πιστοποίηση

Το Customer.io χρησιμοποιεί δύο ξεχωριστά APIs με διαφορετικές μεθόδους πιστοποίησης:

Track API (Συμπεριφορικά Δεδομένα)

Χρησιμοποιείται για αποστολή ατόμων, εκδηλώσεων και δεδομένων συσκευής. Πιστοποίηση με Site ID και API Key μέσω Basic Auth.

# Basic Auth: Site ID ως username, API Key ως password
curl -X POST https://track.customer.io/api/v1/customers/user123 \
  -u "$SITE_ID:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

App API (Ανάγνωση Δεδομένων)

Χρησιμοποιείται για ανάκτηση καμπανιών, τμημάτων και δεδομένων πελατών. Πιστοποίηση με Bearer token.

curl -X GET https://api.customer.io/v1/campaigns \
  -H "Authorization: Bearer $APP_API_KEY"

Σύνδεση στο Tajo

tajo connectors install customerio \
  --site-id $CIO_SITE_ID \
  --track-api-key $CIO_TRACK_API_KEY \
  --app-api-key $CIO_APP_API_KEY

Διαμόρφωση

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

connectors:
  customerio:
    enabled: true
    region: "us"  # or "eu" for EU data center

    sync:
      people: true
      events: true
      campaigns: true
      segments: true
      objects: false

    lists:
      all_contacts: 12
      active_subscribers: 13
      churned: 14

Αντιστοίχιση Πεδίων

Αντιστοίχηση χαρακτηριστικών ατόμου Customer.io σε χαρακτηριστικά επαφών Brevo:

field_mapping:
  # Standard fields
  id: CIO_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  created_at: SIGNUP_DATE
  last_activity: LAST_ACTIVE
  plan: PLAN_NAME

  # Custom attributes
  company: COMPANY
  role: JOB_TITLE
  mrr: MONTHLY_REVENUE
  lifecycle_stage: LIFECYCLE_STAGE

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

event_mapping:
  # Customer.io event -> Brevo event
  purchase_completed: ORDER_PLACED
  subscription_started: SUBSCRIPTION_START
  feature_activated: FEATURE_USED
  support_ticket_opened: SUPPORT_REQUEST

Endpoints API

Το Tajo ενσωματώνεται με τα ακόλουθα endpoints API του Customer.io:

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

Αρχικοποίηση Συνδέσμου

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

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

await tajo.connectors.connect('customerio', {
  siteId: process.env.CIO_SITE_ID,
  trackApiKey: process.env.CIO_TRACK_API_KEY,
  appApiKey: process.env.CIO_APP_API_KEY,
  region: 'us'
});

Συγχρονισμός Ατόμων στο Brevo

// Incremental sync of Customer.io people
await tajo.connectors.sync('customerio', {
  type: 'incremental',
  resources: ['people'],
  since: '2024-01-01',
  batchSize: 100
});

const status = await tajo.connectors.status('customerio');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T14:20:00Z',
//   peopleCount: 32500,
//   campaignsTracked: 18,
//   eventsProcessed: 87000
// }

Προώθηση Εκδηλώσεων

// Forward Customer.io reporting webhook events to Brevo
app.post('/webhooks/customerio', async (req, res) => {
  const events = req.body;

  for (const event of events) {
    await tajo.connectors.handleEvent('customerio', {
      type: event.metric,
      payload: {
        customerId: event.data.customer_id,
        campaignId: event.data.campaign_id,
        timestamp: event.timestamp
      }
    });
  }

  res.status(200).send('OK');
});

Εξαγωγή Τμήματος

const result = await tajo.connectors.exportSegment('customerio', {
  segmentId: 42,
  targetList: 13,
  includeAttributes: ['email', 'first_name', 'last_name', 'plan']
});

console.log(`Exported ${result.count} people to Brevo list 13`);

Όρια Ρυθμού

Το Customer.io επιβάλλει διαφορετικά όρια ρυθμού ανά API:

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

Συνήθη Προβλήματα

Λειτουργία Εντοπισμού Σφαλμάτων

connectors:
  customerio:
    debug: true
    log_level: verbose
    log_api_calls: true

Δοκιμή Σύνδεσης

tajo connectors test customerio
# ✓ Track API connection successful
# ✓ App API connection successful
# ✓ People accessible
# ✓ Campaigns readable
# ✓ Segments listable

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

1. Χρησιμοποιήστε Pipelines API για μαζικά δεδομένα - Το νεότερο Pipelines API είναι βελτιστοποιημένο για υψηλής έντασης εισαγωγή
2. Ρυθμίστε reporting webhooks - Προωθήστε εκδηλώσεις email Customer.io στο Tajo σε πραγματικό χρόνο
3. Αντιστοιχίστε στάδια κύκλου ζωής - Συγχρονίστε συμμετοχή τμήματος Customer.io σε χαρακτηριστικά Brevo
4. Χρησιμοποιήστε συνεπή αναγνωριστικά - Ταιριάξτε πεδία id σε Customer.io και Brevo
5. Συγχρονίστε σταδιακά - Αποφύγετε πλήρεις εξαγωγές· αξιοποιήστε χρονικές σημάνσεις last_activity
6. Παρακολουθήστε παράδοση webhook - Ρυθμίστε ειδοποιήσεις για αποτυχημένες παραδόσεις webhook

Ασφάλεια

• Basic Auth - Πιστοποίηση Track API με Site ID και API Key
• Bearer Token - Το App API χρησιμοποιεί bearer tokens τύπου OAuth
• Μόνο HTTPS - Όλη η επικοινωνία API κρυπτογραφείται μέσω TLS 1.2+
• Περιφερειακά Κέντρα Δεδομένων - Επιλογή κέντρου δεδομένων EU για συμμόρφωση GDPR
• Κρυπτογραφημένη Αποθήκευση - Όλα τα διαπιστευτήρια κρυπτογραφούνται σε ηρεμία στο Tajo
• Υπογραφές Webhook - Επαλήθευση payloads webhook με υπογραφές HMAC

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

• Σύνδεσμος Braze
• Σύνδεσμος Iterable
• Δεξιότητα Συγχρονισμού Πελατών
• API Επαφών Brevo