Braze конектор

Свържи своята Braze платформа за ангажиране с Brevo за унифицирани клиентски профили, оркестрация на кампании през канали и консолидирана маркетингова аналитика.

Преглед

Функции

• Синхронизация на потребителски профили – Двупосочна синхронизация на атрибути на клиенти между Braze и Brevo
• Проследяване на събития от кампании – Проследявай отваряния на имейли, кликове, конверсии и unsubscribes
• Данни от Canvas потоци – Синхронизирай данни от multi-step campaign journey за унифицирано отчитане
• Mirror-иране на сегменти – Репликирай Braze сегменти като списъци в Brevo за cross-platform таргетиране
• Събития от push известия – Препращай данни за ангажиране с push към timeline-ите на контактите в Brevo
• Синхронизация на каталози – Синхронизирай продуктови каталози за персонализирани препоръки

Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Акаунт в Braze с активиран API достъп
2. Braze REST API ключ с подходящи разрешения
3. Твоя Braze instance URL (напр. rest.iad-01.braze.com)
4. Акаунт в Brevo с API достъп
5. Акаунт в Tajo с активен абонамент

Автентикация

Braze използва автентикация с API ключ. Всеки API ключ може да бъде scoped до конкретни крайни точки.

Създаване на API ключ

1. Влез в своя Braze dashboard
2. Навигирай към Settings > API Keys
3. Щракни върху Create New API Key
4. Наименувай го “Tajo Integration”
5. Активирай следните разрешения:

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

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

Конфигурация

Основна настройка

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

Мапване на полета

Мапвай потребителски атрибути на Braze към атрибути на контактите в 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

API крайни точки

Tajo се интегрира със следните Braze REST API крайни точки:

Примери с код

Инициализация на конектора

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

Синхронизация на потребителски профили

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

Проследяване на персонализирани събития

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

Експорт на данни от сегмент

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

Ограничения на заявките

Braze налага rate limits на базата на плана и инстанцията ти:

Крайната точка /users/track има default лимит от 50 000 заявки в минута. Tajo автоматично обработва rate limiting с exponential backoff.

Отстраняване на проблеми

Чести проблеми

Режим за дебъг

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

Тест на връзката

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

Добри практики

1. Използвай инкрементални синхронизации – Избягвай пълни експорти; синхронизирай само променените записи от последната синхронизация
2. Пакетирай обновленията на потребители – Групирай промените на атрибути, за да минимизираш API извикванията
3. Scope-вай API ключовете тясно – Активирай само разрешенията, от които интеграцията ти се нуждае
4. Мониторирай rate limits – Настрой alert-и преди достигане на Braze rate limits
5. Мапвай external IDs консистентно – Използвай един и същ идентификатор в Braze и Brevo
6. Първо тествай в sandbox – Използвай Braze test workspace преди production deploy

Сигурност

• Автентикация с API ключ – Scoped API ключове с гранулирани разрешения
• Само HTTPS – Цялата API комуникация е криптирана чрез TLS 1.2+
• IP Allowlisting – Опционално IP ограничение за API достъп в Braze
• Криптирано съхранение – API credentials криптирани при съхранение в Tajo
• Audit Logging – Всички API извиквания се логват за compliance прегледи

Свързани ресурси

• Customer.io конектор
• Iterable конектор
• Customer Sync скил
• Brevo Contacts API