Se usó la API de Cloud Translation para traducir esta página.

Seguimiento de conversiones

Descripción general

El seguimiento de conversiones realiza un seguimiento de las conversiones que inicia Google a través de una de nuestras integraciones de Action Center. Es necesario mantener tu integración en buen estado y en funcionamiento, ya que puede influir en la clasificación de ciertas páginas. Cada vez que Google genera un action_link, la URL específica se modifica para incluir un parámetro de consulta único: rwg_token. Puedes almacenar el token y mostrar los valores adecuados cuando un usuario complete una reserva.

Para completar la integración, sigue estos pasos:

Analiza y almacena el rwg_token.
Analiza y almacena la información del comercio.
Muestra los valores rwg_token y merchant_changed.
Prueba y verifica el seguimiento de conversiones.

Analiza y almacena el `rwg_token`

Para completar la integración, debes recopilar y almacenar el rwg_token durante un máximo de 30 días a partir de la referencia inicial de Google. El valor rwg_token es una cadena codificada que contiene metadatos sobre el vínculo y la información del comercio que generó ese action_link.

Analiza el token

Cuando se dirige a un usuario a tu página de reservas, se agrega un nuevo rwg_token a la URL proporcionada. En tu página de reservas, debes analizar el valor del token.

En el siguiente ejemplo, se muestra cómo se analiza rwg_token para el seguimiento a nivel del dispositivo a través de un navegador.

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

El token que se agrega a tu URL está encriptado. Consulta el siguiente ejemplo de un rwg_token. Usa este token de muestra para asegurarte de analizarlo correctamente, junto con cualquier carácter especial, como =.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Almacena el token

Cuando almacenas el rwg_token, puedes implementar el seguimiento de conversiones en dos niveles diferentes:

A nivel del dispositivo
A nivel del usuario

Puedes almacenar el token en cualquier nivel, pero debes almacenarlo durante 30 días después de la referencia inicial.

En el siguiente ejemplo, se muestra el seguimiento de conversiones a nivel del dispositivo. Puedes almacenar los valores de token en un navegador con la cookie propia. En este ejemplo, se supone que analizaste el valor del token en una variable. Asegúrate de actualizar rootdomain.com con tu dominio.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Cada vez que Google genera un action_link que proporcionaste a través de los feeds, la URL se modifica para incluir un parámetro de consulta único: rwg_token. Debes almacenar este token y volver a pasarlo como parte del evento de conversión.

Almacenamiento a nivel del dispositivo

El nivel del dispositivo incluye el uso de cookies del navegador, el almacenamiento local, el almacenamiento local de la app o cualquier otro método que pueda conservar el token durante la ventana de atribución de 30 días. El token se almacena de forma local en el dispositivo del usuario. Por lo tanto, el evento de conversión no se puede atribuir correctamente en los siguientes casos:

Cambia el dispositivo que usa.
Borra el almacenamiento local o las cookies.
Usa un navegador privado o incógnito.

Cuando utilizas el seguimiento de conversiones a nivel del dispositivo, debes volver a implementar el evento de conversión en todos los dispositivos compatibles, incluidos los dispositivos móviles.

Almacenamiento a nivel del usuario

El nivel del usuario conserva el token en la base de datos de tu aplicación a través de un sistema de estadísticas del servidor o de otros sistemas del servidor. El token se almacena en el servidor. Por lo tanto, el evento de conversión se atribuye correctamente después de que el usuario vuelve a acceder.

Cuando usas el seguimiento de conversiones a nivel del usuario en función de la arquitectura de tu sistema, puedes implementar el evento de conversión una vez en el servidor y reutilizarlo en todos los dispositivos compatibles.

Actualiza el token

Cuando Google refiere a un usuario al mismo comercio, el token existente que ya está almacenado se reemplaza por el token nuevo de la referencia más reciente. Después del reemplazo del token, se restablece la ventana de atribución de 30 días del almacenamiento de tokens, y las conversiones nuevas de este comercio se atribuyen al token más reciente.

Consulta los Requisitos para la atribución de conversiones para obtener más detalles.

Analiza y almacena la información del comercio

Cuando se dirige a un usuario a tu página de reservas, debes implementar la lógica que puede encontrar y capturar los detalles del comercio. Por lo general, los socios agregan metadatos del comercio o merchant_id a sus vínculos de acción y los usan para identificar y almacenar la información del comercio.

