---
title: "Trình Kết Nối Iterable"
description: "Hướng dẫn tích hợp Iterable đầy đủ để đồng bộ users, campaigns, experiments và engagement events với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/marketing/iterable/
markdown: https://tajo.io/vi/docs/connectors/marketing/iterable.md
lang: vi-VN
robots: noindex
---

Đăng ký quyền truy cập sớm

Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo.

# Trình Kết Nối Iterable

Trạng thái trình kết nối: Dự kiến Chưa được xây dựng. Hiện Tajo chưa chạy trình kết nối này.

| Trường nguồn | Trường đích | Giá trị mẫu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Kết nối nền tảng growth marketing Iterable của bạn với Brevo để hợp nhất customer engagement, phối hợp campaigns đa kênh và hợp nhất analytics trên các công cụ marketing.

## Tổng Quan

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | Iterable |
| **Danh Mục** | Marketing |
| **Độ Phức Tạp Thiết Lập** | Trung Bình |
| **Tích Hợp Chính Thức** | Không |
| **Dữ Liệu Đồng Bộ** | Users, Sự Kiện, Campaigns, Catalogs |
| **Loại API** | REST API |
| **Xác Thực** | API Key |
| **URL Cơ Sở** | `https://api.iterable.com/api/` |

## Tính Năng

- **Đồng bộ user profile** - Đồng bộ dữ liệu người dùng hai chiều với contacts Brevo
- **Campaign analytics** - Đồng bộ số liệu send, open và click cho báo cáo hợp nhất
- **Dữ liệu experiment** - Theo dõi kết quả A/B test và winning variants
- **Đồng bộ catalog** - Đồng bộ product và content catalogs giữa các nền tảng
- **Workflow events** - Forward workflow trigger và completion events sang Brevo
- **Đồng bộ channel preference** - Sao chép user communication preferences trong Brevo

## Yêu Cầu

Trước khi bắt đầu, hãy đảm bảo bạn có:

1. Tài khoản Iterable với quyền truy cập API
2. Iterable API key với quyền phù hợp
3. Project ID Iterable của bạn
4. Tài khoản Brevo với quyền truy cập API
5. Tài khoản Tajo với subscription hoạt động

## Xác Thực

Iterable sử dụng API key authentication được truyền trong request header.

### Tạo API Key

1. Đăng nhập vào Iterable dashboard
2. Điều hướng đến **Integrations** > **API Keys**
3. Nhấp **New API Key**
4. Đặt tên là “Tajo Integration”
5. Chọn loại key **Server-side**
6. Cấp các quyền sau:

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

Loại Key Quan Trọng

Luôn sử dụng API key loại **Server-side** cho tích hợp Tajo. Keys Mobile và JavaScript-side có quyền hạn chế và không thể truy cập tất cả endpoints cần thiết.

### Kết Nối với Tajo

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

## Cấu Hình

### Thiết Lập Cơ Bản

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

### Ánh Xạ Trường

Ánh xạ trường người dùng Iterable sang thuộc tính liên hệ Brevo:

```yaml
field_mapping:
  # Trường tiêu chuẩn
  userId: ITERABLE_ID
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phoneNumber: SMS

  # Dữ liệu tương tác
  signupDate: SIGNUP_DATE
  totalPurchases: TOTAL_PURCHASES
  lastPurchaseDate: LAST_PURCHASE

  # Trường tùy chỉnh
  plan_name: PLAN_NAME
  company_size: COMPANY_SIZE
  preferred_channel: PREFERRED_CHANNEL
  lifecycle_stage: LIFECYCLE_STAGE
```

### Cấu Hình Sự Kiện

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

## API Endpoints

Tajo tích hợp với các Iterable API endpoints sau:

| Endpoint | Phương Thức | Mục Đích |
| --- | --- | --- |
| `/users/update` | POST | Cập nhật user profiles |
| `/users/{email}` | GET | Lấy user theo email |
| `/users/bulkUpdate` | POST | Cập nhật users theo lô |
| `/events/track` | POST | Track custom events |
| `/events/trackBulk` | POST | Track events theo lô |
| `/campaigns` | GET | Liệt kê tất cả campaigns |
| `/campaigns/metrics` | GET | Dữ liệu hiệu suất campaign |
| `/experiments/metrics` | GET | Kết quả experiment |
| `/lists` | GET | Liệt kê tất cả user lists |
| `/lists/subscribe` | POST | Thêm users vào list |
| `/lists/unsubscribe` | POST | Xóa users khỏi list |
| `/catalogs/{catalogName}/items` | GET | Lấy catalog items |
| `/channels` | GET | Liệt kê messaging channels |
| `/export/data.json` | GET | Export raw event data |

