---
title: "Braze Konektor"
description: "Kompletan vodič za integraciju Brazea za sinkronizaciju podataka o angažmanu korisnika, kampanjama i porukama s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/marketing/braze/
markdown: https://tajo.io/hr/docs/connectors/marketing/braze.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# Braze Konektor

Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor.

| Izvorno polje | Odredišno polje | Primjer vrijednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Povežite svoju Braze platformu za angažman s Brevom za ujedinjene korisničke profile, orkestaciju kampanja na više kanala i konsolidirane marketinške analitike.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Braze |
| **Kategorija** | Marketing |
| **Složenost postavljanja** | Srednje |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Kupci, Događaji, Kampanje, Poruke |
| **Vrsta API-ja** | REST API |
| **Autentifikacija** | API ključ |
| **Osnovni URL** | `https://rest.iad-XX.braze.com` (specifičan za instancu) |

## Značajke

- **Sinkronizacija korisničkih profila** - Dvosmjerna sinkronizacija atributa korisnika između Brazea i Breva
- **Praćenje događaja kampanja** - Praćenje otvaranja, klikova, konverzija i odjava e-maila
- **Podaci Canvas toka** - Sinkronizacija podataka o putovanjima kampanje s više koraka za ujedinjeno izvješćivanje
- **Zrcaljenje segmenata** - Replikacija Braze segmenata kao Brevo popisa za ciljanje na više platformi
- **Događaji push obavijesti** - Prosljeđivanje podataka o angažmanu push notifikacija na Brevo vremenske osi kontakata
- **Sinkronizacija kataloga** - Sinkronizacija kataloga proizvoda za personalizirane preporuke

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Braze račun s omogućenim API pristupom
2. Braze REST API ključ s odgovarajućim dozvolama
3. Vaš Braze URL instance (npr. `rest.iad-01.braze.com`)
4. Brevo račun s API pristupom
5. Tajo račun s aktivnom pretplatom

## Autentifikacija

Braze koristi autentifikaciju API ključem. Svaki API ključ može biti opsežen na specifične krajnje točke.

### Kreiranje API ključa

1. Prijavite se na vaš Braze dashboard
2. Navigirajte do **Postavke** > **API ključevi**
3. Kliknite **Kreiraj novi API ključ**
4. Nazovite ga “Tajo integracija”
5. Omogućite sljedeće dozvole:

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

Sigurnost API ključa

Pohranite vaš Braze API ključ sigurno. Nikada ga ne izlažite u kodu na strani klijenta ili javnim repozitorijima. Tajo šifrira sve API vjerodajnice u mirovanju koristeći AES-256.

### Povezivanje s Tajom

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

## Konfiguracija

### Osnovna konfiguracija

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

### Mapiranje polja

Mapirajte atribute Braze korisnika na Brevo atribute kontakata:

```yaml
field_mapping:
  # Standardna polja
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Metrike angažmana
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Prilagođeni atributi
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE
```

## API krajnje točke

Tajo se integrira s sljedećim Braze REST API krajnjim točkama:

| Krajnja točka | Metoda | Namjena |
| --- | --- | --- |
| `/users/track` | POST | Slanje atributa korisnika, događaja i kupnji |
| `/users/export/ids` | POST | Izvoz korisničkih profila po vanjskim ID-ovima |
| `/users/export/segment` | POST | Izvoz korisnika iz segmenta |
| `/campaigns/list` | GET | Dohvati popis kampanja |
| `/campaigns/data_series` | GET | Analitika kampanje kroz vrijeme |
| `/canvas/list` | GET | Dohvati popis Canvas tokova |
| `/canvas/data_series` | GET | Analitika Canvas-a kroz vrijeme |
| `/segments/list` | GET | Dohvati popis segmenata |
| `/email/status` | POST | Promijeni status pretplate na e-mail |
| `/subscription/status/set` | POST | Postavi status grupe pretplate |
| `/catalogs/{catalog_name}/items` | GET | Dohvati stavke kataloga |

