---
title: "Konektor Iterable"
description: "Kompletní průvodce integrací Iterable pro synchronizaci uživatelů, kampaní, experimentů a událostí zapojení s Brevo přes Tajo."
url: https://tajo.io/cz/docs/connectors/marketing/iterable/
markdown: https://tajo.io/cz/docs/connectors/marketing/iterable.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor Iterable

Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propojte svou growth marketingovou platformu Iterable s Brevo pro sjednocené zákaznické zapojení, koordinaci kampaní napříč kanály a konsolidovanou analytiku napříč marketingovými nástroji.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | Iterable |
| **Kategorie** | Marketing |
| **Složitost nastavení** | Střední |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Uživatelé, Události, Kampaně, Katalogy |
| **Typ API** | REST API |
| **Ověření** | API klíč |
| **Základní URL** | `https://api.iterable.com/api/` |

## Funkce

- **Synchronizace uživatelských profilů** – Obousměrná synchronizace uživatelských dat s kontakty Brevo
- **Analytika kampaní** – Synchronizujte metriky odesílání, otevření a kliknutí kampaní pro sjednocené reportování
- **Data experimentů** – Sledujte výsledky A/B testů a vítězné varianty
- **Synchronizace katalogu** – Synchronizujte produktové a obsahové katalogy napříč platformami
- **Události pracovních toků** – Přeposílejte události spouštění a dokončení pracovních toků do Brevo
- **Synchronizace preferencí kanálu** – Replikujte komunikační preference uživatelů v Brevo

## Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Iterable s přístupem k API
2. API klíč Iterable s příslušnými oprávněními
3. ID vašeho projektu Iterable
4. Účet Brevo s přístupem k API
5. Účet Tajo s aktivním předplatným

## Ověření

Iterable používá ověřování API klíčem předávaným v hlavičce požadavku.

### Vytvoření API klíče

1. Přihlaste se do svého řídicího panelu Iterable
2. Přejděte do **Integrations** > **API Keys**
3. Klikněte na **New API Key**
4. Pojmenujte ho “Tajo Integration”
5. Vyberte typ klíče **Server-side**
6. Udělte následující oprávnění:

```
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 klíče je důležitý

Pro integraci Tajo vždy používejte API klíč **Server-side**. Mobilní klíče a klíče na straně JavaScriptu mají omezená oprávnění a nemohou přistupovat ke všem požadovaným koncovým bodům.

### Připojení k Tajo

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

## Konfigurace

### Základní nastavení

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

### Mapování polí

Mapujte pole uživatelů Iterable na atributy kontaktů Brevo:

```yaml
field_mapping:
  # Standardní pole
  userId: ITERABLE_ID
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS

  # Data zapojení
  signupDate: SIGNUP_DATE
  totalPurchases: TOTAL_PURCHASES
  lastPurchaseDate: LAST_PURCHASE

  # Vlastní pole
  plan_name: PLAN_NAME
  company_size: COMPANY_SIZE
  preferred_channel: PREFERRED_CHANNEL
  lifecycle_stage: LIFECYCLE_STAGE
