---
title: "Braze konektor"
description: "Kompletan vodič za Braze integraciju za sinhronizaciju podataka o angažovanju kupaca, kampanja i događaja poruka sa Brevo putem Tajo."
url: https://tajo.io/sr/docs/connectors/marketing/braze/
markdown: https://tajo.io/sr/docs/connectors/marketing/braze.md
lang: sr-Latn-RS
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslaćemo vam vezu za potvrdu zahteva za pristup Taju.

# Braze konektor

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

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

Poveži svoju Braze platformu za angažovanje sa Brevo za unifikovane profile kupaca, orkestaciju kampanja na više kanala i konsolidovanu marketing analitiku.

## Pregled

| Svojstvo | Vrednost |
| --- | --- |
| **Platforma** | Braze |
| **Kategorija** | Marketing |
| **Složenost podešavanja** | Srednje |
| **Zvanična integracija** | Ne |
| **Sinhronizovani podaci** | Kupci, Događaji, Kampanje, Poruke |
| **Tip API-ja** | REST API |
| **Autentifikacija** | API Key |
| **Osnovni URL** | `https://rest.iad-XX.braze.com` (specifično za instancu) |

## Karakteristike

- **Sinhronizacija profila korisnika** - Dvosmerna sinhronizacija atributa kupaca između Braze i Brevo
- **Praćenje događaja kampanje** - Praćenje otvaranja emailova, klikova, konverzija i odjava
- **Podaci Canvas toka** - Sinhronizacija podataka višekoračnih putanja kampanje za unifikovano izveštavanje
- **Ogledanje segmenata** - Replikacija Braze segmenata kao Brevo lista za cross-platform ciljanje
- **Događaji push obaveštenja** - Prosleđivanje podataka o angažovanju push-om na Brevo vremenske linije kontakta
- **Sinhronizacija kataloga** - Sinhronizacija kataloga proizvoda za personalizovane preporuke

## Preduslovi

Pre nego što započneš, proveri da imaš:

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

## Autentifikacija

Braze koristi autentifikaciju API ključem. Svaki API ključ može biti skopovan na specifične endpointe.

### Kreiranje API ključa

1. Prijavi se na svoj Braze dashboard
2. Idi na **Settings** > **API Keys**
3. Klikni **Create New API Key**
4. Nazovi ga “Tajo Integration”
5. Omogući sledeć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
```

Bezbednost API ključa

Čuvaj Braze API ključ bezbedno. Nikada ga ne izlažuj u klijentskom kodu ili javnim repozitorijumima. Tajo enkriptuje sve API akreditive u mirovanju koristeći AES-256.

### Povezivanje sa Tajo

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

## Konfiguracija

### Osnovno podešavanje

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

Mapiranje Braze atributa korisnika na Brevo atribute kontakta:

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

Tajo se integriše sa sledećim Braze REST API endpointima:

| Endpoint | Metoda | Namena |
| --- | --- | --- |
| `/users/track` | POST | Slanje atributa korisnika, događaja i kupovina |
| `/users/export/ids` | POST | Izvoz profila korisnika po spoljnim ID-ovima |
| `/users/export/segment` | POST | Izvoz korisnika iz segmenta |
| `/campaigns/list` | GET | Dohvatanje liste kampanja |
| `/campaigns/data_series` | GET | Analitika kampanja tokom vremena |
| `/canvas/list` | GET | Dohvatanje liste Canvas tokova |
| `/canvas/data_series` | GET | Analitika Canvas-a tokom vremena |
| `/segments/list` | GET | Dohvatanje liste segmenata |
| `/email/status` | POST | Promena statusa email pretplate |
| `/subscription/status/set` | POST | Postavljanje statusa grupe pretplata |
| `/catalogs/{catalog_name}/items` | GET | Dohvatanje stavki kataloga |

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

### Sinhronizacija profila korisnika

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

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

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

### Izvoz podataka segmenta

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

## Ograničenja brzine

Braze primenjuje ograničenja brzine na osnovu tvog plana i instance:

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

Endpoint `/users/track` ima podrazumevani limit od 50.000 zahteva po minutu. Tajo automatski obrađuje ograničenja brzine sa eksponencijalnim usporavanjem.

Batch zahtevi

Tajo grupišu do 75 atributa korisnika, 75 događaja i 75 kupovina po zahtevu `/users/track` za maksimizovanje propusnog opsega unutar ograničenja brzine.

## Rešavanje problema

### Česti problemi

| Problem | Uzrok | Rešenje |
| --- | --- | --- |
| 401 Unauthorized | Nevažeći ili istekli API ključ | Regeneriši API ključ u Braze dashboard-u |
| Korisnici se ne sinhronizuju | Pogrešan URL instance | Verifikuj URL Braze instance (npr. iad-01, iad-02) |
| Nedostaju atributi | Preuski skop API ključa | Dodaj potrebne dozvole API ključu |
| Prekoračen limit brzine | Previše istovremenih zahteva | Smanji veličinu batch-a ili učestalost sinhronizacije |
| Kašnjenje događaja | Veliki red izvoza | Koristi inkrementalnu sinhronizaciju umesto punog izvoza |

### Debug režim

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

### Testiraj vezu

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

## Najbolje prakse

1. **Koristi inkrementalne sinhronizacije** - Izbegavaj pune izvoze; sinhronizuj samo izmenjene zapise od poslednje sinhronizacije
2. **Grupiši ažuriranja korisnika** - Grupiši promene atributa da minimizuješ API pozive
3. **Usko skopuj API ključeve** - Omogući samo dozvole koje tvoja integracija zahteva
4. **Prati ograničenja brzine** - Postavi upozorenja pre dostizanja Braze ograničenja brzine
5. **Dosledno mapiraj spoljne ID-ove** - Koristi isti identifikator u Braze i Brevo
6. **Prvo testiraj u sandbox-u** - Koristi Braze test radni prostor pre produkcijskog implementiranja

## Bezbednost

- **Autentifikacija API ključem** - Skopovani API ključevi sa granularnim dozvolama
- **Samo HTTPS** - Sva API komunikacija enkriptovana putem TLS 1.2+
- **IP Allowlisting** - Opcijsko IP ograničenje za API pristup u Braze
- **Enkriptovana pohrana** - API akreditivi enkriptovani u mirovanju u Tajo
- **Logovanje revizije** - Svi API pozivi logovani za pregled usklađenosti

## Povezani resursi

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