Woordenlijst

Hoe een datalaag events aan je analyticstags doorgeeft

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •9 min leestijd
Hoe een datalaag events aan je analyticstags doorgeeftHoe een datalaag events aan je analyticstags doorgeeft

TL;DR, kort antwoord

9 min leestijd

Een datalaag is een JavaScript-object waarin een pagina events en waarden schrijft die analyticstags kunnen lezen. Google Tag Manager en gtag.js delen één array, window.dataLayer, verwerken gepushte berichten in volgorde van binnenkomst en laten tags afgaan op de sleutel "event". Gepushte waarden smelten samen in een abstract datamodel, dus geneste objecten en arrays blijven tussen pushes bestaan. Daarom pushen de GA4-voorbeelden van Google voor e-commerce ecommerce: null vóór elk e-commerce-event. De oudere W3C-communityspecificatie kiest de andere aanpak: één statusobject met de naam digitalData.

Wat is een datalaag?

In webanalytics is een datalaag (data layer) een JavaScript-object op de pagina waarin je site events en hun waarden schrijft, zodat analytics- en marketingtags schone, benoemde data lezen in plaats van die uit de HTML te schrapen. De Tag Manager-documentatie van Google geeft de korte versie: "De datalaag is een object dat Google Tag Manager en gtag.js gebruiken om informatie aan tags door te geven."

Het doel van de laag is scheiding. Je applicatiecode weet dat er net een checkout is afgerond en wat die waard was. Je tags weten waar ze dat feit naartoe moeten sturen. De datalaag zit daartussen, en Google noemt het ontwerpdoel rechtstreeks: tags "zijn ontworpen om te verwijzen naar informatie die op een georganiseerde en voorspelbare manier aan de datalaag wordt toegevoegd, in plaats van variabelen, transactie-informatie, paginacategorieën en andere signalen te ontleden die over je pagina verspreid staan". Verhuist de prijs bij een nieuw ontwerp naar een andere <div>, dan blijven tags die de datalaag lezen werken en breken tags die de pagina schrapen.

Welke twee soorten datalagen zijn er?

Datalagen bestaan in twee vormen: een statusobject dat de pagina beschrijft, en een eventwachtrij die in volgorde vastlegt wat er gebeurde. De vorm bepaalt hoe een tag hem leest.

StatusobjectEventwachtrij
VoorbeeldW3C Customer Experience Digital Data Layer 1.0Google Tag Manager, Adobe Client Data Layer
Globale naamdigitalDatadataLayer, adobeDataLayer
StructuurEén genest object met de onderdelen page, product, cart, transaction, event en userEen gewone array; elke push() voegt een bericht toe
Hoe tags hem lezenLezen eigenschappen uit wanneer de tag draaitVerwerken berichten in volgorde en reageren op events
TimingprobleemEen tag die draait voordat het object gevuld is, leest nietsBerichten die worden gepusht voordat de tagbibliotheek laadt, wachten in de wachtrij

Het model met een statusobject is het oudste. De Customer Experience Digital Data Layer 1.0, een Community Group Final Report van 10 december 2013, zegt dat het hoofdobject "digitalData MOET zijn, en dat alle data-eigenschappen binnen deze specificatie binnen de hiërarchie van het object digitalData MOETEN vallen". Het statusgedeelte voegt toe: "Het is geen W3C-standaard en bevindt zich ook niet op het W3C Standards Track." Events staan in een array binnen het object, digitalData.event[n], die de specificatie definieert als een "lijst van events die werden gemeten".

Het wachtrijmodel won in de praktijk vanwege de laadvolgorde. De documentatie van Adobe legt het voordeel uit: pagina's en scripts "kunnen al data registreren, events triggeren en callbacks registreren door ze aan de array toe te voegen, nog voordat het script van de datalaag zelf is geladen". Een gewone array accepteert pushes voordat er code van een leverancier op de pagina staat.

Een diagram op een whiteboard van een geordende wachtrij, als illustratie van hoe berichten één voor één worden verwerkt in de volgorde waarin ze binnenkomen.

Hoe wordt een dataLayer.push een analyticsevent?

Een dataLayer.push() wordt een analyticsevent wanneer Tag Manager het bericht verwerkt, de sleutel event koppelt aan een trigger en een tag laat afgaan die de gepushte waarden leest. De volgorde kent vijf stappen:

  1. Declareer de array één keer, boven de containersnippet. De installatiecode van Google is window.dataLayer = window.dataLayer || [];, geplaatst voordat Tag Manager laadt.
  2. Push een bericht met een eventnaam. De syntaxis van Google is dataLayer.push({'event': 'event_name'}), en één push kan naast het event ook waarden meedragen, zoals in dataLayer.push({'color': 'red', 'conversionValue': 50, 'event': 'customize'}).
  3. Tag Manager zet het bericht in de wachtrij en verwerkt het. Google stelt dat "Tag Manager berichten verwerkt in volgorde van binnenkomst: elk bericht wordt één voor één verwerkt, in de volgorde waarin het werd ontvangen".
  4. Een Custom Event-trigger matcht de eventnaam. "Als het bericht een event is, gaan alle tags waarvan aan de triggervoorwaarden is voldaan af voordat Tag Manager doorgaat naar het volgende bericht."
  5. Een Data Layer Variable geeft de waarde door aan de tag, en de tag stuurt die verder, bijvoorbeeld als GA4-eventparameter.

