---
title: "Braze конектор"
description: "Пълно ръководство за интеграция с Braze за синхронизация на данни за ангажиране на клиенти, кампании и събития от съобщения с Brevo чрез Tajo."
url: https://tajo.io/bg/docs/connectors/marketing/braze/
markdown: https://tajo.io/bg/docs/connectors/marketing/braze.md
lang: bg-BG
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 |
| **Категория** | Маркетинг |
| **Сложност на настройка** | Средна |
| **Официална интеграция** | Не |
| **Синхронизирани данни** | Клиенти, събития, кампании, съобщения |
| **Тип на API** | REST API |
| **Автентикация** | API Key |
| **Base URL** | `https://rest.iad-XX.braze.com` (специфичен за инстанцията) |

## Функции

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

Сигурност на API ключ

Съхранявай своя Braze API ключ сигурно. Никога не го излагай в client-side код или публични хранилища. Tajo криптира всички API credentials при съхранение с 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:
  # 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 крайни точки:

| Крайна точка | Метод | Предназначение |
| --- | --- | --- |
| `/users/track` | POST | Изпращане на потребителски атрибути, събития и покупки |
| `/users/export/ids` | POST | Експорт на потребителски профили по external IDs |
| `/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 | Промяна на статуса на имейл абонамент |
| `/subscription/status/set` | POST | Задаване на статус на subscription group |
| `/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
// 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
// }
```

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

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

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

```javascript
// 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 на базата на плана и инстанцията ти:

| План | Rate Limit | Burst Limit |
| --- | --- | --- |
| **Starter** | 250 000 заявки/час | N/A |
| **Pro** | 250 000 заявки/час | N/A |
| **Enterprise** | Персонализиран | Персонализиран |

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

Batch заявки

Tajo пакетира до 75 потребителски атрибута, 75 събития и 75 покупки на `/users/track` заявка, за да максимизира throughput в рамките на rate limits.

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

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

| Проблем | Причина | Решение |
| --- | --- | --- |
| 401 Unauthorized | Невалиден или изтекъл API ключ | Регенерирай API ключа в Braze dashboard |
| Потребителите не се синхронизират | Неправилен instance URL | Провери своя Braze instance URL (напр. iad-01, iad-02) |
| Липсващи атрибути | Твърде тесен scope на API ключ | Добави необходимите разрешения към API ключа |
| Превишен rate limit | Твърде много едновременни заявки | Намали batch size или честотата на синхронизация |
| Събитията се забавят | Голяма export опашка | Използвай инкрементална синхронизация вместо пълен експорт |

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

```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. **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 конектор](https://tajo.io/bg/docs/connectors/marketing/customerio)
- [Iterable конектор](https://tajo.io/bg/docs/connectors/marketing/iterable)
- [Customer Sync скил](https://tajo.io/bg/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/bg/docs/contact-management)