Backend purchase nieuw

Het Purchase event dient te worden verzonden, naar het API endpoint van Squeezely, als een aankoop wordt bevestigd in het ordersysteem. Het verzenden van het event bestaat uit authenticatie en formatie.

Daarnaast wordt aangeraden om de purchase ook vanuit de frontend te triggeren.

Waarom wordt zowel frontend als backend tracking aangeraden voor het purchase event?

Vanwege de volgende situaties wordt zowel de frontend als backend purchase aangeraden:

De frontend purchase wordt niet altijd getriggerd omdat de bedankpagina niet wordt ingeladen
Door sommige Adblockers worden de cookies niet geaccepteerd en worden dus geen frontend events naar Squeezely verstuurd

In onderstaande voorbeeld komt het voordeel van het versturen van beiden tot uiting:

Alleen frontend purchase	Frontend & Backend purchase
Profiel A doet een aankoop Profiel A klikt de bedankpagina weg voordat deze wordt ingeladen = geen frontend purchase, dus geen purchase	Profiel B doet een aankoop Profiel B klikt de bedankpagina weg voordat deze wordt ingeladen = geen frontend purchase Vanuit het ordersysteem wordt doorgegeven dat Profiel B een aankoop heeft gedaan = backend purchase

Authenticatie

Het Squeezely API-endpoint vereist verificatie door middel van authenticatie. Authenticatie wordt uitgevoerd door in de headers van het HTTP request de volgende waardes te controleren:

X-AUTH-ACCOUNT: de identifier van het account (de gebruikersnaam van de API)
X-AUTH-APIKEY: de geheime API key (het wachtwoord van de API)

Waar vind ik de authenticatie waardes van mijn account?

Ga naar Settings
Bekijk:
- Account ID, dit is de X-AUTH-ACCOUNT
- API key, dit is de X-AUTH-APIKEY

Formatie

De informatie die naar de API endpoints wordt verzonden, dient de indeling JavaScript Object Notation (JSON) te hebben of te zijn opgenomen als HTTP POST parameters. De reacties vanuit Squeezely zijn altijd in JSON indeling. Squeezely ondersteunt momenteel geen andere formaten zoals XML of andere methodes. Het API endpoints kan bereikt worden op: https://squeezely.tech

In het API Call wordt minimaal het volgende verstuurd:

Label		Inhoud
event		Purchase
email		Emailadres van het profiel
orderid		Id van de order
products	id	Id van het aangeschafte product
products	quantity	Aantal van het aangeschafte product

Let op: het product id in het event dient overeen te komen met de SKU van het product in Squeezely!

De API Call ziet er bijvoorbeeld als volgt uit:

In de volgende omstandigheden zijn meer velden verplicht:

Worden er meerdere talen gebruikt? → stuur dan ook language mee in de product array
Worden er meerdere valuta gebruikt? → stuur dan ook currency mee in het event

Extra

In dit event kunnen extra datavelden uit de datalayer worden meegestuurd. Wellicht zijn er in het Data Plan velden toegevoegd aan het event, die benodigd zijn voor het opzetten van use cases. Als deze velden niet beschikbaar zijn bij de trigger, dienen deze te worden toegevoegd aan de datalayer. Tip: stuur alle velden mee die beschikbaar zijn bij de trigger in de datalayer en overleg met de gebruikers van Squeezely welke extra velden ze willen ontvangen in het event.

Welke datavelden kan ik meesturen in het event?

Een overzicht van de datavelden die je mee kunt sturen in het event, vind je hier: 📄 Datavelden

Welke datavelden zijn beschikbaar bij de trigger in de datalayer?

Activeer de trigger op de website (bijvoorbeeld in het geval van ViewContent; bekijk een product op de website)
Klik op F12
Ga naar Console
Type ‘datalayer’ en druk op enter
Bekijk in de respons welke velden beschikbaar zijn:

❓ Kom je er niet uit? ➡ Raadpleeg een webdeveloper

Hoe kan ik custom datavelden meesturen in het event?

Allereerst dien je de custom datavelden aan te maken in Squeezely: 🛠 Custom datavelden maken

Als de custom datavelden beschikbaar zijn in de datalayer, kun je deze vervolgens meesturen met de veldlabel: custom_(naam van het veld).

In het geval van het custom dataveld custom_provincie dient dus bijvoorbeeld custom_provincie meegestuurd te worden.

Controleren

Na de implementatie kun je de API call controleren met de response value. Meer informatie over de response values vind je hier: https://squeezely.tech/documentation#backend-tracking

Meer informatie over de backend purchase vind je hier: https://squeezely.tech/documentation#backend-purchase