---
title: "Iterable конектор"
description: "Пълно ръководство за интеграция с Iterable за синхронизация на потребители, кампании, експерименти и събития за ангажиране с Brevo чрез Tajo."
url: https://tajo.io/bg/docs/connectors/marketing/iterable/
markdown: https://tajo.io/bg/docs/connectors/marketing/iterable.md
lang: bg-BG
robots: noindex
---

Заявете ранен достъп

Въведете собственото си име и служебен имейл адрес. Ще ви изпратим връзка за потвърждение на заявката за достъп до Tajo.

# Iterable конектор

Статус на конектора: Планиран Все още не е изграден. Tajo не изпълнява този конектор днес.

| Поле източник | Целево поле | Примерна стойност |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Свържи своята Iterable growth marketing платформа с Brevo за унифицирано ангажиране на клиентите, координация на кампании между канали и консолидирана аналитика през маркетинговите инструменти.

## Преглед

| Свойство | Стойност |
| --- | --- |
| **Платформа** | Iterable |
| **Категория** | Маркетинг |
| **Сложност на настройка** | Средна |
| **Официална интеграция** | Не |
| **Синхронизирани данни** | Потребители, събития, кампании, каталози |
| **Тип на API** | REST API |
| **Автентикация** | API Key |
| **Base URL** | `https://api.iterable.com/api/` |

## Функции

- **Синхронизация на потребителски профили** – Двупосочна синхронизация на потребителски данни с контактите в Brevo
- **Аналитика на кампании** – Синхронизирай метрики за изпращане, отваряне и кликове на кампании за унифицирано отчитане
- **Данни от експерименти** – Проследявай резултати от A/B тестове и печеливши варианти
- **Синхронизация на каталози** – Синхронизирай каталози на продукти и съдържание между платформи
- **Workflow събития** – Препращай тригери и събития за завършване на workflow към Brevo
- **Синхронизация на channel preferences** – Репликирай комуникационните предпочитания на потребителите в Brevo

## Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Акаунт в Iterable с API достъп
2. Iterable API ключ с подходящи разрешения
3. Твоя Iterable project ID
4. Акаунт в Brevo с API достъп
5. Акаунт в Tajo с активен абонамент

## Автентикация

Iterable използва автентикация с API ключ, подаден в хедъра на заявката.

### Създаване на API ключ

1. Влез в своя Iterable dashboard
2. Навигирай към **Integrations** > **API Keys**
3. Щракни върху **New API Key**
4. Наименувай го “Tajo Integration”
5. Избери тип **Server-side** ключ
6. Предостави следните разрешения:

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

Типът на ключа е от значение

Винаги използвай **Server-side** API ключ за Tajo интеграцията. Mobile и JavaScript-side ключовете имат ограничени разрешения и не могат да достъпват всички необходими крайни точки.

### Свързване с Tajo

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

## Конфигурация

### Основна настройка

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

### Мапване на полета

Мапвай потребителски полета от Iterable към атрибути на контактите в 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
```

### Конфигурация на събития

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

## API крайни точки

Tajo се интегрира със следните Iterable API крайни точки:

| Крайна точка | Метод | Предназначение |
| --- | --- | --- |
| `/users/update` | POST | Обновяване на потребителски профили |
| `/users/{email}` | GET | Получаване на потребител по имейл |
| `/users/bulkUpdate` | POST | Пакетно обновяване на потребители |
| `/events/track` | POST | Проследяване на персонализирани събития |
| `/events/trackBulk` | POST | Пакетно проследяване на събития |
| `/campaigns` | GET | Списък с всички кампании |
| `/campaigns/metrics` | GET | Performance данни за кампании |
| `/experiments/metrics` | GET | Резултати от експерименти |
| `/lists` | GET | Списък с всички потребителски списъци |
| `/lists/subscribe` | POST | Добавяне на потребители към списък |
| `/lists/unsubscribe` | POST | Премахване на потребители от списък |
| `/catalogs/{catalogName}/items` | GET | Получаване на артикули от каталог |
| `/channels` | GET | Списък с messaging канали |
| `/export/data.json` | GET | Експорт на raw event данни |

## Примери с код

### Инициализация на конектора

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

### Синхронизация на потребители

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

### Проследяване на събития

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

### Handler за уебхуци

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

## Ограничения на заявките

Iterable налага rate limits на базата на твоя план:

| План | Rate Limit | Лимит на bulk крайни точки |
| --- | --- | --- |
| **Growth** | 500 заявки/секунда | 500 заявки/секунда |
| **Enterprise** | Персонализиран | Персонализиран |

Лимити за конкретни крайни точки:

| Крайна точка | Лимит |
| --- | --- |
| `/users/update` | 500 заявки/сек |
| `/users/bulkUpdate` | 500 заявки/сек (1 000 потребители на заявка) |
| `/events/track` | 500 заявки/сек |
| `/events/trackBulk` | 500 заявки/сек (8 000 събития на заявка) |
| `/export/data.json` | 4 едновременни заявки |

Bulk крайни точки

Tajo автоматично пакетира обновленията на потребители (до 1 000 на извикване) и event track-ове (до 8 000 на извикване), за да максимизира throughput, оставайки в рамките на rate limits.

## Отстраняване на проблеми

### Чести проблеми

| Проблем | Причина | Решение |
| --- | --- | --- |
| 401 Unauthorized | Невалиден API ключ | Провери ключа в Iterable > Integrations > API Keys |
| Потребителите не се синхронизират | Несъответствие на тип ключ | Увери се, че използваш Server-side API ключ |
| Липсват данни за кампании | Недостатъчни разрешения | Добави разрешението Campaigns Read към API ключа |
| Timeout при експорт | Голям обем данни | Използвай филтри по диапазон от дати, за да намалиш размера на експорта |
| Дублирани потребители | Непоследователни идентификатори | Използвай имейл като основен идентификатор консистентно |

### Режим за дебъг

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

### Тест на връзката

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

## Добри практики

1. **Използвай bulk крайни точки** – Винаги предпочитай `bulkUpdate` и `trackBulk` за големи обеми данни
2. **Дедуплицирай по имейл** – Използвай имейл като консистентен идентификатор в Iterable и Brevo
3. **Синхронизирай инкрементално** – Използвай диапазони от дати, за да избегнеш повторна обработка на исторически данни
4. **Мапвай channel preferences** – Синхронизирай opt-in/opt-out статус за поддържане на съвместимост
5. **Мониторирай export jobs** – Големите експорти могат да отнемат време; настрой polling на статус
6. **Тествай с не-production проект** – Валидирай мапванията преди синхронизация на production данни

## Сигурност

- **Автентикация с API ключ** – Server-side ключове с гранулирани разрешения
- **Само HTTPS** – Цялата API комуникация е криптирана чрез TLS 1.2+
- **Ротация на ключове** – Поддръжка на множество активни API ключове по време на ротация
- **Криптирано съхранение** – API credentials криптирани при съхранение в Tajo
- **JWT уебхуци** – Webhook payloads подписани с JWT за верификация

## Свързани ресурси

- [Braze конектор](https://tajo.io/bg/docs/connectors/marketing/braze)
- [Customer.io конектор](https://tajo.io/bg/docs/connectors/marketing/customerio)
- [Customer Sync скил](https://tajo.io/bg/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/bg/docs/contact-management)