Está en la página 1de 7

28/5/2020 Creación de enlaces  |  Analytics para Web (analytics.

js)

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
 (https://developers.google.com/analytics/devguides/collection/analyticsjs/cross-domain?hl=es-419)
de analytics.js.

tante: Para que la medición multidominio funcione correctamente, todos los dominios deben estar incluid
de exclusión de referencias (https://support.google.com/analytics/answer/2795830?hl=es-419), tal com
be en la guía de medición multidominio
://developers.google.com/analytics/devguides/collection/analyticsjs/cross-domain?hl=es-419#ignoring_
als)

Introducción

Para llevar a cabo la medición multidominio, se comparte un ID de cliente


 (https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference?hl=es-
419#clientId)
ú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
 (https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference?hl=es-
419#linkerParam)
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
 (https://developers.google.com/analytics/devguides/collection/analyticsjs/cross-domain?hl=es-
419#detecting_url_sharing)
.

https://developers.google.com/analytics/devguides/collection/analyticsjs/linker?hl=es-419 1/7
28/5/2020 Creación de enlaces  |  Analytics para Web (analytics.js)

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

.199239214.1624002396.1440697407

En el dominio de destino, se proporciona el campo allowLinker


 (https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference?hl=es-
419#allowLinker)
que, 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át

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
 (https://developers.google.com/analytics/devguides/collection/analyticsjs/using-plugins?hl=es-419) el
complemento de creación de enlaces y ejecutar el método autoLink.

autoLink

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


 (https://developers.google.com/analytics/devguides/collection/analyticsjs/how-analyticsjs-works?
hl=es-419#the_ga_command_queue)
.

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

https://developers.google.com/analytics/devguides/collection/analyticsjs/linker?hl=es-419 2/7
28/5/2020 Creación de enlaces  |  Analytics para Web (analytics.js)

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

Parámetros

Nombre Tipo ObligatorioDescripción

domains Array[RexExp| sí Matriz de cadenas o expresiones regulares


string] 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.

decorateFormsboolean 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.

useAnchor no se puede utilizar en formularios porque IE (versiones 6 a 11) y Edge eliminan la parte fija.

Ejemplo

oads the Linker plugin


require', 'linker');

nstructs the Linker plugin to automatically add linker parameters


o all links and forms pointing to the domain "destination.com".
linker:autoLink', ['destination.com'], false, true);

El método autoLink no añade parámetros de creación de enlaces a los iframes. Si quieres que las estrate
menten la medición multidominio en los iframes, consulta la guía de medición multidominio
://developers.google.com/analytics/devguides/collection/analyticsjs/cross-domain?hl=es-419#iframes).

https://developers.google.com/analytics/devguides/collection/analyticsjs/linker?hl=es-419 3/7
28/5/2020 Creación de enlaces  |  Analytics para Web (analytics.js)

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


 (https://developers.google.com/analytics/devguides/collection/analyticsjs/how-analyticsjs-works?
hl=es-419#the_ga_command_queue)
.

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

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

Parámetros

Nombre Tipo ObligatorioDescripción

element HTMLElementsí El elemento <a> o <form> al que se va a añadir el parámetro de


creación de enlaces.

useAnchorboolean 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

oads the Linker plugin


require', 'linker');

ets a reference to a link pointing to an external domain.


destinationLink = document.getElementById('destination-link');

https://developers.google.com/analytics/devguides/collection/analyticsjs/linker?hl=es-419 4/7
28/5/2020 Creación de enlaces  |  Analytics para Web (analytics.js)

dds click handler that decorates `destinationLink`.


inationLink.addEventListener('click', function() {
'linker:decorate', destinationLink);

linkerParam

Además del método decorate, el campo linkerParam


 (https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference?hl=es-
419#linkerParam)
también permite obtener de forma manual el parámetro de creación de enlaces que usará
un objeto de seguimiento.

unction(tracker) {
r linkerParam = tracker.get('linkerParam');

Con gurar 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
 (https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference?hl=es-
419#allowLinker)
al crear el objeto de seguimiento:

create', 'UA-XXXXXX-X', 'auto', {


lowLinker: true

Medición multidominio bidireccional

https://developers.google.com/analytics/devguides/collection/analyticsjs/linker?hl=es-419 5/7
28/5/2020 Creación de enlaces  |  Analytics para Web (analytics.js)

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:

create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});


require', 'linker');
linker:autoLink', ['destination.com']);

En destination.com:

create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});


require', 'linker');
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.

create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});


require', 'linker');
linker:autoLink', ['source.com', 'destination.com']);

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0
License (https://creativecommons.org/licenses/by/4.0/), and code samples are licensed under the Apache
2.0 License (https://www.apache.org/licenses/LICENSE-2.0). For details, see the Google Developers Site
Policies (https://developers.google.com/site-policies?hl=es-419). Java is a registered trademark of Oracle
and/or its affiliates.

https://developers.google.com/analytics/devguides/collection/analyticsjs/linker?hl=es-419 6/7
28/5/2020 Creación de enlaces  |  Analytics para Web (analytics.js)

Last updated 2019-11-22.

https://developers.google.com/analytics/devguides/collection/analyticsjs/linker?hl=es-419 7/7

También podría gustarte