El complemento del enlazador simplifica el proceso de implementación de la medición entre dominios como se describe en la guía de medición entre dominios para analytics.js.
Descripción general
La medición entre dominios funciona compartiendo una ID de cliente única entre un dominio de origen y un dominio de destino. Este es un proceso de dos pasos:
- El dominio de origen debe asegurarse de que todas las URL que apunten al dominio de destino contengan el ID de cliente del dominio de origen.
- El dominio de destino necesita saber para verificar la presencia de una ID de cliente en la URL una vez que un usuario navega allí.
El complemento del enlazador logra esto agregando un parámetro de enlazador a las URL que apuntan al dominio de destino. El parámetro del enlazador contiene el ID del cliente, así como la marca de tiempo actual y los metadatos del navegador codificados en él. La marca de tiempo y los metadatos se utilizan para evitar problemas con el uso compartido de URL .
El parámetro del enlazador se verá así:
_ga=1.199239214.1624002396.1440697407
En el dominio de destino, se proporciona el campo allowLinker , que cuando es true indica a analytics.js que verifique los parámetros del enlazador en la URL. Si el parámetro del enlazador se encuentra y es válido, extrae el ID de cliente del parámetro y lo almacena.
El complemento Linker permite la adición automática y manual del parámetro del vinculador a las URL en los enlaces y formularios de la página. En la mayoría de los casos, se recomienda la forma automática.
Adición automática de parámetros del enlazador
Para configurar el enlace automático entre dominios en el dominio de origen para las URL que apuntan al dominio de destino, debe solicitar el complemento del enlazador y llamar a su método autoLink .
autoLink
El método autoLink se puede llamar a través de la cola de comandos .
Una vez ejecutado, analytics.js escuchará los clics en los enlaces que apuntan al dominio (o dominios) de destino y agregará el parámetro del enlazador a esos enlaces inmediatamente antes de que comience la navegación. Es necesario esperar hasta que un usuario haga clic en un enlace para agregar el parámetro del enlazador porque los parámetros del enlazador caducan después de dos minutos.
El parámetro decorateForms opcional debe especificarse y establecerse en true si tiene formularios en su sitio que apuntan al dominio de destino.
Uso
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
Parámetros
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
domains | Array[RexExp|string] | Sí | Una matriz de cadenas o expresiones regulares para hacer coincidir con el hostname de una URL que indica a qué dominios se debe aplicar el enlace automático. Si se pasa una cadena, analytics.js realizará una coincidencia de subcadena, lo que significa que example.com coincidirá con los enlaces que apuntan a blog.example.com . |
useAnchor | boolean | No | Cuando es verdadero, el parámetro del enlazador se agregará a la parte de anclaje de la URL en lugar de a la parte de consulta. |
decorateForms | boolean | No | Cuando es verdadero, el complemento del enlazador agregará un parámetro del enlazador para formar 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);
Adición manual de parámetros del enlazador
Puede agregar manualmente el parámetro del enlazador a un elemento <a> o <form> en particular a través del método decorate . Este método solo es necesario cuando no se utiliza el método autoLink descrito anteriormente.
decorate
El método decorate se puede llamar a través de la cola de comandos .
Es importante asegurarse de que el método de decoración se llame lo más cerca posible del momento en que ocurrirá la navegación porque los parámetros del enlazador caducan después de dos minutos. La mayoría de las veces, este método debe llamarse en un controlador de eventos.
Uso
ga('[trackerName.]linker:decorate', element, [useAnchor]);
Parámetros
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
element | HTMLElement | Sí | El elemento <a> o <form> al que añadir el parámetro del enlazador. |
useAnchor | boolean | No | Cuando es verdadero, el parámetro del enlazador se agregará a la parte de anclaje de la URL en lugar de a la parte de 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 , puede obtener manualmente el parámetro del enlazador que usará un rastreador a través del campo linkerParam .
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
Configurar un sitio para aceptar parámetros del enlazador
Una vez que un usuario llega a una página en el dominio de destino con un parámetro de enlace en la URL, analytics.js necesita saber para buscar ese parámetro.
Puede indicar a la página de destino que busque los parámetros del enlazador configurando el campo allowLinker en true al crear el rastreador:
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
Medición bidireccional de dominios cruzados
Un flujo de usuarios en el que los usuarios siempre comienzan en el dominio de origen y solo después se trasladan al dominio de destino en una medición multidominio unidireccional considerada. Las instrucciones anteriores asumen este tipo de flujo de usuario.
En los casos en los que no se sabe qué dominio visitarán primero sus usuarios, debe implementar la medición bidireccional entre dominios, donde cada dominio está configurado para funcionar como origen o destino.
Para implementar la medición bidireccional entre dominios, habilite la vinculación automática en ambos dominios y configúrelos para aceptar los parámetros del vinculador.
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']);
Usando un solo fragmento en todos los dominios
Para simplificar esto aún más, puede enumerar todos los dominios posibles que desea medir en el método autoLink , lo que le 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']);