[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.session_count


marketing.session_id


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.



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.



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: 30/08/2024