---
title: "Iterable Konektor"
description: "Kompletan vodič za integraciju Iterablea za sinkronizaciju korisnika, kampanja, eksperimenata i događaja angažmana s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/marketing/iterable/
markdown: https://tajo.io/hr/docs/connectors/marketing/iterable.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# Iterable Konektor

Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor.

| Izvorno polje | Odredišno polje | Primjer vrijednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Povežite svoju Iterable platformu za rast marketinga s Brevom za ujedinjeni angažman korisnika, koordinaciju kampanja na više kanala i konsolidiranu analitiku između marketinških alata.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Iterable |
| **Kategorija** | Marketing |
| **Složenost postavljanja** | Srednje |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Korisnici, Događaji, Kampanje, Katalozi |
| **Vrsta API-ja** | REST API |
| **Autentifikacija** | API ključ |
| **Osnovni URL** | `https://api.iterable.com/api/` |

## Značajke

- **Sinkronizacija korisničkih profila** - Dvosmjerna sinkronizacija korisničkih podataka s Brevo kontaktima
- **Analitika kampanja** - Sinkronizacija metrika slanja, otvaranja i klikova kampanje za ujedinjeno izvješćivanje
- **Podaci eksperimenata** - Praćenje rezultata A/B testova i pobjedničkih varijanti
- **Sinkronizacija kataloga** - Sinkronizacija kataloga proizvoda i sadržaja između platformi
- **Događaji tijeka rada** - Prosljeđivanje ereignaja okidača i dovršetka tijeka rada u Brevo
- **Sinkronizacija preferencija kanala** - Replikacija korisničkih komunikacijskih preferencija u Brevo

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Iterable račun s API pristupom
2. Iterable API ključ s odgovarajućim dozvolama
3. Vaš Iterable ID projekta
4. Brevo račun s API pristupom
5. Tajo račun s aktivnom pretplatom

## Autentifikacija

Iterable koristi autentifikaciju API ključem proslijeđenim u zaglavlju zahtjeva.

### Kreiranje API ključa

1. Prijavite se na vaš Iterable dashboard
2. Navigirajte do **Integracije** > **API ključevi**
3. Kliknite **Novi API ključ**
4. Nazovite ga “Tajo integracija”
5. Odaberite vrstu ključa **Server-side**
6. Dodijelite sljedeće dozvole:

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

Vrsta ključa je važna

Uvijek koristite **Server-side** API ključ za Tajo integraciju. Mobilni i JavaScript ključevi na strani klijenta imaju ograničene dozvole i ne mogu pristupiti svim potrebnim krajnjim točkama.

### Povezivanje s Tajom

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

## Konfiguracija

### Osnovna konfiguracija

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

### Mapiranje polja

Mapirajte Iterable korisničke atribute na Brevo atribute kontakata:

```yaml
field_mapping:
  # Standardna polja
  userId: ITERABLE_ID
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS

  # Podaci o angažmanu
  signupDate: SIGNUP_DATE
  totalPurchases: TOTAL_PURCHASES
  lastPurchaseDate: LAST_PURCHASE

  # Prilagođena polja
  plan_name: PLAN_NAME
  company_size: COMPANY_SIZE
  preferred_channel: PREFERRED_CHANNEL
  lifecycle_stage: LIFECYCLE_STAGE
```

### Konfiguracija događaja

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

## API krajnje točke

Tajo se integrira s sljedećim Iterable API krajnjim točkama:

| Krajnja točka | Metoda | Namjena |
| --- | --- | --- |
| `/users/update` | POST | Ažuriraj korisničke profile |
| `/users/{email}` | GET | Dohvati korisnika po e-mailu |
| `/users/bulkUpdate` | POST | Skupno ažuriranje korisnika |
| `/events/track` | POST | Prati prilagođene događaje |
| `/events/trackBulk` | POST | Skupno praćenje događaja |
| `/campaigns` | GET | Popis svih kampanja |
| `/campaigns/metrics` | GET | Podaci o performansama kampanje |
| `/experiments/metrics` | GET | Rezultati eksperimenata |
| `/lists` | GET | Popis svih korisničkih popisa |
| `/lists/subscribe` | POST | Dodaj korisnike na popis |
| `/lists/unsubscribe` | POST | Ukloni korisnike s popisa |
| `/catalogs/{catalogName}/items` | GET | Dohvati stavke kataloga |
| `/channels` | GET | Popis kanala za razmjenu poruka |
| `/export/data.json` | GET | Izvoz sirovih podataka o događajima |

