---
title: "Braze konektor"
description: "Kompletný sprievodca integráciou Braze na synchronizáciu dát zákazníckeho zapojenia, kampaní a správ s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/marketing/braze/
markdown: https://tajo.io/sk/docs/connectors/marketing/braze.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Braze konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj svoju platformu zapojenia Braze s Brevo pre zjednotené profily zákazníkov, orchestráciu kampaní naprieč kanálmi a konsolidovanú marketingovú analytiku.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Braze |
| **Kategória** | Marketing |
| **Zložitosť nastavenia** | Stredná |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Zákazníci, Udalosti, Kampane, Správy |
| **Typ API** | REST API |
| **Autentifikácia** | API Key |
| **Base URL** | `https://rest.iad-XX.braze.com` (špecifické pre inštanciu) |

## Funkcie

- **Synchronizácia profilov používateľov** - Obojsmerná synchronizácia atribútov zákazníkov medzi Braze a Brevo
- **Sledovanie udalostí kampaní** - Sleduj otvorenia e-mailov, kliknutia, konverzie a odhlásenia
- **Dáta Canvas flow** - Synchronizuj dáta z ciest viacstupňových kampaní pre jednotné reportovanie
- **Zrkadlenie segmentov** - Replikuj segmenty Braze ako zoznamy Brevo pre cielenie naprieč platformami
- **Udalosti push notifikácií** - Preposielaj dáta zapojenia pushov do časových osí kontaktov Brevo
- **Synchronizácia katalógu** - Synchronizuj katalógy produktov pre personalizované odporúčania

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Braze účet s povoleným API prístupom
2. Braze REST API kľúč s príslušnými oprávneniami
3. URL tvojej Braze inštancie (napr. `rest.iad-01.braze.com`)
4. Brevo účet s API prístupom
5. Tajo účet s aktívnym predplatným

## Autentifikácia

Braze používa autentifikáciu API kľúčmi. Každý API kľúč je možné obmedziť na konkrétne endpointy.

### Vytvorenie API kľúča

1. Prihlás sa do svojho Braze dashboardu
2. Prejdi do **Settings** > **API Keys**
3. Klikni na **Create New API Key**
4. Pomenuj ho “Tajo Integration”
5. Povol nasledujúce oprávnenia:

```
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čnosť API kľúča

Uchovávaj svoj Braze API kľúč bezpečne. Nikdy ho nevystavuj v klientskom kóde ani verejných repozitároch. Tajo šifruje všetky API prihlasovací údaje v pokoji pomocou AES-256.

### Pripojenie k Tajo

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

## Konfigurácia

### Základné nastavenie

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

### Mapovanie polí

Namapuj atribúty používateľov Braze na atribúty kontaktov 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 endpointy

Tajo sa integruje s nasledujúcimi Braze REST API endpointmi:

| Endpoint | Metóda | Účel |
| --- | --- | --- |
| `/users/track` | POST | Odosielanie atribútov, udalostí a nákupov používateľov |
| `/users/export/ids` | POST | Export profilov používateľov podľa externých ID |
| `/users/export/segment` | POST | Export používateľov zo segmentu |
| `/campaigns/list` | GET | Načítanie zoznamu kampaní |
| `/campaigns/data_series` | GET | Analytika kampaní v čase |
| `/canvas/list` | GET | Načítanie zoznamu Canvas flows |
| `/canvas/data_series` | GET | Analytika Canvas v čase |
| `/segments/list` | GET | Načítanie zoznamu segmentov |
| `/email/status` | POST | Zmena stavu e-mailového odberu |
| `/subscription/status/set` | POST | Nastavenie stavu skupiny odberov |
| `/catalogs/{catalog_name}/items` | GET | Načítanie položiek katalógu |

## Ukážky kódu

### Inicializácia konektora

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

### Synchronizácia profilov používateľov

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

### Sledovanie vlastných udalostí

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

### Export dát segmentu

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

## Obmedzenia rýchlosti

Braze presadzuje limity rýchlosti na základe tvojho plánu a inštancie:

| Plán | Limit rýchlosti | Burst limit |
| --- | --- | --- |
| **Starter** | 250 000 požiadaviek/hodinu | N/A |
| **Pro** | 250 000 požiadaviek/hodinu | N/A |
| **Enterprise** | Vlastné | Vlastné |

Endpoint `/users/track` má predvolený limit 50 000 požiadaviek za minútu. Tajo automaticky spravuje limity rýchlosti s exponenciálnym backoff.

Dávkové požiadavky

Tajo dávkuje až 75 atribútov používateľov, 75 udalostí a 75 nákupov na požiadavku `/users/track` na maximalizáciu priepustnosti v rámci limitov rýchlosti.

## Riešenie problémov

### Bežné problémy

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| 401 Unauthorized | Neplatný alebo vypršaný API kľúč | Znovu vygeneruj API kľúč v Braze dashboarde |
| Používatelia sa nesynchronizujú | Nesprávna URL inštancie | Overte URL tvojej Braze inštancie (napr. iad-01, iad-02) |
| Chýbajúce atribúty | Scope API kľúča je príliš úzky | Pridaj požadované oprávnenia k API kľúču |
| Prekročený limit rýchlosti | Príliš veľa súbežných požiadaviek | Zmenši veľkosť dávky alebo frekvenciu synchronizácie |
| Oneskorené udalosti | Veľká fronta exportov | Použi inkrementálnu synchronizáciu namiesto plného exportu |

### Debug režim

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

### Test pripojenia

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

## Odporúčané postupy

1. **Použi inkrementálne synchronizácie** - Vyhni sa plným exportom; synchronizuj iba zmenené záznamy od poslednej synchronizácie
2. **Dávkuj aktualizácie používateľov** - Zoskupuj zmeny atribútov na minimalizáciu API volaní
3. **Obmedzuj scope API kľúčov** - Povol iba oprávnenia, ktoré tvoja integrácia potrebuje
4. **Monitoruj limity rýchlosti** - Nastav upozornenia pred dosiahnutím limitov Braze
5. **Konzistentne mapuj externé ID** - Použi rovnaký identifikátor naprieč Braze a Brevo
6. **Najprv testuj v sandboxe** - Použi testovací workspace Braze pred produkčným nasadením

## Bezpečnosť

- **Autentifikácia API kľúčom** - Scoped API kľúče s granulárnnymi oprávneniami
- **Iba HTTPS** - Všetka API komunikácia šifrovaná cez TLS 1.2+
- **IP Allowlisting** - Voliteľné IP obmedzenie pre API prístup v Braze
- **Šifrované úložisko** - API prihlasovací údaje šifrované v pokoji v Tajo
- **Audit logging** - Všetky API volania zaznamenané pre súlad s predpismi

## Súvisiace zdroje

- [Customer.io konektor](https://tajo.io/sk/docs/connectors/marketing/customerio)
- [Iterable konektor](https://tajo.io/sk/docs/connectors/marketing/iterable)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/sk/docs/contact-management)