Braze konektor

Prepoj svoju platformu zapojenia Braze s Brevo pre zjednotené profily zákazníkov, orchestráciu kampaní naprieč kanálmi a konsolidovanú marketingovú analytiku.

Prehľad

Funkcie

• Synchronizácia profilov používateľov - Obojsmerná synchronizácia atribútov zákazníkov medzi Braze a Brevo
• Sledovanie udalostí kampaní - Sleduj otvorenia e-mailov, kliknutia, konverzie a odhlásenia
• Dáta Canvas flow - Synchronizuj dáta z ciest viacstupňových kampaní pre jednotné reportovanie
• Zrkadlenie segmentov - Replikuj segmenty Braze ako zoznamy Brevo pre cielenie naprieč platformami
• Udalosti push notifikácií - Preposielaj dáta zapojenia pushov do časových osí kontaktov Brevo
• Synchronizácia katalógu - Synchronizuj katalógy produktov pre personalizované odporúčania

Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Braze účet s povoleným API prístupom
2. Braze REST API kľúč s príslušnými oprávneniami
3. URL tvojej Braze inštancie (napr. rest.iad-01.braze.com)
4. Brevo účet s API prístupom
5. Tajo účet s aktívnym predplatným

Autentifikácia

Braze používa autentifikáciu API kľúčmi. Každý API kľúč je možné obmedziť na konkrétne endpointy.

Vytvorenie API kľúča

1. Prihlás sa do svojho Braze dashboardu
2. Prejdi do Settings > API Keys
3. Klikni na Create New API Key
4. Pomenuj ho “Tajo Integration”
5. Povol nasledujúce oprávnenia:

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

Pripojenie k Tajo

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

Konfigurácia

Základné nastavenie

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

Mapovanie polí

Namapuj atribúty používateľov Braze na atribúty kontaktov 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

API endpointy

Tajo sa integruje s nasledujúcimi Braze REST API endpointmi:

Ukážky kódu

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

Synchronizácia profilov používateľov

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

Sledovanie vlastných udalostí

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

Obmedzenia rýchlosti

Braze presadzuje limity rýchlosti na základe tvojho plánu a inštancie:

Endpoint /users/track má predvolený limit 50 000 požiadaviek za minútu. Tajo automaticky spravuje limity rýchlosti s exponenciálnym backoff.

Riešenie problémov

Bežné problémy

Debug režim

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

Test pripojenia

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

Odporúčané postupy

1. Použi inkrementálne synchronizácie - Vyhni sa plným exportom; synchronizuj iba zmenené záznamy od poslednej synchronizácie
2. Dávkuj aktualizácie používateľov - Zoskupuj zmeny atribútov na minimalizáciu API volaní
3. Obmedzuj scope API kľúčov - Povol iba oprávnenia, ktoré tvoja integrácia potrebuje
4. Monitoruj limity rýchlosti - Nastav upozornenia pred dosiahnutím limitov Braze
5. Konzistentne mapuj externé ID - Použi rovnaký identifikátor naprieč Braze a Brevo
6. Najprv testuj v sandboxe - Použi testovací workspace Braze pred produkčným nasadením

Bezpečnosť

• Autentifikácia API kľúčom - Scoped API kľúče s granulárnnymi oprávneniami
• Iba HTTPS - Všetka API komunikácia šifrovaná cez TLS 1.2+
• IP Allowlisting - Voliteľné IP obmedzenie pre API prístup v Braze
• Šifrované úložisko - API prihlasovací údaje šifrované v pokoji v Tajo
• Audit logging - Všetky API volania zaznamenané pre súlad s predpismi

Súvisiace zdroje

• Customer.io konektor
• Iterable konektor
• Customer Sync skill
• Brevo Contacts API