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

# Spotler Mail+

Koppel Spotler Mail+ om mailingprestaties, wekelijkse verzendvolumes en e-mailomzet in Data Studio en het Marketingmixmodel te zien.

Koppel je Spotler Mail+-account om e-mailmarketing toe te voegen aan je AdPage-rapporten en het Marketing Mix Model. AdPage leest alleen: er wordt niets teruggeschreven naar Spotler en er worden nooit mailings verzonden.

{% hint style="info" %}
Deze pagina gaat over **Spotler Mail+** , het e-mailmarketingplatform dat voorheen MailPlus heette. Andere Spotler-producten, zoals Spotler Connect, gebruiken andere sleutels en kunnen hier niet worden gekoppeld.
{% endhint %}

### Voordat je begint

Je hebt twee waarden nodig uit Spotler Mail+: een **Authenticatiesleutel** en een **Authenticatiegeheim**. Je maakt ze zelf aan in de API-instellingen van Spotler Mail+ — in de Nederlandse interface heet de knop **Nieuwe authenticatie**. Beide zijn nodig; met slechts één ervan werkt de koppeling niet.

Kun je de API-instellingen niet vinden? De REST API is mogelijk nog niet actief voor je account. Spotler legt uit hoe je die activeert in [zijn helpcentrum](https://mailplus.spotler.help/hc/nl/articles/360035232913) (in het Nederlands).

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

### Spotler Mail+ koppelen

{% stepper %}
{% step %}

#### Open de integratiepagina

Ga naar **Integraties** en selecteer de container bovenaan de pagina. Open daarna de **Spotler Mail+** tegel. Zoeken op "mailplus" vindt hem ook.

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

{% step %}

#### Plak beide waarden

Vul de **Authenticatiesleutel** en de **Authenticatiegeheim**in. Beide worden versleuteld opgeslagen en worden nooit opnieuw getoond — alleen de laatste vier tekens blijven zichtbaar, zodat je kunt herkennen welke combinatie is opgeslagen.
{% endstep %}

{% step %}

#### Testen en koppelen

Selecteer **Testen & koppelen**. Voordat er iets wordt opgeslagen, leest AdPage je automatiseringen, je mailings van de afgelopen 90 dagen en de statistieken van je meest recente mailing, om te bewijzen dat de combinatie werkt. Een combinatie die niet werkt, wordt nooit opgeslagen, dus de tegel kan niet "verbonden" tonen terwijl elke widget leeg blijft.

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

De test laat zien hoeveel e-mailmailings je in de afgelopen 90 dagen hebt verzonden, de naam van de meest recente en hoeveel automatiseringen het account heeft. Ook laat hij zien of Spotlers eCom-module omzet per mailing aanlevert.

### Wat je krijgt

Vier widgets voor de **E-mail & Lifecycle** sectie van Data Studio. Ze maken nog geen deel uit van de standaardset van die sectie, dus voeg ze zelf toe met **Widget toevoegen**:

* **E-mail KPI's (Spotler)** — afgeleverde e-mails, unieke klikratio, click-to-openratio en e-mailomzet, plus verzonden e-mails, openpercentage, uitschrijvingen en bouncepercentage over de geselecteerde periode.
* **Mailings (Spotler)** — één rij per mailing, met de verzenddatum, afleveringen, openpercentage, klikratio, click-to-openratio, uitschrijvingen en omzet.
* **E-maildruk per week (Spotler)** — afgeleverde e-mails en klikken per week, geteld op de verzenddatum. Dit is de reeks die het Marketing Mix Model gebruikt.
* **Van mailing naar order (Spotler)** — het pad van afgeleverde e-mail naar een klik naar je webshop, een winkelwagen en een geconverteerde winkelwagen, met e-mailomzet en omzet per 1.000 afgeleverde e-mails.

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

Tot slot voeden wekelijkse afgeleverde e-mails en klikken het Marketing Mix Model als baselinecontrole. E-mail heeft geen mediabesteding, dus het is geen kanaal in het model — maar hoeveel e-mail er is verstuurd is wel een echte drijfveer van de baseline, en het model wordt beter van die kennis. De omzet die Spotler aan mailings toeschrijft wordt 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 vernieuwd, omdat openingen en klikken nog dagen na een verzending binnenkomen.

### De cijfers lezen

{% hint style="warning" %}
**Automatiseringen zijn niet inbegrepen.** Spotler Mail+ geeft geen cijfers per periode voor automatiseringen (campagnes), dus AdPage telt alleen bulkmailings, en de widgets vermelden dat wanneer je account automatiseringen heeft. Het Marketing Mix Model laat ze ook bewust weg: een automatisering wordt geactiveerd door iets wat een klant op je site deed, en dat bezoek kwam vaak uit betaalde media.
{% endhint %}

**Alleen e-mail.** SMS- en direct-mailverzendingen in Spotler Mail+ worden weggelaten; dat is een ander kanaal.

**Afgeleverd betekent geaccepteerd.** Afgeleverd is het aantal dat Spotler als geaccepteerd rapporteert: verzonden min harde en zachte bounces. Openingen en klikken tellen unieke contacten.

**Openpercentages zijn onbetrouwbaar.** Apple Mail Privacy Protection laadt afbeeldingen vooraf, waardoor openingen onvoorspelbaar worden opgeblazen. Het openpercentage wordt getoond omdat Spotler het rapporteert, maar stuur er niet op. Kliks en omzet zijn de betrouwbare signalen.

**Percentages zijn gewogen, niet gemiddeld.** De percentages in de KPI-widget worden berekend op basis van de opgetelde aantallen, dus een testmailing naar 200 mensen telt niet zo zwaar mee als een verzending naar je hele lijst.

**Omzet vereist Spotlers eCom-module.** Zonder die module kent Spotler geen omzet, en AdPage toont een streepje in plaats van €0 — onbekend is niet hetzelfde als nul. De trechterwidget blijft dan leeg, en e-mail krijgt geen rij in **Kanaal KPI's**.

**Omzet wordt door Spotler toegeschreven.** Spotler kent orders toe aan een mailing volgens zijn eigen regels, op basis van unieke contacten, terwijl AdPage meet op last-click. De twee cijfers zullen verschillen, en dat is verwacht — hetzelfde geldt voor elk advertentieplatform in je rapporten.

**Recente mailings groeien nog.** Openingen en klikken blijven nog dagen na een verzending binnenkomen, dus de mailing van gisteren zal nog steeds stijgen.

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

**Lange perioden zijn afgetopt.** Om de widgets snel te houden, haalt AdPage statistieken op van de 250 meest recente mailings in de periode. Als er meer zijn, vermeldt de widget dat — kies een kortere periode om de rest te zien.

**Een week gemarkeerd als "onvolledig".** Een van de mailings kwam terug zonder statistieken. Die mailing wordt weggelaten uit de totalen, waardoor de week te laag uitvalt; de widget geeft aan hoeveel mailings ontbreken. Het Marketing Mix Model slaat zo'n week over in plaats van die te laag op te slaan.

### Probleemoplossing

**De sleutel wordt geweigerd.** Het bericht noemt wat Spotler heeft geantwoord. Controleer of je beide waarden volledig hebt gekopieerd, zonder spaties aan het einde, en dat ze uit Spotler Mail+ komen — sleutels van een ander Spotler-product werken hier niet.

**De test vindt geen mailings.** De telling omvat e-mailmailings die in de afgelopen 90 dagen zijn verzonden. Als er nul staat terwijl je in Spotler wel recente mailings ziet, vermeldt de tegel welke velden Spotler heeft teruggegeven — stuur die regel naar support.

**De tegel vraagt je om opnieuw te koppelen.** Spotler weigert de opgeslagen sleutel, meestal omdat die is vervangen of verwijderd in Spotler Mail+. Maak een nieuwe Authenticatiesleutel en Authenticatiegeheim aan en plak die erin. Gebruik om een werkende combinatie te vervangen door een nieuwe **Sleutel vervangen** : de nieuwe combinatie wordt eerst getest, en als dat mislukt blijft de huidige combinatie staan.

**Geen omzet en een lege trechter.** Spotlers eCom-module levert geen cijfers aan. Omzet verschijnt zodra de module actief is in Spotler Mail+.

**De widgets ontbreken.** Ze zitten nog niet in de standaardset van **E-mail & Lifecycle** ; voeg ze toe met **Widget toevoegen**.

**De cijfers komen niet overeen met Spotler.** Controleer eerst de periode, en daarna of automatiseringen het verschil verklaren — die zijn bewust uitgesloten. Als omzet het verschil is, onthoud dan dat Spotler en AdPage anders toeschrijven.

**Ontkoppelen.** Selecteer **Ontkoppelen** in de tegel. Daarmee verwijder je de kopie van de sleutelcombinatie in AdPage; de combinatie zelf blijft geldig in Spotler Mail+ totdat je die daar verwijdert.

{% hint style="warning" %}
**Spotler Mail+ valt niet onder de dagelijkse verbindingscontrole**, dus bij een kapotte verbinding ontvang je geen e-mail. Als e-mailcijfers niet meer verschijnen, controleer dan de tegel.
{% endhint %}

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/spotler-mail.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.
