---
title: "Iterable Bağlayıcısı"
description: "Tajo aracılığıyla kullanıcıları, kampanyaları, denemeleri ve etkileşim olaylarını Brevo ile senkronize etmek için eksiksiz Iterable entegrasyon rehberi."
url: https://tajo.io/tr/docs/connectors/marketing/iterable/
markdown: https://tajo.io/tr/docs/connectors/marketing/iterable.md
lang: tr-TR
robots: noindex
---

Erken erişim talep edin

Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz.

# Iterable Bağlayıcısı

Bağlayıcı durumu: Planlandı Henüz oluşturulmadı. Tajo bu bağlayıcıyı bugün çalıştırmıyor.

| Kaynak alanı | Hedef alanı | Örnek değer |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Birleşik müşteri etkileşimi, çok kanallı kampanya koordinasyonu ve pazarlama araçları arasında birleştirilmiş analitik için Iterable büyüme pazarlama platformunuzu Brevo’ya bağlayın.

## Genel Bakış

| Özellik | Değer |
| --- | --- |
| **Platform** | Iterable |
| **Kategori** | Pazarlama |
| **Kurulum Karmaşıklığı** | Orta |
| **Resmi Entegrasyon** | Hayır |
| **Senkronize Edilen Veri** | Kullanıcılar, Olaylar, Kampanyalar, Kataloglar |
| **API Türü** | REST API |
| **Kimlik Doğrulama** | API Anahtarı |
| **Temel URL** | `https://api.iterable.com/api/` |

## Özellikler

- **Kullanıcı profili senkronizasyonu** - Brevo kişileriyle çift yönlü kullanıcı verisi senkronizasyonu
- **Kampanya analitiği** - Birleşik raporlama için kampanya gönderim, açılma ve tıklama metriklerini senkronize edin
- **Deney verileri** - A/B testi sonuçlarını ve kazanan varyantları takip edin
- **Katalog senkronizasyonu** - Platformlar arasında ürün ve içerik kataloglarını senkronize edin
- **İş akışı olayları** - İş akışı tetikleyici ve tamamlama olaylarını Brevo’ya iletin
- **Kanal tercihi senkronizasyonu** - Kullanıcı iletişim tercihlerini Brevo’da kopyalayın

## Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. API erişimi olan bir Iterable hesabı
2. Uygun izinlere sahip bir Iterable API anahtarı
3. Iterable proje kimliğiniz
4. API erişimi olan bir Brevo hesabı
5. Aktif aboneliği olan bir Tajo hesabı

## Kimlik Doğrulama

Iterable, istek başlığında iletilen API anahtar kimlik doğrulamasını kullanır.

### API Anahtarı Oluşturma

1. Iterable panonuza giriş yapın
2. **Integrations** > **API Keys** bölümüne gidin
3. **New API Key** tıklayın
4. Adını “Tajo Integration” koyun
5. **Server-side** anahtar türünü seçin
6. Şu izinleri verin:

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

Anahtar Türü Önemlidir

Tajo entegrasyonu için her zaman bir **Server-side** API anahtarı kullanın. Mobil ve JavaScript tarafı anahtarların kısıtlı izinleri vardır ve gerekli tüm uç noktalara erişemez.

### Tajo’ya Bağlanma

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

## Yapılandırma

### Temel Kurulum

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

### Alan Eşleme

Iterable kullanıcı alanlarını Brevo kişi özniteliklerine eşleyin:

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

### Olay Yapılandırması

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

## API Uç Noktaları

Tajo aşağıdaki Iterable API uç noktalarıyla entegre olur:

| Uç Nokta | Yöntem | Amaç |
| --- | --- | --- |
| `/users/update` | POST | Kullanıcı profillerini güncelle |
| `/users/{email}` | GET | E-postaya göre kullanıcı getir |
| `/users/bulkUpdate` | POST | Toplu kullanıcı güncelle |
| `/events/track` | POST | Özel olayları takip et |
| `/events/trackBulk` | POST | Toplu olay takip et |
| `/campaigns` | GET | Tüm kampanyaları listele |
| `/campaigns/metrics` | GET | Kampanya performans verileri |
| `/experiments/metrics` | GET | Deney sonuçları |
| `/lists` | GET | Tüm kullanıcı listelerini listele |
| `/lists/subscribe` | POST | Bir listeye kullanıcı ekle |
| `/lists/unsubscribe` | POST | Bir listeden kullanıcı kaldır |
| `/catalogs/{catalogName}/items` | GET | Katalog öğelerini al |
| `/channels` | GET | Mesajlaşma kanallarını listele |
| `/export/data.json` | GET | Ham olay verilerini dışa aktar |

