El complemento de vinculador simplifica el proceso de implementación de las mediciones multidominio, como se describe en la Guía de mediciones multidominio de analytics.js.
Descripción general
Las mediciones multidominio funcionan compartiendo un ID de cliente único entre un dominio de origen y un dominio de destino. Este es un proceso en dos pasos:
- El dominio de origen debe asegurarse de que todas las URLs que apuntan al dominio de destino contengan el ID de cliente del dominio de origen.
- El dominio de destino debe saber la presencia de un ID de cliente en la URL una vez que el usuario navega hacia allí.
Para ello, el complemento vinculador agrega un parámetro de vinculador a las URL que apuntan al dominio de destino. El parámetro del vinculador contiene el ID de cliente, así como la marca de tiempo actual y los metadatos del navegador codificados dentro de él. La marca de tiempo y los metadatos se utilizan para evitar problemas con el uso compartido de URLs.
El parámetro del vinculador se verá de la siguiente manera:
_ga=1.199239214.1624002396.1440697407
En el dominio de destino, se proporciona el campo allowLinker, el cual cuando true le indica a analytics.js que verifique los parámetros del vinculador en la URL. Si el parámetro del vinculador se encuentra y es válido, extrae el ID de cliente del parámetro y lo almacena.
El complemento vinculador permite agregar de forma automática y manual el parámetro del vinculador a las URLs de los vínculos y formularios de la página. En la mayoría de los casos, se recomienda el método automático.
Agrega automáticamente parámetros del vinculador
Para configurar la vinculación automática entre dominios en el dominio de origen para las URLs que dirigen al dominio de destino, debes require el complemento del vinculador y llamar al método autoLink.
autoLink
Se puede llamar al método autoLink a través de la cola de comandos.
Una vez que se ejecute, analytics.js escuchará clics en los vínculos que dirigen al dominio (o dominios) de destino y agregará el parámetro del vinculador a esos vínculos inmediatamente antes de comenzar la navegación. Es necesario esperar hasta que un usuario haga clic en un vínculo para agregar el parámetro del vinculador, ya que estos caducan a los dos minutos.
Debes especificar el parámetro opcional decorateForms y configurarlo en true si tu sitio tiene formularios que dirigen al dominio de destino.
Uso
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
domains |
Array[RexExp|string] |
sí | Es un array de cadenas o expresiones regulares que debe coincidir con el hostname de una URL que indica a qué dominios se debe aplicar la vinculación automática. Si se pasa una cadena, analytics.js realizará una coincidencia de substring, es decir, example.com coincidirá con los vínculos que apunten a blog.example.com. |
useAnchor |
boolean |
no | Si es verdadero, el parámetro del vinculador se agregará a la parte de anclaje de la URL en lugar de a la parte de la búsqueda. |
decorateForms |
boolean |
no | Si es verdadero, el complemento del vinculador agregará un parámetro de vinculador para formar los envíos que apunten 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);
Agrega manualmente parámetros del vinculador
Puedes agregar manualmente el parámetro del vinculador a un elemento <a> o <form> determinado con el método decorate. Este método solo es necesario cuando no se usa el método autoLink descrito anteriormente.
decorate
Se puede llamar al método decorate a través de la cola de comandos.
Es importante asegurarse de que se llame al método de decoración lo más cerca posible del momento en que ocurrirá la navegación, ya que los parámetros del vinculador vencen después de dos minutos. La mayoría de las veces, se debe llamar a este método en un controlador de eventos.
Uso
ga('[trackerName.]linker:decorate', element, [useAnchor]);
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
element |
HTMLElement |
sí | El elemento <a> o <form> al que se agregará el parámetro del vinculador. |
useAnchor |
boolean |
no | Si es verdadero, el parámetro del vinculador se agregará a la parte de anclaje de la URL en lugar de a la parte de la búsqueda. |
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, puedes obtener de forma manual el parámetro del vinculador que usará un rastreador a través del campo linkerParam.
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
Configura un sitio para que acepte parámetros del vinculador
Una vez que un usuario llega a una página en el dominio de destino con un parámetro de vinculador en la URL, analytics.js debe buscar ese parámetro.
Para indicarle a la página de destino que busque parámetros del vinculador, configura el campo allowLinker en true cuando crees el rastreador:
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
Medición multidominio bidireccional
Es un flujo de usuarios en el que los usuarios siempre comienzan en el dominio de origen y solo después pasan al dominio de destino en una medición multidominio unidireccional. Las instrucciones anteriores suponen este tipo de flujo de usuarios.
En los casos en que no se sepa qué dominio visitarán primero tus usuarios, debes implementar las mediciones multidominio bidireccionales, en las que cada dominio esté configurado para funcionar como el origen o el destino.
Para implementar las mediciones bidireccionales entre dominios, debes habilitar la vinculación automática en ambos dominios y configurarlos para que acepten los parámetros del vinculador.
El source.com:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);
El destination.com:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);
Usar un solo fragmento en todos los dominios
Para simplificar aún más esta tarea, puedes enumerar todos los dominios posibles que deseas medir en el método autoLink, lo que te permite usar el mismo fragmento de código en cada dominio:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);