Linker

Le plug-in Linker simplifie le processus d'implémentation des mesures multidomaines, comme indiqué dans le Guide relatif aux 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.

  1. Le domaine source doit s'assurer que toutes les URL pointant vers le domaine de destination contiennent l'ID client du domaine source.
  2. Le domaine de destination doit être informé de la présence d'un ID client dans l'URL une fois que l'utilisateur y accède.

Pour ce faire, le plug-in Linker ajoute un paramètre Linker aux URL qui pointent vers le domaine de destination. Le paramètre Linker contient l'ID client, ainsi que le code temporel actuel et les métadonnées de navigateur encodées dans ce paramètre. 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. true demande à analytics.js de vérifier la présence d'un paramètre 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 de l'éditeur de liens

Pour configurer les liens automatiques multidomaines 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.

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. Vous devez attendre qu'un utilisateur clique sur un lien pour ajouter le paramètre Linker, car ces paramètres expirent au bout de deux minutes.

Vous devez spécifier le paramètre facultatif decorateForms et le définir sur true si vous utilisez des formulaires sur votre site qui 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'hostname d'une URL, indiquant les domaines auxquels l'association automatique doit s'appliquer. Si une chaîne est transmise, analytics.js effectuera une correspondance de sous-chaîne, ce qui signifie que example.com fera correspondre les liens pointant vers blog.example.com.
useAnchor boolean non Lorsque la valeur est "true", le paramètre Linker est ajouté à la partie ancrée de l'URL plutôt qu'à la partie requête.
decorateForms boolean non Lorsque 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 de linker

Vous pouvez ajouter manuellement le paramètre Linker à un élément <a> ou <form> particulier via 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 "decate" 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 non Lorsque la valeur est "true", le paramètre Linker est ajouté à la partie ancrée 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 l'éditeur de liens

Lorsqu'un utilisateur arrive sur une page du domaine de destination dont l'URL comporte un paramètre Linker, 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 se déplacent uniquement ensuite vers le domaine de destination dans les 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, où 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 plus cela, 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']);