> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/mailchimp.md).

# Mailchimp

Koppel Mailchimp zodat het volume en de klikken van je wekelijkse nieuwsbrief worden doorgegeven aan het Marketing Mix Model.

Verbind je Mailchimp-account zodat AdPage weet hoeveel e-mails je elke week hebt verstuurd en hoeveel abonnees hebben geklikt. Het Marketing Mix Model gebruikt dat als onderdeel van je basislijn. AdPage leest alleen: er wordt niets teruggeschreven naar Mailchimp, geen doelgroep gewijzigd en er worden nooit mailings verzonden.

{% hint style="info" %}
**Dit is niet de Mailchimp-tag in je servercontainer.** AdPage biedt ook een server-side GTM-sjabloon dat gebeurtenissen verzendt *naar* Mailchimp, voor segmentatie. Die tag en deze integratie staan los van elkaar: de integratie leest je campagnerapporten *van* Mailchimp. Je kunt een van beide gebruiken, of allebei.
{% endhint %}

### Voordat je begint

Je hebt een **Mailchimp-API-sleutel**. Je maakt deze zelf aan in Mailchimp:

1. Klik op je profielpictogram en kies **Profiel**.
2. Open **Extra's** en kies **API-sleutels**.
3. Selecteer **Maak een sleutel aan**, geef het een naam die je later herkent (bijvoorbeeld *AdPage*) en kopieer de sleutel meteen. Mailchimp toont de volledige sleutel mogelijk maar één keer.

Een Mailchimp-API-sleutel eindigt op een streepje en het datacenter van je account, zoals `-us21`. Kopieer de hele sleutel, inclusief dat einde: AdPage gebruikt die om je account te vinden.

{% hint style="warning" %}
Mailchimp heeft geen alleen-lezen-sleutels: met een API-sleutel krijg je toegang tot het hele account. AdPage gebruikt hem alleen om je accountnaam en campagnerapporten te lezen. Maak een aparte sleutel voor AdPage, zodat je die in Mailchimp op elk moment kunt intrekken zonder iets anders te beïnvloeden.
{% endhint %}

Je hebt ook een container geselecteerd in AdPage nodig, en een AdPage-login met toegang tot die container. De verbinding wordt per container opgeslagen, dus een klant met meerdere containers koppelt elke container afzonderlijk.

### Verbind Mailchimp

{% stepper %}
{% step %}

#### Open de integratiepagina

Ga naar **Integraties** en selecteer de container bovenaan de pagina. Open vervolgens de **Mailchimp** tegel in de e-mailgroep. Zoeken op "newsletter" vindt het ook.
{% endstep %}

{% step %}

#### Plak de API-sleutel

Plak de sleutel in het **API-sleutel** veld. Deze wordt versleuteld opgeslagen en nooit meer getoond: alleen de laatste vier tekens en het datacenter blijven zichtbaar, zodat je kunt herkennen welke sleutel is opgeslagen.
{% endstep %}

{% step %}

#### Testen en verbinden

Selecteer **Testen en verbinden**. Voordat iets wordt opgeslagen, leest AdPage je account en de campagnerapporten van de afgelopen 90 dagen om te bewijzen dat de sleutel werkt. Een sleutel die niet werkt, wordt nooit opgeslagen, zodat de tegel niet kan zeggen "verbonden" terwijl er niets binnenkomt.

Gebruik **Alleen testen** als je de sleutel wilt controleren zonder hem al op te slaan.
{% endstep %}
{% endstepper %}

De test toont je accountnaam, hoeveel nieuwsbrieven je in de afgelopen 90 dagen hebt verzonden en de titel van de meest recente. Ook wordt vermeld hoeveel RSS-campagnes en automatiseringen hij heeft gevonden; die worden niet meegeteld (zie hieronder), en of je rapporten e-commerce-omzet bevatten.

### Wat je krijgt

Je wekelijkse e-mailactiviteit voedt het **Marketing Mix Model** als basislijncontrole: het aantal afgeleverde e-mails en het aantal abonnees dat heeft geklikt. E-mail brengt geen mediabudget met zich mee, dus het is geen kanaal in het model. Maar hoeveel e-mail is verzonden is wel een echte drijver van je basislijn, en het model is beter geïnformeerd als dat bekend is: zonder dit kan een sterke nieuwsbriefweek worden toegeschreven aan welk advertentiekanaal die week toevallig meer uitgaf.

