---
title: "Braze-koppling"
description: "Komplett integrationsguide för Braze för att synka kundernas engagemangsdata, kampanjer och meddelandehändelser med Brevo via Tajo."
url: https://tajo.io/se/docs/connectors/marketing/braze/
markdown: https://tajo.io/se/docs/connectors/marketing/braze.md
lang: sv-SE
robots: noindex
---

Ansök om tidig åtkomst

Ange ditt förnamn och din e-postadress på jobbet. Vi skickar en länk för att bekräfta din begäran om åtkomst till Tajo.

# Braze-koppling

Kopplingens status: Planerad Inte byggd än. Tajo kör inte den här kopplingen i dag.

| Källfält | Målfält | Exempelvärde |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## Översikt

| Egenskap | Värde |
| --- | --- |
| **Plattform** | Braze |
| **Kategori** | Marknadsföring |
| **Installationskomplexitet** | Måttlig |
| **Officiell integration** | Nej |
| **Data som synkas** | Kunder, händelser, kampanjer, meddelanden |
| **API-typ** | REST API |
| **Autentisering** | API-nyckel |
| **Bas-URL** | `https://rest.iad-XX.braze.com` (instansspecifik) |

## 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
```

Säkerhet för API-nycklar

Lagra din Braze API-nyckel säkert. Exponera den aldrig i klientkod eller publika repon. Tajo krypterar alla API-uppgifter i vila med AES-256.

### Anslut till Tajo

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

## Konfiguration

### Grundläggande konfiguration

```yaml
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:

```yaml
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:

| Ändpunkt | Metod | Syfte |
| --- | --- | --- |
| `/users/track` | POST | Skicka användarattribut, händelser och köp |
| `/users/export/ids` | POST | Exportera användarprofiler efter externa ID:n |
| `/users/export/segment` | POST | Exportera användare från ett segment |
| `/campaigns/list` | GET | Hämta lista över kampanjer |
| `/campaigns/data_series` | GET | Kampanjanalys över tid |
| `/canvas/list` | GET | Hämta lista över Canvas-flöden |
| `/canvas/data_series` | GET | Canvas-analys över tid |
| `/segments/list` | GET | Hämta lista över segment |
| `/email/status` | POST | Ändra prenumerationsstatus för e-post |
| `/subscription/status/set` | POST | Ange status för prenumerationsgrupp |
| `/catalogs/{catalog_name}/items` | GET | Hämta katalogobjekt |

## Kodexempel

### Initiera kopplingen

```javascript
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

```javascript
// 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

```javascript
// 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

```javascript
// 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:

| Plan | Rate limit | Burst-gräns |
| --- | --- | --- |
| **Starter** | 250 000 förfrågningar/timme | – |
| **Pro** | 250 000 förfrågningar/timme | – |
| **Enterprise** | Anpassad | Anpassad |

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

Batchförfrågningar

Tajo batchar upp till 75 användarattribut, 75 händelser och 75 köp per `/users/track`-förfrågan för att maximera genomflödet inom rate limits.

## Felsökning

### Vanliga problem

| Problem | Orsak | Lösning |
| --- | --- | --- |
| 401 Unauthorized | Ogiltig eller utgången API-nyckel | Generera om API-nyckeln i Braze-dashboarden |
| Användare synkas inte | Felaktig instans-URL | Verifiera din Braze-instans-URL (t.ex. iad-01, iad-02) |
| Attribut saknas | API-nyckelns scope är för smalt | Lägg till nödvändiga behörigheter på API-nyckeln |
| Rate limit överskriden | För många samtidiga förfrågningar | Minska batchstorlek eller synkfrekvens |
| Händelser försenade | Stor exportkö | Använd inkrementell synk istället för fullständig export |

### Debug-läge

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

### Testa anslutningen

```bash
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](https://tajo.io/se/docs/connectors/marketing/customerio)
- [Iterable-koppling](https://tajo.io/se/docs/connectors/marketing/iterable)
- [Skill för kundsynk](https://tajo.io/se/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/se/docs/contact-management)