---
title: "Σύνδεσμος Iterable"
description: "Πλήρης οδηγός ενσωμάτωσης Iterable για συγχρονισμό χρηστών, καμπανιών, πειραμάτων και εκδηλώσεων αφοσίωσης με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/marketing/iterable/
markdown: https://tajo.io/gr/docs/connectors/marketing/iterable.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος Iterable

Κατάσταση συνδέσμου: Προγραμματισμένο Δεν έχει κατασκευαστεί ακόμη. Το Tajo δεν εκτελεί σήμερα αυτόν τον σύνδεσμο.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Iterable |
| **Κατηγορία** | Marketing |
| **Πολυπλοκότητα Ρύθμισης** | Μέτρια |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Χρήστες, Εκδηλώσεις, Καμπάνιες, Κατάλογοι |
| **Τύπος API** | REST API |
| **Πιστοποίηση** | API Key |
| **Βασικό URL** | `https://api.iterable.com/api/` |

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

- **Συγχρονισμός προφίλ χρήστη** - Αμφίδρομος συγχρονισμός δεδομένων χρήστη με επαφές 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
```

Ο Τύπος Κλειδιού Έχει Σημασία

Πάντα να χρησιμοποιείτε κλειδί API τύπου **Server-side** για ενσωμάτωση Tajo. Τα κλειδιά Mobile και JavaScript-side έχουν περιορισμένα δικαιώματα και δεν μπορούν να προσπελάσουν όλα τα απαιτούμενα endpoints.

### Σύνδεση στο Tajo

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

## Διαμόρφωση

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

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

```yaml
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
```

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

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

| Endpoint | Μέθοδος | Σκοπός |
| --- | --- | --- |
| `/users/update` | POST | Ενημέρωση προφίλ χρήστη |
| `/users/{email}` | GET | Ανάκτηση χρήστη κατά email |
| `/users/bulkUpdate` | POST | Μαζική ενημέρωση χρηστών |
| `/events/track` | POST | Παρακολούθηση προσαρμοσμένων εκδηλώσεων |
| `/events/trackBulk` | POST | Μαζική παρακολούθηση εκδηλώσεων |
| `/campaigns` | GET | Λίστα όλων των καμπανιών |
| `/campaigns/metrics` | GET | Δεδομένα απόδοσης καμπάνιας |
| `/experiments/metrics` | GET | Αποτελέσματα πειράματος |
| `/lists` | GET | Λίστα όλων των λιστών χρηστών |
| `/lists/subscribe` | POST | Προσθήκη χρηστών σε λίστα |
| `/lists/unsubscribe` | POST | Αφαίρεση χρηστών από λίστα |
| `/catalogs/{catalogName}/items` | GET | Ανάκτηση στοιχείων καταλόγου |
| `/channels` | GET | Λίστα καναλιών μηνυμάτων |
| `/export/data.json` | GET | Εξαγωγή ακατέργαστων δεδομένων εκδηλώσεων |

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

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

```javascript
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
});
```

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

```javascript
// 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
// }
```

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

```javascript
// Forward Iterable events to Brevo
await tajo.connectors.handleEvent('iterable', {
  type: 'custom_event',
  payload: {
    email: 'user@example.com',
    eventName: 'subscription_upgraded',
    dataFields: {
      previousPlan: 'starter',
      newPlan: 'pro',
      mrr: 99.00
    }
  }
});
```

### Χειριστής Webhook

```javascript
// 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 επιβάλλει όρια ρυθμού βάσει του πλάνου σας:

| Πλάνο | Όριο Ρυθμού | Όριο Bulk Endpoint |
| --- | --- | --- |
| **Growth** | 500 αιτήματα/δευτερόλεπτο | 500 αιτήματα/δευτερόλεπτο |
| **Enterprise** | Προσαρμοσμένο | Προσαρμοσμένο |

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

| Endpoint | Όριο |
| --- | --- |
| `/users/update` | 500 αιτ./δευτ. |
| `/users/bulkUpdate` | 500 αιτ./δευτ. (1.000 χρήστες ανά αίτημα) |
| `/events/track` | 500 αιτ./δευτ. |
| `/events/trackBulk` | 500 αιτ./δευτ. (8.000 εκδηλώσεις ανά αίτημα) |
| `/export/data.json` | 4 ταυτόχρονα αιτήματα |

Bulk Endpoints

Το Tajo ομαδοποιεί αυτόματα ενημερώσεις χρηστών (έως 1.000 ανά κλήση) και παρακολουθήσεις εκδηλώσεων (έως 8.000 ανά κλήση) για μεγιστοποίηση throughput εντός ορίων ρυθμού.

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

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

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| 401 Unauthorized | Μη έγκυρο κλειδί API | Επαληθεύστε κλειδί στο Iterable > Integrations > API Keys |
| Οι χρήστες δεν συγχρονίζονται | Αναντιστοιχία τύπου κλειδιού | Βεβαιωθείτε ότι χρησιμοποιείτε κλειδί API τύπου Server-side |
| Λείπουν δεδομένα καμπάνιας | Ανεπαρκή δικαιώματα | Προσθέστε δικαίωμα Campaigns Read στο κλειδί API |
| Λήξη χρόνου εξαγωγής | Μεγάλος όγκος δεδομένων | Χρησιμοποιήστε φίλτρα εύρους ημερομηνιών για μείωση μεγέθους εξαγωγής |
| Διπλοί χρήστες | Ασυνεπή αναγνωριστικά | Χρησιμοποιήστε συνεπώς email ως κύριο αναγνωριστικό |

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

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

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

```bash
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](https://tajo.io/gr/docs/connectors/marketing/braze)
- [Σύνδεσμος Customer.io](https://tajo.io/gr/docs/connectors/marketing/customerio)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)