## Ví Dụ Code

### Khởi Tạo Trình Kết Nối

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

### Đồng Bộ Users

```javascript
// Đồng bộ tăng dần users từ Iterable sang 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
// }
```

### Theo Dõi Sự Kiện

```javascript
// Forward Iterable events sang 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
    }
  }
});
```

### Xử Lý Webhook

```javascript
// Xử lý 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');
});
```

## Giới Hạn Tốc Độ

Iterable áp dụng giới hạn tốc độ dựa trên gói của bạn:

| Gói | Giới Hạn Tốc Độ | Giới Hạn Bulk Endpoint |
| --- | --- | --- |
| **Growth** | 500 yêu cầu/giây | 500 yêu cầu/giây |
| **Enterprise** | Tùy chỉnh | Tùy chỉnh |

Giới hạn endpoint cụ thể:

| Endpoint | Giới Hạn |
| --- | --- |
| `/users/update` | 500 req/s |
| `/users/bulkUpdate` | 500 req/s (1.000 users mỗi request) |
| `/events/track` | 500 req/s |
| `/events/trackBulk` | 500 req/s (8.000 events mỗi request) |
| `/export/data.json` | 4 requests đồng thời |

Bulk Endpoints

Tajo tự động nhóm user updates (tới 1.000 mỗi lần gọi) và event tracks (tới 8.000 mỗi lần gọi) để tối đa hóa thông lượng trong khi duy trì trong giới hạn tốc độ.

## Khắc Phục Sự Cố

### Sự Cố Phổ Biến

| Sự Cố | Nguyên Nhân | Giải Pháp |
| --- | --- | --- |
| 401 Unauthorized | API key không hợp lệ | Xác minh key trong Iterable > Integrations > API Keys |
| Users không đồng bộ | Loại key không khớp | Đảm bảo dùng Server-side API key |
| Thiếu campaign data | Quyền không đủ | Thêm quyền Campaigns Read vào API key |
| Export timeout | Khối lượng dữ liệu lớn | Sử dụng date range filters để giảm kích thước export |
| Users trùng lặp | Định danh không nhất quán | Sử dụng email như định danh chính thức nhất quán |

### Chế Độ Debug

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

### Kiểm Tra Kết Nối

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

## Thực Hành Tốt Nhất

1. **Sử dụng bulk endpoints** - Luôn ưu tiên `bulkUpdate` và `trackBulk` cho khối lượng dữ liệu lớn
2. **Deduplicate theo email** - Sử dụng email như định danh nhất quán giữa Iterable và Brevo
3. **Đồng bộ tăng dần** - Sử dụng date ranges để tránh xử lý lại dữ liệu lịch sử
4. **Ánh xạ channel preferences** - Đồng bộ trạng thái opt-in/opt-out để duy trì tuân thủ
5. **Theo dõi export jobs** - Exports lớn có thể mất thời gian; thiết lập status polling
6. **Kiểm tra với non-production project** - Xác thực mappings trước khi đồng bộ production data

## Bảo Mật

- **Xác thực API Key** - Server-side keys với quyền chi tiết
- **Chỉ HTTPS** - Tất cả giao tiếp API được mã hóa qua TLS 1.2+
- **Key Rotation** - Hỗ trợ nhiều API keys hoạt động đồng thời trong quá trình rotation
- **Lưu trữ mã hóa** - API credentials được mã hóa lúc nghỉ trong Tajo
- **JWT Webhooks** - Webhook payloads được ký bằng JWT để xác minh

## Tài Nguyên Liên Quan

- [Trình Kết Nối Braze](https://tajo.io/vi/docs/connectors/marketing/braze)
- [Trình Kết Nối Customer.io](https://tajo.io/vi/docs/connectors/marketing/customerio)
- [Customer Sync Skill](https://tajo.io/vi/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/vi/docs/contact-management)