YouTube-video's meten met Google Tag Manager en GA4

YouTube-video's meten (YouTube video tracking) kan in GA4 via verbeterde meting (enhanced measurement) of, met meer controle over drempels en parameters, via het triggertype YouTube-video in Google Tag Manager (GTM). Beide routes leunen op de YouTube IFrame Player API. Gebruik je beide tegelijk zonder maatregelen, dan kan dezelfde interactie twee keer binnenkomen. Kies daarom één route (zie het slot van dit artikel).

Verbeterde meting voor YouTube-video's

Voor ingesloten YouTube-video's met JS API-ondersteuning stuurt verbeterde meting drie events:

• video_start: de video begint te spelen;
• video_progress: de video passeert 10%, 25%, 50% en 75% van de duur;
• video_complete: de video is afgelopen.

Parameters: video_current_time, video_duration, video_percent, video_provider, video_title, video_url en visible (boolean). De drempels zijn niet aan te passen; wil je andere punten, dan heb je een eigen trigger nodig.

Javascript API en origin

Zonder JS API kan een pagina de speler niet aansturen of uitlezen. Onder de motorkap regelt YouTube dit met de parameter enablejsapi in de iframe-URL: waarde 1 maakt besturing via de IFrame Player API mogelijk, de standaardwaarde is 0. Bij gebruik van de IFrame API hoort ook origin op je eigen domein te staan, als extra beveiliging.

<iframe id="ytplayer" width="640" height="360"
  src="https://www.youtube.com/embed/VIDEO_ID?enablejsapi=1&origin=https://www.voorbeeld.nl"
  title="Titel van de video" allowfullscreen></iframe>

GA4 noemt in de Help alleen "JS API-ondersteuning"; dat dit enablejsapi=1 is, volgt uit de YouTube player parameters en de GTM-Help. Staat de parameter niet in de src, dan komen er via verbeterde meting geen video-events binnen.

YouTube video tracking met de YouTube-videotrigger in GTM

Zet eerst de videovariabelen aan via Variabelen → Configureren. De NL-Help noemt Huidige tijd video, Videoduur, Videopercentage, Videoprovider, Videostatus, Video Title, Video-URL en Video zichtbaar. Zij lezen de dataLayer-sleutels gtm.videoCurrentTime, gtm.videoDuration, gtm.VideoPercent (met hoofdletter V; zo gespeld in de Google-Help, terwijl elders vaak gtm.videoPercent staat), gtm.videoProvider, gtm.videoStatus, gtm.videoTitle, gtm.videoUrl en gtm.videoVisible.

Maak de trigger via Triggers → Nieuw → Triggerconfiguratie → YouTube-video. Onder Vastleggen kies je:

• Start;
• Voltooid;
• Pauzeren, zoeken en bufferen;
• Voortgang, als percentages of tijdsdrempels: kommagescheiden gehele getallen, bijvoorbeeld 25, 50, 75.

Een drempel vuurt alleen de eerste keer dat hij wordt bereikt. Zoekt de bezoeker voorbij een drempel, dan vuurt die niet. Voortgang is bovendien relatief aan de tijdlijn van de video en niet aan de daadwerkelijk bekeken tijd; een progress-event zegt dus niets over aaneengesloten kijken.

De trigger vuurt op het dataLayer-event gtm.video; gtm.videoStatus bevat de actie. Gangbare waarden zijn start, progress, complete, pause en buffering. Controleer in Tag Assistant welke waarden jouw container pusht, ook voor zoeken.

Gevolgen van "JavaScript API inschakelen"

Onder Geavanceerd staat Ondersteuning voor de JavaScript API toevoegen aan alle YouTube-video's (Enable JavaScript API). Aangevinkt zorgt GTM ervoor dat enablejsapi=1 aan de YouTube-URL's wordt toegevoegd. Consequenties:

• Een video die al speelt terwijl GTM laadt, wordt opnieuw geladen. Bezoekers kunnen dat als flikkering zien.
• GTM laadt daarbij vaak ook de bibliotheek https://www.youtube.com/iframe_api (bevinding van derden; Google noemt dit niet expliciet in de trigger-Help).
• Het voegt enablejsapi toe, maar niet origin. Wil je dat, zet het dan zelf in de embedcode.
• Voeg je enablejsapi=1 zelf toe in de HTML, dan hoeft de optie niet aan en voorkom je de herlaadactie.
• De trigger start standaard bij Window Load (gtm.load). Opties zijn ook Container Load (gtm.js) en DOM Ready (gtm.dom).

Beperking voor late embeds: de trigger werkt tijdens en na het laden van de pagina, mits bij het laden van GTM minstens één ingesloten YouTube-video of het script van de YouTube IFrame Player API aanwezig is. Wordt een video pas later ingeladen, bijvoorbeeld in een pop-up, en is dan geen van beide aanwezig, dan meet je die video mogelijk niet. Recycle een iframe ook niet voor meerdere video's: laadt de pagina de embed opnieuw nadat GTM hem heeft geïnspecteerd, dan is de listener weg.

GA4-eventtag en dubbele telling

Koppel de trigger aan een GA4-gebeurtenistag. Parameters: video_title = {{Video Title}}, video_percent = {{Video Percent}}.

Tag:              Google Analytics: GA4-gebeurtenis
Gebeurtenisnaam:  yt_video_progress
Parameters:       video_title   = {{Video Title}}
                  video_percent = {{Video Percent}}
                  video_url     = {{Video URL}}

Een parameterwaarde is maximaal 100 tekens; lange titels zijn een risico. Het gedrag bij overschrijding is niet vastgesteld. Voor rapportage maak je een aangepaste dimensie met gebeurtenisbereik via Beheer → Gegevensweergave → Aangepaste definities. Dat kan 24 tot 48 uur duren.

Dubbele telling voorkom je door één route te kiezen, op twee manieren: zet Video-engagement uit in Beheer → Verzameling en wijziging van gegevens → Gegevensstreams → je webstream → Verbeterde meting, of gebruik in GTM andere gebeurtenisnamen dan video_start, video_progress en video_complete. Dat beide routes tegelijk kunnen dubbel tellen, controleer je in DebugView. Kies dus één route per property.

Een consentplugin die de iframe blokkeert tot toestemming, kan het meten verhinderen. Test met en zonder toestemming in de Preview-modus.

Deze trigger is alleen voor YouTube. Vimeo valt erbuiten.