---
title: "Iterable konnektor"
description: "Teljes Iterable integrációs útmutató felhasználók, kampányok, kísérletek és elköteleződési események Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/marketing/iterable/
markdown: https://tajo.io/hu/docs/connectors/marketing/iterable.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Iterable konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd az Iterable növekedési marketing platformot a Brevóhoz egységesített ügyfél-elköteleződéshez, csatornák közötti kampánykoordinációhoz és konszolidált analitikához a marketing eszközök között.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Iterable |
| **Kategória** | Marketing |
| **Telepítés bonyolultsága** | Közepes |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Felhasználók, Események, Kampányok, Katalógusok |
| **API típus** | REST API |
| **Hitelesítés** | API kulcs |
| **Alap URL** | `https://api.iterable.com/api/` |

## Funkciók

- **Felhasználói profil szinkronizáció** – Kétirányú felhasználói adatszinkronizálás Brevo kapcsolatokkal
- **Kampányanalitika** – Kampány-küldési, megnyitási és kattintási mutatók szinkronizálása egységesített riportoláshoz
- **Kísérleti adatok** – A/B teszt eredmények és nyerő variánsok követése
- **Katalógus-szinkronizáció** – Termék- és tartalomkatalógusok szinkronizálása platformok között
- **Munkafolyamat-események** – Munkafolyamat-kiváltó és befejezési események továbbítása a Brevóba
- **Csatorna-preferencia szinkronizáció** – Felhasználói kommunikációs preferenciák replikálása a Brevóba

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Iterable fiókkal API-hozzáféréssel
2. Egy Iterable API kulccsal megfelelő jogosultságokkal
3. Az Iterable projekt azonosítóval
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal aktív előfizetéssel

## Hitelesítés

Az Iterable API kulcs hitelesítést használ, amelyet a kérés fejlécébe kell beilleszteni.

### API kulcs létrehozása

1. Jelentkezz be az Iterable dashboardba
2. Menj az **Integrációk** > **API kulcsok** menübe
3. Kattints az **Új API kulcs** gombra
4. Nevezd el „Tajo Integration”-nek
5. Válaszd a **Szerveroldali** kulcstípust
6. Adj meg a következő jogosultságokat:

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

A kulcstípus fontos

Mindig **Szerveroldali** API kulcsot használj a Tajo integrációhoz. A mobil és JavaScript oldali kulcsok korlátozott jogosultságokkal rendelkeznek, és nem érhetik el az összes szükséges végpontot.

### Csatlakozás a Tajóhoz

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

## Konfiguráció

### Alapbeállítás

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

### Mezőleképezés

Képezd le az Iterable felhasználói mezőket Brevo kapcsolat-attribútumokhoz:

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

### Esemény-konfiguráció

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

## API végpontok

A Tajo az alábbi Iterable API végpontokkal integrálódik:

| Végpont | Módszer | Cél |
| --- | --- | --- |
| `/users/update` | POST | Felhasználói profilok frissítése |
| `/users/{email}` | GET | Felhasználó lekérése e-mail alapján |
| `/users/bulkUpdate` | POST | Felhasználók tömeges frissítése |
| `/events/track` | POST | Egyéni események követése |
| `/events/trackBulk` | POST | Tömeges esemény-követés |
| `/campaigns` | GET | Összes kampány listázása |
| `/campaigns/metrics` | GET | Kampány-teljesítmény adatok |
| `/experiments/metrics` | GET | Kísérlet-eredmények |
| `/lists` | GET | Összes felhasználói lista listázása |
| `/lists/subscribe` | POST | Felhasználók hozzáadása listához |
| `/lists/unsubscribe` | POST | Felhasználók eltávolítása listából |
| `/catalogs/{catalogName}/items` | GET | Katalóguselemek lekérése |
| `/channels` | GET | Üzenetküldési csatornák listázása |
| `/export/data.json` | GET | Nyers esemény-adatok exportálása |

## Kódpéldák

### A konnektor inicializálása

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

### Felhasználók szinkronizálása

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

### Események követése

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

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

## Ráta-korlátok

Az Iterable ráta-korlátokat alkalmaz a csomag alapján:

| Csomag | Ráta-korlát | Bulk végpont korlát |
| --- | --- | --- |
| **Growth** | 500 kérés/másodperc | 500 kérés/másodperc |
| **Enterprise** | Egyéni | Egyéni |

Végpont-specifikus korlátok:

| Végpont | Korlát |
| --- | --- |
| `/users/update` | 500 kérés/mp |
| `/users/bulkUpdate` | 500 kérés/mp (1 000 felhasználó kérésenként) |
| `/events/track` | 500 kérés/mp |
| `/events/trackBulk` | 500 kérés/mp (8 000 esemény kérésenként) |
| `/export/data.json` | 4 párhuzamos kérés |

Bulk végpontok

A Tajo automatikusan kötegelve küldi a felhasználó-frissítéseket (legfeljebb 1 000 hívásonként) és esemény-követéseket (legfeljebb 8 000 hívásonként) az átviteli teljesítmény maximalizálásához a ráta-korlátokon belül.

## Hibaelhárítás

### Gyakori problémák

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| 401 Unauthorized | Érvénytelen API kulcs | Ellenőrizd a kulcsot az Iterable > Integrációk > API kulcsok menüben |
| Felhasználók nem szinkronizálódnak | Kulcstípus eltérés | Győződj meg róla, hogy szerveroldali API kulcsot használsz |
| Hiányzó kampányadatok | Elégtelen jogosultságok | Adj Kampányok Olvasás jogosultságot az API kulcshoz |
| Exportálási időtúllépés | Nagy adatmennyiség | Használj dátumtartomány-szűrőket az exportálás méretének csökkentéséhez |
| Duplikált felhasználók | Nem egységes azonosítók | Következetesen használj e-mailt elsődleges azonosítóként |

### Hibakeresési mód

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

### Kapcsolat tesztelése

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

## Legjobb gyakorlatok

1. **Használj bulk végpontokat** – Mindig a `bulkUpdate`-et és `trackBulk`-ot részesítsd előnyben nagy adatmennyiségnél
2. **E-mail alapú deduplikálás** – Használj e-mailt következetes azonosítóként az Iterable és Brevo között
3. **Szinkronizálj növekményesen** – Dátumtartományokat használj a korábbi adatok újrafeldolgozásának elkerüléséhez
4. **Képezd le a csatorna-preferenciákat** – Szinkronizálj be/ki-iratkozási státuszt a megfelelőség fenntartásához
5. **Figyeld az exportálási feladatokat** – A nagy exportálások időt igényelhetnek; állíts be státusz-lekérdezést
6. **Tesztelj nem-éles projektben** – Validáld a leképezéseket az éles adatok szinkronizálása előtt

## Biztonság

- **API kulcs hitelesítés** – Szerveroldali kulcsok részletes jogosultságokkal
- **Csak HTTPS** – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva
- **Kulcs rotáció** – Több aktív API kulcs támogatása rotáció során
- **Titkosított tárolás** – API hitelesítő adatok titkosítva tárolódnak a Tajóban
- **JWT webhookok** – A webhook terhelések JWT-vel aláírva ellenőrzéshez

## Kapcsolódó források

- [Braze konnektor](https://tajo.io/hu/docs/connectors/marketing/braze)
- [Customer.io konnektor](https://tajo.io/hu/docs/connectors/marketing/customerio)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)