Plug-ins verwenden

Plug-ins sind Skripts, mit denen die Funktionsweise von analytics.js verbessert wird. So kann die Nutzerinteraktion besser gemessen werden. Plug-ins beziehen sich in der Regel auf bestimmte Funktionen, die möglicherweise nicht für alle Google Analytics-Nutzer erforderlich sind, z. B. E-Commerce oder domainübergreifende Messung. Sie sind daher standardmäßig nicht in analytics.js enthalten.

In diesem Leitfaden wird erläutert, wie analytics.js-Plug-ins erforderlich sind und verwendet werden können.

Erforderliche Plug-ins

Der Befehl require verwendet 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 letztes Argument an den Befehl require übergeben werden.

Im Folgenden finden Sie die vollständige Signatur des require-Befehls:

ga('[trackerName.]require', pluginName, [pluginOptions]);

So benötigen Sie beispielsweise das Plug-in Erweiterter E-Commerce zur Verwendung mit dem Standard-Tracker:

ga('require', 'ec');

Und nun benötigen Sie das Plug-in Werbefunktionen für einen Tracker mit dem Namen „&Tracker“. Außerdem wird eine Konfigurationsoption übergeben, die den standardmäßigen Wert des Cookienamens überschreibt:

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

Plug-in-Code wird geladen

Mit dem Befehl require werden die Plug-in-Methoden zur Verwendung mit der Befehlswarteschlange ga() initialisiert. Das Plug-in-Skript wird jedoch nicht geladen. Wenn Sie ein Drittanbieter-Plug-in verwenden oder ein Plug-in selbst schreiben, müssen Sie den Plug-in-Code manuell auf der Seite einfügen.

Wir empfehlen, Plug-in-Code über ein <script>-Tag hinzuzufügen, bei dem das Attribut async festgelegt ist. So ist gewährleistet, dass das Laden anderer Funktionen auf deiner Website nicht blockiert wird.

Der folgende Code erfordert und lädt ein hypothetisches Link-Tracking-Plug-in:

<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 das Laden der 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. Nach dem Laden des Plug-ins wird die Warteschlangenausführung wie gewohnt fortgesetzt.

Aus diesem Grund 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, wird die Ausführung aller nachfolgenden analytics.js-Befehle verhindert.

Aufruf von Plug-in-Methoden

Nachdem ein Plug-in erforderlich ist, können die Methoden mit der ga()-Befehlswarteschlange verwendet werden. Dies ist die Befehlssignatur zum Aufrufen von Plug-in-Methoden:

ga('[trackerName.][pluginName:]methodName', ...args);

Die Methode addProduct des erweiterten E-Commerce-Plug-ins kann beispielsweise so aufgerufen werden:

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

Oder bei einem benannten Tracker, indem Sie den Tracker-Namen in den Befehlsstring aufnehmen:

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

Nächste Schritte

Wenn Sie alle Anleitungen in diesem Abschnitt gelesen haben, sollten Sie mit den meisten Funktionen von analytics.js vertraut sein. Im nächsten Leitfaden erfahren Sie, wie Sie Fehler in Ihren analytics.js-Implementierungen beheben. So können Sie Fehler leichter erkennen und sehen, was genau in Ihrem Code geschieht.