---
title: "Braze Connector"
description: "Komplet guide til Braze-integration til synkronisering af kundeengagementdata, kampagner og beskedhændelser med Brevo via Tajo."
url: https://tajo.io/dk/docs/connectors/marketing/braze/
markdown: https://tajo.io/dk/docs/connectors/marketing/braze.md
lang: da-DK
robots: noindex
---

Bed om tidlig adgang til Tajo

Indtast dit fornavn og din arbejds-e-mailadresse. Vi sender dig et link til at bekræfte din anmodning om adgang til Tajo.

# Braze Connector

Connectorstatus: Planlagt Ikke bygget endnu. Tajo kører ikke denne connector i dag.

| Kildefelt | Destinationsfelt | Eksempelværdi |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Forbind din Braze-engagementplatform til Brevo for forenede kundeprofiler, tværkanal-kampagneorkestrering og konsoliderede marketinganalyser.

## Oversigt

| Egenskab | Værdi |
| --- | --- |
| **Platform** | Braze |
| **Kategori** | Marketing |
| **Opsætningskompleksitet** | Moderat |
| **Officiel integration** | Nej |
| **Synkroniserede data** | Kunder, hændelser, kampagner, beskeder |
| **API-type** | REST API |
| **Autentifikation** | API-nøgle |
| **Base-URL** | `https://rest.iad-XX.braze.com` (instansspecifik) |

## Funktioner

- **Synkronisering af brugerprofiler** - Tovejssynkronisering af kundeattributter mellem Braze og Brevo
- **Sporing af kampagnehændelser** - Spor e-mailåbninger, klik, konverteringer og afmeldinger
- **Canvas flow-data** - Synkronisér data fra flertrinskampagnerejser til forenet rapportering
- **Segmentspejling** - Replicér Braze-segmenter som Brevo-lister til tværplatformsmålretning
- **Push-notifikationshændelser** - Videresend push-engagementdata til Brevo-kontakt-tidslinjer
- **Katalogsynkronisering** - Synkronisér produktkataloger til personaliserede anbefalinger

## Forudsætninger

Før du begynder, skal du sikre dig, at du har:

1. En Braze-konto med API-adgang aktiveret
2. En Braze REST API-nøgle med passende rettigheder
3. Din Braze-instans-URL (f.eks. `rest.iad-01.braze.com`)
4. En Brevo-konto med API-adgang
5. En Tajo-konto med et aktivt abonnement

## Autentifikation

Braze bruger API-nøgle-autentifikation. Hver API-nøgle kan scopes til specifikke endpoints.

### Oprettelse af en API-nøgle

1. Log ind på dit Braze-dashboard
2. Navigér til **Settings** > **API Keys**
3. Klik **Create New API Key**
4. Navngiv den “Tajo Integration”
5. Aktivér følgende rettigheder:

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

Sikkerhed for API-nøgler

Opbevar din Braze API-nøgle sikkert. Eksponér den aldrig i klientside-kode eller offentlige repositories. Tajo krypterer alle API-legitimationsoplysninger i hvile med AES-256.

### Forbind til Tajo

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

## Konfiguration

### Grundlæggende opsætning

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

### Feltmapping

Knyt Braze-brugerattributter til Brevo-kontaktattributter:

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

Tajo integrerer med følgende Braze REST API-endpoints:

| Endpoint | Metode | Formål |
| --- | --- | --- |
| `/users/track` | POST | Send brugerattributter, hændelser og køb |
| `/users/export/ids` | POST | Eksportér brugerprofiler efter eksterne id’er |
| `/users/export/segment` | POST | Eksportér brugere fra et segment |
| `/campaigns/list` | GET | Hent liste over kampagner |
| `/campaigns/data_series` | GET | Kampagneanalyse over tid |
| `/canvas/list` | GET | Hent liste over Canvas-flows |
| `/canvas/data_series` | GET | Canvas-analyse over tid |
| `/segments/list` | GET | Hent liste over segmenter |
| `/email/status` | POST | Skift e-mailabonnementsstatus |
| `/subscription/status/set` | POST | Sæt abonnementsgruppestatus |
| `/catalogs/{catalog_name}/items` | GET | Hent katalogelementer |

## Kodeeksempler

### Initialisér konnektor

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

### Synkronisér brugerprofiler

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

### Spor brugerdefinerede 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
    }
  }
});
```

### Eksportér 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`);
```

## Ratebegrænsninger

Braze håndhæver ratebegrænsninger baseret på din plan og instans:

| Plan | Ratebegrænsning | Burst-grænse |
| --- | --- | --- |
| **Starter** | 250.000 forespørgsler/time | N/A |
| **Pro** | 250.000 forespørgsler/time | N/A |
| **Enterprise** | Tilpasset | Tilpasset |

Endpointet `/users/track` har en standardgrænse på 50.000 forespørgsler per minut. Tajo håndterer automatisk ratebegrænsning med eksponentiel backoff.

Batch-forespørgsler

Tajo batcher op til 75 brugerattributter, 75 hændelser og 75 køb per `/users/track`-forespørgsel for at maksimere gennemstrømning inden for ratebegrænsninger.

## Fejlfinding

### Almindelige problemer

| Problem | Årsag | Løsning |
| --- | --- | --- |
| 401 Unauthorized | Ugyldig eller udløbet API-nøgle | Regenerér API-nøgle i Braze-dashboard |
| Brugere synkroniseres ikke | Forkert instans-URL | Verificér din Braze-instans-URL (f.eks. iad-01, iad-02) |
| Manglende attributter | API-nøglens scope er for smalt | Tilføj påkrævede rettigheder til API-nøglen |
| Ratebegrænsning overskredet | For mange samtidige forespørgsler | Reducér batchstørrelse eller synkroniseringsfrekvens |
| Hændelser forsinkes | Stor eksportkø | Brug inkrementel synkronisering i stedet for fuld eksport |

### Fejlfindingstilstand

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

### Test forbindelse

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

## Best practices

1. **Brug inkrementelle synkroniseringer** - Undgå fulde eksporter; synkronisér kun ændrede poster siden sidste synkronisering
2. **Batch-brugeropdateringer** - Gruppér attributændringer for at minimere API-kald
3. **Scope API-nøgler smalt** - Aktivér kun de rettigheder, din integration har brug for
4. **Overvåg ratebegrænsninger** - Opsæt advarsler, før du rammer Braze-ratebegrænsninger
5. **Map eksterne id’er konsekvent** - Brug samme identifikator på tværs af Braze og Brevo
6. **Test først i sandbox** - Brug et Braze-testworkspace før produktionsdeployment

## Sikkerhed

- **API-nøgle-autentifikation** - Scoped API-nøgler med granulære rettigheder
- **Kun HTTPS** - Al API-kommunikation krypteret via TLS 1.2+
- **IP-allowlisting** - Valgfri IP-restriktion for API-adgang i Braze
- **Krypteret lagring** - API-legitimationsoplysninger krypteres i hvile i Tajo
- **Revisionslogning** - Alle API-kald logges til compliance-gennemgang

## Relaterede ressourcer

- [Customer.io Connector](https://tajo.io/dk/docs/connectors/marketing/customerio)
- [Iterable Connector](https://tajo.io/dk/docs/connectors/marketing/iterable)
- [Customer Sync Skill](https://tajo.io/dk/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/dk/docs/contact-management)