Σύνδεσμος Iterable

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

Επισκόπηση

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

• Συγχρονισμός προφίλ χρήστη - Αμφίδρομος συγχρονισμός δεδομένων χρήστη με επαφές Brevo
• Αναλυτικά καμπάνιας - Συγχρονισμός μετρικών αποστολής, ανοίγματος και κλικ καμπάνιας για ενοποιημένες αναφορές
• Δεδομένα πειράματος - Παρακολούθηση αποτελεσμάτων A/B test και νικητήριων παραλλαγών
• Συγχρονισμός καταλόγου - Συγχρονισμός καταλόγων προϊόντων και περιεχομένου σε πλατφόρμες
• Εκδηλώσεις ροής εργασίας - Προώθηση εκδηλώσεων trigger και ολοκλήρωσης ροής εργασίας στο Brevo
• Συγχρονισμός προτιμήσεων καναλιού - Αναπαραγωγή προτιμήσεων επικοινωνίας χρήστη στο Brevo

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

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

1. Λογαριασμό Iterable με ενεργοποιημένη πρόσβαση API
2. Κλειδί API Iterable με κατάλληλα δικαιώματα
3. Το ID του έργου Iterable σας
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με ενεργή συνδρομή

Πιστοποίηση

Το Iterable χρησιμοποιεί πιστοποίηση με κλειδί API που περνά στην κεφαλίδα αιτήματος.

Δημιουργία Κλειδιού API

1. Συνδεθείτε στο dashboard Iterable
2. Μεταβείτε στις Integrations > API Keys
3. Κάντε κλικ New API Key
4. Ονομάστε το “Tajo Integration”
5. Επιλέξτε τύπο κλειδιού Server-side
6. Παραχωρήστε τα ακόλουθα δικαιώματα:

Users: Read/Write
Events: Read/Write
Campaigns: Read
Lists: Read/Write
Catalogs: Read
Experiments: Read
Workflows: Read
Templates: Read
Channels: Read
Message Types: Read

Σύνδεση στο Tajo

tajo connectors install iterable \
  --api-key $ITERABLE_API_KEY

Διαμόρφωση

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

connectors:
  iterable:
    enabled: true

    sync:
      users: true
      events: true
      campaigns: true
      catalogs: true
      experiments: true

    lists:
      all_users: 16
      engaged_users: 17
      inactive_users: 18

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

Αντιστοίχηση πεδίων χρήστη Iterable σε χαρακτηριστικά επαφών Brevo:

field_mapping:
  # Standard fields
  userId: ITERABLE_ID
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS

  # Engagement data
  signupDate: SIGNUP_DATE
  totalPurchases: TOTAL_PURCHASES
  lastPurchaseDate: LAST_PURCHASE

  # Custom fields
  plan_name: PLAN_NAME
  company_size: COMPANY_SIZE
  preferred_channel: PREFERRED_CHANNEL
  lifecycle_stage: LIFECYCLE_STAGE

Διαμόρφωση Εκδηλώσεων

event_mapping:
  # Iterable event -> Brevo event
  purchase: ORDER_PLACED
  addToCart: CART_UPDATED
  pageView: PAGE_VIEWED
  appOpen: APP_OPENED
  pushOpen: PUSH_ENGAGED

Endpoints API

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

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

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

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('iterable', {
  apiKey: process.env.ITERABLE_API_KEY
});

Συγχρονισμός Χρηστών

// Incremental user sync from Iterable to Brevo
await tajo.connectors.sync('iterable', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

const status = await tajo.connectors.status('iterable');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T09:45:00Z',
//   usersCount: 58700,
//   campaignsTracked: 42,
//   eventsProcessed: 210000
// }

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

// Forward Iterable events to Brevo
await tajo.connectors.handleEvent('iterable', {
  type: 'custom_event',
  payload: {
    email: '[email protected]',
    eventName: 'subscription_upgraded',
    dataFields: {
      previousPlan: 'starter',
      newPlan: 'pro',
      mrr: 99.00
    }
  }
});

Χειριστής Webhook

// Handle Iterable system webhooks
app.post('/webhooks/iterable', async (req, res) => {
  const event = req.body;

  await tajo.connectors.handleWebhook('iterable', {
    type: event.eventName,
    payload: event
  });

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

Όρια Ρυθμού

Το Iterable επιβάλλει όρια ρυθμού βάσει του πλάνου σας:

Συγκεκριμένα όρια endpoint:

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

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

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

connectors:
  iterable:
    debug: true
    log_level: verbose
    log_api_calls: true

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

tajo connectors test iterable
# ✓ API connection successful
# ✓ User data accessible
# ✓ Campaign list readable
# ✓ Event tracking operational
# ✓ List management available

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

1. Χρησιμοποιήστε bulk endpoints - Πάντα να προτιμάτε bulkUpdate και trackBulk για μεγάλους όγκους δεδομένων
2. Αποεπτύξτε κατά email - Χρησιμοποιήστε email ως συνεπές αναγνωριστικό σε Iterable και Brevo
3. Συγχρονίστε σταδιακά - Χρησιμοποιήστε εύρη ημερομηνιών για αποφυγή επεξεργασίας ιστορικών δεδομένων
4. Αντιστοιχίστε προτιμήσεις καναλιού - Συγχρονίστε κατάσταση opt-in/opt-out για τήρηση συμμόρφωσης
5. Παρακολουθήστε εργασίες εξαγωγής - Οι μεγάλες εξαγωγές χρειάζονται χρόνο· ρυθμίστε polling κατάστασης
6. Δοκιμάστε με μη-παραγωγικό έργο - Επαληθεύστε αντιστοιχίσεις πριν συγχρονίσετε δεδομένα παραγωγής

Ασφάλεια

• Πιστοποίηση API Key - Κλειδιά server-side με λεπτομερή δικαιώματα
• Μόνο HTTPS - Όλη η επικοινωνία API κρυπτογραφείται μέσω TLS 1.2+
• Εναλλαγή Κλειδιών - Υποστήριξη πολλαπλών ενεργών κλειδιών API κατά την εναλλαγή
• Κρυπτογραφημένη Αποθήκευση - Διαπιστευτήρια API κρυπτογραφούνται σε ηρεμία στο Tajo
• JWT Webhooks - Τα payloads webhook υπογράφονται με JWT για επαλήθευση

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

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