---
title: "Braze-kobling"
description: "Fullstendig Braze-integrasjonsveiledning for synkronisering av kundeengasjementsdata, kampanjer og meldingshendelser med Brevo via Tajo."
url: https://tajo.io/no/docs/connectors/marketing/braze/
markdown: https://tajo.io/no/docs/connectors/marketing/braze.md
lang: no-NO
robots: noindex
---

Be om tidlig tilgang

Skriv inn fornavn og e-postadresse på jobb. Vi sender deg en lenke for å bekrefte forespørselen om tilgang til Tajo.

# Braze-kobling

Koblingsstatus: Planlagt Ikke bygget ennå. Tajo kjører ikke denne koblingen i dag.

| Kildefelt | Målfelt | Eksempelverdi |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Koble Braze-engasjementsplattformen din til Brevo for enhetlige kundeprofiler, tverrkanalskampanjeorkestrering og konsolidert markedsføringsanalyse.

## Oversikt

| Egenskap | Verdi |
| --- | --- |
| **Plattform** | Braze |
| **Kategori** | Markedsføring |
| **Oppsettskompleksitet** | Moderat |
| **Offisiell integrasjon** | Nei |
| **Synkroniserte data** | Kunder, hendelser, kampanjer, meldinger |
| **API-type** | REST API |
| **Autentisering** | API-nøkkel |
| **Base URL** | `https://rest.iad-XX.braze.com` (instansspesifikk) |

## Funksjoner

- **Synkronisering av brukerprofiler** - Toveis synkronisering av kundeattributter mellom Braze og Brevo
- **Sporing av kampanjehendelser** - Spor e-poståpninger, klikk, konverteringer og avmeldinger
- **Canvas-flytdata** - Synkroniser data fra flerstegs-kampanjereiser for enhetlig rapportering
- **Segmentspeiling** - Replikér Braze-segmenter som Brevo-lister for tverrplattform-målretting
- **Push-varselhendelser** - Videresend push-engasjementsdata til Brevo-kontakttidslinjer
- **Katalogsynkronisering** - Synkroniser produktkataloger for personaliserte anbefalinger

## Forutsetninger

Før du begynner, sørg for at du har:

1. En Braze-konto med API-tilgang aktivert
2. En Braze REST API-nøkkel med passende rettigheter
3. Din Braze-instans-URL (f.eks. `rest.iad-01.braze.com`)
4. En Brevo-konto med API-tilgang
5. En Tajo-konto med aktivt abonnement

## Autentisering

Braze bruker API-nøkkelautentisering. Hver API-nøkkel kan avgrenses til spesifikke endepunkter.

### Opprette en API-nøkkel

1. Logg inn på Braze-dashbordet ditt
2. Gå til **Settings** > **API Keys**
3. Klikk **Create New API Key**
4. Gi den navnet “Tajo Integration”
5. Aktiver følgende rettigheter:

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

API-nøkkelsikkerhet

Lagre Braze API-nøkkelen din sikkert. Eksponer den aldri i klientside-kode eller offentlige repositorier. Tajo krypterer alle API-påloggingsdetaljer i hvilemodus med AES-256.

### Koble til Tajo

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

## Konfigurasjon

### Grunnleggende oppsett

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

Mapp Braze-brukerattributter til Brevo-kontaktattributter:

```yaml
field_mapping:
  # Standardfelt
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engasjementsmålinger
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Egendefinerte attributter
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE
```

## API-endepunkter

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

| Endepunkt | Metode | Formål |
| --- | --- | --- |
| `/users/track` | POST | Send brukerattributter, hendelser og kjøp |
| `/users/export/ids` | POST | Eksporter brukerprofiler etter eksterne ID-er |
| `/users/export/segment` | POST | Eksporter brukere fra et segment |
| `/campaigns/list` | GET | Hent liste over kampanjer |
| `/campaigns/data_series` | GET | Kampanjeanalyse over tid |
| `/canvas/list` | GET | Hent liste over Canvas-flyter |
| `/canvas/data_series` | GET | Canvas-analyse over tid |
| `/segments/list` | GET | Hent liste over segmenter |
| `/email/status` | POST | Endre e-postabonnementstatus |
| `/subscription/status/set` | POST | Sett status for abonnementsgruppe |
| `/catalogs/{catalog_name}/items` | GET | Hent katalogelementer |