Stap 4 verklaart een regel waar mensen over struikelen. Een push zonder sleutel event werkt waarden bij, maar laat niets afgaan. Google waarschuwt dat pushes vanuit paginacode "niet gegarandeerd beschikbaar zijn voor het volgende event", en de oplossing is "een eventnaam aan een bericht toevoegen wanneer het naar de datalaag wordt gepusht, en dan met een Custom Event-trigger naar die eventnaam luisteren".

De gtag.js-snippet gebruikt dezelfde wachtrij. De eigen snippet van Google definieert de functie gtag als wrapper van één regel:

window.dataLayer = window.dataLayer || [];
function gtag() {
  dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'TAG_ID');

Een site die zowel gtag.js als Tag Manager draait, heeft dus één array die berichten van beide ontvangt. Google zegt het expliciet: "Er wordt maar één dataLayer-object per pagina ondersteund."

Waarom blijven waarden in de datalaag van de ene push naar de volgende bestaan?

Waarden in de datalaag blijven bestaan omdat elke push wordt samengevoegd met een lopend "abstract datamodel", in plaats van het te vervangen. De opensourcebibliotheek data-layer-helper van Google, die dit model documenteert, zegt dat het model "de meest recente waarde bewaart voor alle sleutels die door een datalaagbericht zijn ingesteld". Scalaire waarden worden overschreven. Gewone objecten en arrays worden recursief samengevoegd: de sleutels van een nieuw object worden op het oude object gekopieerd, en de indexen van een nieuwe array worden over de indexen van de oude array geschreven, waarbij elke index die de nieuwe array niet instelt blijft staan.

Die regel is onschuldig voor een pageType-string en gevaarlijk voor e-commerce. Push een winkelwagenweergave met twee items en daarna een aankoop met één item, en het model kan nog steeds het tweede item uit de eerdere push bevatten. De GA4-gids voor e-commerce in Tag Manager van Google voorkomt dit door in alle 14 eventvoorbeelden eerst te wissen. Het aankoopvoorbeeld, ingekort:

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: { transaction_id: "T_12345", value: 72.05, currency: "USD", items: [ ... ] }
});

De null werkt omdat null in de samenvoegtabel onder "al het andere" valt, dus het oude object wordt in één keer overschreven. De volgende push wordt dan op niets samengevoegd. Tonen je omzetrapporten items die niemand kocht, controleer dan eerst of er een wisactie ontbreekt voordat je iets anders gaat doorlichten. De GA4-kant van die opzet komt aan bod in e-commercetrackingtools kiezen zonder te veel te tracken.

Een developer zoekt een fout in code op een laptop, passend bij de sectie over wat een datalaag laat breken.

E-commercepush zonder en met wissen
Geen ecommerce: null
  • De winkelwagenweergave pusht twee items
  • De aankooppush voegt één item toe
  • Door het samenvoegen blijft het eerdere item in het model
  • Het GA4-aankoopevent rapporteert een item dat niemand kocht
Eerst ecommerce: null gepusht
  • De wispush overschrijft het oude e-commerceobject
  • De aankooppush wordt op niets samengevoegd
  • GA4 ziet alleen transaction_id T_12345 en de eigen items
Dezelfde samenvoegregel die een pageType-string meeneemt, neemt ook verouderde winkelwagenitems mee naar een aankoopevent, tenzij de push het model eerst wist.

Wat laat een datalaag breken?

Zes fouten verklaren de meeste datalagen die correct lijken maar events laten vallen. Elke fout komt uit de eigen probleemoplossingslijst van Google of volgt uit de samenvoegregels hierboven.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

FoutWat er gebeurtOplossing
dataLayer = [{...}] nadat de container is geladen"het overschrijft alle bestaande waarden", en Tag Manager ziet geen pushes meerDeclareer één keer met de beveiligde snippet van Google en roep daarna alleen push() aan
datalayer.push(...) in kleine letters"De objectnaam dataLayer is hoofdlettergevoelig", dus de push gaat nergens heenGebruik overal dezelfde schrijfwijze
visitorType op de ene pagina, visitor_type op een andere"je tags kunnen dan niet consequent op alle bedoelde plekken afgaan"Eén naamgevingsconventie voor de hele site
Waarden gepusht zonder sleutel eventWaarden worden bijgewerkt, maar er gaat geen trigger afNoem een event in dezelfde push
Verwachten dat waarden een navigatie overlevenElke variabele "blijft alleen bestaan zolang de bezoeker op de huidige pagina blijft"Push waarden op paginaniveau bij elke paginalading
Geen e-commercewisVerouderde items en waarden smelten samen met het volgende eventPush eerst { ecommerce: null }

