Plugins sind Skripte, die die Funktionalität von analytics.js erweitern, um die Messung der Nutzerinteraktion zu unterstützen. Plugins sind in der Regel spezifisch für eine Reihe von Funktionen, die nicht von allen Google Analytics-Nutzern benötigt werden, wie z. B. E-Commerce oder domänenübergreifende Messungen, und sind daher nicht standardmäßig in analytics.js enthalten.

In dieser Anleitung wird erklärt, wie analytics.js-Plugins angefordert und verwendet werden.

Plugins anfordern

Der require-Befehl nimmt den Namen eines Plugins und registriert es für die Verwendung mit der ga()-Befehlswarteschlange. Wenn das Plugin Konfigurationsoptionen akzeptiert, können diese Optionen als letztes Argument an den Befehl require übergeben werden.

Nachfolgend finden Sie die vollständige require-Befehlssignatur:

ga('require', pluginName, );

Beispielsweise würden Sie hier das Enhanced Ecommerce Plugin für die Verwendung mit dem Standard-Tracker anfordern:

ga('require', 'ec');

Und so würden Sie das Advertising Features Plugin für einen Tracker namens „myTracker“ anfordern und eine Konfigurationsoption übergeben, die den Standardwert für den Cookie-Namen überschreibt:

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

Laden des Plugin-Codes

Der require-Befehl initialisiert die Plugin-Methoden für die Verwendung mit der ga()-Befehlswarteschlange, aber er lädt nicht das Plugin-Skript selbst. Wenn Sie ein Plugin eines Drittanbieters verwenden oder selbst ein Plugin schreiben, müssen Sie den Plugin-Code manuell zur Seite hinzufügen.

Die empfohlene Methode zum Hinzufügen von Plugin-Code zur Seite ist über ein <script>-Tag mit dem async-Attribut, um sicherzustellen, dass es das Laden anderer Funktionen auf Ihrer Seite nicht blockiert.

Der folgende Code benötigt und lädt ein hypothetisches Link-Tracking-Plugin:

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

Warten, dass Plugins geladen werden

Da sowohl die analytics.js Bibliothek als auch analytics.js-Plugins asynchron geladen werden, kann es eine Herausforderung sein, zu wissen, wann Plugins vollständig geladen und bereit zur Verwendung sind.

Die analytics.js-Bibliothek löst dieses Problem, indem sie die Ausführung der Befehlswarteschlange anhält, wenn sie auf einen require-Befehl für ein Plugin trifft, das noch nicht geladen ist. Sobald das Plugin geladen ist, wird die Ausführung der Warteschlange normal fortgesetzt.

Deshalb ist es äußerst wichtig, dass Sie die von Ihnen verwendeten Plugins testen, um sicherzustellen, dass sie geladen und korrekt ausgeführt werden. Wenn ein Plugin nicht geladen wird oder einen Fehler aufweist, verhindert es die Ausführung aller nachfolgenden analytics.js-Befehle.

Aufruf von Plugin-Methoden

Nachdem ein Plugin angefordert wurde, werden seine Methoden für die Verwendung mit der ga() Befehlswarteschlange verfügbar. Hier ist die Befehlssignatur für den Aufruf von Plugin-Methoden:

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

Zum Beispiel kann die Methode des Enhanced Ecommerce Plugins addProduct wie folgt aufgerufen werden:

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

Oder auf einem benannten Tracker, indem Sie den Tracker-Namen zum Befehlsstring hinzufügen:

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

Wenn Sie alle Anleitungen in diesem Abschnitt gelesen haben, sollten Sie mit den meisten Funktionen von analytics.js. Die nächste Anleitung erklärt, wie Sie Ihre analytics.js-Implementierungen debuggen können, um Fehler leichter zu erkennen und genau zu sehen, was Ihr Code tut.