---
title: "Mailchimp-kobling"
description: "Fullstendig Mailchimp-integrasjonsveiledning for synkronisering av målgrupper, kampanjer, automatiseringer og engasjementsdata med Brevo via Tajo."
url: https://tajo.io/no/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/no/docs/connectors/marketing/mailchimp.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.

# Mailchimp-kobling

Koblingsstatus: Under utvikling Under bygging. Ikke verifisert ennå.

| 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 Mailchimp-kontoen din til Brevo via Tajo for sømløs målgruppemigrering, kampanjedatasynkronisering og enhetlig markedsføringsautomatisering på tvers av begge plattformene.

## Oversikt

| Egenskap | Verdi |
| --- | --- |
| **Plattform** | Mailchimp |
| **Kategori** | Markedsføring |
| **Oppsettskompleksitet** | Enkel |
| **Offisiell integrasjon** | Nei |
| **Synkroniserte data** | Kontakter, kampanjer, automatiseringer, hendelser |
| **API Base URL** | `https://{dc}.api.mailchimp.com/3.0` |

## Funksjoner

- **Målgruppesynkronisering** - Migrer og synkroniser Mailchimp-målgrupper med Brevo-kontaktlister
- **Kampanjedata** - Synkroniser kampanjeytelsesdata for enhetlig rapportering
- **Automatiseringsmigrering** - Mapp Mailchimp-automatiseringer til Brevo-arbeidsflyter
- **Engasjementsmålinger** - Synkroniser åpninger, klikk og returdata til Brevo-attributter
- **Segmentmapping** - Replikér Mailchimp-segmenter som Brevo-lister eller -segmenter
- **E-handelsdata** - Synkroniser butikk-, produkt- og ordredata fra Mailchimp e-handel
- **Tag-synkronisering** - Mapp Mailchimp-tagger til Brevo-kontaktattributter eller -lister
- **Malmigrering** - Eksporter Mailchimp-maler for bruk i Brevo-kampanjer

## Forutsetninger

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

1. En Mailchimp-konto (Free, Essentials, Standard eller Premium)
2. En Mailchimp API-nøkkel eller OAuth-app
3. En Brevo-konto med API-tilgang
4. En Tajo-konto

## Autentisering

### API-nøkkelautentisering

Generer en API-nøkkel fra Mailchimp Account > Extras > API Keys.

```bash
curl https://{dc}.api.mailchimp.com/3.0/ping \
  --user "anystring:{api_key}" \
  -H "Content-Type: application/json"
```

`{dc}`-datasenterprefikset er den siste delen av API-nøkkelen din (f.eks. `us21`).

### OAuth 2.0

For flerkonto-integrasjoner:

```bash
# Autorisasjons-URL
https://login.mailchimp.com/oauth2/authorize?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}

# Token-utveksling
curl -X POST https://login.mailchimp.com/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "redirect_uri={redirect_uri}" \
  -d "code={auth_code}"
```

Datasenter

Trekk alltid ut datasenteret fra API-nøkkelen eller OAuth-metadataendepunktet. Å bruke feil datasenter vil resultere i autentiseringsfeil.

## Konfigurasjon

### Grunnleggende oppsett

```yaml
connectors:
  mailchimp:
    enabled: true
    api_key: "${MAILCHIMP_API_KEY}"
    data_center: "us21"

    # Synkroniseringsalternativer
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Mapping av målgruppe til Brevo-liste
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42
```

### Feltmapping

Mapp Mailchimp merge-felt til Brevo-kontaktattributter:

