---
title: "Conector Braze"
description: "Ghid complet de integrare Braze pentru sincronizarea datelor de implicare a clienților, campaniilor și evenimentelor de mesagerie cu Brevo prin Tajo."
url: https://tajo.io/ro/docs/connectors/marketing/braze/
markdown: https://tajo.io/ro/docs/connectors/marketing/braze.md
lang: ro-RO
robots: noindex
---

Solicită acces anticipat

Introduceți prenumele și adresa de e-mail profesională. Vă vom trimite un link pentru a confirma cererea de acces la Tajo.

# Conector Braze

Starea conectorului: Planificat Încă neconstruit. Tajo nu rulează astăzi acest conector.

| Câmp sursă | Câmp destinație | Valoare exemplu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Conectați platforma de implicare Braze la Brevo pentru profiluri unificate ale clienților, orchestrare de campanii cross-canal și analize de marketing consolidate.

## Prezentare generală

| Proprietate | Valoare |
| --- | --- |
| **Platformă** | Braze |
| **Categorie** | Marketing |
| **Complexitate configurare** | Moderată |
| **Integrare oficială** | Nu |
| **Date sincronizate** | Clienți, Evenimente, Campanii, Mesaje |
| **Tip API** | REST API |
| **Autentificare** | Cheie API |
| **URL de bază** | `https://rest.iad-XX.braze.com` (specific instanței) |

## Funcționalități

- **Sincronizare profil utilizator** - Sincronizare bidirecțională a atributelor clienților între Braze și Brevo
- **Urmărire evenimente campanie** - Urmăriți deschiderile, clicurile, conversiile și dezabonările din e-mailuri
- **Date flux Canvas** - Sincronizați datele campaniei în mai mulți pași pentru raportare unificată
- **Oglindire segmente** - Replicați segmentele Braze ca liste Brevo pentru targetare cross-platformă
- **Evenimente notificări push** - Redirecționați datele de implicare push la cronologiile de contact Brevo
- **Sincronizare catalog** - Sincronizați cataloagele de produse pentru recomandări personalizate

## Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un cont Braze cu acces API activat
2. O cheie API REST Braze cu permisiunile corespunzătoare
3. URL-ul instanței Braze (ex: `rest.iad-01.braze.com`)
4. Un cont Brevo cu acces API
5. Un cont Tajo cu abonament activ

## Autentificare

Braze utilizează autentificarea cu cheie API. Fiecare cheie API poate fi configurată cu scope pentru puncte finale specifice.

### Creare cheie API

1. Autentificați-vă în tabloul de bord Braze
2. Navigați la **Settings** > **API Keys**
3. Faceți clic pe **Create New API Key**
4. Numiți-o “Tajo Integration”
5. Activați următoarele permisiuni:

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

Securitate cheie API

Stocați cheia API Braze în siguranță. Nu o expuneți niciodată în codul client sau în depozitele publice. Tajo criptează toate credențialele API în repaus folosind AES-256.

### Conectare la Tajo

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

## Configurare

### Configurare de bază

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

### Mapare câmpuri

Mapați atributele utilizatorilor Braze la atributele de contact 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
```

## Puncte finale API

Tajo se integrează cu următoarele puncte finale REST API Braze:

| Punct final | Metodă | Scop |
| --- | --- | --- |
| `/users/track` | POST | Trimite atribute utilizator, evenimente și achiziții |
| `/users/export/ids` | POST | Exportă profiluri utilizator după ID-uri externe |
| `/users/export/segment` | POST | Exportă utilizatori dintr-un segment |
| `/campaigns/list` | GET | Recuperează lista de campanii |
| `/campaigns/data_series` | GET | Analitice campanii în timp |
| `/canvas/list` | GET | Recuperează lista de fluxuri Canvas |
| `/canvas/data_series` | GET | Analitice Canvas în timp |
| `/segments/list` | GET | Recuperează lista de segmente |
| `/email/status` | POST | Modifică statusul abonamentului e-mail |
| `/subscription/status/set` | POST | Setează statusul grupului de abonamente |
| `/catalogs/{catalog_name}/items` | GET | Recuperează articolele din catalog |

## Exemple de cod

### Inițializare conector

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

### Sincronizare profiluri utilizatori

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

### Urmărire evenimente personalizate

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

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

## Limite de rată

Braze aplică limite de rată bazate pe planul și instanța dvs.:

| Plan | Limită de rată | Limită burst |
| --- | --- | --- |
| **Starter** | 250.000 cereri/oră | N/A |
| **Pro** | 250.000 cereri/oră | N/A |
| **Enterprise** | Personalizat | Personalizat |

Punctul final `/users/track` are o limită implicită de 50.000 de cereri per minut. Tajo gestionează automat limitarea ratei cu backoff exponențial.

Cereri în lot

Tajo grupează până la 75 de atribute utilizator, 75 de evenimente și 75 de achiziții per cerere `/users/track` pentru a maximiza debitul în cadrul limitelor de rată.

## Depanare

### Probleme frecvente

| Problemă | Cauză | Soluție |
| --- | --- | --- |
| 401 Neautorizat | Cheie API invalidă sau expirată | Regenerați cheia API în tabloul de bord Braze |
| Utilizatori nesincronizați | URL instanță incorect | Verificați URL-ul instanței Braze (ex: iad-01, iad-02) |
| Atribute lipsă | Scope cheie API prea restrâns | Adăugați permisiunile necesare cheii API |
| Limită de rată depășită | Prea multe cereri concurente | Reduceți dimensiunea lotului sau frecvența sincronizării |
| Evenimente întârziate | Coadă de export mare | Utilizați sincronizare incrementală în loc de export complet |

### Modul de depanare

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

### Testare conexiune

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

## Bune practici

1. **Utilizați sincronizări incrementale** - Evitați exporturile complete; sincronizați doar înregistrările modificate de la ultima sincronizare
2. **Grupați actualizările utilizatorilor** - Grupați modificările atributelor pentru a minimiza apelurile API
3. **Configurați cheile API cu scope restrâns** - Activați doar permisiunile necesare integrării dvs.
4. **Monitorizați limitele de rată** - Configurați alerte înainte de atingerea limitelor de rată Braze
5. **Mapați ID-urile externe consistent** - Utilizați același identificator în Braze și Brevo
6. **Testați mai întâi în sandbox** - Utilizați un spațiu de lucru de test Braze înainte de implementarea în producție

## Securitate

- **Autentificare cu cheie API** - Chei API cu scope cu permisiuni granulare
- **Numai HTTPS** - Toate comunicațiile API criptate prin TLS 1.2+
- **Allowlisting IP** - Restricție IP opțională pentru accesul API în Braze
- **Stocare criptată** - Credențiale API criptate în repaus în Tajo
- **Jurnalizare audit** - Toate apelurile API înregistrate pentru revizuire conformitate

## Resurse conexe

- [Conector Customer.io](https://tajo.io/ro/docs/connectors/marketing/customerio)
- [Conector Iterable](https://tajo.io/ro/docs/connectors/marketing/iterable)
- [Skill Sincronizare clienți](https://tajo.io/ro/docs/skills/data-sync/customer-sync)
- [API Contacte Brevo](https://tajo.io/ro/docs/contact-management)