Konektor Braze

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

Przegląd

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

Połączenie z Tajo

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

Konfiguracja

Podstawowa konfiguracja

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:

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:

Przykłady kodu

Inicjalizacja konektora

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

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

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

// 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:

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

Rozwiązywanie problemów

Typowe problemy

Tryb debug

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

Test połączenia

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
• Konektor Iterable
• Skill synchronizacji klientów
• Brevo Contacts API