Artikelen over: CMS overzicht

[Magento] Purchase webhooks instellen

Let op: Om de webhooks goed werkend te krijgen is het belangrijk dat je de Google Tag (GA4 configuratietag) voorziet van extra parameters genaamd de marketing.user_id, marketing.session_count, en markeing.session_id

Volg onderstaande stappen om de Google Tag in de webcontainer aan te passen:

Voeg DataLayer variabelen toe van het "trytagging_user_data" event als variabelen in je Google Tag Manager web container.

marketing.user_id
Marketing User ID

marketing.session_count
Marketing Session Count

marketing.session_id
Marketing Session Count

Zorg ervoor dat de Google Tag wordt afgevuurd via de "trytagging_user_data" event, anders is het niet mogelijk om de user data op te halen.

Trytagging_userdata trigger

De Google Tag zal ten alle tijden afgevuurd moeten worden voor alle standaard eCommerce events. Mocht dat niet lukken, kies er dan voor om een Trigger groep te maken.

Voeg de 3 parameters toe die we hebben aangemaakt in stap 1.

Configuratieparameter	Variable	Variabele Configuratie
x-fb-ck-fbc	x-fb-ck-fbc	1st-Party Cookie
x-fb-ck-fbp	x-fb-ck-fbp	1st-Party Cookie
first_party_collection	true
send_page_view	false
user_data	User-Provided Data	template
server_container_url	@ Server URL	Constant
clientId	marketing.user_id	Data Layer Variable
sessionId	marketing.session_id	Data Layer Variable
session_count	marketing.session_count	Data Layer Variable

Volg onderstaande stappen om de servercontainer aan te passen:

Voeg 3 event data variabelen toe

session_count

sessionId

ClientId

Maak een Transformation aan met het type "Augment event"

client_id = {{ClientId}}
ga_session_id = {{sessionid}}
ga_session_number = {{sessioncount}}

Zorg er nu voor dat deze Transformations worden toegevoegd aan de GA4 Tag van de Servercontainer.

Attach tag

Zorg ervoor dat het "purchase" event wordt ge-exclude van de GA4 trigger. Dit doen we omdat de Purchase events voortaan via de Webhooks worden gestuurd, anders krijg je dubbele data.

Voor het maken van de Dataclient maken we gebruik van de Stape Dataclient. Je kunt deze hier downloaden: https://github.com/stape-io/data-client

Ga naar templates in sGTM -> Klik op new -> Import Data Client -> en klik op "Save"

Maak Dataclient aan door naar Tags te gaan -> Klik op nieuw -> Selecteer type Data Client Accepted Path Settings -> Add Path -> Voeg de endpoint toe zoals "order_created"

Voeg de volgende Event Data variabelen toe voor de Purchase webhooks data:

ecommerce.value

ecommerce.currency

ecommerce.transaction_id

ecommerce.items

ecommerce.tax

ecommerce.shipping

ecommerce.coupon

marketing_data.session_id

marketing_data.session_count

marketing_data.user_id

timestamp

page_location (depends on your CMS)

Voeg vervolgens deze variabelen toe als parameters in de Purchase Tag

Maak een de Purchase Tag aan en zorg dat je de volgende parameters toevoegt als purchase tag.
value = {{ecommerce.value}}
currency = {{ecommerce.currency}}
transaction_id = {{ecommerce.transaction_id}}
items = {{ecommerce.items}}
tax = {{ecommerce.tax}}
shipping = {{ecommerce.shipping}}
coupon = {{ecommerce.coupon}}
ga_session_id = {{marketing_data.session_id}}
ga_session_number = {{marketing_data.session_count}}
client_id = {{marketing_data.user_id}}
event_time = {{timestamp}}
page_location = {{page_location}}
Engagement_time_msec = 1564
Page_hostname = domain.com
page_title = thank you page title

Let op! Zorg ervoor dat je de variabelen checkt of deze gevuld worden in preview modus en check ook of het de juiste parameters zijn. Bijvoorbeeld: als page_location een andere URL heeft dan in werkelijkheid dan zul je deze variabelen moeten aanpassen.

Maak vervolgens een Trigger aan die wordt afgevuurd op basis van:
Client Name equals Data Client
Event Name equals trytagging_purchase

Ga vervolgens een test doen door live orders te testen of door zelf een order te plaatsen. Via het volgende artikel kun je zien hoe je deze test kan doen:
Webhooks testen via de sGTM

Bijgewerkt op: 02/04/2025

Was dit artikel nuttig?

Dankuwel!