Versions Compared

Old Version 15

changes.mady.by.user Pim Reijnen

Saved on

compared with

New Version 16

changes.mady.by.user Pim Reijnen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleWaarom 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

  1. Profiel A doet een aankoop

  2. Profiel A klikt de bedankpagina weg voordat deze wordt ingeladen = geen frontend purchase, dus geen purchase

  1. Profiel B doet een aankoop

  2. Profiel B klikt de bedankpagina weg voordat deze wordt ingeladen = geen frontend purchase

  3. 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)

Expand
titleWaar 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

Let op: zorg ervoor dat je geen van deze API-endpoints implementeert in front-end code. Dit levert beveiligingsproblemen op, aangezien de authenticatie headers dan in elk verzoek worden opgenomen.

Formatie

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

...

Inhoud

In het Backend Purchase event worden de volgende velden minimaal meegestuurd:

Veldlabel

Veldinhoud

event

Purchase

email

Emailadres van het profiel

orderid

Id van de order

products

id

Id van het aangeschafte product

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!Een voorbeeld van de Backend Purchase API Call vind je hier: https://squeezely.tech/documentation#backend-purchase (zie Example)

In de volgende omstandigheden zijn meer velden verplicht:

...

Expand
titleHoe kan ik custom datavelden meesturen in het event?

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

Vervolgens kun je deze 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.

Implementatie

De documentatie voor het implementeren van de Backend Purchase via API Calls, vind je hier: https://squeezely.tech/documentation#backend-purchase

Controleren

Na de implementatie kun je de volgende twee dingen controleren:

...