De rij over naamgeving is waar een datalaag de rest van je instrumentatie raakt. Een datalaag is maar zo consistent als de specificatie erachter, en dat is de taak van een trackingplan. De namen zelf volgen de regels uit hoe een naamgevingsconventie voor events haar eerste hernoeming overleeft.

Wat moet een push naar de datalaag bevatten?

Een push naar de datalaag hoort de eventnaam en de waarden te bevatten die een rapport nodig heeft, en niets wat een persoon identificeert. Alles wat je pusht, is leesbaar voor elke tag in de container, ook voor tags die later door iemand anders worden toegevoegd. De inhoud van formuliervelden, e-mailadressen en namen horen niet in de wachtrij; push in plaats daarvan een formulier-ID en een resultaat, zoals de praktische gids over tracking zonder cookies voor formulieren uitlegt.

Een handige toets is dezelfde die je op elk event toepast: elke waarde in de push moet een vraag beantwoorden die een rapport stelt. Kan niemand het rapport noemen, laat de sleutel dan vallen. De onderliggende praktijk, acties vastleggen als benoemde events met eigenschappen, komt aan bod in hoe eventtracking vastlegt wat gebruikers echt deden.

Heeft elke analyticstool een datalaag nodig?

Geen enkele analyticstool heeft strikt een datalaag nodig; de laag bestaat zodat een tag manager één set waarden naar veel leveranciers kan sturen. Een tool die events via een directe functieaanroep ontvangt, slaat de wachtrij en de samenvoegregels over. Zo werkt Flowsery: de doeltracking legt events vast met één aanroep zoals window.flowsery("signup"), "zonder ingewikkelde opzet of tag managers". Events verschijnen in een realtime feed, zodat je "je tracking direct kunt debuggen en valideren", aan events kunnen omzetwaarden worden gekoppeld om de impact van elke actie te meten, en events worden bijgehouden zonder cookies of persoonsgegevens. De functie voor doel- en eventtracking laat de opzet zien. Sites die al een datalaag voor andere leveranciers draaien, kunnen die houden en window.flowsery() aanroepen vanuit dezelfde code die het event pusht.

Veelgestelde vragen

Is de datalaag hetzelfde als Google Tag Manager?

Nee. De datalaag is de array op je pagina, en Tag Manager is één afnemer die hem leest. De snippet van Google voor gtag.js gebruikt dezelfde dataLayer-array zonder Tag Manager, en de client data layer van Adobe gebruikt een eigen array met de naam adobeDataLayer.

Waar hoort de code van de datalaag op de pagina?

Declareer hem zo hoog mogelijk op de pagina, boven de snippet van Tag Manager of gtag.js. Google zegt dat waarden die "beschikbaar moeten zijn voor Tag Manager wanneer de pagina laadt" ook boven de containercode moeten worden gepusht. Pushes die lager staan, bereiken de wachtrij nog steeds, maar komen pas na de eerste events van de container binnen.

Kan ik de variabele dataLayer hernoemen?

Ja. Tag Manager neemt de naam als parameter in de containersnippet, en gtag.js neemt een queryparameter l, zoals in l=myNewName. Elke declaratie en elke push moet dan de nieuwe naam gebruiken, want pushes naar de oude naam bereiken niets.

Waarom bevat mijn GA4-aankoopevent items uit een eerder event?

De eerdere push is samengevoegd met het datamodel en je aankooppush heeft het niet gewist. Arrays en gewone objecten worden recursief samengevoegd, dus achtergebleven items overleven. Push { ecommerce: null } direct vóór elk e-commerce-event, zoals de voorbeelden van Google doen.

Blijven waarden in de datalaag bestaan tussen paginaladingen?

Nee. Google stelt dat elke datalaagvariabele "alleen blijft bestaan zolang de bezoeker op de huidige pagina blijft". Waarden die op elke pagina belangrijk zijn, zoals een bezoekerstype of paginacategorie, moet je bij elke paginalading opnieuw pushen.

Wat is het verschil tussen dataLayer.push en gtag?

gtag() is een wrapper die dataLayer.push(arguments) aanroept, dus beide schrijven naar dezelfde wachtrij. Het verschil zit in het berichtformaat en de eigen methoden: volgens Google "moeten" functies die worden gepusht om set, get en reset te gebruiken rechtstreeks ".push gebruiken", omdat gtag een functie als "een ongeldige opdracht" ziet en negeert.

