Das Verknüpfungs-Plug-in vereinfacht die Implementierung der domainübergreifenden Messung, wie im Leitfaden zur domainübergreifenden Messung für analytics.js beschrieben.
Überblick
Bei der domainübergreifenden Messung wird eine eindeutige Client-ID zwischen einer Quell- und einer Zieldomain geteilt. Hierzu sind zwei Schritte notwendig:
- Die Quelldomain muss sicherstellen, dass alle URLs, die auf die Zieldomain verweisen, die Client-ID der Quelldomain enthalten.
- Die Zieldomain muss überprüft werden, um zu prüfen, ob eine Client-ID in der URL vorhanden ist, sobald ein Nutzer die Seite aufruft.
Dazu wird im Verknüpfungs-Plug-in ein Verknüpfungsparameter in URLs eingefügt, die auf die Zieldomain verweisen. Der Verknüpfungsparameter enthält die Client-ID sowie den aktuellen Zeitstempel und die darin codierten Browsermetadaten. Der Zeitstempel und die Metadaten werden verwendet, um Probleme bei der URL-Freigabe zu vermeiden.
Der Verknüpfungsparameter sieht in etwa so aus:
_ga=1.199239214.1624002396.1440697407
In der Zieldomain wird das Feld allowLinker bereitgestellt, wenn true das analytics.js-Script anweist, in der URL nach Verknüpfungsparametern zu suchen. Wenn der Verknüpfungsparameter gefunden wird und gültig ist, wird die Client-ID aus dem Parameter extrahiert und gespeichert.
Mit dem Verknüpfungs-Plug-in kann der Verknüpfungsparameter sowohl automatisch als auch manuell zu URLs in Links und Formularen auf der Seite hinzugefügt werden. In den meisten Fällen wird die automatische Methode empfohlen.
Verknüpfungsparameter automatisch hinzufügen
Um die domainübergreifende automatische Verknüpfung in der Quelldomain für URLs einzurichten, die auf die Zieldomain verweisen, require das Verknüpfungs-Plug-in erforderlich sein und die zugehörige Methode autoLink aufgerufen werden.
autoLink
Die Methode autoLink kann über die Befehlswarteschlange aufgerufen werden.
Nach der Ausführung erfasst analytics.js Klicks auf Links, die auf die Zieldomain (oder Zieldomains) verweisen, und fügt diesen Links unmittelbar vor Beginn der Navigation den Verknüpfungsparameter hinzu. Es muss gewartet werden, bis der Nutzer auf einen Link klickt, um den Verknüpfungsparameter hinzuzufügen, da Verknüpfungsparameter nach zwei Minuten ablaufen.
Der optionale Parameter decorateForms sollte angegeben und auf true gesetzt werden, wenn Sie Formulare auf Ihrer Website haben, die auf die Zieldomain verweisen.
Nutzung
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
domains |
Array[RexExp|string] |
ja | Ein Array von Strings oder regulären Ausdrücken, die mit dem hostname einer URL abgeglichen werden und angibt, für welche Domains die automatische Verknüpfung gelten soll. Wenn ein String übergeben wird, führt analytics.js einen Teilstringabgleich durch, d. h. example.com gleicht Links ab, die auf blog.example.com verweisen. |
useAnchor |
boolean |
nein | Bei „true“ wird der Verknüpfungsparameter dem Ankerteil der URL und nicht dem Abfrageteil hinzugefügt. |
decorateForms |
boolean |
nein | Wenn der Wert „true“ ist, fügt das Verknüpfungs-Plug-in Formularübermittlungen einen Verknüpfungsparameter hinzu, die auf Ziele verweisen, die dem domain-Parameter entsprechen. |
Beispiel
// Loads the Linker plugin
ga('require', 'linker');
// Instructs the Linker plugin to automatically add linker parameters
// to all links and forms pointing to the domain "destination.com".
ga('linker:autoLink', ['destination.com'], false, true);
Verknüpfungsparameter manuell hinzufügen
Sie können den Verknüpfungsparameter über die Methode decorate einem bestimmten <a>- oder <form>-Element manuell hinzufügen. Diese Methode ist nur erforderlich, wenn nicht die oben beschriebene autoLink-Methode verwendet wird.
decorate
Die Methode decorate kann über die Befehlswarteschlange aufgerufen werden.
Es ist wichtig, dass die Decorator-Methode möglichst kurz vor dem Zeitpunkt der Navigation aufgerufen wird, da Verknüpfungsparameter nach zwei Minuten ablaufen. Meistens sollte diese Methode in einem Event-Handler aufgerufen werden.
Nutzung
ga('[trackerName.]linker:decorate', element, [useAnchor]);
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
element |
HTMLElement |
ja | Das <a>- oder <form>-Element, an das der Verknüpfungsparameter angehängt werden soll. |
useAnchor |
boolean |
nein | Bei „true“ wird der Verknüpfungsparameter dem Ankerteil der URL und nicht dem Abfrageteil hinzugefügt. |
Beispiel
// Loads the Linker plugin
ga('require', 'linker');
// Gets a reference to a link pointing to an external domain.
var destinationLink = document.getElementById('destination-link');
// Adds click handler that decorates `destinationLink`.
destinationLink.addEventListener('click', function() {
ga('linker:decorate', destinationLink);
});
linkerParam
Zusätzlich zur decorate-Methode können Sie den Verknüpfungsparameter, den ein Tracker verwendet, manuell über das Feld linkerParam abrufen.
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
Website so konfigurieren, dass Verknüpfungsparameter akzeptiert werden
Sobald ein Nutzer auf eine Seite der Zieldomain mit einem Verknüpfungsparameter in der URL gelangt, muss analytics.js nach diesem Parameter suchen.
Sie können die Landingpage anweisen, nach Verknüpfungsparametern zu suchen, indem Sie beim Erstellen des Trackers das Feld allowLinker auf true setzen:
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
Bidirektionale domainübergreifende Messung
Ein User Flow, bei dem Nutzer bei der unidirektionalen domainübergreifenden Messung immer in der Quelldomain beginnen und danach zur Zieldomain wechseln. In der obigen Anleitung wird von dieser Art von User Flow ausgegangen.
Falls nicht bekannt ist, welche Domain Ihre Nutzer zuerst besuchen, müssen Sie die bidirektionale domainübergreifende Messung implementieren. Dabei ist jede Domain so konfiguriert, dass sie als Quelle oder Ziel verwendet wird.
Wenn Sie die bidirektionale domainübergreifende Messung implementieren möchten, müssen Sie die automatische Verknüpfung für beide Domains aktivieren und beide so konfigurieren, dass Verknüpfungsparameter akzeptiert werden.
Am source.com:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);
Am destination.com:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);
Ein einzelnes Snippet für alle Domains verwenden
Um diesen Vorgang weiter zu vereinfachen, können Sie alle möglichen Domains, die Sie messen möchten, in der autoLink-Methode auflisten, sodass Sie für jede Domain dasselbe Code-Snippet verwenden können:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);