Konektor Braze

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

Ikhtisar

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

Menghubungkan ke Tajo

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

Konfigurasi

Setup dasar

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:

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:

Contoh kode

Inisialisasi konektor

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

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

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

// 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:

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

Pemecahan masalah

Masalah umum

Mode debug

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

Uji koneksi

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
• Konektor Iterable
• Skill Customer Sync
• API Kontak Brevo