Als marketeer wil je graag inzicht in je resultaten en aanknopingspunten voor verbetering in de toekomst. Spotler biedt daarom verschillende rapportages die ook via de API op te vragen zijn. Zo kun je de volgende gegevens ophalen:
- Mailingrapportages
- Mailinghistorie van een contact
- Respons op formulieren
- Campagnegegevens
- Campagnehistorie van een contact
Met bovenstaande gegevens in een extern systeem kun je gerichte follow-up acties organiseren en krijg je een totaal beeld van je contacten.
Mailingrapportage ophalen
De rapportages van mailings uit Spotler zijn op verschillende manieren op te halen. Welke manier het beste past hangt af van hoeveel je van de mailingrapportage wilt tonen in het gekoppelde systeem.
Verzonden mailings periodiek ophalen
Als je als doel hebt om de rapportages van Spotler-mailings te tonen in het gekoppelde systeem, dan moet je periodiek alle mailings ophalen die sinds de vorige synchronisatie zijn verzonden. De meest basale mailinggegevens komen dan direct terug in de respons, zoals een unieke referentie van de mailing (om meer informatie op te halen), de naam van de mailing, een link naar de online versie, de verzenddatum en naar hoeveel contacten de mailing is verzonden. Dit is bedoeld om een lijst van verzonden mailings te tonen in het gekoppelde systeem.
![]() |
Technische documentatie Ophalen van verzonden mailings |
Mailinginformatie ophalen
Op basis van de opgehaalde unieke referentie van een mailing kun je met een specifieke API methode meer informatie ophalen. Zoals de naam van de marketeer die de mailing heeft verzonden, de naam van de doelgroep, en de gegevens van het bericht zelf, waaronder de onderwerpregel en welke trackable links erin voorkwamen. In feite allemaal statische gegevens van de mailing.
![]() |
Technische documentatie Informatie ophalen van een specifieke mailing |
Statistieken van een mailing ophalen
Voor het tonen van de statistieken van een specifieke mailing is een aparte API-methode te gebruiken. Als een mailing is verzonden, duurt het dagen, soms weken voordat de respons op de mailing is uitgewerkt. Je kunt ervoor kiezen om van een mailing een paar keer na de verzenddatum de statistieken op te halen en deze op te slaan in het gekoppelde systeem. Of je kunt ervoor kiezen om de meest recente statistieken van een mailing op te halen, op het moment dat de gebruiker van het gekoppelde systeem daarom vraagt. De volgende statistieken kunnen van een mailing worden opgehaald:
- Aantal verzonden
- Aantal unieke contacten waarvan de e-mail is geaccepteerd
- Aantal unieke contacten die de e-mail hebben geopend
- Aantal unieke contacten die afbeeldingen hebben uit de e-mail gedownload
- Aantal unieke contacten die hebben doorgeklikt in de e-mail
- Aantal unieke contacten waarvan het e-mailadres een hardbounce heeft veroorzaakt
- Aantal unieke contacten waarvan het e-mailadres een softbounce heeft veroorzaakt
- Aantal unieke contacten die niet zijn behouden als gevolg van een hardbounce of een 4e achtereenvolgende softbounce
- Aantal unieke contacten die op een conversielink hebben geklikt
- Aantal unieke contacten die zich hebben afgemeld (door middel van een afmeldformulier, list-unsubscribe header of een spam-melding)
- Aantal unieke contacten die op een link naar de webwinkel hebben geklikt (Spotler eCommerce)
- Aantal unieke contacten die een winkelwagen hebben aangemaakt na een klik vanuit de e-mail (Spotler eCommerce)
- Aantal unieke contacten die een winkelwagen hebben afgerekend na een klik vanuit de e-mail (Spotler eCommerce)
- Totale omzet die de mailing heeft opgeleverd in de webwinkel (Spotler eCommerce)
![]() |
Technische documentatie Statistieken ophalen van een specifieke mailing |
Specifieke rapportages van een mailing ophalen
Naast de hierboven genoemde globale statistieken van een mailing, kun je met afzonderlijke API-methodes nog specifiekere rapportages ophalen van de mailing. Denk daarbij aan de volgende zaken:
- Naar welke contacten is de mailing verzonden?
- Welke contacten hebben op welk moment de mailing geopend? Dit is ook op te vragen voor één specifiek contact. Deze open-interacties kunnen ook worden gebruikt voor follow-up acties in het gekoppelde systeem.
- Welke contacten hebben op welk moment doorgeklikt op één of meerdere trackable links? En wat is de unieke referentie van die links? Dit is ook op te vragen voor één specifiek contact. Bij het ophalen van de statische informatie van een mailing, dat hierboven is beschreven, is meer informatie over deze links te vinden, zoals de naam, de URL en het type. Deze klik-interacties kunnen ook worden gebruikt voor follow-up acties in het gekoppelde systeem.
- Welke contacten zijn op welk moment gebounced? En ging het daarbij om een hardbounce of een softbounce? Deze bounce-interacties kunnen ook gebruikt worden voor follow-up acties in het gekoppelde systeem.
Mailinghistorie van een contact ophalen
Het is mogelijk om een lijst van alle mailings op te halen die naar een specifiek contact zijn verzonden. Het doel hiervan is om dit te tonen op de ‘klantkaart’ in het gekoppelde systeem. Zo heeft de gebruiker een compleet beeld van de relatie. De volgende gegevens worden daarbij van iedere mailing opgehaald:
- Globale gegevens van de mailing, zoals de verzenddatum en de URL van de online versie, om te kunnen tonen om welke e-mail het ging. Meer informatie van de mailing is eventueel op te halen op basis van de unieke referentie van de mailing.
- Heeft het contact de e-mail geopend? (True/False)
- Heeft het contact doorgeklikt in de e-mail? (True/False)
- Is het e-mailadres naar aanleiding van deze e-mail gebounced? Als dat zo is, dan wordt aangegeven of het ging om een ‘hardbounce’ of ‘softbounce’.
- Een unieke referentie van elke opgehaalde mailing.
![]() |
Technische documentatie Ophalen welke mailings een specifiek contact heeft ontvangen |
Formulierhistorie van een contact ophalen
Naast het tonen van welke mailings een contact heeft ontvangen, kunt u op de klantkaart ook tonen welke Spotler-formulieren en/of -surveys het contact heeft ingevuld. De volgende gegevens kunnen daarbij worden opgehaald:
- De gegevens van het formulier, zoals een unieke referentie, de naam en het type.
- De datum waarop het formulier is ingevuld door het contact. Dit kunnen meerdere momenten zijn, elk met een afzonderlijke unieke referentie (‘formResultId’).
- En of het formulier volledig is ingevuld in het geval dat een formulier uit meerdere pagina’s bestaat. (True/False)
Op basis van de unieke referentie van het formulier kun je meer gegevens ophalen van het formulier zelf, zoals welke vragen er werden gesteld in het formulier. Op basis van het ‘formResultId’ kunt u eventueel de respons van het contact ophalen (de gegevens die hij/zij in het formulier heeft ingevuld). Dat is niet alleen interessante informatie om te tonen op de klantkaart. Het kan ook aantrekkelijk zijn om hier follow-up acties aan te verbinden, bijvoorbeeld een nabelactie als een klant een negatief oordeel in een enquête heeft ingevuld.
![]() |
Technische documentatie Ophalen welke formulieren een specifiek contact heeft ingevuld Ophalen van de respons van een contact van een specifieke formulier-submit |
Totale respons op een formulier ophalen
Bij een rapportage en/of follow-up acties kun je ook de totale respons van alle contacten op een formulier ophalen.
![]() |
Technische documentatie Ophalen van de totale respons op een formulier |
Gegevens van een campagne ophalen
Bij het ophalen van alle campagnes uit Spotler, krijg je in de response een unieke referentie van elke campagne terug. Op basis van deze unieke referentie kun je met een aparte API-methode de campagnestappen van deze campagne ophalen waarin een e-mail of SMS wordt verstuurd. Vervolgens kun je per campagnestap de volgende gegevens ophalen:
- De naam van de campagnestap
- Het type bericht (e-mail of SMS)
- Specifieke gegevens van het bericht zelf (zoals de onderwerpregel in het geval van een e-mail bericht)
- De links die in het bericht voorkwamen (in het geval van een e-mail bericht)
Per campagnemailing zijn in afzonderlijke methodes de volgende gegevens op te halen:
- Naar welke contacten en wanneer is het campagnebericht (e-mail of SMS) verzonden? En wat is de bijbehorende unieke referentie van de ‘campagne-inschrijving’? Een campagne kan immers meerdere malen voor hetzelfde contact getriggerd zijn. En daarmee kan hetzelfde campagnebericht meerdere malen naar het contact verzonden zijn.
- Welke contacten hebben op welk moment het campagnebericht (e-mail) geopend? Dit is ook op te vragen voor één specifieke campagne-inschrijving. Deze open-interacties kunnen ook worden gebruikt voor follow-up acties in het gekoppelde systeem.
- Welke contacten hebben op welk moment op één of meerdere trackable links doorgeklikt? En wat is de unieke referentie van die links? Dit is ook op te vragen voor één specifieke campagne-inschrijving. Bij het ophalen van de statische informatie van een mailing, dat hierboven is beschreven, is meer informatie over deze links te vinden, zoals de naam, de URL en het type. Deze klik-interacties kunnen ook worden gebruikt voor follow-up acties in het gekoppelde systeem.
- Welke contacten zijn op welk moment gebounced? En ging het daarbij om een hardbounce of een softbounce? Deze bounce-interacties kunnen ook gebruikt worden voor follow-up acties in het gekoppelde systeem.
Campagnehistorie van een contact ophalen
Er is ook een mogelijkheid om een lijst van alle campagneberichten (e-mail of SMS) op te halen die naar een specifiek contact zijn verzonden. Het doel hiervan is om dit te tonen op de ‘klantkaart’ in het gekoppelde systeem. De volgende gegevens worden daarbij van ieder campagnebericht opgehaald:
- Globale gegevens van het campagnebericht, zoals de verzenddatum. Meer informatie van het campagnebericht is eventueel op te halen op basis van de unieke referentie.
- Heeft het contact het campagnebericht (e-mail) geopend? (True/False)
- Heeft het contact doorgeklikt in het campagnebericht (e-mail)? (True/False)
- Is het e-mailadres naar aanleiding van dit campagnebericht gebounced? Als dat zo is, dan wordt aangegeven of het ging om een ‘hardbounce’ of ‘softbounce’.
- De unieke referentie van het campagnebericht.
![]() |
Technische documentatie Ophalen welke campagnemailings een specifiek contact heeft ontvangen |