Коннектор Braze

Подключите платформу вовлечённости Braze к Brevo для создания единых профилей клиентов, оркестрации кросс-канальных кампаний и консолидированной маркетинговой аналитики.

Обзор

Возможности

• Синхронизация профилей пользователей, двунаправленная синхронизация атрибутов клиентов между Braze и Brevo
• Отслеживание событий кампаний, трекинг открытий, кликов, конверсий и отписок email
• Данные Canvas Flow, синхронизация данных многошаговых customer journey для единой отчётности
• Зеркалирование сегментов, репликация сегментов Braze как списков Brevo для кросс-платформенного таргетинга
• События push-уведомлений, пересылка данных о вовлечённости с push-уведомлениями в таймлайны контактов Brevo
• Синхронизация каталога, синхронизация каталогов товаров для персонализированных рекомендаций

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

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

Аутентификация

Braze использует аутентификацию по API-ключу. Каждый ключ можно ограничить конкретными эндпоинтами.

Создание API Key

1. Войдите в дашборд Braze
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:
  # Стандартные поля
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Метрики вовлечённости
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Пользовательские атрибуты
  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'
});

Синхронизация профилей пользователей

// Синхронизация пользователей Braze с контактами Brevo
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Проверка статуса синхронизации
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }

Трекинг пользовательских событий

// Пересылка событий Braze в 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
    }
  }
});

Экспорт данных сегмента

// Экспорт сегмента Braze и создание списка Brevo
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 устанавливает ограничения скорости в зависимости от плана и инстанса:

Эндпоинт /users/track имеет лимит по умолчанию 50 000 запросов в минуту. Tajo автоматически обрабатывает ограничения скорости с экспоненциальной задержкой.

Устранение неполадок

Частые проблемы

Режим отладки

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. Ограничивайте права API-ключей, включайте только те разрешения, которые нужны интеграции
4. Мониторьте ограничения скорости, настройте оповещения до достижения лимитов Braze
5. Используйте согласованные внешние ID, применяйте один и тот же идентификатор в Braze и Brevo
6. Тестируйте в sandbox сначала, используйте тестовое рабочее пространство Braze перед продакшн-деплоем

Безопасность

• Аутентификация по API Key, ключи с гранулярными разрешениями
• Только HTTPS, все API-коммуникации зашифрованы через TLS 1.2+
• IP-разрешение, опциональные IP-ограничения для доступа к API в Braze
• Зашифрованное хранение, API-учётные данные зашифрованы при хранении в Tajo
• Логирование аудита, все API-вызовы логируются для проверки соответствия требованиям

Связанные ресурсы

• Коннектор Customer.io
• Коннектор Iterable
• Скилл синхронизации клиентов
• Brevo Contacts API