Te recomendamos que almacenes el merchant_id o el identificador seleccionado junto con el rwg_token. Cuando un usuario confirma una reserva, puedes consultar al comercio antes de enviar la solicitud de conversión completa. Al igual que con el almacenamiento de tokens, debes guardar los detalles del comercio con el token durante 30 días después de la referencia inicial.

En el siguiente ejemplo, se modifica el rwg_token almacenado anteriormente. Se supone que analizaste la información del comercio a partir de los metadatos en la URL proporcionada y la guardaste como un merchant_id o la comparaste con un merchant_id existente.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Muestra los valores `rwg_token` y `merchant_changed`

Cuando un usuario completa una reserva que comienza con una referencia de action_link, debes enviar una solicitud HTTP POST al extremo de conversión. Existen dos extremos:

Entorno de producción: https://www.google.com/maps/conversion/collect
Entorno de pruebas: https://www.google.com/maps/conversion/debug/collect

Cuando envías un evento de conversión, debes incluir el rwg_token almacenado y un valor merchant_changed de 1 o 2. Para obtener más detalles sobre merchant_changed, consulta Cómo mostrar el valor de cambio del comercio.

El cuerpo de la POST debe ser un objeto codificado en JSON con el siguiente formato:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

En el siguiente ejemplo, se incluye el seguimiento de conversiones a nivel del dispositivo con una cookie en el dispositivo del usuario, escrita en JavaScript:

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

Devuelve el valor de cambio del comercio

El valor merchant_changed se usa para determinar si se cambia el comercio del comercio de redireccionamiento inicial. El cambio de comercios es habitual si tu página de destino se encuentra en una plataforma que incluye a otros comercios. En este caso, si Google le recomienda tu plataforma a un usuario y este decide navegar a un comercio diferente para completar una reserva, debes saber que se produjo una conversión con otro comercio. Puedes usar un valor booleano para identificar el cambio del comercio, pero no los detalles del comercio.

Cuando decidas qué valor asignar a merchant_changed, debes tomar el comercio original guardado en Cómo analizar y almacenar la información del comercio. Verifica si el comercio cambió y asigna el valor según tus necesidades.

Requisito: Ocurre cuando un usuario abandona el sitio web del comercio original y completa una compra a través de tu plataforma con un comercio diferente.
- Valor de cambio del comercio: 1
Requisito: Cuando el usuario completa una transacción a través del comercio original.
- Valor de cambio del comercio: 2

Prueba y verifica el seguimiento de conversiones

En los siguientes casos de prueba, se usan tokens de prueba proporcionados en la sección Tokens de prueba y su objetivo es guiarte a través de todas las situaciones que pueden generar un evento de conversión. Esto garantiza que el token se almacene de forma adecuada, que el valor de merchant_changed se establezca correctamente y que se envíe el evento de conversión cuando corresponda.

Usa el vínculo de acción o las URLs de las páginas de reservas que se proporcionan en tus feeds y ejecuta cada caso de prueba agregando los Tokens de prueba al final de la URL. Asegúrate de usar una ventana de navegador privada o en modo Incógnito, ya que esto borrará los tokens existentes asociados con el usuario actual y te dará un espacio en blanco para trabajar.

Caso de prueba	Descripción de la prueba	Flujo de usuarios	Resultado esperado
1	Un usuario completa una reserva que no se originó en Google.	Un usuario navega directamente a la página de reservas sin que Google lo dirija o sin una referencia existente. Esto no debería generar ningún evento de conversión.	No hay un evento de conversión porque el usuario no visitó la página de reservas anteriormente o Google no lo refirió.
2	Un usuario completa una reserva que se originó en Google.	Un usuario encuentra tu comercio a través de Google, se le dirige a tu página de reservas y completa una reserva.	Se enviaría un evento de conversión con el token A y el valor merchant changed de 2 porque Google derivó al usuario a la página de reservas.
3	Un usuario (que proviene de Google) comienza el flujo de reserva, pero abandona la sesión antes de que se complete la reserva. Nota: Mantén esta sesión abierta para las pruebas 4 y 5.	Se deriva a un usuario a tu página de reservas, pero la sesión finaliza y no completa una reserva.	No hay conversión porque el usuario no completó la reserva, pero el token B se debe almacenar durante 30 días.
4	Un usuario regresa a la página de reservas, sin haber iniciado desde Google, y completa una reserva. Nota: La URL del flujo de reservas no debe incluir un rwg_token.	Un usuario regresa a la página de reservas después de la prueba n° 4. El token B debe almacenarse durante 30 días, y cualquier conversión durante ese período debe mostrar un evento de conversión.	Se enviaría un evento de conversión con el token B y el valor merchant changed de 2 porque el usuario regresa a la página de reservas después de una referencia anterior de Google.
5	Un usuario completa una reserva nueva que se origina en Google después de la prueba n° 4.	Si un usuario regresa a tu página de reservas con una referencia de Google después de una referencia anterior de Google, se restablece su ventana de almacenamiento de 30 días y un token nuevo Token C reemplaza al anterior Token B. Todas las conversiones futuras se atribuirán al token C.	Se enviaría un evento de conversión con el token C y el valor merchant changed de 2 porque el usuario completó la reserva y el token nuevo reemplazó el token almacenado anteriormente.

