GA4 & Nexym

GA4 (Google Analytics 4) is het statistiekenpakket van Google dat veel webshops gebruiken. Nexym kan wat er op je site gebeurt via zijn onderdelen doorgeven aan de Google Analytics 4 die je shop al gebruikt: een zoekopdracht, een klik in de zoekresultaten, een product dat via een Nexym-knop in de winkelwagen gaat, een popup, een chat. Zo zie je in je eigen rapporten wat elk onderdeel opleverde, naast al je andere cijfers.

Het staat standaard uit. Het voegt data toe aan rapporten waar anderen op sturen, dus jij zet het aan.

Bron en medium blijven van jou

Een bezoeker die de zoekfunctie of de chat gebruikt, is al op je site en kwam ergens vandaan: Google, een nieuwsbrief, een advertentie. GA4 houdt die bron de hele sessie vast.

Nexym raakt bron en medium nooit aan. Geen UTM-parameters op interne links, geen campagne, geen extra page_view. Elk van die dingen start in GA4 een nieuwe sessie: de verkoop zou dan aan Nexym worden toegeschreven, en het kanaal dat de bezoeker echt binnenbracht verdwijnt uit je cijfers. In plaats daarvan stuurt Nexym gewone events binnen het bezoek, en draagt de naam van de itemlijst de toeschrijving.

1Zet het aan

Ga naar Beheer → Bezoekers & toestemming → Wat we meten en open de kaart Google Analytics 4.

• Stuur Nexym-events naar je GA4 — de schakelaar.
• Hoe events GA4 bereiken — Automatisch gebruikt Google Tag Manager als de pagina een container heeft, en anders gtag.js. Kies er één vast als je site beide laadt.
• Eventnamen — met nexym_ ervoor (standaard) of de standaardnamen van GA4. Zie Eventnamen.
• Product-id als item_id — zie hieronder. Dit is de instelling die er het meest toe doet.

Binnen vijf minuten is het actief op je site. Alleen modules die live staan sturen iets: een module in test, een preview en een demoproject sturen nooit.

2Kies het juiste item_id

GA4 volgt een product vanzelf van de klik in een lijst (select_item) via de winkelwagen tot de aankoop (purchase) — maar alleen als het item_id in al die events hetzelfde is. Kies dus het id dat je shop in zijn eigen GA4-ecommerce-events gebruikt:

Keuze	Wanneer
SKU	Je shop stuurt de artikelcode als item_id (de meeste Magento- en WooCommerce-shops)
Referentie	Je shop stuurt zijn eigen product-id
SKU van de variant	Je shop stuurt de code van de gekozen maat of kleur
Automatisch	Nexym vergelijkt de view_item of add_to_cart van je shop op een productpagina met het product op die pagina, en onthoudt wat past. Tot dat gebeurd is, geldt de SKU

Twijfel je, kijk dan in GTM Preview of in GA4 → Beheer → DebugView naar een view_item van je eigen site en vergelijk het item_id met de productpagina.

Wat er verstuurd wordt

Elk event (behalve nexym_engaged) draagt nexym_module: het onderdeel waar het vandaan kwam. Standaard staat er nexym_ voor de naam; met de standaardnamen van GA4 valt dat voorvoegsel weg (behalve bij de twee eigen events, die altijd nexym_ heten).

Event (standaard)	Met GA4-standaardnamen	Wanneer	Lijst of details
nexym_search	search	Een zoekopdracht is afgerond — één keer per term, niet per toetsaanslag	search_term
nexym_view_item_list	view_item_list	De eerste pagina zoekresultaten	Nexym – Zoeken (of Nexym – Advisor als de zoekwidget de uitkomst van de Keuzehulp toont; nexym_module is dan ook search)
nexym_select_item	select_item	Klik op een product in een Nexym-lijst	Nexym – Zoeken, Nexym – Advisor, Nexym – Chat, Nexym – Popups
nexym_add_to_cart	add_to_cart	Een product via een Nexym-knop in de winkelwagen (zoeken of chat)	dezelfde lijst
nexym_view_promotion	view_promotion	Een popup verschijnt	promotion_id is de publieke sleutel van de popup
nexym_select_promotion	select_promotion	Een popup wordt gebruikt	idem
nexym_interaction	nexym_interaction	Iets zonder GA4-naam	nexym_action: open, message, product_click (chat), completed (adviseur), helpful_vote, write_review (reviews)
nexym_generate_lead	generate_lead	Het contactformulier van de chat is verstuurd	nexym_module = chat
nexym_engaged	nexym_engaged	Eén keer per bezoek, bij de eerste Nexym-interactie	zet de gebruikerseigenschap nexym_engaged = yes

Parameters en e-commercegegevens (items, lijstnaam, waarde) zijn in beide gevallen hetzelfde; alleen de naam verschilt. Op de kaart staat de tabel met de namen zoals ze met jouw keuze verstuurd worden.

Eventnamen: met of zonder nexym_

Met nexym_ (standaard, ook voor bestaande projecten). Nexym’s events blijven los van die van je shop. Dat is belangrijk: veel shops sturen zelf al een add_to_cart bij elke toevoeging aan de winkelwagen — ook als die via een Nexym-knop ging. Met dezelfde naam telt GA4 zo’n toevoeging twee keer. Met nexym_add_to_cart gebeurt dat niet, en zie je in elk rapport meteen wat van Nexym komt.

