Braze konektor

Poveži svoju Braze platformu za angažovanje sa Brevo za unifikovane profile kupaca, orkestaciju kampanja na više kanala i konsolidovanu marketing analitiku.

Pregled

Karakteristike

• Sinhronizacija profila korisnika - Dvosmerna sinhronizacija atributa kupaca između Braze i Brevo
• Praćenje događaja kampanje - Praćenje otvaranja emailova, klikova, konverzija i odjava
• Podaci Canvas toka - Sinhronizacija podataka višekoračnih putanja kampanje za unifikovano izveštavanje
• Ogledanje segmenata - Replikacija Braze segmenata kao Brevo lista za cross-platform ciljanje
• Događaji push obaveštenja - Prosleđivanje podataka o angažovanju push-om na Brevo vremenske linije kontakta
• Sinhronizacija kataloga - Sinhronizacija kataloga proizvoda za personalizovane preporuke

Preduslovi

Pre nego što započneš, proveri da imaš:

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

Autentifikacija

Braze koristi autentifikaciju API ključem. Svaki API ključ može biti skopovan na specifične endpointe.

Kreiranje API ključa

1. Prijavi se na svoj Braze dashboard
2. Idi na Settings > API Keys
3. Klikni Create New API Key
4. Nazovi ga “Tajo Integration”
5. Omogući sledeć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 sa Tajo

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

Konfiguracija

Osnovno podešavanje

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

Mapiranje Braze atributa korisnika na Brevo atribute kontakta:

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 endpointi

Tajo se integriše sa sledećim Braze REST API endpointima:

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

Sinhronizacija profila korisnika

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

Praćenje prilagođenih događaja

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

Izvoz podataka segmenta

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

Ograničenja brzine

Braze primenjuje ograničenja brzine na osnovu tvog plana i instance:

Endpoint /users/track ima podrazumevani limit od 50.000 zahteva po minutu. Tajo automatski obrađuje ograničenja brzine sa eksponencijalnim usporavanjem.

Rešavanje problema

Česti problemi

Debug režim

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

Testiraj vezu

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

Najbolje prakse

1. Koristi inkrementalne sinhronizacije - Izbegavaj pune izvoze; sinhronizuj samo izmenjene zapise od poslednje sinhronizacije
2. Grupiši ažuriranja korisnika - Grupiši promene atributa da minimizuješ API pozive
3. Usko skopuj API ključeve - Omogući samo dozvole koje tvoja integracija zahteva
4. Prati ograničenja brzine - Postavi upozorenja pre dostizanja Braze ograničenja brzine
5. Dosledno mapiraj spoljne ID-ove - Koristi isti identifikator u Braze i Brevo
6. Prvo testiraj u sandbox-u - Koristi Braze test radni prostor pre produkcijskog implementiranja

Bezbednost

• Autentifikacija API ključem - Skopovani API ključevi sa granularnim dozvolama
• Samo HTTPS - Sva API komunikacija enkriptovana putem TLS 1.2+
• IP Allowlisting - Opcijsko IP ograničenje za API pristup u Braze
• Enkriptovana pohrana - API akreditivi enkriptovani u mirovanju u Tajo
• Logovanje revizije - Svi API pozivi logovani za pregled usklađenosti

Povezani resursi

• Customer.io konektor
• Iterable konektor
• Customer Sync veština
• Brevo Contacts API