## Kod Örnekleri

### Bağlayıcıyı Başlat

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

### Kullanıcıları Senkronize Et

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

### Olayları Takip Et

```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 İşleyici

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

## Hız Limitleri

Iterable, planınıza göre hız limitleri uygular:

| Plan | Hız Limiti | Toplu Uç Nokta Limiti |
| --- | --- | --- |
| **Growth** | 500 istek/saniye | 500 istek/saniye |
| **Enterprise** | Özel | Özel |

Belirli uç nokta limitleri:

| Uç Nokta | Limit |
| --- | --- |
| `/users/update` | 500 istek/sn |
| `/users/bulkUpdate` | 500 istek/sn (istek başına 1.000 kullanıcı) |
| `/events/track` | 500 istek/sn |
| `/events/trackBulk` | 500 istek/sn (istek başına 8.000 olay) |
| `/export/data.json` | 4 eşzamanlı istek |

Toplu Uç Noktalar

Tajo, hız limitleri içinde kalarak verimliliği maksimize etmek için kullanıcı güncellemelerini (çağrı başına 1.000’e kadar) ve olay takiplerini (çağrı başına 8.000’e kadar) otomatik olarak gruplandırır.

## Sorun Giderme

### Sık Karşılaşılan Sorunlar

| Sorun | Neden | Çözüm |
| --- | --- | --- |
| 401 Unauthorized | Geçersiz API anahtarı | Iterable > Integrations > API Keys’te anahtarı doğrulayın |
| Kullanıcılar senkronize edilmiyor | Anahtar türü uyuşmazlığı | Server-side API anahtarı kullandığınızdan emin olun |
| Eksik kampanya verileri | Yetersiz izinler | API anahtarına Campaigns Read izni ekleyin |
| Dışa aktarma zaman aşımı | Büyük veri hacmi | Dışa aktarma boyutunu azaltmak için tarih aralığı filtreleri kullanın |
| Yinelenen kullanıcılar | Tutarsız tanımlayıcılar | E-postayı tutarlı bir şekilde birincil tanımlayıcı olarak kullanın |

### Hata Ayıklama Modu

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

### Bağlantıyı Test Et

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

## En İyi Uygulamalar

1. **Toplu uç noktaları kullanın** - Büyük veri hacimleri için her zaman `bulkUpdate` ve `trackBulk` tercih edin
2. **E-postaya göre tekilleştirin** - Iterable ve Brevo arasında e-postayı tutarlı tanımlayıcı olarak kullanın
3. **Artımlı senkronize edin** - Geçmiş verileri yeniden işlemekten kaçınmak için tarih aralıkları kullanın
4. **Kanal tercihlerini eşleyin** - Uyumluluğu korumak için onay/red durumunu senkronize edin
5. **Dışa aktarma işlerini izleyin** - Büyük dışa aktarmalar zaman alabilir; durum sorgulaması kurun
6. **Üretim dışı projeyle test edin** - Üretim verilerini senkronize etmeden önce eşlemeleri doğrulayın

## Güvenlik

- **API Anahtar Kimlik Doğrulaması** - Ayrıntılı izinlerle Server-side anahtarlar
- **Yalnızca HTTPS** - Tüm API iletişimi TLS 1.2+ aracılığıyla şifrelenir
- **Anahtar Rotasyonu** - Rotasyon sırasında birden fazla aktif API anahtarı desteği
- **Şifreli Depolama** - Tajo’da API kimlik bilgileri durağan halde şifrelenir
- **JWT Webhook’ları** - Webhook yükleri doğrulama için JWT ile imzalanır

## İlgili Kaynaklar

- [Braze Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/braze)
- [Customer.io Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/customerio)
- [Müşteri Senkronizasyon Yeteneği](https://tajo.io/tr/docs/skills/data-sync/customer-sync)
- [Brevo Kişiler API’si](https://tajo.io/tr/docs/contact-management)