---
title: "Konektor Braze"
description: "Kompletní průvodce integrací Braze pro synchronizaci dat o zapojení zákazníků, kampaní a zpráv s Brevo přes Tajo."
url: https://tajo.io/cz/docs/connectors/marketing/braze/
markdown: https://tajo.io/cz/docs/connectors/marketing/braze.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor Braze

Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propojte svou zapojovací platformu Braze s Brevo pro sjednocené zákaznické profily, orchestraci kampaní napříč kanály a konsolidovanou marketingovou analytiku.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | Braze |
| **Kategorie** | Marketing |
| **Složitost nastavení** | Střední |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Zákazníci, Události, Kampaně, Zprávy |
| **Typ API** | REST API |
| **Ověření** | API klíč |
| **Základní URL** | `https://rest.iad-XX.braze.com` (specifické pro instanci) |

## Funkce

- **Synchronizace uživatelských profilů** – Obousměrná synchronizace atributů zákazníků mezi Braze a Brevo
- **Sledování událostí kampaní** – Sledujte otevření e-mailů, kliknutí, konverze a odhlášení
- **Data toků Canvas** – Synchronizujte data vícekrokových kampaní pro sjednocené reportování
- **Zrcadlení segmentů** – Replikujte segmenty Braze jako seznamy Brevo pro cross-platformní cílení
- **Události push notifikací** – Přeposílejte data o zapojení přes push na časové osy kontaktů Brevo
- **Synchronizace katalogu** – Synchronizujte produktové katalogy pro personalizovaná doporučení

## Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Braze s povoleným přístupem k API
2. REST API klíč Braze s příslušnými oprávněními
3. URL vaší instance Braze (např. `rest.iad-01.braze.com`)
4. Účet Brevo s přístupem k API
5. Účet Tajo s aktivním předplatným

## Ověření

Braze používá ověřování API klíčem. Každý API klíč lze vymezit na konkrétní koncové body.

### Vytvoření API klíče

1. Přihlaste se do svého řídicího panelu Braze
2. Přejděte do **Nastavení** > **API Keys**
3. Klikněte na **Create New API Key**
4. Pojmenujte ho “Tajo Integration”
5. Povolte následující oprávnění:

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

Bezpečnost API klíče

Uchovávejte svůj API klíč Braze bezpečně. Nikdy ho nezveřejňujte v klientském kódu nebo veřejných repozitářích. Tajo šifruje všechny API přihlašovací údaje v klidu pomocí AES-256.

### Připojení k Tajo

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

## Konfigurace

### Základní nastavení

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

### Mapování polí

Mapujte atributy uživatelů Braze na atributy kontaktů Brevo:

```yaml
field_mapping:
  # Standardní pole
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Metriky zapojení
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Vlastní atributy
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE
```

## Koncové body API

Tajo se integruje s následujícími koncovými body Braze REST API:

| Koncový bod | Metoda | Účel |
| --- | --- | --- |
| `/users/track` | POST | Odesílání atributů uživatele, událostí a nákupů |
| `/users/export/ids` | POST | Export uživatelských profilů podle externích ID |
| `/users/export/segment` | POST | Export uživatelů ze segmentu |
| `/campaigns/list` | GET | Načtení seznamu kampaní |
| `/campaigns/data_series` | GET | Analytika kampaní v čase |
| `/canvas/list` | GET | Načtení seznamu toků Canvas |
| `/canvas/data_series` | GET | Analytika Canvas v čase |
| `/segments/list` | GET | Načtení seznamu segmentů |
| `/email/status` | POST | Změna stavu e-mailového předplatného |
| `/subscription/status/set` | POST | Nastavení stavu skupiny předplatného |
| `/catalogs/{catalog_name}/items` | GET | Načtení položek katalogu |

## Příklady kódu

### Inicializace konektoru

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

### Synchronizace uživatelských profilů

```javascript
// Synchronizace uživatelů Braze do kontaktů Brevo
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Kontrola stavu synchronizace
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }
```

### Sledování vlastních událostí

```javascript
// Přeposílání událostí Braze do 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 dat segmentu

```javascript
// Export segmentu Braze a vytvoření seznamu Brevo
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Exportováno ${result.count} uživatelů do seznamu Brevo 15`);
```

## Omezení rychlosti

Braze vynucuje limity rychlosti na základě vašeho plánu a instance:

| Plán | Limit rychlosti | Burst limit |
| --- | --- | --- |
| **Starter** | 250 000 požadavků/hodinu | N/A |
| **Pro** | 250 000 požadavků/hodinu | N/A |
| **Enterprise** | Vlastní | Vlastní |

Koncový bod `/users/track` má výchozí limit 50 000 požadavků za minutu. Tajo automaticky zpracovává omezení rychlosti pomocí exponenciálního zpětného odběrání.

Dávkové požadavky

Tajo sdružuje až 75 atributů uživatelů, 75 událostí a 75 nákupů na požadavek `/users/track` pro maximalizaci propustnosti v rámci limitů rychlosti.

## Řešení problémů

### Časté problémy

| Problém | Příčina | Řešení |
| --- | --- | --- |
| 401 Unauthorized | Neplatný nebo vypršelý API klíč | Znovu vygenerujte API klíč v řídicím panelu Braze |
| Uživatelé se nesynchronizují | Nesprávná URL instance | Ověřte URL své instance Braze (např. iad-01, iad-02) |
| Chybějící atributy | Příliš úzký rozsah API klíče | Přidejte požadovaná oprávnění k API klíči |
| Překročen limit rychlosti | Příliš mnoho souběžných požadavků | Snižte velikost dávky nebo frekvenci synchronizace |
| Zpoždění událostí | Velká fronta exportu | Používejte přírůstkovou synchronizaci místo úplného exportu |

### Režim ladění

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

### Test připojení

```bash
tajo connectors test braze
# ✓ Připojení API úspěšné
# ✓ Export uživatelů přístupný
# ✓ Data kampaní čitelná
# ✓ Seznam segmentů přístupný
# ✓ Sledování událostí funkční
```

## Osvědčené postupy

1. **Používejte přírůstkové synchronizace** – Vyhněte se úplným exportům; synchronizujte pouze změněné záznamy od poslední synchronizace
2. **Dávkujte aktualizace uživatelů** – Skupinujte změny atributů pro minimalizaci volání API
3. **Vymezujte API klíče úzce** – Povolujte pouze oprávnění, která vaše integrace potřebuje
4. **Monitorujte limity rychlosti** – Nastavte upozornění před dosažením limitů rychlosti Braze
5. **Konzistentně mapujte externí ID** – Používejte stejný identifikátor napříč Braze a Brevo
6. **Nejprve testujte v sandboxu** – Používejte testovací workspace Braze před nasazením do produkce

## Zabezpečení

- **Ověřování API klíčem** – Vymezené API klíče s granulárními oprávněními
- **Pouze HTTPS** – Veškerá API komunikace šifrovaná přes TLS 1.2+
- **Whitelisting IP** – Volitelné IP omezení pro přístup k API v Braze
- **Šifrované úložiště** – API přihlašovací údaje šifrované v klidu v Tajo
- **Protokolování auditu** – Všechna volání API protokolována pro kontrolu souladu

## Související zdroje

- [Konektor Customer.io](https://tajo.io/cz/docs/connectors/marketing/customerio)
- [Konektor Iterable](https://tajo.io/cz/docs/connectors/marketing/iterable)
- [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/cz/docs/contact-management)