## Primjeri koda

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

### Sinkronizacija korisnika

```javascript
// Inkrementalna sinkronizacija korisnika iz Iterablea u 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
// }
```

### Praćenje događaja

```javascript
// Prosljeđivanje Iterable događaja u 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
    }
  }
});
```

### Handler za webhookove

```javascript
// Rukovanje Iterable sistemskim webhookovima
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');
});
```

## Ograničenja brzine

Iterable primjenjuje ograničenja brzine na temelju vašeg plana:

| Plan | Ograničenje brzine | Ograničenje skupne krajnje točke |
| --- | --- | --- |
| **Growth** | 500 zahtjeva/sekundi | 500 zahtjeva/sekundi |
| **Enterprise** | Prilagođeno | Prilagođeno |

Ograničenja specifičnih krajnjih točaka:

| Krajnja točka | Ograničenje |
| --- | --- |
| `/users/update` | 500 zah./s |
| `/users/bulkUpdate` | 500 zah./s (1.000 korisnika po zahtjevu) |
| `/events/track` | 500 zah./s |
| `/events/trackBulk` | 500 zah./s (8.000 događaja po zahtjevu) |
| `/export/data.json` | 4 istovremena zahtjeva |

Skupne krajnje točke

Tajo automatski grupira ažuriranja korisnika (do 1.000 po pozivu) i praćenja događaja (do 8.000 po pozivu) za maksimiziranje propusnosti unutar ograničenja brzine.

## Rješavanje problema

### Uobičajeni problemi

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| 401 Unauthorized | Nevažeći API ključ | Verificirajte ključ u Iterable > Integracije > API ključevi |
| Korisnici se ne sinkroniziraju | Nepodudaranje vrste ključa | Osigurajte da koristite Server-side API ključ |
| Nedostaju podaci o kampanjama | Nedovoljne dozvole | Dodajte dozvolu za čitanje kampanja API ključu |
| Vremensko ograničenje izvoza | Veliki volumen podataka | Koristite filtere raspona datuma za smanjenje veličine izvoza |
| Duplicirani korisnici | Nedosljedni identifikatori | Koristite e-mail dosljedno kao primarni identifikator |

### Način otklanjanja grešaka

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

### Testiranje veze

```bash
tajo connectors test iterable
# ✓ API veza uspješna
# ✓ Korisnički podaci dostupni
# ✓ Popis kampanja čitljiv
# ✓ Praćenje događaja operativno
# ✓ Upravljanje popisima dostupno
```

## Preporučene prakse

1. **Koristite skupne krajnje točke** - Uvijek preferirajte `bulkUpdate` i `trackBulk` za velike volumene podataka
2. **Deduplicirajte po e-mailu** - Koristite e-mail kao dosljedni identifikator u Iterableu i Brevo
3. **Sinkronizirajte inkrementalno** - Koristite raspone datuma kako biste izbjegli ponovnu obradu historijskih podataka
4. **Mapirajte preferencije kanala** - Sinkronizacija statusa prijave/odjave za održavanje usklađenosti
5. **Pratite zadatke izvoza** - Veliki izvozi mogu potrajati; postavite anketiranje statusa
6. **Testirajte s neprodukcijskim projektom** - Validir mapiranja prije sinkronizacije produkcijskih podataka

## Sigurnost

- **Autentifikacija API ključem** - Server-side ključevi s granularnim dozvolama
- **Samo HTTPS** - Sva API komunikacija šifrirana putem TLS 1.2+
- **Rotacija ključeva** - Podrška za više aktivnih API ključeva tokom rotacije
- **Šifrirano pohranjivanje** - API vjerodajnice šifrirane u mirovanju u Taju
- **JWT webhookovi** - Webhook opterećenja potpisana JWT-om za verifikaciju

## Povezani resursi

- [Braze Konektor](https://tajo.io/hr/docs/connectors/marketing/braze)
- [Customer.io Konektor](https://tajo.io/hr/docs/connectors/marketing/customerio)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)
- [Brevo API kontakata](https://tajo.io/hr/docs/contact-management)