Braze-koppling

Anslut din Braze-engagemangsplattform till Brevo för enhetliga kundprofiler, orkestrering av kampanjer över kanaler och konsoliderad marknadsföringsanalys.

Översikt

Funktioner

• Synk av användarprofiler - Dubbelriktad synkronisering av kundattribut mellan Braze och Brevo
• Spårning av kampanjhändelser - Spåra öppningar, klick, konverteringar och avprenumerationer
• Canvas-flödesdata - Synka data från kampanjresor i flera steg för enhetlig rapportering
• Spegling av segment - Replikera Braze-segment som Brevo-listor för målinriktning över plattformar
• Händelser för push-notiser - Vidarebefordra push-engagemangsdata till kontakternas tidslinjer i Brevo
• Katalogsynk - Synka produktkataloger för personaliserade rekommendationer

Förutsättningar

Innan du börjar, se till att du har:

1. Ett Braze-konto med API-åtkomst aktiverad
2. En Braze REST API-nyckel med lämpliga behörigheter
3. Din Braze-instans-URL (t.ex. rest.iad-01.braze.com)
4. Ett Brevo-konto med API-åtkomst
5. Ett Tajo-konto med aktivt abonnemang

Autentisering

Braze använder autentisering med API-nyckel. Varje API-nyckel kan scopas till specifika ändpunkter.

Skapa en API-nyckel

1. Logga in på din Braze-dashboard
2. Navigera till Settings > API Keys
3. Klicka på Create New API Key
4. Namnge den “Tajo Integration”
5. Aktivera följande behörigheter:

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

Anslut till Tajo

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

Konfiguration

Grundläggande konfiguration

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

Fältmappning

Mappa Braze-användarattribut till Brevo-kontaktattribut:

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-ändpunkter

Tajo integrerar med följande Braze REST API-ändpunkter:

Kodexempel

Initiera kopplingen

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

Synka användarprofiler

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

Spåra anpassade händelser

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

Exportera segmentdata

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

API-gränser

Braze tillämpar rate limits baserat på din plan och instans:

Ändpunkten /users/track har en standardgräns på 50 000 förfrågningar per minut. Tajo hanterar rate limiting automatiskt med exponentiell backoff.

Felsökning

Vanliga problem

Debug-läge

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

Testa anslutningen

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

Bästa praxis

1. Använd inkrementella synkar - Undvik fullständiga exporter; synka endast ändrade poster sedan senaste synkron
2. Batcha användaruppdateringar - Gruppera attributändringar för att minimera API-anrop
3. Scopea API-nycklar snävt - Aktivera endast de behörigheter din integration behöver
4. Övervaka rate limits - Sätt upp varningar innan du slår i Braze rate limits
5. Mappa externa ID:n konsekvent - Använd samma identifierare i både Braze och Brevo
6. Testa i sandbox först - Använd en Braze-testarbetsyta innan produktiondeploy

Säkerhet

• API-nyckelautentisering - Scope-baserade API-nycklar med granulära behörigheter
• Endast HTTPS - All API-kommunikation krypteras via TLS 1.2+
• IP-allowlist - Valbar IP-begränsning för API-åtkomst i Braze
• Krypterad lagring - API-uppgifter krypterade i vila i Tajo
• Revisionsloggning - Alla API-anrop loggas för efterlevnadsgranskning

Relaterade resurser

• Customer.io-koppling
• Iterable-koppling
• Skill för kundsynk
• Brevo Contacts API