Plug-ins sind Skripts, die die Funktionalität von analytics.js erweitern und so Nutzerinteraktionen besser messen. Plug-ins sind in der Regel spezifisch für bestimmte Funktionen, die nicht für alle Google Analytics-Nutzer erforderlich sind, z. B. ecommerce oder domainübergreifende Messung. Sie sind daher nicht standardmäßig in analytics.js enthalten.
In diesem Leitfaden wird erläutert, wie Sie analytics.js-Plug-ins anfordern und verwenden.
Erforderliche Plug-ins
Der Befehl require
übernimmt den Namen eines Plug-ins und registriert es für die Verwendung mit der ga()
-Befehlswarteschlange. Wenn das Plug-in Konfigurationsoptionen akzeptiert, können diese Optionen als endgültiges Argument an den Befehl require
übergeben werden.
Das ist die vollständige Signatur des require
-Befehls:
ga('[trackerName.]require', pluginName, [pluginOptions]);
Im Folgenden sehen Sie, wie das Plug-in Erweiterter E-Commerce für die Verwendung mit dem Standard-Tracker erforderlich ist:
ga('require', 'ec');
Und so würden Sie das Plug-in Werbefunktionen für einen Tracker mit dem Namen „myTracker“ benötigen und eine Konfigurationsoption übergeben, die den Standardwert des Cookie-Namens überschreibt:
ga('myTracker.require', 'displayfeatures', {
cookieName: 'display_features_cookie'
});
Plug-in-Code laden
Der Befehl require
initialisiert die Plug-in-Methoden für die Verwendung mit der ga()
-Befehlswarteschlange, lädt jedoch nicht das Plug-in-Skript selbst. Wenn Sie das Plug-in eines Drittanbieters verwenden oder selbst Plug-in schreiben, müssen Sie den Plug-in-Code manuell auf der Seite einfügen.
Um der Seite Plug-in-Code hinzuzufügen, verwenden Sie ein <script>
-Tag, bei dem das Attribut async
festgelegt ist. So wird das Laden anderer Funktionen auf Ihrer Website nicht blockiert.
Für den folgenden Code ist ein hypothetisches Link-Tracking-Plug-in erforderlich und geladen:
<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 auf Laden von Plug-ins
Da sowohl die analytics.js-Bibliothek als auch die analytics.js-Plug-ins asynchron geladen werden, kann es schwierig sein zu wissen, wann Plug-ins vollständig geladen und einsatzbereit sind.
Die analytics.js-Bibliothek löst dieses Problem, indem die Ausführung der Befehlswarteschlange angehalten wird, wenn ein require
-Befehl für ein Plug-in erkannt wird, das noch nicht geladen wurde. Sobald das Plug-in geladen ist, wird die Ausführung der Warteschlange wie gewohnt fortgesetzt.
Daher ist es äußerst wichtig, dass Sie die verwendeten Plug-ins testen, um sicherzustellen, dass sie korrekt geladen und ausgeführt werden. Wenn ein Plug-in nicht geladen wird oder ein Fehler auftritt, werden alle nachfolgenden analytics.js-Befehle nicht ausgeführt.
Plug-in-Methoden aufrufen
Wenn ein Plug-in erforderlich ist, stehen seine Methoden zur Verwendung mit der ga()
-Befehlswarteschlange zur Verfügung. Dies ist die Befehlssignatur zum Aufrufen von Plug-in-Methoden:
ga('[trackerName.][pluginName:]methodName', ...args);
Die addProduct
-Methode des Plug-ins Erweiterte E-Commerce kann beispielsweise so 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
});
Nächste Schritte
Wenn Sie alle Leitfäden in diesem Abschnitt gelesen haben, sind Sie mit den meisten Funktionen von analytics.js vertraut. Im nächsten Leitfaden wird erläutert, wie Sie Fehler in analytics.js-Implementierungen beheben, um Fehler einfacher zu erkennen und genau zu sehen, was Ihr Code tut.