Si tienes una plataforma que permite que los usuarios realicen la confirmación de la compra con un comercio diferente, prueba lo siguiente.

Caso de prueba	Descripción de la prueba	Flujo de usuarios	Resultado esperado
6	Google dirige a un usuario a tu página de reservas y este completa una reserva con un comercio diferente.	Google le envía una referencia a un usuario a tu página de reservas y se usa el token A, pero antes de completar una reserva, navega a una página diferente y la completa con un comercio que difiere de la referencia original.	Se enviaría un evento de conversión porque el usuario completó una reserva que se originó con una referencia de Google con el token A y el valor de comercio cambiado de 1 porque el usuario completó la reserva en un comercio diferente al de la referencia.

Durante la prueba, envía la solicitud HTTP POST al extremo de conversión. Hay dos extremos:

Entorno de producción: https://www.google.com/maps/conversion/collect
Entorno de zona de pruebas: https://www.google.com/maps/conversion/debug/collect

Tokens de prueba

Para probar el seguimiento de conversiones, agrega uno de los siguientes tokens de prueba al final de los vínculos de acción o las URLs de la página de reservas que proporcionas en tus feeds.

Token A:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Token B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Token C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Cuando envíes los eventos de conversión correctos, podrás verlos agregados en el Centro de acciones, en el panel de seguimiento de conversiones.

conversion-tracking-dashboard

Requisitos para la atribución de conversiones

El estándar obligatorio de Google para la atribución de conversiones es una ventana de atribución de 30 días para cualquier interacción con un vínculo de acción de lugar en cualquier tienda.

Esta ventana de atribución significa que Google puede esperar que se envíe un evento de conversión en cualquiera de las siguientes situaciones:

Un usuario sigue un vínculo de acción de lugar y realiza un pedido para el mismo comercio en la misma sesión. Valor de cambio del comercio = 2.
Un usuario sigue un vínculo de acción de ubicación y, luego, regresa desde un canal diferente dentro del período de atribución de 30 días para realizar un pedido en el mismo comercio. Valor de cambio del comercio = 2.
Un usuario sigue un vínculo de acción de lugar y, luego, realiza un pedido en una tienda diferente, ya sea dentro de la misma sesión o en una sesión diferente, dentro de una ventana de atribución de 30 días. Valor de cambio del comercio = 1.

Además, Google espera enviar eventos de conversión desde cualquier dispositivo al que un usuario pueda acceder a través de un vínculo de acción de lugar. Entre estos dispositivos, se incluyen los siguientes:

Aplicaciones web para computadoras de escritorio o dispositivos móviles
Apps para dispositivos móviles, ya sea a través de un vínculo directo de la app o un intent de app registrado para tu dominio

Si el token se almacena a nivel del usuario, se espera que proporciones la atribución multidispositivo. Para obtener más información, consulta Almacenamiento a nivel del usuario. En este caso, un usuario que sigue un vínculo de acción desde una computadora de escritorio y, luego, completa la transacción en un dispositivo móvil con la misma cuenta de usuario debe activar un evento de conversión.

Si el token se almacena exclusivamente a nivel del dispositivo, como en las cookies del navegador, no se espera que proporciones atribución multidispositivo. En este caso, cada dispositivo puede tener un token independiente persistente, si el usuario sigue un vínculo de acción en ese dispositivo, y cada dispositivo puede seguir las reglas de atribución por separado.

Feeds

Revisión de la integración