Seguimiento de conversiones

Figura 2: Descripción general del seguimiento de conversiones

Resumen

El objetivo del seguimiento de conversiones es hacer un seguimiento de las conversiones que inicia Google a través de una de nuestras integraciones de Action Center. Esto es fundamental para mantener la integración en buen estado y en funcionamiento, y puede influir en la clasificación de ciertas páginas. Cada vez que Google muestra un action_link, esa URL se modifica para incluir un parámetro de consulta único: rwg_token. Depende de ti almacenar ese token y mostrar los valores adecuados cuando un usuario complete una reserva.

Para completar la integración, debes hacer lo siguiente:

  1. Recopila y almacena el rwg_token.
  2. Recopila y almacena el comercio.
  3. Muestra los valores rwg_token y merchant_change.
  4. Prueba y verifica el seguimiento de conversiones.

Recopila y almacena el rwg_token.

Para completar esta 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 algunos metadatos sobre el vínculo y el comercio que lo generó. Es importante tener en cuenta que no se almacenan ni encriptan datos del usuario en el token.

Recopilación de tokens

Cuando se dirija a un usuario a tu página de reservas, se adjuntará un nuevo parámetro de consulta, rwg_token, a la URL proporcionada. En tu página de reservas, debes analizar el valor. Se incluye un ejemplo de cómo se puede analizar este token para el seguimiento a nivel del dispositivo a través del 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 parámetro de consulta que se adjunta a tu URL será un token encriptado. Consulta el siguiente ejemplo de un rwg_token. Usa este token de muestra para asegurarte de analizar el token correctamente, incluidos los caracteres especiales, como "=". El siguiente es un ejemplo de cómo será un token típico.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Almacenamiento de tokens

Cuando almacenas el rwg_token, hay dos niveles diferentes en los que puedes implementar el seguimiento de conversiones: a nivel del dispositivo y a nivel del usuario. Tú decides dónde almacenar el token, pero debes almacenarlo durante 30 días desde la referencia inicial.

En el siguiente ejemplo, se muestra el seguimiento de conversiones a nivel del dispositivo, que almacena estos valores en un navegador web con una cookie propia. En este ejemplo, se supone que analizaste el valor del token en una variable, como en el ejemplo de almacenamiento de tokens. 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=/";
}

Ten en cuenta lo siguiente cuando decidas dónde almacenar el rwg_token.

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 el período de atribución de 30 días. Debido a que el token se almacenaría de forma local en el dispositivo del usuario, si este cambia el dispositivo que usa, borra su almacenamiento local o sus cookies, o usa un modo de navegación privada o incógnito, es posible que el evento de conversión no se atribuya correctamente. Cuando uses el seguimiento de conversiones a nivel del dispositivo, debes volver a implementarlo en todas las plataformas compatibles (incluidos los dispositivos móviles).

Almacenamiento a nivel del usuario

El nivel de usuario incluye conservarlo 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. Debido a que el token se almacenaría en el servidor, si el usuario cambia el dispositivo que usa, borra su almacenamiento local o sus cookies, o usa un modo de navegación privada o incógnito, el evento de conversión se seguirá atribuyendo una vez que el usuario vuelva a acceder. Cuando usas el seguimiento de conversiones a nivel del usuario, según la arquitectura de tu sistema, es posible que puedas implementarlo una vez en tu servidor y reutilizarlo en todas las plataformas compatibles.

Cada vez que Google muestra un action_link que proporcionaste a través de los feeds, esa URL se modifica para incluir un parámetro de consulta único: rwg_token. El valor de rwg_token es una cadena codificada que contiene algunos metadatos sobre el vínculo en el que hizo clic el usuario, pero no datos del usuario. Debes almacenar este token y volver a pasarlo como parte del evento de conversión.

Actualiza el token

Cuando Google dirige a un usuario al mismo comercio, si se almacena un token existente, este se reemplaza por el nuevo de la referencia más reciente. Cuando se reemplaza el token, se restablece el período de 30 días del almacenamiento del token y las conversiones nuevas de este comercio se deben atribuir al token más reciente.

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

Recopila y almacena el comercio.

Cuando se dirige a un usuario a tu página de reservas, debes implementar una lógica que encuentre y capture al 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 el comercio. Te recomendamos que almacenes el merchant_id (o el identificador seleccionado) junto con el rwg_token para que, cuando un usuario confirme una reserva, puedas consultar al comercio antes de enviar la solicitud de conversión completada. Al igual que con la ventana de almacenamiento de tokens, el comercio debe guardarse con el token durante 30 días a partir de la referencia inicial.

En los siguientes ejemplos, se ajusta el rwg_token almacenado anteriormente. Esto supone que estás analizando el comercio a partir de los metadatos de la URL proporcionada y lo guardas como un merchant_id o lo haces coincidir 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_change.

