---
title: "Braze Bağlayıcısı"
description: "Tajo aracılığıyla müşteri etkileşim verilerini, kampanyaları ve mesajlaşma olaylarını Brevo ile senkronize etmek için eksiksiz Braze entegrasyon rehberi."
url: https://tajo.io/tr/docs/connectors/marketing/braze/
markdown: https://tajo.io/tr/docs/connectors/marketing/braze.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.

# Braze 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 profilleri, çok kanallı kampanya orkestrasyonu ve birleştirilmiş pazarlama analitiği için Braze etkileşim platformunuzu Brevo’ya bağlayın.

## Genel Bakış

| Özellik | Değer |
| --- | --- |
| **Platform** | Braze |
| **Kategori** | Pazarlama |
| **Kurulum Karmaşıklığı** | Orta |
| **Resmi Entegrasyon** | Hayır |
| **Senkronize Edilen Veri** | Müşteriler, Olaylar, Kampanyalar, Mesajlar |
| **API Türü** | REST API |
| **Kimlik Doğrulama** | API Anahtarı |
| **Temel URL** | `https://rest.iad-XX.braze.com` (örneğe özgü) |

## Özellikler

- **Kullanıcı profili senkronizasyonu** - Braze ve Brevo arasında çift yönlü müşteri öznitelik senkronizasyonu
- **Kampanya olay takibi** - E-posta açılmalarını, tıklamaları, dönüşümleri ve abonelikten çıkmaları takip edin
- **Canvas akış verileri** - Birleşik raporlama için çok adımlı kampanya yolculuk verilerini senkronize edin
- **Segment yansıtma** - Çapraz platform hedefleme için Braze segmentlerini Brevo listeleri olarak kopyalayın
- **Push bildirimi olayları** - Push etkileşim verilerini Brevo kişi zaman çizelgelerine iletin
- **Katalog senkronizasyonu** - Kişiselleştirilmiş öneriler için ürün kataloglarını senkronize edin

## Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. API erişimi etkin bir Braze hesabı
2. Uygun izinlere sahip bir Braze REST API anahtarı
3. Braze örnek URL’niz (örn. `rest.iad-01.braze.com`)
4. API erişimi olan bir Brevo hesabı
5. Aktif aboneliği olan bir Tajo hesabı

## Kimlik Doğrulama

Braze API anahtar kimlik doğrulamasını kullanır. Her API anahtarı belirli uç noktalarla kapsamlandırılabilir.

### API Anahtarı Oluşturma

1. Braze panonuza giriş yapın
2. **Settings** > **API Keys** bölümüne gidin
3. **Create New API Key** tıklayın
4. Adını “Tajo Integration” koyun
5. Şu izinleri etkinleştirin:

```
users.track
users.export.ids
users.export.segment
campaigns.list
campaigns.data_series
canvas.list
canvas.data_series
segments.list
segments.data_series
email.status
subscription.status.set
catalogs.list_items
```

API Anahtarı Güvenliği

Braze API anahtarınızı güvenli bir şekilde saklayın. Asla istemci tarafı kodda veya genel depolarda göstermeyin. Tajo, tüm API kimlik bilgilerini AES-256 kullanarak durağan halde şifreler.

### Tajo’ya Bağlanma

```bash
tajo connectors install braze \
  --api-key $BRAZE_API_KEY \
  --instance-url rest.iad-01.braze.com
```

## Yapılandırma

### Temel Kurulum

```yaml
connectors:
  braze:
    enabled: true
    instance_url: "rest.iad-01.braze.com"
    api_version: "v1"

    sync:
      users: true
      campaigns: true
      canvases: true
      segments: true
      events: true

    lists:
      engaged_users: 10
      dormant_users: 11
```

### Alan Eşleme

Braze kullanıcı özniteliklerini Brevo kişi özniteliklerine eşleyin:

```yaml
field_mapping:
  # Standard fields
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Custom attributes
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE
```

## API Uç Noktaları

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

| Uç Nokta | Yöntem | Amaç |
| --- | --- | --- |
| `/users/track` | POST | Kullanıcı özniteliklerini, olayları ve satın almaları gönder |
| `/users/export/ids` | POST | Harici kimliklere göre kullanıcı profillerini dışa aktar |
| `/users/export/segment` | POST | Bir segmentten kullanıcıları dışa aktar |
| `/campaigns/list` | GET | Kampanya listesini al |
| `/campaigns/data_series` | GET | Zaman içinde kampanya analitiği |
| `/canvas/list` | GET | Canvas akışları listesini al |
| `/canvas/data_series` | GET | Zaman içinde Canvas analitiği |
| `/segments/list` | GET | Segment listesini al |
| `/email/status` | POST | E-posta abonelik durumunu değiştir |
| `/subscription/status/set` | POST | Abonelik grubu durumunu ayarla |
| `/catalogs/{catalog_name}/items` | GET | Katalog öğelerini al |

