Woordenlijst

Wat gtag is, hoe het laadt en wat elk commando verstuurt

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •8 min leestijd
Wat gtag is, hoe het laadt en wat elk commando verstuurtWat gtag is, hoe het laadt en wat elk commando verstuurt

TL;DR, kort antwoord

8 min leestijd

gtag() is de JavaScript-functie achter de Google-tag (gtag.js). Elke aanroep zet een commando in de dataLayer, en de bibliotheek gtag.js, die asynchroon van googletagmanager.com laadt, leest die wachtrij en stuurt data naar Google Analytics, Google Ads en andere Google-producten. De belangrijkste commando's zijn config, event, set, get en consent. Standaardwaarden voor consent moeten vóór elke config- of event-aanroep draaien, en Google verwijst mensen die niet vertrouwd zijn met JavaScript naar Google Tag Manager.

Wat is gtag?

De functie gtag() is de JavaScript-API van de Google-tag, en elke aanroep zet een commando zoals config, event, set of consent in een wachtrij met de naam dataLayer, die de bibliotheek gtag.js uitleest om data naar Google-producten te sturen. De referentie van Google zegt het in één regel: "The Google tag (gtag.js) API uses the gtag() function to send data to Google products like Google Analytics and Google Ads." Laadt de broncode van een site gtag/js?id=, dan draait die site de Google-tag direct in de eigen code in plaats van via een Tag Manager-container.

Drie namen raken hier door elkaar. gtag.js is het bibliotheekbestand. gtag() is de functie die je code aanroept. De Google-tag is de productnaam die Google voor de hele set-up gebruikt, die het omschrijft als "één tag die je aan je website toevoegt om meet- en advertentieproducten van Google te gebruiken, zoals Google Ads, Google Analytics, Campaign Manager, Display & Video 360 en Search Ads 360."

Hoe laadt gtag.js op een pagina?

gtag.js laadt via een fragment in twee delen dat Google je laat plaatsen "direct na de openende <head>-HTML-tag op elke pagina die je wilt meten." Het eerste deel downloadt de bibliotheek, het tweede deel definieert de functie gtag() en zet de eerste commando's in de wachtrij.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag() {
    dataLayer.push(arguments);
  }
  gtag('js', new Date());
  gtag('config', 'TAG_ID');
</script>

De volgorde maakt minder uit dan het lijkt. De bibliotheek laadt met async, dus het inline script draait eerst. Omdat gtag() niets anders doet dan dataLayer.push(arguments), wacht elk commando dat je aanroept voordat de bibliotheek binnen is in de dataLayer-array, en gtag.js verwerkt de wachtrij zodra het is geladen. Daarom kun je gtag('event', ...) overal op de pagina aanroepen zonder te controleren of de bibliotheek klaar is.

De id in de script-URL is een Google-tag-ID. Google noemt "GT-XXXXXXXXX, G-XXXXXXXXX en AW-XXXXXXXXX" als voorbeelden en merkt op dat "de ID's door elkaar kunnen worden gebruikt als je de Google-tag aan je website toevoegt." Eén Google-tag kan meerdere ID's dragen en naar meerdere bestemmingen sturen, zoals een Google Analytics-property en een Google Ads-account.

Wat er met een gtag-aanroep gebeurt voordat de bibliotheek laadt
Inline fragment definieert gtag()
Commando wordt in de dataLayer gezet
gtag.js komt binnen van googletagmanager.com
Wachtrij wordt op volgorde gelezen
Data gaat naar Google-producten
Wordt het verzoek voor de bibliotheek geblokkeerd, dan stopt de keten na de tweede stap.

Wat doen de gtag()-commando's?

De gtag()-commando's zijn vijf werkwoorden, die je elk als eerste argument meegeeft: config, event, set, get en consent. De tabel gebruikt de syntaxis en bewoording uit de API-referentie van Google.

