Konektor Braze

Propojte svou zapojovací platformu Braze s Brevo pro sjednocené zákaznické profily, orchestraci kampaní napříč kanály a konsolidovanou marketingovou analytiku.

Přehled

Funkce

• Synchronizace uživatelských profilů – Obousměrná synchronizace atributů zákazníků mezi Braze a Brevo
• Sledování událostí kampaní – Sledujte otevření e-mailů, kliknutí, konverze a odhlášení
• Data toků Canvas – Synchronizujte data vícekrokových kampaní pro sjednocené reportování
• Zrcadlení segmentů – Replikujte segmenty Braze jako seznamy Brevo pro cross-platformní cílení
• Události push notifikací – Přeposílejte data o zapojení přes push na časové osy kontaktů Brevo
• Synchronizace katalogu – Synchronizujte produktové katalogy pro personalizovaná doporučení

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Braze s povoleným přístupem k API
2. REST API klíč Braze s příslušnými oprávněními
3. URL vaší instance Braze (např. rest.iad-01.braze.com)
4. Účet Brevo s přístupem k API
5. Účet Tajo s aktivním předplatným

Ověření

Braze používá ověřování API klíčem. Každý API klíč lze vymezit na konkrétní koncové body.

Vytvoření API klíče

1. Přihlaste se do svého řídicího panelu Braze
2. Přejděte do Nastavení > API Keys
3. Klikněte na Create New API Key
4. Pojmenujte ho “Tajo Integration”
5. Povolte následující oprávnění:

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

Připojení k Tajo

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

Konfigurace

Základní nastavení

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

Mapování polí

Mapujte atributy uživatelů Braze na atributy kontaktů Brevo:

field_mapping:
  # Standardní pole
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Metriky zapojení
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Vlastní atributy
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE

Koncové body API

Tajo se integruje s následujícími koncovými body Braze REST API:

Příklady kódu

Inicializace konektoru

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

Synchronizace uživatelských profilů

// Synchronizace uživatelů Braze do kontaktů Brevo
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

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

Sledování vlastních událostí

// Přeposílání událostí Braze do 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 dat segmentu

// Export segmentu Braze a vytvoření seznamu Brevo
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Exportováno ${result.count} uživatelů do seznamu Brevo 15`);

Omezení rychlosti

Braze vynucuje limity rychlosti na základě vašeho plánu a instance:

Koncový bod /users/track má výchozí limit 50 000 požadavků za minutu. Tajo automaticky zpracovává omezení rychlosti pomocí exponenciálního zpětného odběrání.

Řešení problémů

Časté problémy

Režim ladění

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

Test připojení

tajo connectors test braze
# ✓ Připojení API úspěšné
# ✓ Export uživatelů přístupný
# ✓ Data kampaní čitelná
# ✓ Seznam segmentů přístupný
# ✓ Sledování událostí funkční

Osvědčené postupy

1. Používejte přírůstkové synchronizace – Vyhněte se úplným exportům; synchronizujte pouze změněné záznamy od poslední synchronizace
2. Dávkujte aktualizace uživatelů – Skupinujte změny atributů pro minimalizaci volání API
3. Vymezujte API klíče úzce – Povolujte pouze oprávnění, která vaše integrace potřebuje
4. Monitorujte limity rychlosti – Nastavte upozornění před dosažením limitů rychlosti Braze
5. Konzistentně mapujte externí ID – Používejte stejný identifikátor napříč Braze a Brevo
6. Nejprve testujte v sandboxu – Používejte testovací workspace Braze před nasazením do produkce

Zabezpečení

• Ověřování API klíčem – Vymezené API klíče s granulárními oprávněními
• Pouze HTTPS – Veškerá API komunikace šifrovaná přes TLS 1.2+
• Whitelisting IP – Volitelné IP omezení pro přístup k API v Braze
• Šifrované úložiště – API přihlašovací údaje šifrované v klidu v Tajo
• Protokolování auditu – Všechna volání API protokolována pro kontrolu souladu

Související zdroje

• Konektor Customer.io
• Konektor Iterable
• Dovednost synchronizace zákazníků
• Brevo Contacts API