Waarom liet mijn dataLayer.push geen tag afgaan?

Een push laat alleen een tag afgaan als hij een eventsleutel meedraagt waar een Custom Event-trigger naar luistert. Waarden die zonder zo'n sleutel worden gepusht, werken de datalaag nog steeds bij, maar Tag Manager heeft niets om op te matchen, dus er draait geen trigger en er gaat geen tag af. Voeg de eventnaam toe aan dezelfde push, anders blijven die waarden liggen tot een later bericht er een meebrengt.

Gebruik ik digitalData of dataLayer voor een nieuw project?

Kies het model met een eventwachtrij, het model dat dataLayer en adobeDataLayer allebei gebruiken. Het accepteert pushes voordat er een script van een leverancier is geladen, en dat is precies het laadvolgordeprobleem waar het statusobjectmodel tegenaan loopt: een tag die digitalData leest voordat het object gevuld is, leest niets. digitalData komt bovendien uit een Community Group-rapport uit 2013 dat duidelijk zegt geen W3C-standaard te zijn.

Is het veilig om e-mailadressen naar de datalaag te pushen?

Nee. Alles wat naar de datalaag wordt gepusht, is leesbaar voor elke tag in de container, ook voor tags die later door iemand anders worden toegevoegd. Push in plaats daarvan een formulier-ID en een resultaat, nooit de echte inhoud van velden, een naam of een e-mailadres.

Is adobeDataLayer hetzelfde als de dataLayer van Google?

Beide zijn gewone arrays die berichten in volgorde verwerken, maar het zijn aparte globale variabelen. Tag Manager en gtag.js van Google delen window.dataLayer, en de client data layer van Adobe gebruikt een eigen array, window.adobeDataLayer. De documentatie van Adobe beschrijft hetzelfde voordeel in laadvolgorde: pagina's en scripts kunnen data registreren en events triggeren door naar de array te pushen voordat het script van de datalaag zelf is geladen.

Was dit artikel nuttig?

Laat ons weten wat je ervan vindt!

Zie ons vaker in Google

Met één klik markeer je Flowsery als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.

Voordat je gaat...

Flowsery

Flowsery

Analytics voor je website, met omzet voorop

Volg elke bezoeker, bron en conversie in realtime. Eenvoudig, krachtig en zonder cookies.

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Gerelateerde begrippen

Contentgroepering in GA4 instellen met één parameterContentgroepering in GA4 instellen met één parameter
Woordenlijst

Contentgroepering in GA4 instellen met één parameter

Stel contentgroepering in GA4 in met de parameter content_group in gtag of Tag Manager, lees de dimensie Content group en houd (not set)-rijen eruit.

•8 min leestijd
Hoe eventparameters in GA4 de details achter elk event meedragenHoe eventparameters in GA4 de details achter elk event meedragen
Woordenlijst

Hoe eventparameters in GA4 de details achter elk event meedragen

Google beperkt eventparameters in GA4 tot 25 per event. Bekijk de limieten voor namen en waarden, gereserveerde namen en waarom aangepaste parameters buiten rapporten blijven.

•8 min leestijd
Wat er in een trackingplan hoort, en wat het niet kan vangenWat er in een trackingplan hoort, en wat het niet kan vangen
Woordenlijst

Wat er in een trackingplan hoort, en wat het niet kan vangen

Een trackingplan noemt elk event, elke trigger, eigenschap en eigenaar voordat er code live gaat. Bekijk de kolommen, een ingevuld voorbeeld en het gat dat validatietools missen.

•8 min leestijd
Hoe een naamgevingsconventie voor events de eerste hernoeming overleeftHoe een naamgevingsconventie voor events de eerste hernoeming overleeft
Woordenlijst

Hoe een naamgevingsconventie voor events de eerste hernoeming overleeft

Een naamgevingsconventie voor events moet voldoen aan de gereserveerde namen, het maximum van 40 tekens en de hoofdlettergevoeligheid van GA4, want hernoemen na de lancering raakt de historie nooit.

•9 min leestijd
Wat er veranderde met key events en conversies in GA4Wat er veranderde met key events en conversies in GA4
Woordenlijst

Wat er veranderde met key events en conversies in GA4

Google splitste één woord in tweeën: key events en conversies in GA4 zijn nu verschillende objecten in Analytics en Ads. Wat ze betekenen en waar je ze terugziet.

•7 min leestijd
Waarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage isWaarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage is
Woordenlijst

Waarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage is

Je GA4-bouncepercentage is het aandeel sessies zonder engagement. Hoe Google het definieert, hoe het verschilt van Universal Analytics en waar je het toevoegt.

•7 min leestijd

Gerelateerde artikelen