---
title: "Iterable Connector"
description: "Popoln vodnik za integracijo Iterable za sinhronizacijo profilov uporabnikov, kampanj in podatkov o angažiranosti z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/marketing/iterable/
markdown: https://tajo.io/sl/docs/connectors/marketing/iterable.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Iterable Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži Iterable z Brevo prek Tajo za sinhronizacijo profilov uporabnikov, kampanjskih podatkov in vedenjskih dogodkov za celovito večkanalno marketinško avtomatizacijo.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | Iterable |
| **Kategorija** | Marketing |
| **Zahtevnost nastavitve** | Srednja |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Uporabniki, dogodki, kampanje, seznami |
| **Metoda avtentikacije** | API ključ |

## Funkcionalnosti

- **Sinhronizacija profilov** – sinhroniziraj profile uporabnikov z atributi med Iterable in Brevo
- **Posredovanje dogodkov** – posreduj vedenjske dogodke iz Iterable v avtomatizacije Brevo
- **Sinhronizacija seznamov** – preslikaj liste naročnikov Iterable v sezname stikov Brevo
- **Migracija kampanj** – prenos uspešnosti kampanj in angažirnih podatkov
- **Sledenje konverzijam** – sinhroniziraj konverzijske dogodke za enotno poročanje
- **Podpora za webhooks** – obravnavaj kampanjske in sporočilne dogodke v realnem času

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Iterable z dostopom do API
2. API ključ iz nastavitev projekta Iterable
3. Brevo račun z dostopom do API
4. Tajo račun z dovoljenji za konektorje

## Avtentikacija

### Avtentikacija z API ključem

```bash
# Set your API keys
export ITERABLE_API_KEY=your_iterable_api_key
export TAJO_API_KEY=your_tajo_api_key
export BREVO_API_KEY=your_brevo_api_key
```

```javascript
// All requests require the Api-Key header
const headers = {
  'Api-Key': process.env.ITERABLE_API_KEY,
  'Content-Type': 'application/json'
};
```

## Konfiguracija

### Osnovna nastavitev

```yaml
connectors:
  iterable:
    enabled: true
    api_key: "${ITERABLE_API_KEY}"

    sync:
      users: true
      events: true
      lists: true
      campaigns: true

    lists:
      all_users: 15
      active_users: 16
      churned: 17
```

### Preslikava polj

```yaml
field_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS
  signupDate: SIGNUP_DATE
  totalRevenue: TOTAL_REVENUE
  lastPurchaseDate: LAST_ORDER_DATE
  preferredChannel: CHANNEL_PREF
```

### Preslikava dogodkov

```yaml
event_mapping:
  "purchase": "order_completed"
  "addToCart": "cart_updated"
  "emailOpen": "email_opened"
  "emailClick": "email_clicked"
  "unsubscribe": "customer_unsubscribed"
  "webPush": "push_received"
```

## Končne točke API

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `POST` | `/api/users/update` | Posodobi podatkovne polja uporabnika |
| `GET` | `/api/users/{email}` | Pridobi profil uporabnika |
| `POST` | `/api/events/track` | Sledi dogodku |
| `GET` | `/api/lists` | Seznam vseh list |
| `POST` | `/api/lists/subscribe` | Naroči uporabnike na listo |
| `POST` | `/api/lists/unsubscribe` | Odjavi uporabnike z liste |
| `GET` | `/api/campaigns` | Seznam kampanj |
| `POST` | `/api/email/target` | Pošlji ciljani e-mail |
| `POST` | `/api/push/target` | Pošlji ciljano potisno obvestilo |
| `POST` | `/api/sms/target` | Pošlji ciljani SMS |

## Primeri kode

### Inicializacija konektorja

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

### Sinhronizacija profilov uporabnikov

```javascript
// Update user profile in Iterable and sync to Brevo
const response = await fetch('https://api.iterable.com/api/users/update', {
  method: 'POST',
  headers: {
    'Api-Key': process.env.ITERABLE_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'jane@example.com',
    dataFields: {
      firstName: 'Jane',
      lastName: 'Kim',
      totalRevenue: 450.00,
      plan: 'premium'
    }
  })
});

// Sync the user to Brevo via Tajo
await tajo.contacts.sync({
  email: 'jane@example.com',
  attributes: {
    FIRSTNAME: 'Jane',
    LASTNAME: 'Kim',
    TOTAL_REVENUE: 450.00,
    SUBSCRIPTION_PLAN: 'premium'
  }
});
```

### Sledenje in posredovanje dogodkov

```javascript
// Track an event in Iterable
await fetch('https://api.iterable.com/api/events/track', {
  method: 'POST',
  headers: {
    'Api-Key': process.env.ITERABLE_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'jane@example.com',
    eventName: 'purchase',
    dataFields: {
      orderId: 'ORD-123',
      revenue: 89.99,
      items: ['Widget Pro']
    }
  })
});
```

## Omejitve hitrosti

| Vrsta | Omejitev | Opombe |
| --- | --- | --- |
| Splošni API | 500 zahtevkov/s | Na projekt |
| Paketni API | 250 zahtevkov/s | Na projekt |
| Izvozni API | 5 zahtevkov/min | Na projekt |

Omejitve izvoza

Iterable Exports API je omejen na 5 zahtevkov na minuto. Za velike izvozne naloge implementiraj čakanje med zahtevki in obravnavaj odgovore 429.

## Odpravljanje težav

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| 401 Unauthorized | Neveljaven API ključ | Preveri API ključ v nastavitvah projekta Iterable |
| Uporabnik ni najden | E-mail ne obstaja | Najprej ustvari uporabniški profil z `/api/users/update` |
| Dogodki se ne sprožajo | Neujemanje imen | Preveri natančna imena dogodkov v Iterable |
| Sinhronizacija liste neuspešna | Presežena omejitev velikosti | Razdeli na manjše pakete za uvoz |

### Način odpravljanja napak

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

## Najboljše prakse

1. **Identificiraj s prijavno točko** – pri registraciji vedno ustvari uporabniški profil
2. **Paketni dogodki** – za učinkovito sledenje visokemu obsegu uporabi Batch API
3. **Sinhroniziraj demografijo** – redno posodabljaj podatkovne atribute v Iterable
4. **Enotna imenovanja dogodkov** – vzdržuj dosledno konvencijo poimenovanja dogodkov med platformama
5. **Upravljaj odjave** – sinhroniziraj odjave med Iterable in Brevo za skladnost
6. **Sprljuj odzivnost kampanj** – uvozi angažirne metrike kampanj v Brevo za analizo

## Varnost

- **Avtentikacija z API ključem** – dostop prek glave `Api-Key`
- **Varnost projektnega nivoja** – API ključi obsegani na posamezne projekte
- **TLS šifriranje** – vsa komunikacija API šifrirana prek HTTPS
- **Rotacija ključev** – periodično menjaj API ključe prek nadzorne plošče Iterable

## Povezani viri

- [Brevo Connector](https://tajo.io/sl/docs/connectors/marketing/brevo)
- [Klaviyo Connector](https://tajo.io/sl/docs/connectors/marketing/klaviyo)
- [Customer Sync Skill](https://tajo.io/sl/docs/skills/data-sync/customer-sync)
- [Iterable API dokumentacija](https://api.iterable.com/api/docs)