---
title: "Коннектор Braze"
description: "Полное руководство по интеграции Braze для синхронизации данных о вовлечённости клиентов, кампаний и событий сообщений с Brevo через Tajo."
url: https://tajo.io/ru/docs/connectors/marketing/braze/
markdown: https://tajo.io/ru/docs/connectors/marketing/braze.md
lang: ru-RU
robots: noindex
---

Подайте заявку на ранний доступ

Укажите имя и рабочий адрес электронной почты. Мы отправим ссылку для подтверждения запроса на доступ к Tajo.

# Коннектор Braze

Статус коннектора: Запланирован Ещё не создан. Сегодня Tajo не запускает этот коннектор.

| Поле источника | Поле назначения | Пример значения |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## Обзор

| Свойство | Значение |
| --- | --- |
| **Платформа** | Braze |
| **Категория** | Marketing |
| **Сложность настройки** | Средняя |
| **Официальная интеграция** | Нет |
| **Синхронизируемые данные** | Клиенты, события, кампании, сообщения |
| **Тип API** | REST API |
| **Аутентификация** | API Key |
| **Базовый URL** | `https://rest.iad-XX.braze.com` (зависит от инстанса) |

## Возможности

- **Синхронизация профилей пользователей**, двунаправленная синхронизация атрибутов клиентов между 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
```

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

Храните API-ключ Braze надёжно. Никогда не раскрывайте его в клиентском коде или публичных репозиториях. Tajo шифрует все API-учётные данные при хранении с использованием AES-256.

### Подключение к Tajo

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

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

### Базовая настройка

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

### Сопоставление полей

Сопоставьте атрибуты пользователей Braze с атрибутами контактов Brevo:

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

| Эндпоинт | Метод | Назначение |
| --- | --- | --- |
| `/users/track` | POST | Отправка атрибутов пользователей, событий и покупок |
| `/users/export/ids` | POST | Экспорт профилей пользователей по внешним ID |
| `/users/export/segment` | POST | Экспорт пользователей из сегмента |
| `/campaigns/list` | GET | Получение списка кампаний |
| `/campaigns/data_series` | GET | Аналитика кампаний по времени |
| `/canvas/list` | GET | Получение списка Canvas-потоков |
| `/canvas/data_series` | GET | Аналитика Canvas по времени |
| `/segments/list` | GET | Получение списка сегментов |
| `/email/status` | POST | Изменение статуса подписки на email |
| `/subscription/status/set` | POST | Установка статуса группы подписок |
| `/catalogs/{catalog_name}/items` | GET | Получение элементов каталога |

## Примеры кода

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

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

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

```javascript
// Синхронизация пользователей 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
// }
```

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

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

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

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

| План | Лимит | Burst-лимит |
| --- | --- | --- |
| **Starter** | 250 000 запросов/час | Н/Д |
| **Pro** | 250 000 запросов/час | Н/Д |
| **Enterprise** | Индивидуальный | Индивидуальный |

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

Пакетные запросы

Tajo группирует до 75 атрибутов пользователей, 75 событий и 75 покупок в один запрос `/users/track` для максимальной пропускной способности в пределах лимитов.

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

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

| Проблема | Причина | Решение |
| --- | --- | --- |
| 401 Unauthorized | Недействительный или истёкший API-ключ | Перегенерируйте API-ключ в дашборде Braze |
| Пользователи не синхронизируются | Неверный URL инстанса | Проверьте URL инстанса Braze (например, iad-01, iad-02) |
| Отсутствующие атрибуты | Слишком узкие права API-ключа | Добавьте необходимые разрешения к API-ключу |
| Превышен лимит скорости | Слишком много параллельных запросов | Уменьшите размер пакета или частоту синхронизации |
| Задержка событий | Большая очередь экспорта | Используйте инкрементальную синхронизацию вместо полного экспорта |

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

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

### Проверка подключения

```bash
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](https://tajo.io/ru/docs/connectors/marketing/customerio)
- [Коннектор Iterable](https://tajo.io/ru/docs/connectors/marketing/iterable)
- [Скилл синхронизации клиентов](https://tajo.io/ru/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/ru/docs/contact-management)