Seguimiento de conversiones

Descripción general

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

Para completar la integración, sigue estos pasos:

1. Analiza y almacena el rwg_token.
2. Analiza y almacena la información del comercio.
3. Devuelve los valores de rwg_token y merchant_changed.
4. 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 de 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.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

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 (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}

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

Almacenar a nivel del dispositivo

El nivel del dispositivo incluye el uso de cookies del navegador, almacenamiento local, 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. 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 si el usuario realiza las siguientes acciones:

• Cambia el dispositivo que usa.
• Borra el almacenamiento local o las cookies.
• Usar un navegador privado o de 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.

Almacenar a nivel del usuario

El nivel del usuario persiste el token en la base de datos de tu aplicación, a través de un sistema de análisis del servidor o de otros sistemas del servidor. El token se almacena en el servidor. Por lo tanto, el evento de conversión se sigue atribuyendo correctamente después de que el usuario vuelve a acceder.

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

Actualiza el token

Cuando Google deriva a un usuario al mismo comercio, el token existente que ya está almacenado se reemplaza por el token nuevo de la derivación 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 pueda 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 de la URL proporcionada y que la guardaste como un objeto merchant_id o la correlacionaste con un objeto merchant_id existente.

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}

Devuelve los valores de rwg_token y merchant_changed.

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

• 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 de merchant_changed de 1 o 2. Para obtener más detalles sobre merchant_changed, consulta Cómo devolver el valor de cambio del comercio.

El cuerpo de la solicitud 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, escrito en JavaScript:

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

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      merchant_changed: merchantChanged
    })
  });
}

Devuelve el valor del cambio del comercio

El valor de merchant_changed se usa para determinar si el comercio cambió desde el comercio de redireccionamiento inicial. El cambio de comercios es común si tu página de destino se encuentra en una plataforma que incluye otros comercios. En este caso, si Google deriva un usuario a tu plataforma y este decide navegar a otro comercio para completar una reserva, debes saber que se produjo una conversión con un comercio diferente. 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 tener en cuenta el comercio original guardado en Analiza y almacena la información del comercio. Verifica si el comercio cambió y asigna el valor según tus requisitos.

• Requisito: 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

Los siguientes casos de prueba usan tokens de prueba que se proporcionan en la sección Tokens de prueba y tienen como objetivo guiarte por todas las situaciones posibles 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 el evento de conversión se envíe cuando corresponda.

Usa los vínculos de acción o las URLs de las páginas de reserva 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 incógnito o privada del navegador, ya que esto borrará los tokens existentes asociados con el usuario actual y te proporcionará un espacio limpio para trabajar.

Si tienes una plataforma que permite a los usuarios confirmar la compra con un comercio diferente, prueba lo siguiente.

Mientras realizas 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 proporciones 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 exitosos, podrás verlos agregados en el Centro de acciones, en el panel de seguimiento de conversiones.

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. El valor de cambio del comercio es igual a 2.
• Un usuario sigue un vínculo de acción de lugar y, luego, regresa desde un canal diferente dentro del período de atribución de 30 días para realizar un pedido al mismo comercio. El valor de cambio del comercio es igual a 2.
• Un usuario sigue un vínculo de acción de lugar y, luego, realiza un pedido en otra tienda, ya sea en la misma sesión o en una sesión diferente dentro de una ventana de atribución de 30 días. El valor de cambio del comercio es igual a 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. Estos dispositivos incluyen los siguientes:

• Aplicaciones web para computadoras o dispositivos móviles
• Aplicaciones para dispositivos móviles, ya sea a través de un vínculo directo de la aplicación o una intención de aplicación registrada para tu dominio

Si el token se almacena a nivel del usuario, se espera que proporciones 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 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 persistente independiente 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.