TL;DR, kort antwoord
9 min leestijdEen 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.
| Statusobject | Eventwachtrij | |
|---|---|---|
| Voorbeeld | W3C Customer Experience Digital Data Layer 1.0 | Google Tag Manager, Adobe Client Data Layer |
| Globale naam | digitalData | dataLayer, adobeDataLayer |
| Structuur | Eén genest object met de onderdelen page, product, cart, transaction, event en user | Een gewone array; elke push() voegt een bericht toe |
| Hoe tags hem lezen | Lezen eigenschappen uit wanneer de tag draait | Verwerken berichten in volgorde en reageren op events |
| Timingprobleem | Een tag die draait voordat het object gevuld is, leest niets | Berichten 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.

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:
- Declareer de array één keer, boven de containersnippet. De installatiecode van Google is
window.dataLayer = window.dataLayer || [];, geplaatst voordat Tag Manager laadt. - 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 indataLayer.push({'color': 'red', 'conversionValue': 50, 'event': 'customize'}). - 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".
- 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."
- 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.

- 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
- De wispush overschrijft het oude e-commerceobject
- De aankooppush wordt op niets samengevoegd
- GA4 ziet alleen transaction_id T_12345 en de eigen items
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.
Realtime dashboard
Doelen bijhouden
Tracking zonder cookies
| Fout | Wat er gebeurt | Oplossing |
|---|---|---|
dataLayer = [{...}] nadat de container is geladen | "het overschrijft alle bestaande waarden", en Tag Manager ziet geen pushes meer | Declareer éé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 heen | Gebruik 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 event | Waarden worden bijgewerkt, maar er gaat geen trigger af | Noem een event in dezelfde push |
| Verwachten dat waarden een navigatie overleven | Elke variabele "blijft alleen bestaan zolang de bezoeker op de huidige pagina blijft" | Push waarden op paginaniveau bij elke paginalading |
| Geen e-commercewis | Verouderde items en waarden smelten samen met het volgende event | Push 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
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 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.


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


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.


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.


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.
Gerelateerde artikelen


Wat het rapport over landingspagina's in GA4 telt en waar het leeg blijft
Het rapport over landingspagina's in GA4 toont de eerste pagina van elke sessie. Waar je het vindt, de standaardstatistieken, waarom (not set)-rijen verschijnen en hoe je de bron toevoegt.


Hoe het bijhouden van zoekopdrachten op je site in GA4 vastlegt wat bezoekers typen
Stel zoekopdrachten op je site in GA4 in met enhanced measurement, voeg je eigen queryparameters toe, vind de dimensie Search term en volg zoekopdrachten zonder URL.


Gebruikerseigenschappen in GA4 instellen en erover rapporteren
Stel gebruikerseigenschappen in GA4 in met gtag of Tag Manager, registreer ze als aangepaste dimensies op gebruikersniveau en blijf binnen de limiet van 25 eigenschappen.

