---
title: "Konektor Braze"
description: "Panduan integrasi Braze lengkap untuk menyinkronkan data engagement pelanggan, kampanye, dan event pesan dengan Brevo melalui Tajo."
url: https://tajo.io/in/docs/connectors/marketing/braze/
markdown: https://tajo.io/in/docs/connectors/marketing/braze.md
lang: id-ID
robots: noindex
---

Ajukan akses awal

Masukkan nama depan dan alamat email kerja Anda. Kami akan mengirim tautan untuk mengonfirmasi permintaan akses Tajo.

# Konektor Braze

Status konektor: Direncanakan Belum dibangun. Tajo belum menjalankan konektor ini.

| Field sumber | Field tujuan | Nilai contoh |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Hubungkan platform engagement Braze Anda ke Brevo untuk profil pelanggan terpadu, orkestrasi kampanye lintas kanal, dan analitik marketing yang terkonsolidasi.

## Ikhtisar

| Properti | Nilai |
| --- | --- |
| **Platform** | Braze |
| **Kategori** | Marketing |
| **Kompleksitas setup** | Menengah |
| **Integrasi resmi** | Tidak |
| **Data yang disinkronkan** | Pelanggan, Event, Kampanye, Pesan |
| **Tipe API** | REST API |
| **Autentikasi** | API Key |
| **URL dasar** | `https://rest.iad-XX.braze.com` (spesifik per instance) |

## Fitur

- **Sinkronisasi profil pengguna** - Sinkronisasi atribut pelanggan dua arah antara Braze dan Brevo
- **Pelacakan event kampanye** - Lacak open email, klik, konversi, dan unsubscribe
- **Data alur Canvas** - Sinkronkan data perjalanan kampanye multi-langkah untuk pelaporan terpadu
- **Pencerminan segmen** - Replikasikan segmen Braze sebagai list Brevo untuk penargetan lintas platform
- **Event push notification** - Teruskan data engagement push ke timeline kontak Brevo
- **Sinkronisasi katalog** - Sinkronkan katalog produk untuk rekomendasi yang dipersonalisasi

## Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Braze dengan akses API yang aktif
2. API key REST Braze dengan izin yang sesuai
3. URL instance Braze Anda (misalnya `rest.iad-01.braze.com`)
4. Akun Brevo dengan akses API
5. Akun Tajo dengan langganan aktif

## Autentikasi

Braze menggunakan autentikasi API key. Setiap API key dapat dibatasi cakupannya ke endpoint tertentu.

### Membuat API key

1. Masuk ke dashboard Braze Anda
2. Buka **Settings** > **API Keys**
3. Klik **Create New API Key**
4. Beri nama “Tajo Integration”
5. Aktifkan izin berikut:

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

Keamanan API key

Simpan API key Braze Anda dengan aman. Jangan pernah menampilkannya di kode sisi klien atau repositori publik. Tajo mengenkripsi seluruh kredensial API saat disimpan menggunakan AES-256.

### Menghubungkan ke Tajo

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

## Konfigurasi

### Setup dasar

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

### Pemetaan field

Petakan atribut pengguna Braze ke atribut kontak Brevo:

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

## Endpoint API

Tajo terintegrasi dengan endpoint REST API Braze berikut:

| Endpoint | Metode | Tujuan |
| --- | --- | --- |
| `/users/track` | POST | Mengirim atribut pengguna, event, dan pembelian |
| `/users/export/ids` | POST | Mengekspor profil pengguna berdasarkan external ID |
| `/users/export/segment` | POST | Mengekspor pengguna dari sebuah segmen |
| `/campaigns/list` | GET | Mengambil daftar kampanye |
| `/campaigns/data_series` | GET | Analitik kampanye dari waktu ke waktu |
| `/canvas/list` | GET | Mengambil daftar alur Canvas |
| `/canvas/data_series` | GET | Analitik Canvas dari waktu ke waktu |
| `/segments/list` | GET | Mengambil daftar segmen |
| `/email/status` | POST | Mengubah status langganan email |
| `/subscription/status/set` | POST | Menetapkan status grup langganan |
| `/catalogs/{catalog_name}/items` | GET | Mengambil item katalog |

## Contoh kode

### Inisialisasi konektor

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

### Sinkronkan profil pengguna

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

### Lacak custom event

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

### Ekspor data segmen

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

## Batas rate

Braze menerapkan batas rate berdasarkan paket dan instance Anda:

| Paket | Batas rate | Batas burst |
| --- | --- | --- |
| **Starter** | 250.000 permintaan/jam | Tidak ada |
| **Pro** | 250.000 permintaan/jam | Tidak ada |
| **Enterprise** | Kustom | Kustom |

Endpoint `/users/track` memiliki batas bawaan 50.000 permintaan per menit. Tajo menangani pembatasan rate secara otomatis dengan exponential backoff.

Permintaan batch

Tajo mengelompokkan hingga 75 atribut pengguna, 75 event, dan 75 pembelian per permintaan `/users/track` untuk memaksimalkan throughput dalam batas rate.

## Pemecahan masalah

### Masalah umum

| Masalah | Penyebab | Solusi |
| --- | --- | --- |
| 401 Unauthorized | API key tidak valid atau kedaluwarsa | Buat ulang API key di dashboard Braze |
| Pengguna tidak tersinkronisasi | URL instance salah | Verifikasi URL instance Braze Anda (misalnya iad-01, iad-02) |
| Atribut hilang | Cakupan API key terlalu sempit | Tambahkan izin yang diperlukan ke API key |
| Batas rate terlampaui | Terlalu banyak permintaan bersamaan | Kurangi ukuran batch atau frekuensi sinkronisasi |
| Event tertunda | Antrean ekspor besar | Gunakan sinkronisasi inkremental alih-alih ekspor penuh |

### Mode debug

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

### Uji koneksi

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

## Praktik terbaik

1. **Gunakan sinkronisasi inkremental** - Hindari ekspor penuh; sinkronkan hanya record yang berubah sejak sinkronisasi terakhir
2. **Perbarui pengguna secara batch** - Kelompokkan perubahan atribut untuk meminimalkan panggilan API
3. **Batasi cakupan API key** - Aktifkan hanya izin yang dibutuhkan integrasi Anda
4. **Pantau batas rate** - Siapkan peringatan sebelum batas rate Braze tercapai
5. **Petakan external ID secara konsisten** - Gunakan identifier yang sama di Braze dan Brevo
6. **Uji di sandbox lebih dulu** - Gunakan workspace uji Braze sebelum deployment produksi

## Keamanan

- **Autentikasi API key** - API key dengan cakupan dan izin granular
- **Hanya HTTPS** - Semua komunikasi API dienkripsi melalui TLS 1.2+
- **Allowlist IP** - Pembatasan IP opsional untuk akses API di Braze
- **Penyimpanan terenkripsi** - Kredensial API dienkripsi saat disimpan di Tajo
- **Audit logging** - Semua panggilan API dicatat untuk keperluan tinjauan kepatuhan

## Sumber terkait

- [Konektor Customer.io](https://tajo.io/in/docs/connectors/marketing/customerio)
- [Konektor Iterable](https://tajo.io/in/docs/connectors/marketing/iterable)
- [Skill Customer Sync](https://tajo.io/in/docs/skills/data-sync/customer-sync)
- [API Kontak Brevo](https://tajo.io/in/docs/contact-management)