---
title: "Iterable konektor"
description: "Kompletný sprievodca integráciou Iterable na synchronizáciu používateľov, kampaní, experimentov a udalostí zapojenia s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/marketing/iterable/
markdown: https://tajo.io/sk/docs/connectors/marketing/iterable.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Iterable konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj svoju rastovú marketingovú platformu Iterable s Brevo pre zjednotené zákaznícke zapojenie, koordináciu kampaní naprieč kanálmi a konsolidovanú analytiku naprieč marketingovými nástrojmi.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Iterable |
| **Kategória** | Marketing |
| **Zložitosť nastavenia** | Stredná |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Používatelia, Udalosti, Kampane, Katalógy |
| **Typ API** | REST API |
| **Autentifikácia** | API Key |
| **Base URL** | `https://api.iterable.com/api/` |

## Funkcie

- **Synchronizácia profilov používateľov** - Obojsmerná synchronizácia dát používateľov s kontaktmi Brevo
- **Analytika kampaní** - Synchronizuj metriky odosielania, otvárania a klikania kampaní pre jednotné reportovanie
- **Dáta experimentov** - Sleduj výsledky A/B testov a víťazné varianty
- **Synchronizácia katalógu** - Synchronizuj katalógy produktov a obsahu naprieč platformami
- **Udalosti workflowov** - Preposielaj udalosti triggeru a dokončenia workflowov do Brevo
- **Synchronizácia preferencií kanálov** - Replikuj preferencie komunikácie používateľov v Brevo

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Iterable účet s API prístupom
2. Iterable API kľúč s príslušnými oprávneniami
3. ID tvojho Iterable projektu
4. Brevo účet s API prístupom
5. Tajo účet s aktívnym predplatným

## Autentifikácia

Iterable používa autentifikáciu API kľúčmi prenášanými v hlavičke požiadavky.

### Vytvorenie API kľúča

1. Prihlás sa do svojho Iterable dashboardu
2. Prejdi do **Integrations** > **API Keys**
3. Klikni na **New API Key**
4. Pomenuj ho “Tajo Integration”
5. Vyber typ kľúča **Server-side**
6. Udeľ nasledujúce oprávnenia:

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

Typ kľúča je dôležitý

Pre integráciu Tajo vždy použi API kľúč typu **Server-side**. Mobilné a JavaScript-side kľúče majú obmedzené oprávnenia a nemôžu pristupovať ku všetkým potrebným endpointom.

### Pripojenie k Tajo

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

## Konfigurácia

### Základné nastavenie

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

### Mapovanie polí

Namapuj polia používateľov Iterable na atribúty kontaktov 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
```

### Konfigurácia udalostí

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

## API endpointy

Tajo sa integruje s nasledujúcimi API endpointmi Iterable:

| Endpoint | Metóda | Účel |
| --- | --- | --- |
| `/users/update` | POST | Aktualizácia profilov používateľov |
| `/users/{email}` | GET | Načítanie používateľa podľa e-mailu |
| `/users/bulkUpdate` | POST | Dávková aktualizácia používateľov |
| `/events/track` | POST | Sledovanie vlastných udalostí |
| `/events/trackBulk` | POST | Dávkové sledovanie udalostí |
| `/campaigns` | GET | Zoznam všetkých kampaní |
| `/campaigns/metrics` | GET | Dáta výkonu kampaní |
| `/experiments/metrics` | GET | Výsledky experimentov |
| `/lists` | GET | Zoznam všetkých zoznamov používateľov |
| `/lists/subscribe` | POST | Pridanie používateľov do zoznamu |
| `/lists/unsubscribe` | POST | Odstránenie používateľov zo zoznamu |
| `/catalogs/{catalogName}/items` | GET | Načítanie položiek katalógu |
| `/channels` | GET | Zoznam zasielacích kanálov |
| `/export/data.json` | GET | Export surových dát udalostí |

## Ukážky kódu

### Inicializácia konektora

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

### Synchronizácia používateľov

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

### Sledovanie udalostí

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

### Spracovanie webhookov

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

## Obmedzenia rýchlosti

Iterable presadzuje limity rýchlosti na základe tvojho plánu:

| Plán | Limit rýchlosti | Limit dávkového endpointu |
| --- | --- | --- |
| **Growth** | 500 požiadaviek/sekundu | 500 požiadaviek/sekundu |
| **Enterprise** | Vlastné | Vlastné |

Limity konkrétnych endpointov:

| Endpoint | Limit |
| --- | --- |
| `/users/update` | 500 požiadaviek/sek |
| `/users/bulkUpdate` | 500 požiadaviek/sek (1 000 používateľov na požiadavku) |
| `/events/track` | 500 požiadaviek/sek |
| `/events/trackBulk` | 500 požiadaviek/sek (8 000 udalostí na požiadavku) |
| `/export/data.json` | 4 súbežné požiadavky |

Dávkové endpointy

Tajo automaticky dávkuje aktualizácie používateľov (až 1 000 na volanie) a sledovanie udalostí (až 8 000 na volanie) na maximalizáciu priepustnosti v rámci limitov rýchlosti.

## Riešenie problémov

### Bežné problémy

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| 401 Unauthorized | Neplatný API kľúč | Overte kľúč v Iterable > Integrations > API Keys |
| Používatelia sa nesynchronizujú | Nezhoda typu kľúča | Uisti sa, že používaš Server-side API kľúč |
| Chýbajúce dáta kampaní | Nedostatočné oprávnenia | Pridaj oprávnenie Campaigns Read k API kľúču |
| Timeout exportu | Veľký objem dát | Použi filtre rozsahu dátumov na zníženie veľkosti exportu |
| Duplicitní používatelia | Nekonzistentné identifikátory | Konzistentne použi e-mail ako primárny identifikátor |

### Debug režim

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

### Test pripojenia

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

## Odporúčané postupy

1. **Použi dávkové endpointy** - Vždy uprednostňuj `bulkUpdate` a `trackBulk` pre veľké objemy dát
2. **Deduplikuj podľa e-mailu** - Použi e-mail ako konzistentný identifikátor naprieč Iterable a Brevo
3. **Synchronizuj inkrementálne** - Použi rozsahy dátumov na vyhnutie sa opätovnému spracovaniu historických dát
4. **Mapuj preferencie kanálov** - Synchronizuj stav opt-in/opt-out na zachovanie súladu
5. **Monitoruj exportové úlohy** - Veľké exporty môžu trvať dlho; nastav polling stavu
6. **Testuj s neprodukčným projektom** - Validuj mapovania pred synchronizáciou produkčných dát

## Bezpečnosť

- **Autentifikácia API kľúčom** - Server-side kľúče s granulárnnymi oprávneniami
- **Iba HTTPS** - Všetka API komunikácia šifrovaná cez TLS 1.2+
- **Rotácia kľúčov** - Podpora viacerých aktívnych API kľúčov počas rotácie
- **Šifrované úložisko** - API prihlasovací údaje šifrované v pokoji v Tajo
- **JWT webhooky** - Payloady webhookov podpísané JWT pre overenie

## Súvisiace zdroje

- [Braze konektor](https://tajo.io/sk/docs/connectors/marketing/braze)
- [Customer.io konektor](https://tajo.io/sk/docs/connectors/marketing/customerio)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/sk/docs/contact-management)