De widget insluiten
Gebeurtenissen voor GA4 en Tag Manager
De chat kan de activiteiten van bezoekers binnen de chat doorgeven aan de analyse-tools die je al gebruikt — Google Tag Manager, een directe GA4-tag of iets anders dat op browsergebeurtenissen let. Je kunt dit per agent inschakelen onder ‘Geavanceerd’ › ‘Gebeurtenissen bijhouden’ van de AI-medewerker; het staat uit totdat je dit doet.
Hoe de gebeurtenissen binnenkomen
De widget draait op je pagina zelf, niet in een iframe, dus stuurt hij gebeurtenissen rechtstreeks door naar wat je site al laadt. Drie bestemmingen, elk onafhankelijk — als er één niet werkt, heeft dat geen invloed op de andere, en geen van alle kan de chat verstoren:
window.dataLayer— Google Tag Manager. Dit is wat de meeste sites willen: bouw de GA4-gebeurtenis, de conversie en de trechter in GTM zonder aan de code te komen.window.gtag— een directe GA4-tag zonder dat er een tagmanager tussen zit.- Een DOM-gebeurtenis op
window, altijd, met dezelfde naam. Gebruik deze voor Plausible, Matomo of je eigen listener:window.addEventListener('blengi_chat_started', e => console.log(e.detail)).
De gebeurtenissen
Elke naam krijgt de waarde die je instelt als voorvoegsel (standaard
blengi_
), zodat één GTM-trigger ze allemaal kan selecteren.
| Gebeurtenis | Wordt geactiveerd wanneer |
|---|---|
chat_opened | het chatvenster wordt geopend, op welke manier dan ook. |
chat_started | Het eerste bericht van de bezoeker in een gesprek — het moment waarop een toevallige bezoeker een gesprek begint. |
message_sent | Elk bericht van een bezoeker, inclusief het eerste. Gebruik dit om de gespreksdiepte te meten. |
cta_clicked | Er wordt op een call-to-action-knop in de chat geklikt. |
product_clicked | Er wordt op de link van een productkaart geklikt. |
lead_form_opened | Het leadformulier verschijnt, ongeacht de aanleiding. |
lead_form_submitted | De lead is door de server geaccepteerd — niet alleen omdat er op ‘Verzenden’ is gedrukt. |
human_takeover_requested | De bezoeker vroeg om een medewerker. Wordt geactiveerd bij het verzoek, of er nu iemand opneemt of niet: wat een funnel wil laten zien, is hoe vaak de AI vastliep. |
Parameters
Elke gebeurtenis bevat agent_id, agent_name,
page_url en page_path — de pagina die wordt gelezen op
het moment dat de gebeurtenis wordt geactiveerd, dus een single-page-app die navigeert onder
de widget rapporteert nog steeds de juiste. Daarbovenop:
chat_started,message_sent,human_takeover_requested—conversation_id.message_sent—message_length, een tekenaantal. Nooit het bericht zelf. Enmessage_source:typed,chip(een knop onder een antwoord),starter(een voorgestelde vraag) ofinline(een chatblok op de pagina).cta_clicked—cta_label,cta_type,cta_url.product_clicked—product_title,product_url.lead_form_submitted—fields_submitted, een telling van de ingevulde velden.
Wat er nooit wordt verzonden
Toestemming
Toestemming is bewust niet onze beslissing. We voegen ons toe aan de eigen taglaag van de pagina, en jouw bestaande cookiebanner — Google Consent Mode, of wat je site ook gebruikt — beslist of er iets wordt doorgestuurd, precies zoals dat ook geldt voor elke andere tag op de pagina. Een tweede, concurrerende toestemmingsstatus binnen de chat zou je niet kunnen zien of controleren, en die zou vroeg of laat in strijd zijn met je banner.
Instellen in Tag Manager
- Schakel ‘Geavanceerd’ › ‘Tracking-events’ in voor de agent en noteer het voorvoegsel.
- Maak in GTM een trigger voor een aangepaste gebeurtenis aan. Om
alles in één keer te registreren, stel je de gebeurtenisnaam in op
blengi_.*en vink je regex-matching gebruiken aan. - Voeg een GA4-gebeurtenistag toe aan die trigger, met de
gebeurtenisnaam ingesteld op
{{Event}}. - Voeg voor elke parameter die je in GA4 wilt hebben een Data Layer-variabele toe
(
agent_name,cta_type, enzovoort) en koppel deze toe aan de lijst met gebeurtenisparameters van de tag. - Bekijk een voorbeeld, open de chat op je site en controleer of de gebeurtenissen
verschijnen. Markeer vervolgens de belangrijke gebeurtenissen — meestal
lead_form_submitted— als conversies in GA4.
Dezelfde stappen staan op de pagina ‘Gebeurtenissen bijhouden’ zelf, ingevuld met het eigen voorvoegsel van de AI-medewerker.
Een snelle controle zonder GTM: open de browserconsole op je site en
voer
window.addEventListener('blengi_chat_opened', e => console.log(e.detail))
uit,
open vervolgens de chat.
Verschijnt er niets in GA4?
Werk deze punten op volgorde af — de eerste is veruit de meest voorkomende.
- Geen trigger voor de gebeurtenissen in je container. Zelfs als je elke gebeurtenis handmatig doorgeeft aan Tag Manager; Tag Manager stuurt niets door waarvoor geen trigger en GA4-tag is ingesteld. Dit was het hele probleem op een live klantensite: hun container stuurde twee eigen gebeurtenisnamen door naar GA4 en liet elke chatgebeurtenis vallen. Voeg de bovenstaande trigger en tag toe en publiceer vervolgens — een opgeslagen maar niet-gepubliceerde werkruimte verandert niets op de site.
- Testen met een geautomatiseerde browser. GA4 filtert bekend botverkeer, en veel containers blokkeren hun tags voor geautomatiseerde browsers volledig. Test handmatig, in de Preview van Tag Manager (de gebeurtenissen verschijnen in de gebeurtenissenlijst) of in de DebugView van GA4.
- Toestemming. De gebeurtenissen lopen via je eigen toestemmingsinstellingen, net als de rest van de tags op je site: als de toestemming voor analytics wordt geweigerd, stuurt GA4 hooguit cookieloze pings (Consent Mode) of helemaal niets.
- Verwerkingsvertraging van GA4. Standaardrapporten kunnen een dag duren; Realtime en DebugView tonen gebeurtenissen binnen een minuut.
Een site waarvan de GA4-tag direct in de pagina is geplaatst (gtag.js, geen tagmanager)
ontvangt de gebeurtenissen zonder al dit gedoe: de widget roept zelf
gtag('event', …)
aan. Als GA4 binnen Tag Manager draait —
ook via een server-side container — wordt een gtag
-commando
vanaf de pagina ook niet doorgestuurd; alleen een trigger en de GA4-tag in
de container worden doorgestuurd.