Braze konnektor

Csatlakoztasd a Braze elköteleződési platformot a Brevóhoz egységesített ügyfélprofilokhoz, csatornák közötti kampány-orchestrációhoz és konszolidált marketinganalitikához.

Áttekintés

Funkciók

• Felhasználói profil szinkronizáció – Kétirányú ügyfél-attribútum szinkronizálás a Braze és Brevo között
• Kampányesemény-követés – E-mail megnyitások, kattintások, konverziók és leiratkozások követése
• Canvas flow adatok – Több-lépéses kampányút adatok szinkronizálása egységesített riportoláshoz
• Szegmens-tükrözés – Braze szegmensek replikálása Brevo listákként platformok közötti célzáshoz
• Push értesítés-események – Push elköteleződési adatok továbbítása Brevo kapcsolat-idővonalakra
• Katalógus-szinkronizáció – Termékkatalógusok szinkronizálása személyre szabott ajánlásokhoz

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Braze fiókkal engedélyezett API-hozzáféréssel
2. Egy Braze REST API kulccsal megfelelő jogosultságokkal
3. A Braze példány URL-jével (pl. rest.iad-01.braze.com)
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal aktív előfizetéssel

Hitelesítés

A Braze API kulcs hitelesítést használ. Minden API kulcs adott végpontokra korlátozható.

API kulcs létrehozása

1. Jelentkezz be a Braze dashboardba
2. Menj a Beállítások > API kulcsok menübe
3. Kattints az Új API kulcs létrehozása gombra
4. Nevezd el „Tajo Integration”-nek
5. Engedélyezd a következő jogosultságokat:

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

Csatlakozás a Tajóhoz

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

Konfiguráció

Alapbeállítás

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

Mezőleképezés

Képezd le a Braze felhasználói attribútumokat Brevo kapcsolat-attribútumokhoz:

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 végpontok

A Tajo az alábbi Braze REST API végpontokkal integrálódik:

Kódpéldák

A konnektor inicializálása

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

Felhasználói profilok szinkronizálása

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

Egyéni események követése

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

Szegmensadatok exportálása

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

Ráta-korlátok

A Braze ráta-korlátokat alkalmaz a csomag és a példány alapján:

A /users/track végpontnak alapértelmezés szerint 50 000 kérés/perc a korlátja. A Tajo automatikusan kezeli a ráta-korlátokat exponenciális visszalépéssel.

Hibaelhárítás

Gyakori problémák

Hibakeresési mód

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

Kapcsolat tesztelése

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

Legjobb gyakorlatok

1. Használj növekményes szinkronizálást – Kerüld a teljes exportálásokat; csak az utolsó szinkronizálás óta megváltozott rekordokat szinkronizáld
2. Kötegelj felhasználó-frissítéseket – Csoportosítsd az attribútumváltozásokat az API hívások minimalizálásához
3. Szűkítsd az API kulcsok hatókörét – Csak a szükséges jogosultságokat engedélyezd
4. Figyeld a ráta-korlátokat – Állíts be riasztásokat a Braze ráta-korlátok elérése előtt
5. Egységesen képezd le a külső azonosítókat – Ugyanazt az azonosítót használd a Braze-ben és a Brevóban
6. Először tesztelj sandbox környezetben – Használj Braze teszt munkaterületet az éles bevezetés előtt

Biztonság

• API kulcs hitelesítés – Részletes jogosultságokkal rendelkező hatókörhöz korlátozott API kulcsok
• Csak HTTPS – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva
• IP engedélyezési lista – Opcionális IP korlátozás az API-hozzáféréshez a Braze-ben
• Titkosított tárolás – API hitelesítő adatok titkosítva tárolódnak a Tajóban
• Audit naplózás – Minden API hívás naplózásra kerül megfelelőségi célokból

Kapcsolódó források

• Customer.io konnektor
• Iterable konnektor
• Ügyfél-szinkronizáció Skill
• Brevo Contacts API