---
title: "Konektor Braze"
description: "Kompletny przewodnik integracji Braze do synchronizacji danych zaangażowania klientów, kampanii i zdarzeń komunikacyjnych z Brevo przez Tajo."
url: https://tajo.io/pl/docs/connectors/marketing/braze/
markdown: https://tajo.io/pl/docs/connectors/marketing/braze.md
lang: pl-PL
robots: noindex
---

Poproś o wcześniejszy dostęp

Podaj imię i firmowy adres e-mail. Wyślemy Ci link potwierdzający prośbę o dostęp do Tajo.

# Konektor Braze

Status konektora: Planowany Jeszcze niezbudowany. Tajo nie uruchamia dziś tego konektora.

| Pole źródłowe | Pole docelowe | Przykładowa wartość |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Połącz swoją platformę zaangażowania Braze z Brevo dla ujednoliconych profili klientów, wielokanałowej orkiestracji kampanii i skonsolidowanej analityki marketingowej.

## Przegląd

| Właściwość | Wartość |
| --- | --- |
| **Platforma** | Braze |
| **Kategoria** | Marketing |
| **Poziom konfiguracji** | Średni |
| **Integracja oficjalna** | Nie |
| **Synchronizowane dane** | Klienci, Zdarzenia, Kampanie, Wiadomości |
| **Typ API** | REST API |
| **Uwierzytelnianie** | Klucz API |
| **Bazowy URL** | `https://rest.iad-XX.braze.com` (specyficzny dla instancji) |

## Funkcje

- **Synchronizacja profili użytkowników** - Dwukierunkowa synchronizacja atrybutów klientów między Braze a Brevo
- **Śledzenie zdarzeń kampanii** - Śledź otwarcia e-maili, kliknięcia, konwersje i rezygnacje
- **Dane przepływów Canvas** - Synchronizuj dane wieloetapowych podróży kampanii dla ujednoliconego raportowania
- **Dublowanie segmentów** - Replikuj segmenty Braze jako listy Brevo dla targetowania wieloplatformowego
- **Zdarzenia powiadomień push** - Przekazuj dane zaangażowania push do osi czasu kontaktów Brevo
- **Synchronizacja katalogu** - Synchronizuj katalogi produktów dla spersonalizowanych rekomendacji

## Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

1. Konto Braze z włączonym dostępem do API
2. Klucz REST API Braze z odpowiednimi uprawnieniami
3. URL instancji Braze (np. `rest.iad-01.braze.com`)
4. Konto Brevo z dostępem do API
5. Konto Tajo z aktywną subskrypcją

## Uwierzytelnianie

Braze używa uwierzytelniania kluczem API. Każdy klucz API może być ograniczony do konkretnych endpointów.

### Tworzenie klucza API

1. Zaloguj się do dashboardu Braze
2. Przejdź do **Settings** > **API Keys**
3. Kliknij **Create New API Key**
4. Nadaj mu nazwę “Tajo Integration”
5. Włącz następujące uprawnienia:

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

Bezpieczeństwo klucza API

Przechowuj klucz API Braze w bezpiecznym miejscu. Nigdy nie ujawniaj go w kodzie po stronie klienta ani publicznych repozytoriach. Tajo szyfruje wszystkie poświadczenia API w stanie spoczynku za pomocą AES-256.

### Połączenie z Tajo

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

## Konfiguracja

### Podstawowa konfiguracja

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

### Mapowanie pól