CommandoSyntaxisWat het volgens Google doet
configgtag('config', '<TARGET_ID>', {...})"Hiermee voeg je extra configuratie-informatie toe aan targets."
eventgtag('event', '<event_name>', {...})"Gebruik het commando event om eventdata te versturen."
setgtag('set', {...})"Hiermee definieer je parameters die aan elk volgend event op de pagina worden gekoppeld."
getgtag('get', '<target>', '<field_name>', callback)"Hiermee haal je verschillende waarden op uit gtag.js, waaronder waarden die met het commando set zijn ingesteld."
consentgtag('consent', 'default' or 'update', {...})"Gebruik het commando consent om toestemming in te stellen."

config doet meer dan de beschrijving doet vermoeden. Google zegt dat "het commando config nodig is om data naar advertentieproducten van Google te sturen," en voor Google Analytics verstuurt de standaard config-aanroep ook een page_view-event. Om dat te voorkomen, documenteert Google send_page_view: false, wat je nodig hebt als je paginaweergaven zelf verstuurt, bijvoorbeeld in een single-page app.

set gebruik je spaarzaam. Google voegt toe: "We raden aan waar mogelijk de commando's config of event te gebruiken." Waarden op eventniveau overschrijven configwaarden, en configwaarden overschrijven alles wat globaal met set is ingesteld.

consent kent twee modi. 'default' stelt de beginstatus in voordat de bezoeker je banner beantwoordt, en 'update' wijzigt die daarna. De vier parameters in consent mode v2 zijn ad_storage, analytics_storage, ad_user_data en ad_personalization; de gids over Google consent mode v2 behandelt wat de twee nieuwere signalen toevoegden.

Handen schrijven een genummerde checklist in een notitieboek, als beeld van de vaste volgorde waarin gtag-commando's moeten draaien.

In welke volgorde moeten gtag-commando's draaien?

gtag-commando's draaien in de volgorde waarin je ze in de wachtrij zet, en drie ervan werken alleen als ze vóór de eerste config- of event-aanroep komen.

  1. Opt-outvlag. window['ga-disable-MEASUREMENT_ID'] = true "moet worden ingesteld voordat er aanroepen naar gtag() worden gedaan, en op elke pagina waarop je Analytics wilt uitzetten."
  2. Standaardwaarden voor consent. Google zegt dat je de standaardwaarde voor elk consenttype instelt "op elke pagina van je site vóór commando's die meetdata versturen (zoals config of event)." Laadt je consenttool asynchroon, voeg dan wait_for_update toe met een waarde in milliseconden.
  3. Globale instellingen. set-aanroepen zoals allow_google_signals: false komen vóór config, zodat de eerste hit ze al meedraagt.
  4. config. Eén aanroep per tag-ID.
  5. event. Al het andere daarna.

Een standaardwaarde voor consent die na config staat, komt te laat voor de eerste paginaweergave, en dat is een van de stillere manieren waarop een site hits verstuurt die hij eigenlijk wilde tegenhouden.

Hoe verhoudt gtag zich tot de Google-tag en Google Tag Manager?

gtag.js en Google Tag Manager zijn twee manieren om dezelfde Google-tag uit te rollen: met gtag.js schrijf je de commando's in de code van je pagina, en met Tag Manager stel je ze in via een webinterface en laadt het containerscript, gtm.js, ze voor je. De gtag.js-gids van Google zegt: "Ben je niet vertrouwd met JavaScript, dan raden we aan Google Tag Manager te gebruiken in plaats van gtag.js."

gtag.js in de paginaGoogle Tag Manager
Geladen scriptgtag/js?id=G-...gtm.js?id=GTM-...
Waar de commando's staanIn de code van je siteTags en triggers in de GTM-container
Wie tracking wijzigtDevelopers, via een deploymentIedereen met toegang tot de container, via een publicatie
Gebruikte IDGoogle-tag-ID (G-, AW-, GT-)Container-ID (GTM-), die daarna de Google-tag laadt

