---
title: "Braze konnektor"
description: "Teljes Braze integrációs útmutató ügyfél-elköteleződési adatok, kampányok és üzenetküldési események Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/marketing/braze/
markdown: https://tajo.io/hu/docs/connectors/marketing/braze.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Braze konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Braze elköteleződési platformot a Brevóhoz egységesített ügyfélprofilokhoz, csatornák közötti kampány-orchestrációhoz és konszolidált marketinganalitikához.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Braze |
| **Kategória** | Marketing |
| **Telepítés bonyolultsága** | Közepes |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Ügyfelek, Események, Kampányok, Üzenetek |
| **API típus** | REST API |
| **Hitelesítés** | API kulcs |
| **Alap URL** | `https://rest.iad-XX.braze.com` (példány-specifikus) |

## Funkciók

- **Felhasználói profil szinkronizáció** – Kétirányú ügyfél-attribútum szinkronizálás a Braze és Brevo között
- **Kampányesemény-követés** – E-mail megnyitások, kattintások, konverziók és leiratkozások követése
- **Canvas flow adatok** – Több-lépéses kampányút adatok szinkronizálása egységesített riportoláshoz
- **Szegmens-tükrözés** – Braze szegmensek replikálása Brevo listákként platformok közötti célzáshoz
- **Push értesítés-események** – Push elköteleződési adatok továbbítása Brevo kapcsolat-idővonalakra
- **Katalógus-szinkronizáció** – Termékkatalógusok szinkronizálása személyre szabott ajánlásokhoz

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Braze fiókkal engedélyezett API-hozzáféréssel
2. Egy Braze REST API kulccsal megfelelő jogosultságokkal
3. A Braze példány URL-jével (pl. `rest.iad-01.braze.com`)
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal aktív előfizetéssel

## Hitelesítés

A Braze API kulcs hitelesítést használ. Minden API kulcs adott végpontokra korlátozható.

### API kulcs létrehozása

1. Jelentkezz be a Braze dashboardba
2. Menj a **Beállítások** > **API kulcsok** menübe
3. Kattints az **Új API kulcs létrehozása** gombra
4. Nevezd el „Tajo Integration”-nek
5. Engedélyezd a következő jogosultságokat:

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

API kulcs biztonság

Tárold biztonságosan a Braze API kulcsodat. Soha ne tedd ki kliens oldali kódban vagy nyilvános tárolókban. A Tajo AES-256 titkosítással tárolja az összes API hitelesítő adatot.

### Csatlakozás a Tajóhoz

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

## Konfiguráció

### Alapbeállítás

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

### Mezőleképezés

Képezd le a Braze felhasználói attribútumokat Brevo kapcsolat-attribútumokhoz:

```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 végpontok

A Tajo az alábbi Braze REST API végpontokkal integrálódik:

| Végpont | Módszer | Cél |
| --- | --- | --- |
| `/users/track` | POST | Felhasználói attribútumok, események és vásárlások küldése |
| `/users/export/ids` | POST | Felhasználói profilok exportálása külső azonosítók alapján |
| `/users/export/segment` | POST | Felhasználók exportálása szegmensből |
| `/campaigns/list` | GET | Kampányok listájának lekérése |
| `/campaigns/data_series` | GET | Kampányanalitika időbeli bontásban |
| `/canvas/list` | GET | Canvas munkafolyamatok listájának lekérése |
| `/canvas/data_series` | GET | Canvas analitika időbeli bontásban |
| `/segments/list` | GET | Szegmensek listájának lekérése |
| `/email/status` | POST | E-mail előfizetési státusz módosítása |
| `/subscription/status/set` | POST | Előfizetési csoport státuszának beállítása |
| `/catalogs/{catalog_name}/items` | GET | Katalóguselemek lekérése |

## Kódpéldák

### A konnektor inicializálása

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

### Felhasználói profilok szinkronizálása

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

### Egyéni események követése

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

### Szegmensadatok exportálása

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

## Ráta-korlátok

A Braze ráta-korlátokat alkalmaz a csomag és a példány alapján:

| Csomag | Ráta-korlát | Burst korlát |
| --- | --- | --- |
| **Starter** | 250 000 kérés/óra | N/A |
| **Pro** | 250 000 kérés/óra | N/A |
| **Enterprise** | Egyéni | Egyéni |

A `/users/track` végpontnak alapértelmezés szerint 50 000 kérés/perc a korlátja. A Tajo automatikusan kezeli a ráta-korlátokat exponenciális visszalépéssel.

Kötegelt kérések

A Tajo `/users/track` kérésenként legfeljebb 75 felhasználói attribútumot, 75 eseményt és 75 vásárlást kötegelve küld az átviteli teljesítmény maximalizálásához a ráta-korlátokon belül.

## Hibaelhárítás

### Gyakori problémák

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| 401 Unauthorized | Érvénytelen vagy lejárt API kulcs | Generáld újra az API kulcsot a Braze dashboardon |
| Felhasználók nem szinkronizálódnak | Helytelen példány URL | Ellenőrizd a Braze példány URL-t (pl. iad-01, iad-02) |
| Hiányzó attribútumok | Az API kulcs hatóköre túl szűk | Adj hozzá szükséges jogosultságokat az API kulcshoz |
| Ráta-korlát túllépve | Túl sok párhuzamos kérés | Csökkentsd a köteg méretét vagy a szinkronizálás gyakoriságát |
| Késleltetett események | Nagy exportálási sor | Használj növekményes szinkronizálást a teljes exportálás helyett |

### Hibakeresési mód

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

### Kapcsolat tesztelése

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

## Legjobb gyakorlatok

1. **Használj növekményes szinkronizálást** – Kerüld a teljes exportálásokat; csak az utolsó szinkronizálás óta megváltozott rekordokat szinkronizáld
2. **Kötegelj felhasználó-frissítéseket** – Csoportosítsd az attribútumváltozásokat az API hívások minimalizálásához
3. **Szűkítsd az API kulcsok hatókörét** – Csak a szükséges jogosultságokat engedélyezd
4. **Figyeld a ráta-korlátokat** – Állíts be riasztásokat a Braze ráta-korlátok elérése előtt
5. **Egységesen képezd le a külső azonosítókat** – Ugyanazt az azonosítót használd a Braze-ben és a Brevóban
6. **Először tesztelj sandbox környezetben** – Használj Braze teszt munkaterületet az éles bevezetés előtt

## Biztonság

- **API kulcs hitelesítés** – Részletes jogosultságokkal rendelkező hatókörhöz korlátozott API kulcsok
- **Csak HTTPS** – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva
- **IP engedélyezési lista** – Opcionális IP korlátozás az API-hozzáféréshez a Braze-ben
- **Titkosított tárolás** – API hitelesítő adatok titkosítva tárolódnak a Tajóban
- **Audit naplózás** – Minden API hívás naplózásra kerül megfelelőségi célokból

## Kapcsolódó források

- [Customer.io konnektor](https://tajo.io/hu/docs/connectors/marketing/customerio)
- [Iterable konnektor](https://tajo.io/hu/docs/connectors/marketing/iterable)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)