Met de standaardnamen van GA4. Het ingebouwde rapport Zoekopdrachten op de site en de toeschrijving per itemlijst in de ecommerce-rapporten vullen alleen met de standaardnamen (search, select_item, add_to_cart, …). Kies dit als je die rapporten wilt én je eigen tags niet dezelfde events voor dezelfde klik sturen.

Met nexym_-namen maak je in GA4 zelf de rapporten: een verkenning op de eventnaam, of een aangepast event in Beheer → Bezoekers & toestemming → Wat we meten als je ze als conversie wilt tellen.

Een popup die alleen verschijnt of een lijst die alleen getoond wordt, telt niet als interactie: nexym_engaged wordt pas gezet als de bezoeker zelf iets doet.

De toestemmingsmodule stuurt niets: een toestemmingskeuze is nooit een analytics-event.

3Registreer de dimensies in GA4

GA4 toont een eigen parameter pas in rapporten als hij geregistreerd is. Ga naar Beheer → Aangepaste definities → Aangepaste dimensie maken en maak er drie, met precies deze namen:

Parameter	Bereik	Bevat
nexym_module	Event	search, chat, advisor, popups, reviews
nexym_action	Event	wat er gebeurde bij nexym_interaction
nexym_engaged	Gebruiker	yes voor een bezoeker die Nexym gebruikte

Een dimensie telt vanaf het moment dat je hem aanmaakt, niet met terugwerkende kracht.

4Google Tag Manager: importeer de container

Gebruikt je site gtag.js zonder GTM, sla deze stap dan over: de events gaan direct naar GA4.

Met GTM komen de events in je dataLayer terecht en hebben ze tags nodig. Op de kaart staat Download GTM container:

1. In GTM: Beheer → Container importeren, kies het bestand, kies je werkruimte en Samenvoegen (niet overschrijven).
2. Open de variabele GA4 Measurement ID en vul je eigen metings-ID in (G-…, te vinden onder GA4 → Beheer → Gegevensstreams).
3. Controleer in Preview dat een zoekopdracht de tag GA4 - Nexym - nexym_search laat vuren (met standaardnamen: GA4 - Nexym - search), en publiceer.

De container volgt je keuze voor de eventnamen: download hem opnieuw als je die wijzigt.

De container bevat per event één trigger en één GA4-eventtag; de ecommerce-events staan op Ecommercegegevens verzenden. Elke trigger vuurt alleen op een push van Nexym zelf (de variabele nexym is true), zodat je eigen add_to_cart niet dubbel verstuurd wordt.

!

Heeft je container al een GA4-tag die op alle ecommerce-events vuurt (een trigger met een reguliere expressie op de eventnaam)? Dan vangt die ook de pushes van Nexym. Voeg daar de uitzondering nexym is niet true aan toe, of gebruik alleen de geïmporteerde tags. Stuurt je shop zelf al een add_to_cart voor élke toevoeging aan de winkelwagen, ook die via Nexym? Vergelijk dan in DebugView of je er per klik één of twee ziet.

Toestemming

Nexym voegt geen eigen toestemmingsdrempel toe. De events gaan dezelfde weg als de eigen tags van je shop — de dataLayer en GTM, of gtag — dus Google Consent Mode geldt er precies zo voor als voor al het andere op je site. Weigert een bezoeker analytische cookies, dan behandelt GA4 de events van Nexym zoals die van je shop.

Controleren zonder je cijfers te vervuilen

Open je site met de debugger (Beheer → Debugger, of ?nexym_debug=1). Een debuggende browser stuurt niets naar GA4. Het tabblad Signalen in het debuggervenster op je site toont elk event dat een gewone bezoeker had verstuurd, met de items en de reden waarom het nu niet ging: debugging, module niet live, preview, of geen GTM of gtag op deze pagina.

De rapporten om naar te kijken

Omzet per Nexym-onderdeel (met de standaardnamen van GA4). Rapporten → Inkomsten genereren → Ecommerce-aankopen, wissel de dimensie naar Naam van itemlijst. Nexym – Zoeken, Nexym – Chat en de andere lijsten staan naast de lijsten van je eigen shop, met de artikelen, toevoegingen aan de winkelwagen en de opbrengst die GA4 aan elke lijst toeschrijft.

Wie Nexym gebruikt tegenover wie niet. Maak in Verkennen een vrije-vormverkenning en twee segmenten: gebruikers met nexym_engaged = yes, en gebruikers zonder. Zet conversieratio, aankopen en gemiddelde orderwaarde naast elkaar. Houd er rekening mee dat wie zoekt vaak al koopintentie heeft: het verschil is een aanwijzing, geen bewijs.

Welke acties. Een verkenning op het event nexym_interaction met de dimensies nexym_module en nexym_action laat zien hoe vaak de chat geopend wordt, hoeveel berichten er volgen en hoeveel adviseurs worden afgerond.

Zoektermen. Het standaardrapport voor zoekopdrachten op de site leest search_term van het event search — dus alleen met de standaardnamen; met nexym_search maak je een verkenning op dat event met de dimensie search_term. Met de dimensie nexym_module = search filter je op zoekopdrachten via Nexym.