De twee delen de dataLayer, dus een site kan beide draaien. Het risico is dubbel tellen. Google waarschuwt bijvoorbeeld dat je, als je tags via Tag Manager instelt, niet ook automatische history tracking in Google Analytics moet aanzetten, "omdat dat kan leiden tot dubbel getelde paginaweergaven." Dezelfde logica geldt voor een hardgecodeerd gtag-fragment en een GTM-Google-tag die allebei naar dezelfde measurement ID wijzen: elk verstuurt een eigen page_view. De gids over de privacy-impact van Google Tag Manager behandelt de andere kant van die keuze: hoeveel code een container andere mensen op je pagina's laat zetten.

Een rood-witte slagboom sluit een weg af, als beeld van een geblokkeerd verzoek dat voorkomt dat gtag-data de pagina verlaat.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Waarom houden adblockers gtag tegen?

Adblockers houden gtag tegen door het verzoek voor de bibliotheek op www.googletagmanager.com te blokkeren, of de hits die het naar de verzamelendpoints van Google stuurt. Mislukt het scriptverzoek, dan bestaat gtag() nog steeds, omdat het inline fragment hem definieerde, maar niets leest ooit de wachtrij in de dataLayer, dus er verlaat geen data de pagina. De gids over adblockers en de nauwkeurigheid van analytics legt uit hoe dat gat in rapporten zichtbaar wordt. Google tag gateway for advertisers serveert de tag vanaf je eigen domein, al noemt de gateway-documentatie van Google geen adblockers.

Hoe controleer je wat gtag verstuurt?

Je controleert wat gtag verstuurt door naar de netwerkverzoeken en de debugtools van Google te kijken, niet door het fragment te lezen. De eigen gidsen van Google gebruiken er twee: Tag Assistant, dat de commando's toont en de hits die elk ervan opleverde, en DebugView in Google Analytics, dat events toont zodra ze binnenkomen als debugmodus aanstaat. Filter in de browser het tabblad Network op de verzamelverzoeken en controleer dat elke paginaweergave of elk event één keer verschijnt, met de parameters die je verwacht. De checklist om je analytics te verifiëren loopt dezelfde controles door voor elke tracker.

Hoe verhoudt het script van Flowsery zich tot gtag?

De tracker van Flowsery is één scripttag met een website-ID, dus er is geen commandowachtrij om in te stellen voordat er data stroomt. Plak <script defer data-fl-website-id="flid_******" src="https://cdn.flowsery.com/main.js"></script> in de head, en paginaweergaven worden automatisch gemeten. Custom doelen gebruiken een attribuut data-fs-goal op het element of een aanroep zoals window.flowsery('signup'), en de documentatie van Flowsery toont een kleine wachtrij-stub, window.flowsery.q, die aanroepen vasthoudt die worden gedaan voordat het script laadt: hetzelfde patroon dat gtag met de dataLayer gebruikt. Het script heeft ook een cookieloze optie die een dagelijks wisselende bezoekershash gebruikt en geen persoonsgegevens opslaat. Het lichte script is kleiner dan 10 KB en laadt asynchroon. Beheert je team al tags in Google Tag Manager, dan bevat de documentatie van Flowsery een set-up met een Custom HTML-tag voor GTM, zodat de twee tijdens een migratie naast elkaar kunnen staan.

Veelgestelde vragen

Is gtag hetzelfde als Google Tag Manager?

Nee. gtag.js is de bibliotheek achter de Google-tag, en je roept gtag() aan vanuit de code van je eigen pagina. Google Tag Manager is een aparte container, geladen via gtm.js, waarin tags in een webinterface worden ingesteld. Beide kunnen dezelfde Google-tag uitrollen.

Kan ik gtag() aanroepen voordat gtag.js is geladen?

Ja. Het inline fragment definieert gtag() als een functie die de argumenten in de dataLayer-array zet. Aanroepen die worden gedaan voordat de bibliotheek binnen is, wachten in die wachtrij, en gtag.js verwerkt ze op volgorde zodra het is geladen.

Kan één gtag-fragment data naar Google Analytics en Google Ads sturen?

Ja. Eén Google-tag kan met meerdere bestemmingen verbinden, zoals een Google Analytics-property en een Google Ads-account. Eén tag kan meerdere tag-ID's dragen, en Google merkt op dat die ID's door elkaar kunnen worden gebruikt als je de tag aan je site toevoegt.

