Braze Konektor

Povežite svoju Braze platformu za angažman s Brevom za ujedinjene korisničke profile, orkestaciju kampanja na više kanala i konsolidirane marketinške analitike.

Pregled

Značajke

• Sinkronizacija korisničkih profila - Dvosmjerna sinkronizacija atributa korisnika između Brazea i Breva
• Praćenje događaja kampanja - Praćenje otvaranja, klikova, konverzija i odjava e-maila
• Podaci Canvas toka - Sinkronizacija podataka o putovanjima kampanje s više koraka za ujedinjeno izvješćivanje
• Zrcaljenje segmenata - Replikacija Braze segmenata kao Brevo popisa za ciljanje na više platformi
• Događaji push obavijesti - Prosljeđivanje podataka o angažmanu push notifikacija na Brevo vremenske osi kontakata
• Sinkronizacija kataloga - Sinkronizacija kataloga proizvoda za personalizirane preporuke

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Braze račun s omogućenim API pristupom
2. Braze REST API ključ s odgovarajućim dozvolama
3. Vaš Braze URL instance (npr. rest.iad-01.braze.com)
4. Brevo račun s API pristupom
5. Tajo račun s aktivnom pretplatom

Autentifikacija

Braze koristi autentifikaciju API ključem. Svaki API ključ može biti opsežen na specifične krajnje točke.

Kreiranje API ključa

1. Prijavite se na vaš Braze dashboard
2. Navigirajte do Postavke > API ključevi
3. Kliknite Kreiraj novi API ključ
4. Nazovite ga “Tajo integracija”
5. Omogućite sljedeće dozvole:

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

Povezivanje s Tajom

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

Konfiguracija

Osnovna konfiguracija

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

Mapiranje polja

Mapirajte atribute Braze korisnika na Brevo atribute kontakata:

field_mapping:
  # Standardna polja
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Metrike angažmana
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Prilagođeni atributi
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE

API krajnje točke

Tajo se integrira s sljedećim Braze REST API krajnjim točkama:

Primjeri koda

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

Sinkronizacija korisničkih profila

// Sinkronizacija Braze korisnika s Brevo kontaktima
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Provjera statusa sinkronizacije
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }

Praćenje prilagođenih događaja

// Prosljeđivanje Braze događaja u 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 podataka segmenta

// Izvoz Braze segmenta i kreiranje Brevo popisa
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Izvezeno ${result.count} korisnika na Brevo popis 15`);

Ograničenja brzine

Braze primjenjuje ograničenja brzine na temelju vašeg plana i instance:

Krajnja točka /users/track ima zadano ograničenje od 50.000 zahtjeva u minuti. Tajo automatski rukuje ograničenjem brzine s eksponencijalnim povratkom.

Rješavanje problema

Uobičajeni problemi

Način otklanjanja grešaka

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

Testiranje veze

tajo connectors test braze
# ✓ API veza uspješna
# ✓ Izvoz korisnika dostupan
# ✓ Podaci o kampanjama čitljivi
# ✓ Popis segmenata dostupan
# ✓ Praćenje događaja operativno

Preporučene prakse

1. Koristite inkrementalne sinkronizacije - Izbjegavajte potpune izvoze; sinkronizirajte samo promijenjene zapise od posljednje sinkronizacije
2. Skupna ažuriranja korisnika - Grupiranje promjena atributa za minimiziranje API poziva
3. Usko opsežite API ključeve - Omogućite samo dozvole koje vaša integracija zahtijeva
4. Pratite ograničenja brzine - Postavite upozorenja prije dosizanja Braze ograničenja brzine
5. Dosljedno mapirajte vanjske ID-ove - Koristite isti identifikator u Brazeu i Brevo
6. Testirajte u sandbox-u prvo - Koristite Braze testni radni prostor prije produkcijskog raspoređivanja

Sigurnost

• Autentifikacija API ključem - Opseženi API ključevi s granularnim dozvolama
• Samo HTTPS - Sva API komunikacija šifrirana putem TLS 1.2+
• Lista dopuštenih IP-ova - Opcionalno IP ograničenje za API pristup u Brazeu
• Šifrirano pohranjivanje - API vjerodajnice šifrirane u mirovanju u Taju
• Revizijsko zapisivanje - Svi API pozivi zapisani za pregled usklađenosti

Povezani resursi

• Customer.io Konektor
• Iterable Konektor
• Vještina sinkronizacije korisnika
• Brevo API kontakata