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.

De API endpoints zijn te bereiken op: https://squeezely.tech

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

Minimaal

In het event 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

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

Extra velden

In dit event kunnen extra velden uit de datalayer meegestuurd worden. Wellicht zijn er in het Data Plan velden toegevoegd aan het event, die benodigde zijn voor het opzetten van use cases. Wanneer deze velden niet beschikbaar zijn bij de trigger, dienen deze toegevoegd te worden aan de datalayer. Wanneer deze velden custom velden zijn, dienen deze te worden aangemaakt in Squeezely en doorgestuurd in het event. Daarnaast raden we aan om met de gebruikers van Squeezely af te stemmen welke extra velden ze willen ontvangen met dit event.

De extra velden vind je hier: Datavelden

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