Cuando un usuario completa una reserva que comenzó a partir de una referencia de vínculo de acción, debes enviar una solicitud HTTP POST al extremo de conversión. Hay dos extremos, uno para el entorno de producción y otro para el entorno de zona de pruebas.

  • Producción: https://www.google.com/maps/conversion/collect
  • Zona de pruebas: https://www.google.com/maps/conversion/debug/collect

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

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. Está escrito 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 el comercio cambió del comercio de redireccionamiento inicial. Es común cambiar de comercio si tu página de destino se encuentra en una plataforma que incluye a otros comercios. En este caso, si Google refirió a un usuario a tu plataforma y este decidió navegar a un comercio diferente y completar una reserva, queremos saber que se produjo una conversión, pero con un comercio diferente. No necesitamos conocer el comercio, solo que se produjo un evento de conversión y que el comercio era diferente. Usamos un valor booleano para identificar si cambió o no un comercio.

Cuando decidas qué valor asignar a merchant_change, deberás tomar el comercio original guardado en Cómo recopilar y almacenar el comercio y verificar si cambió. Luego, consulta la siguiente tabla cuando asignes el valor.

Si tu página de reservas no está dentro de una plataforma o los usuarios no pueden navegar a un comercio diferente, puedes codificar el valor de estas solicitudes en 2. Esto es común para los socios que integran sus páginas de reservas en el sitio web de su comercio o que tienen páginas de destino personalizadas para procesar reservas.

Valor del cambio del comercio Requisito
1 Este valor se debe usar cuando un usuario abandona el sitio web del comercio original y completa una compra a través de tu plataforma con un comercio diferente.
2 Este valor se debe usar cuando el cliente completó una transacción a través de la entidad original (comerciante).

Prueba y verifica el seguimiento de conversiones.

Para asegurarte de que la implementación del seguimiento de conversiones sea correcta, deberás ejecutar la siguiente prueba. Asegúrate de usar vínculos de acción vinculados a tus comercios y de que las solicitudes se realicen en una ventana privada o de incógnito para garantizar que se borre cualquier token anterior asociado con ese usuario.

  1. Completa una reserva solo con un vínculo de acción
    • Las reservas directas sin referencias ni tokens almacenados anteriores no deberían generar ninguna solicitud enviada a Google.
  2. Completa una reserva con un vínculo que tenga un rwg_token adjunto.
    • Asegúrate de que la solicitud se realice correctamente y se envíe con los valores rwg_token y merchant_change de 2.
    • Asegúrate de almacenar el rwg_token durante 30 días
  3. Completa una reserva nueva con el mismo comercio usando un rwg_token nuevo.
    • Asegúrate de que la solicitud se realice correctamente y se envíe con el nuevo valor rwg_token y merchant_change de 2.
    • Asegúrate de que la ventana de almacenamiento de atribución del token se actualice durante 30 días
  4. Navega directamente a la página de reservas del comercio que probaste y realiza una reserva nueva sin un rwg_token adjunto.
    • Asegúrate de que la solicitud se envíe con el rwg_token almacenado anteriormente y que el valor de merchant_change sea 2.

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

  1. Ve a la página de reservas del comercio con un vínculo que tenga un rwg_token adjunto y, luego, navega a otro comercio y realiza una reserva.
    • Asegúrate de que la solicitud se envíe con el valor rwg_token y merchant_change de 1.

Cuando realices pruebas, envía la solicitud HTTP POST al extremo de conversión. Hay dos extremos, uno para el entorno de producción y otro para el entorno de zona de pruebas.

  • Producción: https://www.google.com/maps/conversion/collect
  • Zona de pruebas: https://www.google.com/maps/conversion/debug/collect

Deberás agregar el siguiente token a tu vínculo de acción o URL:

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

Usa el siguiente token para las pruebas que requieran tokens adicionales.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%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. Ten en cuenta que las conversiones pueden tardar hasta una hora en aparecer en el panel.

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 lugar, en cualquier tienda.

Esta ventana de atribución significa que Google espera 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. (Merchant Change Value = 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 30 días para realizar un pedido en el mismo comercio. (Merchant Change Value = 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 un período de 30 días. ( Merchant Change Value = 1 )

Además, Google espera que los eventos de conversión se envíen desde todas las plataformas a las que un usuario puede llegar desde un vínculo de acción del lugar. Esto incluye lo siguiente:

  • 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 (consulta cómo conservar el token), se espera que proporciones una atribución multidispositivo. Es decir, 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) debería 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 entre dispositivos. En este caso, cada dispositivo tendría un token independiente si el usuario hubiera seguido un vínculo de acción en ese dispositivo, y cada dispositivo seguiría las reglas de atribución por separado.