B Blengi docs

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.

GebeurtenisWordt geactiveerd wanneer
chat_openedhet chatvenster wordt geopend, op welke manier dan ook.
chat_startedHet eerste bericht van de bezoeker in een gesprek — het moment waarop een toevallige bezoeker een gesprek begint.
message_sentElk bericht van een bezoeker, inclusief het eerste. Gebruik dit om de gespreksdiepte te meten.
cta_clickedEr wordt op een call-to-action-knop in de chat geklikt.
product_clickedEr wordt op de link van een productkaart geklikt.
lead_form_openedHet leadformulier verschijnt, ongeacht de aanleiding.
lead_form_submittedDe lead is door de server geaccepteerd — niet alleen omdat er op ‘Verzenden’ is gedrukt.
human_takeover_requestedDe 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. En message_source : typed , chip (een knop onder een antwoord), starter (een voorgestelde vraag) of inline (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

Er verlaten geen persoonlijke gegevens de pagina
Geen berichttekst, geen antwoorden uit het leadformulier, geen naam, e-mailadres of telefoonnummer — alleen dat er een gebeurtenis heeft plaatsgevonden en wat voor soort gebeurtenis het was. Dit is geen instelling die je kunt versoepelen. De voorwaarden van Google zelf verbieden persoonsgegevens in GA4, en een klant die ons snippet plakt, mag die regel niet overtreden.

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

  1. Schakel ‘Geavanceerd’ › ‘Tracking-events’ in voor de agent en noteer het voorvoegsel.
  2. 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.
  3. Voeg een GA4-gebeurtenistag toe aan die trigger, met de gebeurtenisnaam ingesteld op {{Event}}.
  4. 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.
  5. 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.