Braze Bağlayıcısı

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ış

Ö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

Tajo’ya Bağlanma

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

Yapılandırma

Temel Kurulum

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:

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:

Kod Örnekleri

Bağlayıcıyı Başlat

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

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

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

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

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

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

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

Bağlantıyı Test Et

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ı
• Iterable Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği
• Brevo Kişiler API’si