Le plug-in Linker simplifie le processus d'implémentation des mesures multidomaines, comme indiqué dans le Guide sur les mesures multidomaines pour analytics.js.
Présentation
Les mesures multidomaines consistent à partager un ID client unique entre un domaine source et un domaine de destination. Il s'agit d'un processus en deux étapes.
- Le domaine source doit s'assurer que toutes les URL pointant vers le domaine de destination contiennent l'ID client du domaine source.
- Le domaine de destination doit vérifier la présence d'un ID client dans l'URL lorsqu'un utilisateur y accède.
Pour ce faire, le plug-in Linker ajoute un paramètre Linker aux URL qui renvoient au domaine de destination. Le paramètre Linker contient l'ID client, ainsi que l'horodatage actuel et les métadonnées de navigateur encodées. Le code temporel et les métadonnées permettent d'éviter les problèmes liés au partage d'URL.
Le paramètre Linker se présente comme suit:
_ga=1.199239214.1624002396.1440697407
Sur le domaine de destination, le champ allowLinker est fourni. Lorsque true demande à analytics.js de vérifier la présence de paramètres Linker dans l'URL. Si le paramètre Linker est trouvé et valide, il extrait l'ID client du paramètre et le stocke.
Le plug-in Linker permet d'ajouter automatiquement et manuellement le paramètre Linker aux URL dans les liens et les formulaires de la page. Dans la plupart des cas, la méthode automatique est recommandée.
Ajouter automatiquement des paramètres Linker
Pour configurer des liens automatiques inter-domaines sur le domaine source pour les URL pointant vers le domaine de destination, vous devez require le plug-in Linker et appeler sa méthode autoLink.
autoLink
La méthode autoLink peut être appelée via la file d'attente de commandes.
Une fois exécuté, analytics.js écoute les clics sur les liens qui pointent vers le ou les domaines de destination et ajoute le paramètre Linker à ces liens juste avant le début de la navigation. Il est nécessaire d'attendre qu'un utilisateur clique sur un lien pour ajouter le paramètre Linker, car ces paramètres expirent au bout de deux minutes.
Le paramètre facultatif decorateForms doit être spécifié et défini sur true si certains formulaires de votre site pointent vers le domaine de destination.
Utilisation
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
domains |
Array[RexExp|string] |
oui | Tableau de chaînes ou d'expressions régulières à mettre en correspondance avec l'élément hostname d'une URL, indiquant les domaines auxquels la liaison automatique doit s'appliquer. Si une chaîne est transmise, analytics.js effectue une correspondance de sous-chaîne, ce qui signifie que example.com établit une correspondance avec les liens pointant vers blog.example.com. |
useAnchor |
boolean |
no | Lorsque la valeur est "true", le paramètre Linker est ajouté à la partie ancrage de l'URL plutôt qu'à la partie requête. |
decorateForms |
boolean |
no | Si la valeur est "true", le plug-in Linker ajoute un paramètre Linker aux envois de formulaires qui pointent vers des destinations correspondant au paramètre domain. |
Exemple
// 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);
Ajouter manuellement des paramètres Linker
Vous pouvez ajouter manuellement le paramètre Linker à un élément <a> ou <form> particulier à l'aide de la méthode decorate. Cette méthode n'est nécessaire que si vous n'utilisez pas la méthode autoLink décrite ci-dessus.
decorate
La méthode decorate peut être appelée via la file d'attente de commandes.
Il est important de s'assurer que la méthode "decorate" est appelée le plus près possible du moment où la navigation a lieu, car les paramètres de l'éditeur de liens expirent au bout de deux minutes. La plupart du temps, cette méthode doit être appelée dans un gestionnaire d'événements.
Utilisation
ga('[trackerName.]linker:decorate', element, [useAnchor]);
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
element |
HTMLElement |
oui | Élément <a> ou <form> auquel ajouter le paramètre Linker. |
useAnchor |
boolean |
no | Lorsque la valeur est "true", le paramètre Linker est ajouté à la partie ancrage de l'URL plutôt qu'à la partie requête. |
Exemple
// 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
En plus de la méthode decorate, vous pouvez obtenir manuellement le paramètre Linker qu'un outil de suivi utilisera via le champ linkerParam.
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
Configurer un site pour qu'il accepte les paramètres de linker
Lorsqu'un utilisateur arrive sur une page du domaine de destination comportant un paramètre Linker dans l'URL, analytics.js doit savoir qu'il doit rechercher ce paramètre.
Vous pouvez demander à la page de destination de rechercher les paramètres de l'éditeur de liens en définissant le champ allowLinker sur true lors de la création de l'outil de suivi:
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
Mesures multidomaines bidirectionnelles
Parcours utilisateur dans lequel les utilisateurs commencent toujours sur le domaine source et ne passent ensuite au domaine de destination que dans le cas de mesures multidomaines à sens unique. Les instructions ci-dessus supposent ce type de flux utilisateur.
Si vous ne savez pas quel domaine vos utilisateurs visiteront en premier, vous devez implémenter les mesures multidomaines bidirectionnelles, dans lesquelles chaque domaine est configuré pour fonctionner comme source ou destination.
Pour implémenter les mesures multidomaines bidirectionnelles, vous devez activer l'association automatique sur les deux domaines et les configurer pour qu'ils acceptent les paramètres de l'éditeur de liens.
Sur source.com:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);
Sur destination.com:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);
Utiliser un seul extrait pour tous les domaines
Pour simplifier encore davantage, vous pouvez lister tous les domaines possibles que vous souhaitez mesurer dans la méthode autoLink, ce qui vous permet d'utiliser le même extrait de code sur chaque domaine:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);