## 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('braze', {
  apiKey: process.env.BRAZE_API_KEY,
  instanceUrl: 'rest.iad-01.braze.com'
});
```

### Kullanıcı Profillerini Senkronize Et

```javascript
// Sync Braze users to Brevo contacts
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Check sync status
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }
```

### Özel Olayları Takip Et

```javascript
// Forward Braze events to Brevo
await tajo.connectors.handleEvent('braze', {
  type: 'user.event',
  payload: {
    external_id: 'user_12345',
    name: 'product_viewed',
    properties: {
      product_id: 'SKU-789',
      category: 'electronics',
      price: 299.99
    }
  }
});
```

### Segment Verilerini Dışa Aktar

```javascript
// Export a Braze segment and create a Brevo list
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Exported ${result.count} users to Brevo list 15`);
```

## Hız Limitleri

Braze, planınıza ve örneğinize göre hız limitleri uygular:

| Plan | Hız Limiti | Patlama Limiti |
| --- | --- | --- |
| **Starter** | 250.000 istek/saat | Yok |
| **Pro** | 250.000 istek/saat | Yok |
| **Enterprise** | Özel | Özel |

`/users/track` uç noktasının varsayılan limiti dakikada 50.000 istektir. Tajo, üstel geri çekilme ile hız sınırlamasını otomatik olarak yönetir.

Toplu İstekler

Tajo, hız limitleri içinde verimliliği maksimize etmek için her `/users/track` isteği başına 75 kullanıcı özniteliği, 75 olay ve 75 satın almayı toplu hale getirir.

## Sorun Giderme

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

| Sorun | Neden | Çözüm |
| --- | --- | --- |
| 401 Unauthorized | Geçersiz veya süresi dolmuş API anahtarı | Braze panosunda API anahtarını yeniden oluşturun |
| Kullanıcılar senkronize edilmiyor | Yanlış örnek URL’si | Braze örnek URL’nizi doğrulayın (örn. iad-01, iad-02) |
| Eksik öznitelikler | API anahtar kapsamı çok dar | API anahtarına gerekli izinleri ekleyin |
| Hız limiti aşıldı | Çok fazla eşzamanlı istek | Toplu boyutunu veya senkronizasyon sıklığını azaltın |
| Olaylar gecikiyor | Büyük dışa aktarma kuyruğu | Tam dışa aktarma yerine artımlı senkronizasyon kullanın |

### Hata Ayıklama Modu

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

### Bağlantıyı Test Et

```bash
tajo connectors test braze
# ✓ API connection successful
# ✓ User export accessible
# ✓ Campaign data readable
# ✓ Segment list accessible
# ✓ Event tracking operational
```

## En İyi Uygulamalar

1. **Artımlı senkronizasyon kullanın** - Tam dışa aktarmadan kaçının; yalnızca son senkronizasyondan beri değişen kayıtları senkronize edin
2. **Kullanıcı güncellemelerini gruplandırın** - API çağrılarını minimize etmek için öznitelik değişikliklerini gruplandırın
3. **API anahtarlarını dar kapsamlandırın** - Yalnızca entegrasyonunuzun ihtiyacı olan izinleri etkinleştirin
4. **Hız limitlerini izleyin** - Braze hız limitlerine ulaşmadan önce uyarılar kurun
5. **Harici kimlikleri tutarlı eşleyin** - Braze ve Brevo’da aynı tanımlayıcıyı kullanın
6. **Önce sandbox’ta test edin** - Üretim dağıtımından önce bir Braze test çalışma alanı kullanın

## Güvenlik

- **API Anahtar Kimlik Doğrulaması** - Ayrıntılı izinlerle kapsamlandırılmış API anahtarları
- **Yalnızca HTTPS** - Tüm API iletişimi TLS 1.2+ aracılığıyla şifrelenir
- **IP İzin Listesi** - Braze’de API erişimi için isteğe bağlı IP kısıtlaması
- **Şifreli Depolama** - Tajo’da API kimlik bilgileri durağan halde şifrelenir
- **Denetim Günlüğü** - Uyumluluk incelemesi için tüm API çağrıları günlüklenir

## İlgili Kaynaklar

- [Customer.io Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/customerio)
- [Iterable Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/iterable)
- [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)