De omzet die Mailchimp aan een campagne toeschrijft, wordt ernaast opgeslagen ter vergelijking, maar nooit gebruikt in het model: die omzet maakt al deel uit van wat het model verklaart.

AdPage laadt de geschiedenis één keer, wanneer je model wordt voorbereid. Daarna worden de laatste vier weken elke maandag ververst, omdat opens en klikken nog dagen na een verzending binnenkomen.

{% hint style="info" %}
Er zijn nog geen Mailchimp-widgets in Data Studio. Voor Spotler Mail+ en MailCampaigns wel; Mailchimp volgt nog.
{% endhint %}

### De cijfers lezen

{% hint style="warning" %}
**Alleen nieuwsbrieven worden meegeteld.** Reguliere, platte-tekst-, A/B-test- en multivariate campagnes tellen mee. Automatiseringen (customer journeys) niet: een automatisering wordt geactiveerd door iets wat een klant deed, en dat bezoek kwam vaak uit betaalde media, dus als controle zou het krediet wegnemen van de advertenties die het veroorzaakten. RSS-campagnes worden ook weggelaten om te voorkomen dat dezelfde e-mail twee keer wordt geteld.
{% endhint %}

**Afgeleverd betekent verzonden minus bounces.** Afgeleverd is het aantal verzonden e-mails minus hard bounces, soft bounces en adressen met een syntaxfout.

**Kliks tellen abonnees, niet klikken.** Een abonnee die op drie links in één e-mail klikt, telt één keer mee.

**Openingen worden niet gebruikt.** Apple Mail Privacy Protection laadt afbeeldingen vooraf, waardoor openingen onvoorspelbaar worden opgeblazen. AdPage slaat ze op, maar geeft ze niet door aan het model.

**Weken volgen de Nederlandse verzenddatum.** Mailchimp rapporteert verzendtijden in UTC. Een nieuwsbrief die op zondag om 23:30 Nederlandse tijd wordt verzonden, telt mee in die week en niet in de volgende.

**Een week kan worden overgeslagen.** Als één campagnerapport in een week terugkomt zonder verzendaantal, laat AdPage die hele week weg in plaats van hem te laag op te slaan, en meldt het dat wanneer de geschiedenis wordt geladen.

**Omzet vereist een gekoppelde webshop.** Mailchimp kent campagne-omzet alleen wanneer je webshop met Mailchimp is gekoppeld. Zonder die koppeling is er simpelweg geen omzet, en dat heeft geen invloed op het model.

### Probleemoplossing

**"Dit is geen Mailchimp-API-sleutel" (dit is geen Mailchimp-API-sleutel).** De sleutel moet eindigen op een streepje en het datacenter, zoals `-us21`. Je hebt waarschijnlijk maar een deel ervan gekopieerd: kopieer de hele sleutel opnieuw.

**De sleutel wordt geweigerd.** Het bericht noemt wat Mailchimp heeft geantwoord. Meestal is de sleutel ingetrokken of verkeerd getypt. Maak in Mailchimp een nieuwe sleutel aan en plak die erin.

**De test vindt geen nieuwsbrieven.** De telling omvat nieuwsbrieven die in de afgelopen 90 dagen zijn verzonden. Als er nul staat terwijl je wel recente campagnes in Mailchimp ziet, vermeldt de tegel de velden die Mailchimp heeft teruggegeven. Stuur die regel naar support.

**De tegel vraagt je opnieuw te verbinden.** Mailchimp weigert de opgeslagen sleutel, meestal omdat die in Mailchimp is verwijderd. Maak een nieuwe sleutel aan en plak die erin. Gebruik **Sleutel vervangen**: de nieuwe sleutel wordt eerst getest en als dat mislukt blijft de huidige sleutel staan.

**Ontkoppelen.** Selecteer **Ontkoppelen** in de tegel. Daarmee wordt AdPage's kopie van de sleutel verwijderd; de sleutel zelf blijft geldig in Mailchimp totdat je hem daar verwijdert. De weken die al zijn geladen blijven in het model.

{% hint style="warning" %}
**Mailchimp valt niet onder de dagelijkse verbindingscontrole**, dus een verbroken verbinding stuurt je geen e-mail. Als je sleutels in Mailchimp vervangt of verwijdert, controleer dan daarna de tegel.
{% endhint %}

Nog steeds vastgelopen? Neem contact op met <support@adpage.io> en vermeld de container en wat de tegel liet zien.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adpage.io/data-and-insights/data-and-insights-nl/marketingintegraties/mailchimp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
