> 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/mailcampaigns.md).

# MailCampaigns

Koppel MailCampaigns om e-mailomzet, mailingprestaties en resultaten per webshop in Data Studio te zien.

Koppel je MailCampaigns-account om e-mailmarketing in je AdPage-rapporten op te nemen. AdPage leest alleen: er wordt niets teruggeschreven en er worden nooit mailings verzonden.

### Voordat je begint

Je hebt twee waarden uit je MailCampaigns-account nodig, onder de API-instellingen: een **API-sleutel** en een **API-token**. Beide zijn vereist — met slechts één ervan werkt de verbinding niet.

Je moet ook een container hebben geselecteerd in AdPage. De verbinding wordt per container opgeslagen, dus een klant met meerdere containers koppelt ze afzonderlijk.

### Koppel MailCampaigns

{% stepper %}
{% step %}

#### Open de integratiepagina

Ga naar **Integraties** en selecteer de container bovenaan de pagina. Open vervolgens de **MailCampaigns** tegel.

<figure><img src="https://3085749494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5kjEu8mwstNkOrvFl6S%2Fuploads%2Fpcu9Qhr3x8dvNR0991NP%2Fintegrations-mailcampaigns-tile-en.webp?alt=media" alt="MailCampaigns tile opened with the API key field"><figcaption><p>De MailCampaigns-tegel op de integratiepagina.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Plak beide waarden

Vul de **API-sleutel** en de **API-token**. Beide worden versleuteld opgeslagen en worden nooit meer getoond — alleen de laatste vier tekens blijven zichtbaar, zodat je kunt herkennen welke sleutel is opgeslagen.
{% endstep %}

{% step %}

#### Test en koppel

Selecteer **Testen & koppelen**. AdPage leest je ontvangersgroepen om te bewijzen dat de sleutel werkt voordat iets wordt opgeslagen. Een sleutel die niet werkt, wordt nooit opgeslagen, dus de tegel kan niet "verbonden" zeggen terwijl elke widget leeg blijft.

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

Na het koppelen toont de tegel hoeveel ontvangersgroepen de sleutel bereikt. Een account zonder groepen is geldig — de tegel bevestigt dan dat de sleutel werkt door in plaats daarvan abonnee-statistieken uit te lezen.

### Wat je krijgt

Zodra de koppeling actief is, komen drie widgets beschikbaar in de **E-mail & levenscyclus** sectie van Data Studio:

* **E-mail-KPI's** — omzet, bestellingen, verzendvolume, openingspercentage, klikpercentage, click-to-openpercentage en bouncepercentage over de geselecteerde periode.
* **Mailings** — één rij per mailing, met de bijbehorende percentages, bestellingen en omzet.
* **E-mailomzet per webshop** — hoe de omzet van een mailing wordt verdeeld over je webshops. Deze verdeling bestaat alleen in MailCampaigns; geen enkele andere bron rapporteert dit.

E-mail verschijnt ook in de **Kanaal-KPI's** widget, op een aparte rij onder de totalenregel. Het telt niet mee in de totalen: e-mail koopt geen media in, dus de omzet daarvan optellen bij de betaalde kanalen zou de betekenis van elk totaal in die tabel veranderen.

Ten slotte voeden het wekelijkse verzendvolume en de clicks het Marketing Mix Model als baselinecontrole. E-mail kent geen mediabudget, dus het is geen kanaal in het model — maar hoeveel e-mail er is verstuurd is wel een echte drijver van de basislijn, en het model is beter af als het dat weet.

### De cijfers lezen

{% hint style="warning" %}
**Automatiseringen tonen cumulatieve totalen.** MailCampaigns filtert bulkmailings op verzenddatum, maar een automatisering komt altijd terug met het totaal sinds de start. Automatiseringen verschijnen daarom in de mailingstabel — als zodanig gemarkeerd — maar worden weggelaten uit de periodetotalen. Ze toevoegen zou een cijfer opleveren dat er volkomen normaal uitziet en toch fout is.
{% endhint %}

**Openingspercentages zijn onbetrouwbaar.** Apple Mail Privacy Protection laadt afbeeldingen vooraf, waardoor opens onvoorspelbaar worden opgeblazen. Het openingspercentage wordt getoond omdat dat is wat MailCampaigns rapporteert, maar stuur daar niet op. Clicks en omzet zijn de betrouwbare signalen.

**Percentages zijn gewogen, niet gemiddeld.** De open- en klikpercentages in de KPI-widget zijn gewogen op basis van verzendvolume. Een testmailing naar 200 personen telt daarom minder zwaar mee dan een verzending naar je hele lijst.

**Omzet wordt door MailCampaigns toegeschreven.** Het gebruikt zijn eigen attributievenster, terwijl AdPage meet op last-click. De twee cijfers zullen verschillen, en dat is normaal — hetzelfde geldt voor elk advertentieplatform in je rapporten.

**De webshopverdeling dekt de grootste mailings.** Om de widget snel te houden, haalt AdPage de verdeling op voor de mailings met de hoogste omzet in de periode in plaats van voor allemaal. De widget vermeldt wat dat precies inhoudt, bijvoorbeeld "gebaseerd op 20 van 34 mailings, samen 96% van de e-mailomzet".

### Problemen oplossen

**De sleutel wordt afgewezen.** Het bericht noemt wat MailCampaigns heeft geantwoord. Controleer beide waarden onder de API-instellingen in je MailCampaigns-account en zorg ervoor dat je de volledige waarde hebt gekopieerd zonder spaties aan het einde. Een sleutel van een ander MailCampaigns-product werkt hier niet.

**Nul ontvangersgroepen.** Als de tegel nul groepen meldt maar bevestigt dat hij abonnee-statistieken heeft uitgelezen, werkt de sleutel en heeft het account gewoon geen groepen. Als beide leeg terugkomen, somt de tegel de veldnamen op die hij heeft ontvangen — stuur die regel naar support.

**De tegel zegt dat de verbinding is verlopen.** MailCampaigns weigert de opgeslagen sleutel. Dit betekent meestal dat de sleutel in MailCampaigns is vervangen of ingetrokken. Gebruik **Sleutel vervangen** om het nieuwe paar te plakken; de rest van de verbinding blijft zoals die is.

**De cijfers komen niet overeen met MailCampaigns.** Controleer eerst de periode, en daarna of automatiseringen het verschil verklaren — ze worden bewust uitgesloten van periodetotalen. Als de omzet niet overeenkomt, bedenk dan dat MailCampaigns en AdPage anders toeschrijven.

Nog steeds vastgelopen? Neem contact op met <support@adpage.io> en vermeld de container, de periode en wat de widget 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/mailcampaigns.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.
