Creación de enlaces

El complemento de creación de enlaces simplifica el proceso de implementación de la medición multidominio, tal como se describe en la guía de medición multidominio de analytics.js.

Introducción

Para llevar a cabo la medición multidominio, se comparte un ID de cliente único entre un dominio de origen y un dominio de destino. Este proceso consta de dos pasos:

  1. El dominio de origen debe asegurarse de que todas las URL que dirigen al dominio de destino contienen el ID de cliente del dominio de origen.
  2. El dominio de destino necesita saber que debe buscar un ID de cliente en la URL cuando un usuario llegue ahí.

Para lograr esto, el complemento de creación de enlaces añade un parámetro de creación de enlaces a las URL que dirigen al dominio de destino. El parámetro de creación de enlaces contiene el ID de cliente, y también la marca de tiempo actual y los metadatos del navegador codificados en el mismo. La marca de tiempo y los metadatos se utilizan para evitar problemas cuando se comparten URLs.

El parámetro de creación de enlaces será similar a este:

_ga=1.199239214.1624002396.1440697407

En el dominio de destino, se proporciona el campo allowLinkerque, si se le asigna el valor true, solicita a analytics.js que compruebe si hay parámetros de creación de enlaces en la URL. Si se encuentra un parámetro de creación de enlaces y es válido, extrae el ID de cliente del parámetro y lo almacena.

El complemento de creación de enlaces permite añadir el parámetro de creación de enlaces a las URL en los enlaces y formularios de la página, tanto de forma automática como manual. En la mayoría de los casos, se recomienda el modo automático.

Añadir parámetros de creación de enlaces de forma automática

Si quieres configurar la creación automática de enlaces multidominio en el dominio de origen para las URL que apuntan al dominio de destino, debes solicitar el complemento de creación de enlaces y ejecutar el método autoLink.

El método autoLink se puede ejecutar mediante la cola de comandos.

Cuando analytics.js se ejecute, procesará los clics en los enlaces que dirijan al dominio de destino (o dominios) y les añadirá el parámetro de creación de enlaces justo antes de comenzar la navegación. Para añadir el parámetro de creación de enlaces, es necesario esperar a que un usuario haga clic en un enlace, ya que dicho parámetro caduca a los dos minutos.

Debes especificar el parámetro decorateForms opcional y asignarle el valor true si en tu sitio web hay formularios que dirijan al dominio de destino.

Uso

ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);

Parámetros

Nombre Tipo Obligatorio Descripción
domains Array[RexExp|string] Matriz de cadenas o expresiones regulares correspondientes al hostname de una URL que indica a qué dominios debe aplicarse la creación automática de enlaces. Si se transfiere una cadena, analytics.js hará una concordancia de cadena secundaria, por lo que example.com también se corresponderá con los enlaces que dirijan a blog.example.com.
useAnchor boolean no Si es "true", el parámetro de creación de enlaces se añadirá a la parte fija de la URL, y no a la parte de la consulta.
decorateForms boolean no Si es "true", el complemento de creación de enlaces añadirá un parámetro de creación de enlaces a los envíos de formularios que dirijan a destinos que coincidan con el parámetro domain.

Ejemplo

// 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);

Añadir parámetros de creación de enlaces de forma manual

Para añadir de forma manual el parámetro de creación de enlaces a un elemento <a> o <form>, debes usar el método decorate. Este método solo es necesario si no se usa el método autoLink descrito anteriormente.

decorate

El método decorate se puede ejecutar mediante la cola de comandos.

Es importante asegurarse de que se llama al método "decorate" justo antes de la navegación, ya que los parámetros de creación de enlaces caducan a los dos minutos. En la mayoría de las ocasiones se debe llamar a este método desde un gestor de eventos.

Uso

ga('[trackerName.]linker:decorate', element, [useAnchor]);

Parámetros

Nombre Tipo Obligatorio Descripción
element HTMLElement El elemento <a> o <form> al que se va a añadir el parámetro de creación de enlaces.
useAnchor boolean no Si es "true", el parámetro de creación de enlaces se añadirá a la parte fija de la URL, y no a la parte de la consulta.

Ejemplo

// 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

Además del método decorate, el campo linkerParam también permite obtener de forma manual el parámetro de creación de enlaces que usará un objeto de seguimiento.

ga(function(tracker) {
  var linkerParam = tracker.get('linkerParam');
});

Configurar un sitio web para aceptar parámetros de creación de enlaces

Cuando un usuario llega a una página del dominio de destino que tiene un parámetro de creación de enlaces en la URL, analytics.js necesita saber que debe buscar ese parámetro.

Para indicar a la página de destino que busque los parámetros de creación de enlaces, asigna el valor true al campo allowLinker al crear el objeto de seguimiento:

ga('create', 'UA-XXXXXX-X', 'auto', {
  allowLinker: true
});

Medición multidominio bidireccional

La medición multidominio unidireccional es un flujo de usuarios en el que el usuario siempre empieza en el dominio de origen y después se dirige al dominio de destino. Las instrucciones anteriores se refieren a este tipo de flujo de usuarios.

Si no sabes qué dominio visitarán los usuarios en primer lugar, debes implementar la medición multidominio bidireccional, en la que los dominios pueden funcionar como origen o destino.

Para aplicar la medición multidominio bidireccional, habilita la creación automática de enlaces en ambos dominios y configúralos para que acepten los parámetros de creación de enlaces.

En source.com:

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);

En destination.com:

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);

Usar un único fragmento en todos los dominios

Para simplificar aún más la medición, puedes crear una lista con todos los dominios posibles que quieras medir en el método autoLink. Así, podrás usar el mismo fragmento de código en cada uno de ellos.

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);