## Kodeeksempler

### Initialiser kobling

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

### Synkroniser brukerprofiler

```javascript
// Synkroniser Braze-brukere til Brevo-kontakter
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Sjekk synkroniseringsstatus
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 egendefinerte hendelser

```javascript
// Videresend Braze-hendelser til 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
    }
  }
});
```

### Eksporter segmentdata

```javascript
// Eksporter et Braze-segment og opprett en Brevo-liste
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`);
```

## Ratebegrensninger

Braze håndhever ratebegrensninger basert på planen og instansen din:

| Plan | Ratebegrensning | Burstgrense |
| --- | --- | --- |
| **Starter** | 250 000 forespørsler/time | N/A |
| **Pro** | 250 000 forespørsler/time | N/A |
| **Enterprise** | Tilpasset | Tilpasset |

Endepunktet `/users/track` har en standardgrense på 50 000 forespørsler per minutt. Tajo håndterer automatisk ratebegrensning med eksponentiell backoff.

Batch-forespørsler

Tajo batcher opptil 75 brukerattributter, 75 hendelser og 75 kjøp per `/users/track`-forespørsel for å maksimere gjennomstrømning innenfor ratebegrensningene.

## Feilsøking

### Vanlige problemer

| Problem | Årsak | Løsning |
| --- | --- | --- |
| 401 Unauthorized | Ugyldig eller utløpt API-nøkkel | Regenerer API-nøkkelen i Braze-dashbordet |
| Brukere synkroniseres ikke | Feil instans-URL | Verifiser Braze-instans-URL (f.eks. iad-01, iad-02) |
| Manglende attributter | API-nøkkelens scope for smalt | Legg til nødvendige rettigheter på API-nøkkelen |
| Ratebegrensning overskredet | For mange samtidige forespørsler | Reduser batchstørrelse eller synkroniseringsfrekvens |
| Forsinkede hendelser | Stor eksportkø | Bruk inkrementell synkronisering i stedet for full eksport |

### Feilsøkingsmodus

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

### Test tilkobling

```bash
tajo connectors test braze
# ✓ API-tilkobling vellykket
# ✓ Brukereksport tilgjengelig
# ✓ Kampanjedata lesbare
# ✓ Segmentliste tilgjengelig
# ✓ Hendelsessporing operativ
```

## Beste praksis

1. **Bruk inkrementelle synkroniseringer** - Unngå fulleksport; synkroniser kun endrede poster siden siste synkronisering
2. **Batch brukeroppdateringer** - Grupper attributtendringer for å minimere API-kall
3. **Avgrens API-nøkler smalt** - Aktiver kun rettighetene integrasjonen din trenger
4. **Overvåk ratebegrensninger** - Sett opp varsler før Braze-ratebegrensninger nås
5. **Mapp eksterne ID-er konsistent** - Bruk samme identifikator på tvers av Braze og Brevo
6. **Test i sandbox først** - Bruk et Braze-testarbeidsområde før produksjonsutrulling

## Sikkerhet

- **API-nøkkelautentisering** - Avgrensede API-nøkler med granulære rettigheter
- **Kun HTTPS** - All API-kommunikasjon kryptert via TLS 1.2+
- **IP-hviteliste** - Valgfri IP-restriksjon for API-tilgang i Braze
- **Kryptert lagring** - API-påloggingsdetaljer kryptert i hvilemodus i Tajo
- **Revisjonslogg** - Alle API-kall logget for etterlevelsesgjennomgang

## Relaterte ressurser

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