Braze Connector

Poveži platformo za angažiranje Braze z Brevo za enotne profile strank, orkestracijo kampanj prek kanalov in konsolidirano marketinško analitiko.

Pregled

Funkcionalnosti

• Sinhronizacija profilov uporabnikov – dvosmerna sinhronizacija atributov strank med Braze in Brevo
• Sledenje dogodkom kampanj – sledi odpiranjem, klikom, konverzijam in odjavami e-mailov
• Podatki Canvas flow – sinhroniziraj podatke potovanj kampanj z več koraki za enotno poročanje
• Zrcaljenje segmentov – repliciraj segmente Braze kot sezname Brevo za ciljanje na več platformah
• Dogodki potisnih obvestil – posreduj podatke o angažiranosti potisnih obvestil v časovnice stikov Brevo
• Sinhronizacija kataloga – sinhroniziraj kataloge izdelkov za personaliziirana priporočila

Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Braze z omogočenim dostopom do API
2. API ključ REST Braze z ustreznimi dovoljenji
3. URL tvoje instance Braze (npr. rest.iad-01.braze.com)
4. Brevo račun z dostopom do API
5. Tajo račun z aktivno naročnino

Avtentikacija

Braze za avtentikacijo uporablja API ključe. Vsak API ključ je lahko obsegan na določene končne točke.

Ustvarjanje API ključa

1. Prijavi se v nadzorno ploščo Braze
2. Pojdi na Settings > API Keys
3. Klikni Create New API Key
4. Poimenuj ga “Tajo Integration”
5. Omogoči naslednja dovoljenja:

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

Povezovanje s Tajo

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

Konfiguracija

Osnovna nastavitev

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

Preslikava polj

Preslikaj atribute uporabnikov Braze v atribute stikov 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

Končne točke API

Tajo se integrira z naslednjimi REST API končnimi točkami Braze:

Primeri kode

Inicializacija konektorja

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 profilov uporabnikov

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

Sledenje dogodkom po meri

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

Omejitve hitrosti

Braze uveljavlja omejitve hitrosti glede na tvoj plan in instanco:

Končna točka /users/track ima privzeto omejitev 50.000 zahtevkov na minuto. Tajo samodejno obravnava omejevanje hitrosti z eksponentnim odlogom.

Odpravljanje težav

Pogoste težave

Način odpravljanja napak

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

Preizkus povezave

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

Najboljše prakse

1. Uporabi postopne sinhronizacije – izogibaj se polnim izvozom; sinhroniziraj samo spremembe od zadnje sinhronizacije
2. Združuj posodobitve uporabnikov – grupiraj spremembe atributov za minimizacijo klicev API
3. Obsegaj API ključe ozko – omogoči samo dovoljenja, ki jih tvoja integracija potrebuje
4. Sprljuj omejitve hitrosti – nastavi opozorila pred doseganjem omejitev hitrosti Braze
5. Dosledno preslikavaj zunanje ID-je – uporablj isti identifikator v Braze in Brevo
6. Najprej preizkusi v peskovniku – pred produkcijsko namestitvijo uporabi testni delovni prostor Braze

Varnost

• Avtentikacija z API ključem – obsegani API ključi z granularnimi dovoljenji
• Samo HTTPS – vsa komunikacija API šifrirana prek TLS 1.2+
• Dovoljenje IP – neobvezna omejitev IP za dostop do API v Braze
• Šifrirano shranjevanje – poverilnice API šifrirane v mirovanju v Tajo
• Dnevnik revizije – vsi klici API zabeleženi za pregled skladnosti

Povezani viri

• Customer.io Connector
• Iterable Connector
• Customer Sync Skill
• Brevo Contacts API