```

### Konfigurace událostí

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

## Koncové body API

Tajo se integruje s následujícími koncovými body Iterable API:

| Koncový bod | Metoda | Účel |
| --- | --- | --- |
| `/users/update` | POST | Aktualizace uživatelských profilů |
| `/users/{email}` | GET | Načtení uživatele podle e-mailu |
| `/users/bulkUpdate` | POST | Dávková aktualizace uživatelů |
| `/events/track` | POST | Sledování vlastních událostí |
| `/events/trackBulk` | POST | Dávkové sledování událostí |
| `/campaigns` | GET | Výpis všech kampaní |
| `/campaigns/metrics` | GET | Data výkonu kampaní |
| `/experiments/metrics` | GET | Výsledky experimentů |
| `/lists` | GET | Výpis všech seznamů uživatelů |
| `/lists/subscribe` | POST | Přidání uživatelů do seznamu |
| `/lists/unsubscribe` | POST | Odebrání uživatelů ze seznamu |
| `/catalogs/{catalogName}/items` | GET | Načtení položek katalogu |
| `/channels` | GET | Výpis kanálů zasílání zpráv |
| `/export/data.json` | GET | Export nezpracovaných dat událostí |

## Příklady kódu

### Inicializace konektoru

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

### Synchronizace uživatelů

```javascript
// Přírůstková synchronizace uživatelů z Iterable do 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
// }
```

### Sledování událostí

```javascript
// Přeposílání událostí Iterable do 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
    }
  }
});
```

### Obsluha webhooků

```javascript
// Zpracování systémových webhooků Iterable
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');
});
```

## Omezení rychlosti

Iterable vynucuje limity rychlosti na základě vašeho plánu:

| Plán | Limit rychlosti | Limit dávkového koncového bodu |
| --- | --- | --- |
| **Growth** | 500 požadavků/sekundu | 500 požadavků/sekundu |
| **Enterprise** | Vlastní | Vlastní |

Limity konkrétních koncových bodů:

| Koncový bod | Limit |
| --- | --- |
| `/users/update` | 500 požadavků/s |
| `/users/bulkUpdate` | 500 požadavků/s (1 000 uživatelů na požadavek) |
| `/events/track` | 500 požadavků/s |
| `/events/trackBulk` | 500 požadavků/s (8 000 událostí na požadavek) |
| `/export/data.json` | 4 souběžné požadavky |

Dávkové koncové body

Tajo automaticky sdružuje aktualizace uživatelů (až 1 000 na volání) a sledování událostí (až 8 000 na volání) pro maximalizaci propustnosti při dodržení limitů rychlosti.

## Řešení problémů

### Časté problémy

| Problém | Příčina | Řešení |
| --- | --- | --- |
| 401 Unauthorized | Neplatný API klíč | Ověřte klíč v Iterable > Integrations > API Keys |
| Uživatelé se nesynchronizují | Neshoda typu klíče | Ujistěte se, že používáte Server-side API klíč |
| Chybějící data kampaní | Nedostatečná oprávnění | Přidejte oprávnění Campaigns Read k API klíči |
| Timeout exportu | Velký objem dat | Používejte filtry časového rozsahu pro snížení velikosti exportu |
| Duplicitní uživatelé | Nekonzistentní identifikátory | Konzistentně používejte e-mail jako primární identifikátor |

### Režim ladění

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

### Test připojení

```bash
tajo connectors test iterable
# ✓ Připojení API úspěšné
# ✓ Uživatelská data přístupná
# ✓ Seznam kampaní čitelný
# ✓ Sledování událostí funkční
# ✓ Správa seznamů dostupná
```

## Osvědčené postupy

1. **Používejte dávkové koncové body** – Vždy upřednostňujte `bulkUpdate` a `trackBulk` pro velké objemy dat
2. **Deduplikujte podle e-mailu** – Používejte e-mail jako konzistentní identifikátor napříč Iterable a Brevo
3. **Synchronizujte přírůstkově** – Používejte časové rozsahy pro zamezení opětovného zpracování historických dat
4. **Mapujte preference kanálu** – Synchronizujte stav opt-in/opt-out pro zachování souladu
5. **Monitorujte exportní úlohy** – Velké exporty mohou trvat; nastavte pollování stavu
6. **Testujte s ne-produkčním projektem** – Ověřte mapování před synchronizací produkčních dat

## Zabezpečení

- **Ověřování API klíčem** – Server-side klíče s granulárními oprávněními
- **Pouze HTTPS** – Veškerá API komunikace šifrovaná přes TLS 1.2+
- **Rotace klíčů** – Podpora pro více aktivních API klíčů během rotace
- **Šifrované úložiště** – API přihlašovací údaje šifrované v klidu v Tajo
- **JWT webhooky** – Payloady webhooků podepsány pomocí JWT pro ověření

## Související zdroje

- [Konektor Braze](https://tajo.io/cz/docs/connectors/marketing/braze)
- [Konektor Customer.io](https://tajo.io/cz/docs/connectors/marketing/customerio)
- [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/cz/docs/contact-management)