Conector Braze

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ă

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

Conectare la Tajo

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

Configurare

Configurare de bază

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:

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:

Exemple de cod

Inițializare conector

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

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

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

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

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

Depanare

Probleme frecvente

Modul de depanare

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

Testare conexiune

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
• Conector Iterable
• Skill Sincronizare clienți
• API Contacte Brevo