Mapuj atrybuty użytkowników Braze na atrybuty kontaktów 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
```

## Endpointy API

Tajo integruje się z następującymi endpointami REST API Braze:

| Endpoint | Metoda | Przeznaczenie |
| --- | --- | --- |
| `/users/track` | POST | Wysyłaj atrybuty użytkownika, zdarzenia i zakupy |
| `/users/export/ids` | POST | Eksportuj profile użytkowników po zewnętrznych ID |
| `/users/export/segment` | POST | Eksportuj użytkowników z segmentu |
| `/campaigns/list` | GET | Pobierz listę kampanii |
| `/campaigns/data_series` | GET | Analityka kampanii w czasie |
| `/canvas/list` | GET | Pobierz listę przepływów Canvas |
| `/canvas/data_series` | GET | Analityka Canvas w czasie |
| `/segments/list` | GET | Pobierz listę segmentów |
| `/email/status` | POST | Zmień status subskrypcji e-mail |
| `/subscription/status/set` | POST | Ustaw status grupy subskrypcji |
| `/catalogs/{catalog_name}/items` | GET | Pobierz elementy katalogu |

## Przykłady kodu

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

### Synchronizuj profile użytkowników

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

### Śledź niestandardowe zdarzenia

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

### Eksportuj dane segmentu

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

## Limity API

Braze egzekwuje limity szybkości na podstawie planu i instancji:

| Plan | Limit szybkości | Limit burst |
| --- | --- | --- |
| **Starter** | 250 000 żądań/godzinę | Nie dotyczy |
| **Pro** | 250 000 żądań/godzinę | Nie dotyczy |
| **Enterprise** | Niestandardowy | Niestandardowy |

Endpoint `/users/track` ma domyślny limit 50 000 żądań na minutę. Tajo automatycznie obsługuje ograniczanie szybkości z wykładniczym wycofaniem.

Żądania wsadowe

Tajo grupuje do 75 atrybutów użytkownika, 75 zdarzeń i 75 zakupów na żądanie `/users/track`, aby zmaksymalizować przepustowość w ramach limitów szybkości.

## Rozwiązywanie problemów

### Typowe problemy

| Problem | Przyczyna | Rozwiązanie |
| --- | --- | --- |
| 401 Unauthorized | Nieprawidłowy lub wygasły klucz API | Wygeneruj ponownie klucz API w dashboardzie Braze |
| Użytkownicy się nie synchronizują | Nieprawidłowy URL instancji | Zweryfikuj URL instancji Braze (np. iad-01, iad-02) |
| Brakujące atrybuty | Zbyt wąski zakres klucza API | Dodaj wymagane uprawnienia do klucza API |
| Przekroczono limit szybkości | Zbyt wiele równoczesnych żądań | Zmniejsz rozmiar partii lub częstotliwość synchronizacji |
| Opóźnione zdarzenia | Duża kolejka eksportu | Używaj synchronizacji przyrostowej zamiast pełnego eksportu |

### Tryb debug

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

### Test połączenia

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

## Najlepsze praktyki

1. **Używaj synchronizacji przyrostowej** - Unikaj pełnych eksportów; synchronizuj tylko zmienione rekordy od ostatniej synchronizacji
2. **Grupuj aktualizacje użytkowników** - Grupuj zmiany atrybutów, aby zminimalizować wywołania API
3. **Ogranicz zakresy kluczy API** - Włączaj tylko uprawnienia potrzebne dla integracji
4. **Monitoruj limity szybkości** - Ustaw alerty przed osiągnięciem limitów Braze
5. **Mapuj zewnętrzne ID spójnie** - Używaj tego samego identyfikatora w Braze i Brevo
6. **Najpierw testuj w sandboxie** - Używaj przestrzeni roboczej testowej Braze przed wdrożeniem produkcyjnym

## Bezpieczeństwo

- **Uwierzytelnianie kluczem API** - Klucze API z zakresem i szczegółowymi uprawnieniami
- **Tylko HTTPS** - Cała komunikacja API szyfrowana przez TLS 1.2+
- **Allowlisting IP** - Opcjonalne ograniczenie IP dla dostępu do API w Braze
- **Szyfrowane przechowywanie** - Poświadczenia API szyfrowane w stanie spoczynku w Tajo
- **Logowanie audytowe** - Wszystkie wywołania API rejestrowane dla przeglądu zgodności

## Powiązane zasoby

- [Konektor Customer.io](https://tajo.io/pl/docs/connectors/marketing/customerio)
- [Konektor Iterable](https://tajo.io/pl/docs/connectors/marketing/iterable)
- [Skill synchronizacji klientów](https://tajo.io/pl/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/pl/docs/contact-management)