---
title: "Braze Connector"
description: "Popoln vodnik za integracijo Braze za sinhronizacijo podatkov o angažiranosti strank, kampanj in sporočilnih dogodkov z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/marketing/braze/
markdown: https://tajo.io/sl/docs/connectors/marketing/braze.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Braze Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži platformo za angažiranje Braze z Brevo za enotne profile strank, orkestracijo kampanj prek kanalov in konsolidirano marketinško analitiko.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | Braze |
| **Kategorija** | Marketing |
| **Zahtevnost nastavitve** | Srednja |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Stranke, dogodki, kampanje, sporočila |
| **Vrsta API** | REST API |
| **Avtentikacija** | API Key |
| **Osnovni URL** | `https://rest.iad-XX.braze.com` (specifično za instanco) |

## Funkcionalnosti

- **Sinhronizacija profilov uporabnikov** – dvosmerna sinhronizacija atributov strank med Braze in Brevo
- **Sledenje dogodkom kampanj** – sledi odpiranjem, klikom, konverzijam in odjavami e-mailov
- **Podatki Canvas flow** – sinhroniziraj podatke potovanj kampanj z več koraki za enotno poročanje
- **Zrcaljenje segmentov** – repliciraj segmente Braze kot sezname Brevo za ciljanje na več platformah
- **Dogodki potisnih obvestil** – posreduj podatke o angažiranosti potisnih obvestil v časovnice stikov Brevo
- **Sinhronizacija kataloga** – sinhroniziraj kataloge izdelkov za personaliziirana priporočila

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Braze z omogočenim dostopom do API
2. API ključ REST Braze z ustreznimi dovoljenji
3. URL tvoje instance Braze (npr. `rest.iad-01.braze.com`)
4. Brevo račun z dostopom do API
5. Tajo račun z aktivno naročnino

## Avtentikacija

Braze za avtentikacijo uporablja API ključe. Vsak API ključ je lahko obsegan na določene končne točke.

### Ustvarjanje API ključa

1. Prijavi se v nadzorno ploščo Braze
2. Pojdi na **Settings** > **API Keys**
3. Klikni **Create New API Key**
4. Poimenuj ga “Tajo Integration”
5. Omogoči naslednja dovoljenja:

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

Varnost API ključa

Shrani API ključ Braze varno. Nikoli ga ne razkrivaj v kodi na strani odjemalca ali javnih repozitorijih. Tajo šifrira vse poverilnice API v mirovanju z AES-256.

### Povezovanje s Tajo

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

## Konfiguracija

### Osnovna nastavitev

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

### Preslikava polj

Preslikaj atribute uporabnikov Braze v atribute stikov 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
```

## Končne točke API

Tajo se integrira z naslednjimi REST API končnimi točkami Braze:

| Končna točka | Metoda | Namen |
| --- | --- | --- |
| `/users/track` | POST | Pošlji atribute, dogodke in nakupe uporabnikov |
| `/users/export/ids` | POST | Izvozi profile uporabnikov po zunanjih ID-jih |
| `/users/export/segment` | POST | Izvozi uporabnike iz segmenta |
| `/campaigns/list` | GET | Pridobi seznam kampanj |
| `/campaigns/data_series` | GET | Analitika kampanj skozi čas |
| `/canvas/list` | GET | Pridobi seznam Canvas flow-ov |
| `/canvas/data_series` | GET | Analitika Canvas skozi čas |
| `/segments/list` | GET | Pridobi seznam segmentov |
| `/email/status` | POST | Spremeni status naročnine na e-mail |
| `/subscription/status/set` | POST | Nastavi status naročniške skupine |
| `/catalogs/{catalog_name}/items` | GET | Pridobi elemente kataloga |

## Primeri kode

### Inicializacija konektorja

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

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

### Sledenje dogodkom po meri

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

## Omejitve hitrosti

Braze uveljavlja omejitve hitrosti glede na tvoj plan in instanco:

| Plan | Omejitev hitrosti | Omejitev sunka |
| --- | --- | --- |
| **Starter** | 250.000 zahtevkov/uro | Ni |
| **Pro** | 250.000 zahtevkov/uro | Ni |
| **Enterprise** | Po meri | Po meri |

Končna točka `/users/track` ima privzeto omejitev 50.000 zahtevkov na minuto. Tajo samodejno obravnava omejevanje hitrosti z eksponentnim odlogom.

Paketni zahtevki

Tajo združuje do 75 atributov uporabnikov, 75 dogodkov in 75 nakupov na zahtevek `/users/track` za maksimizacijo pretoka v okvirih omejitev hitrosti.

## Odpravljanje težav

### Pogoste težave

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| 401 Unauthorized | Neveljaven ali potekel API ključ | Znova ustvari API ključ v nadzorni plošči Braze |
| Uporabniki se ne sinhronizirajo | Napačen URL instance | Preveri URL instance Braze (npr. iad-01, iad-02) |
| Manjkajoči atributi | Obseg API ključa preozek | Dodaj zahtevana dovoljenja API ključu |
| Presežena omejitev hitrosti | Preveč vzporednih zahtevkov | Zmanjšaj velikost paketa ali pogostost sinhronizacije |
| Zakasnjeni dogodki | Velika čakalna vrsta za izvoz | Namesto polnega izvoza uporabi postopno sinhronizacijo |

### Način odpravljanja napak

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

### Preizkus povezave

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

## Najboljše prakse

1. **Uporabi postopne sinhronizacije** – izogibaj se polnim izvozom; sinhroniziraj samo spremembe od zadnje sinhronizacije
2. **Združuj posodobitve uporabnikov** – grupiraj spremembe atributov za minimizacijo klicev API
3. **Obsegaj API ključe ozko** – omogoči samo dovoljenja, ki jih tvoja integracija potrebuje
4. **Sprljuj omejitve hitrosti** – nastavi opozorila pred doseganjem omejitev hitrosti Braze
5. **Dosledno preslikavaj zunanje ID-je** – uporablj isti identifikator v Braze in Brevo
6. **Najprej preizkusi v peskovniku** – pred produkcijsko namestitvijo uporabi testni delovni prostor Braze

## Varnost

- **Avtentikacija z API ključem** – obsegani API ključi z granularnimi dovoljenji
- **Samo HTTPS** – vsa komunikacija API šifrirana prek TLS 1.2+
- **Dovoljenje IP** – neobvezna omejitev IP za dostop do API v Braze
- **Šifrirano shranjevanje** – poverilnice API šifrirane v mirovanju v Tajo
- **Dnevnik revizije** – vsi klici API zabeleženi za pregled skladnosti

## Povezani viri

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