## Primjeri koda

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

### Sinkronizacija korisničkih profila

```javascript
// Sinkronizacija Braze korisnika s Brevo kontaktima
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

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

### Praćenje prilagođenih događaja

```javascript
// Prosljeđivanje Braze događaja u 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
    }
  }
});
```

### Izvoz podataka segmenta

```javascript
// Izvoz Braze segmenta i kreiranje Brevo popisa
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Izvezeno ${result.count} korisnika na Brevo popis 15`);
```

## Ograničenja brzine

Braze primjenjuje ograničenja brzine na temelju vašeg plana i instance:

| Plan | Ograničenje brzine | Burst ograničenje |
| --- | --- | --- |
| **Starter** | 250.000 zahtjeva/sat | N/A |
| **Pro** | 250.000 zahtjeva/sat | N/A |
| **Enterprise** | Prilagođeno | Prilagođeno |

Krajnja točka `/users/track` ima zadano ograničenje od 50.000 zahtjeva u minuti. Tajo automatski rukuje ograničenjem brzine s eksponencijalnim povratkom.

Skupni zahtjevi

Tajo grupira do 75 atributa korisnika, 75 događaja i 75 kupnji po zahtjevu `/users/track` kako bi maksimizirao propusnost unutar ograničenja brzine.

## Rješavanje problema

### Uobičajeni problemi

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| 401 Unauthorized | Nevažeći ili istekli API ključ | Regenerirajte API ključ u Braze dashboardu |
| Korisnici se ne sinkroniziraju | Netočan URL instance | Verificirajte vaš Braze URL instance (npr. iad-01, iad-02) |
| Nedostaju atributi | Preuzak opseg API ključa | Dodajte potrebne dozvole API ključu |
| Premašeno ograničenje brzine | Previše istovremenih zahtjeva | Smanjite veličinu serije ili učestalost sinkronizacije |
| Kašnjenje događaja | Veliki red za izvoz | Koristite inkrementalnu sinkronizaciju umjesto potpunog izvoza |

### Način otklanjanja grešaka

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

### Testiranje veze

```bash
tajo connectors test braze
# ✓ API veza uspješna
# ✓ Izvoz korisnika dostupan
# ✓ Podaci o kampanjama čitljivi
# ✓ Popis segmenata dostupan
# ✓ Praćenje događaja operativno
```

## Preporučene prakse

1. **Koristite inkrementalne sinkronizacije** - Izbjegavajte potpune izvoze; sinkronizirajte samo promijenjene zapise od posljednje sinkronizacije
2. **Skupna ažuriranja korisnika** - Grupiranje promjena atributa za minimiziranje API poziva
3. **Usko opsežite API ključeve** - Omogućite samo dozvole koje vaša integracija zahtijeva
4. **Pratite ograničenja brzine** - Postavite upozorenja prije dosizanja Braze ograničenja brzine
5. **Dosljedno mapirajte vanjske ID-ove** - Koristite isti identifikator u Brazeu i Brevo
6. **Testirajte u sandbox-u prvo** - Koristite Braze testni radni prostor prije produkcijskog raspoređivanja

## Sigurnost

- **Autentifikacija API ključem** - Opseženi API ključevi s granularnim dozvolama
- **Samo HTTPS** - Sva API komunikacija šifrirana putem TLS 1.2+
- **Lista dopuštenih IP-ova** - Opcionalno IP ograničenje za API pristup u Brazeu
- **Šifrirano pohranjivanje** - API vjerodajnice šifrirane u mirovanju u Taju
- **Revizijsko zapisivanje** - Svi API pozivi zapisani za pregled usklađenosti

## Povezani resursi

- [Customer.io Konektor](https://tajo.io/hr/docs/connectors/marketing/customerio)
- [Iterable Konektor](https://tajo.io/hr/docs/connectors/marketing/iterable)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)
- [Brevo API kontakata](https://tajo.io/hr/docs/contact-management)