#### Standardmappinger

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | Abonnentens e-post (unik identifikator) |
| `FNAME` optional | string | Fornavn merge-felt, mappes til FIRSTNAME |
| `LNAME` optional | string | Etternavn merge-felt, mappes til LASTNAME |
| `PHONE` optional | string | Telefon merge-felt, mappes til SMS |
| `status` optional | string | Abonnementsstatus (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Abonnenttagger for segmentering |
| `stats.avg_open_rate` optional | number | Gjennomsnittlig e-poståpningsrate |
| `stats.avg_click_rate` optional | number | Gjennomsnittlig e-postklikkrate |

#### Mapping av egendefinerte merge-felt

```yaml
field_mapping:
  # Standardfelt
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Engasjementsmålinger
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # E-handelsfelt
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Egendefinerte merge-felt
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE
```

## API-endepunkter

### Målgrupper (Lists)

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `GET` | `/3.0/lists` | List alle målgrupper |
| `GET` | `/3.0/lists/{list_id}` | Hent målgruppedetaljer |
| `GET` | `/3.0/lists/{list_id}/members` | List målgruppemedlemmer |
| `POST` | `/3.0/lists/{list_id}/members` | Legg til et medlem |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Oppdater et medlem |
| `POST` | `/3.0/lists/{list_id}` | Batchabonnering/avmelding |

### Kampanjer

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | List kampanjer |
| `GET` | `/3.0/campaigns/{id}` | Hent kampanjedetaljer |
| `GET` | `/3.0/reports/{id}` | Hent kampanjerapport |
| `GET` | `/3.0/reports/{id}/email-activity` | Hent e-postaktivitet |

### Automatiseringer

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `GET` | `/3.0/automations` | List automatiseringer |
| `GET` | `/3.0/automations/{id}` | Hent automatiseringsdetaljer |
| `GET` | `/3.0/automations/{id}/emails` | List automatiserings-e-poster |

### E-handel

| Metode | Endepunkt | Beskrivelse |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | List tilkoblede butikker |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | List butikk-kunder |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | List butikk-ordrer |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | List butikk-produkter |

## Hendelser

### Kampanjehendelser

| Hendelse | Utløser | Bruksområde |
| --- | --- | --- |
| `campaign.sent` | Kampanje levert | Ytelsessporing |
| `campaign.opened` | E-post åpnet | Engasjementsscoring |
| `campaign.clicked` | Lenke klikket | Interessesporing |
| `campaign.bounced` | E-post returnert | Listehygiene |

### Abonnenthendelser

| Hendelse | Utløser | Bruksområde |
| --- | --- | --- |
| `subscribe` | Ny abonnent lagt til | Velkomstflyt |
| `unsubscribe` | Abonnent meldte seg av | Preferansehåndtering |
| `profile` | Profil oppdatert | Attributtsynkronisering |
| `cleaned` | E-post ryddet (returnert) | Listevedlikehold |

### E-handelshendelser

| Hendelse | Utløser | Bruksområde |
| --- | --- | --- |
| `ecommerce.order` | Ordre plassert | Etterkjøpsflyt |
| `ecommerce.cart` | Handlekurv oppdatert | Gjenoppretting av forlatt handlekurv |

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

// Koble til Mailchimp
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});
```

### Migrer målgrupper til Brevo

```javascript
// Full målgruppemigrering fra Mailchimp til Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// Sjekk migrasjonsstatus
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }
```

### Synkroniser kampanjeengasjementsdata

```javascript
// Synkroniser kampanjeytelse til Brevo-attributter
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});
```

## Ratebegrensninger

Mailchimp Marketing API-ratebegrensninger:

| Type | Grense | Detaljer |
| --- | --- | --- |
| Standard | 10 samtidige forespørsler | Per API-nøkkel |
| Batchoperasjoner | 500 operasjoner per batch | Per forespørsel |
| Eksportgrense | 1 samtidig eksport | Per konto |
| Transaksjonell | 25 forespørsler/sekund | Per API-nøkkel |

Strategi for ratebegrensning

Mailchimp begrenser samtidige tilkoblinger i stedet for forespørsler per sekund. Bruk batchendepunkter og implementer retry-logikk med eksponentiell backoff på `429`-respons.

## Feilsøking

### Vanlige problemer

| Problem | Årsak | Løsning |
| --- | --- | --- |
| 401 Unauthorized | Ugyldig API-nøkkel eller feil datasenter | Verifiser API-nøkkel og trekk ut korrekt `dc`-prefiks |
| Medlem finnes | E-post allerede i målgruppen | Bruk PUT i stedet for POST for å oppdatere eksisterende medlemmer |
| Etterlevelsestilstand | GDPR-sletting hindrer re-adding | Kontakten må re-abonnere gjennom et registreringsskjema |
| Batch-tidsavbrudd | Stor batchoperasjon | Del opp i mindre batcher på 500 operasjoner |
| Manglende merge-felt | Egendefinerte felt ikke opprettet | Opprett merge-felt i Mailchimp før mapping |

### Feilsøkingsmodus

Aktiver utvidet logging:

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

### Test tilkobling

```bash
tajo connectors test mailchimp
# ✓ API-tilkobling vellykket
# ✓ Målgrupper lesbare
# ✓ Kampanjer lesbare
# ✓ E-handelsdata tilgjengelige
# ✓ Webhook konfigurert
```

## Beste praksis

1. **Bruk batchoperasjoner** - Bruk batchabonnering/avmelding for bulkoppdateringer
2. **Bevar abonnentstatus** - Respekter abonnementssamtykke under migrering
3. **Mapp merge-felt først** - Opprett tilsvarende Brevo-attributter før synkronisering
4. **Synkroniser engasjementsdata** - Importer åpnings-/klikkrater for historisk segmentering
5. **Håndter etterlevelsestilstander** - Respekter GDPR- og permanente slettingstilstander
6. **Bruk inkrementell synkronisering** - Synkroniser kun endringer siden siste synkronisering for å redusere API-bruk

## Sikkerhet

- **API-nøkkelautentisering** - Hemmelig nøkkel sendes som HTTP Basic Auth-passord
- **OAuth 2.0** - Token-basert autorisasjon for flerkonto-tilgang
- **TLS-kryptering** - All API-kommunikasjon kryptert via HTTPS
- **Webhook-verifisering** - Valider webhook-kilde med delt hemmelighet
- **Datasenterisolering** - Data lagret i regionsspesifikke datasentre

## Relaterte ressurser

- [Mailchimp Marketing API-referanse](https://mailchimp.com/developer/marketing/api/)
- [Mailchimp API-veiledninger](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Brevo-kobling](https://tajo.io/no/docs/connectors/marketing/brevo)
- [ActiveCampaign-kobling](https://tajo.io/no/docs/connectors/marketing/activecampaign)
- [Customer Sync-ferdighet](https://tajo.io/no/docs/skills/data-sync/customer-sync)