Waarom verstuurt gtag een page_view zonder event-aanroep?

De standaard config-aanroep voor een Google Analytics-ID verstuurt zelf een page_view-event. Stel send_page_view: false in als je paginaweergaven handmatig wilt versturen. Op sites met enhanced measurement gaan paginaweergaven op basis van de browsergeschiedenis nog steeds af, tenzij je die optie ook in de datastream uitzet.

Waar moet het gtag-fragment staan?

Google zegt dat je het direct na de openende <head>-tag plaatst op elke pagina die je wilt meten. Een opt-outvlag komt in een script vóór het fragment, omdat Google zegt dat die vóór elke gtag()-aanroep moet worden ingesteld. Standaardwaarden voor consent komen in het fragment, vóór de config-aanroep, omdat Google zegt dat ze vóór elk commando moeten draaien dat meetdata verstuurt.

Werkt gtag als het script wordt geblokkeerd?

Er wordt geen data verstuurd. Het inline deel van het fragment definieert gtag() nog steeds en vult de dataLayer, maar zonder de bibliotheek gtag.js verwerkt niets die wachtrij. Daarom ontbreken geblokkeerde bezoekers in Google Analytics in plaats van als fouten te verschijnen.

Wat is het verschil tussen gtag.js, gtag() en de Google-tag?

gtag.js is het bibliotheekbestand dat van googletagmanager.com laadt. gtag() is de functie die je code aanroept om commando's in de dataLayer te zetten. De Google-tag is de naam die Google voor de hele set-up gebruikt: één tag die producten als Google Ads en Google Analytics dekt.

Welke formaten voor tag-ID's kan ik in het gtag-fragment gebruiken?

Google noemt GT-XXXXXXXXX, G-XXXXXXXXX en AW-XXXXXXXXX als voorbeelden en zegt dat de ID's door elkaar kunnen worden gebruikt als je de Google-tag aan je website toevoegt. De ID komt in de parameter id van de script-URL en in je config-aanroep. Eén Google-tag kan meerdere ID's dragen.

Wanneer gebruik ik gtag('set')?

Gebruik set voor parameters die aan elk volgend event op de pagina moeten hangen. Google raadt waar mogelijk config of event aan. Eventwaarden overschrijven configwaarden, en configwaarden overschrijven alles wat globaal is ingesteld. Gebruik je set toch, zet het dan vóór config, zodat de eerste hit de waarden al meedraagt.

Hoe zet ik Google Analytics uit met een gtag-opt-outvlag?

Stel window['ga-disable-MEASUREMENT_ID'] = true in op de pagina. Google zegt dat het moet worden ingesteld voordat er aanroepen naar gtag() worden gedaan, en op elke pagina waarop je Analytics wilt uitzetten.

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

Gebruikerseigenschappen in GA4 instellen en erover rapporterenGebruikerseigenschappen in GA4 instellen en erover rapporteren
Woordenlijst

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.

•8 min leestijd
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
Zo werkt een opt-out voor Google Analytics, en wat elke methode blokkeertZo werkt een opt-out voor Google Analytics, en wat elke methode blokkeert
Woordenlijst

Zo werkt een opt-out voor Google Analytics, en wat elke methode blokkeert

Een opt-out voor Google Analytics kan een browserextensie zijn, een ga-disable-vlag op window of geweigerde toestemming. Wat elke methode blokkeert, wie er de baas over is en waar ze ophoudt.

•8 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
Wat het rapport over landingspagina's in GA4 telt en waar het leeg blijftWat het rapport over landingspagina's in GA4 telt en waar het leeg blijft
Woordenlijst

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.

•8 min leestijd
Hoe het bijhouden van zoekopdrachten op je site in GA4 vastlegt wat bezoekers typenHoe het bijhouden van zoekopdrachten op je site in GA4 vastlegt wat bezoekers typen
Woordenlijst

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.

•8 min leestijd

Gerelateerde artikelen