Plugins zijn scripts die de functionaliteit van analytics.js verbeteren om te helpen bij het meten van gebruikersinteractie. Plugins zijn meestal specifiek voor een set van functies die niet nodig zijn voor alle Google Analytics-gebruikers, zoals e-commerce of cross-domain meting, en zijn daarom niet standaard opgenomen in analytics.js.

Deze gids legt uit hoe u analytics.js plugins kunt vereisen en gebruiken.

Plugin’s vereisen

Het require commando neemt de naam van een plugin en registreert deze voor gebruik met de ga() commandowachtrij. Als de plugin configuratie-opties accepteert, kunnen die opties worden doorgegeven als het laatste argument voor het require commando.

Hier volgt de volledige require signatuur van het commando:

ga('require', pluginName, );

Hier ziet u bijvoorbeeld hoe u de Enhanced Ecommerce plugin zou vereisen voor gebruik met de standaard tracker:

ga('require', 'ec');

En hier zie je hoe je de Reclamefuncties-plugin vereist voor een tracker met de naam “myTracker” en hoe je een configuratieoptie doorgeeft die de standaardcookienaamwaarde opheft:

ga('myTracker.require', 'displayfeatures', { cookieName: 'display_features_cookie'});

Laden van de plugin code

Het require commando initialiseert de plugin methodes voor gebruik met de ga() commando wachtrij, maar het laadt niet het plugin script zelf. Als u een plugin van derden gebruikt, of zelf een plugin schrijft, moet u de plugincode handmatig aan de pagina toevoegen.

De aanbevolen methode om plugincode aan de pagina toe te voegen is via een <script>-tag met het async-attribuut om ervoor te zorgen dat het laden van andere functies op uw site niet wordt geblokkeerd.

De volgende code vereist en laadt een hypothetische plugin voor het volgen van links:

<script>ga('create', 'UA-XXXXX-Y', 'auto');ga('require', 'linkTracker');ga('send', 'pageview');</script><!--Note: plugin scripts must be included after the tracking snippet. --><script async src="/path/to/link-tracker-plugin.js"></script>

Wachten op het laden van de plugins

Omdat zowel de analytics.js bibliotheek als de analytics.js plugins asynchroon worden geladen, kan het een uitdaging zijn om te weten wanneer plugins volledig zijn geladen en klaar zijn om te worden gebruikt.

De analytics.js bibliotheek lost dit probleem op door de uitvoering van de opdrachtwachtrij te stoppen wanneer deze een require commando tegenkomt voor een plugin die nog niet is geladen. Zodra de plugin is geladen, gaat de uitvoering van de wachtrij gewoon door.

Als gevolg hiervan is het uiterst belangrijk dat je de plugins die je gebruikt test om er zeker van te zijn dat ze correct worden geladen en uitgevoerd. Als een plugin niet laadt of een fout vertoont, zullen alle volgende analytics.js commando’s niet worden uitgevoerd.

Oproepen van plugin-methodes

Nadat een plugin is vereist, worden zijn methodes beschikbaar voor gebruik met de ga() commandowachtrij. Hier is de commando signatuur voor het aanroepen van plugin methodes:

ga('methodName', ...args);

Voorbeeld, de Enhanced Ecommerce plugin’s addProduct methode kan als volgt worden aangeroepen:

ga('ec:addProduct', { 'id': 'P12345', 'quantity': 1});

Of op een tracker met naam door de naam van de tracker aan de command string toe te voegen:

ga('myTracker.ec:addProduct', { 'id': 'P12345', 'quantity': 1});

Als u alle gidsen in dit gedeelte hebt gelezen, zou u bekend moeten zijn met de meeste functies van analytics.js. De volgende gids legt uit hoe u uw analytics.js implementaties kunt debuggen om gemakkelijker fouten op te sporen en precies te zien wat uw code doet.