Seguimiento de conversiones

Implementación

Resumen

La implementación del seguimiento de conversiones consta de tres partes:

Recopila el rwg_token desde el punto de entrada de la página de destino o la app.
Cómo conservar el objeto rwg_token para el período de atribución adecuado
Envío de un evento de conversión en la confirmación de compra

Esta implementación del seguimiento de conversiones no requiere que uses Google Analytics ni ningún otro JavaScript de terceros.

Antes de comenzar a trabajar en la implementación del seguimiento de conversiones, debes decidir si realizarás el seguimiento de las conversiones a nivel del dispositivo o del usuario:

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. Dado que el token se almacenaría de forma local en el dispositivo del usuario, si este cambia de dispositivo, borra su almacenamiento local o sus cookies, o usa el 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, deberás volver a implementar esta función en todas las plataformas compatibles (incluidos los dispositivos móviles).
El nivel del usuario incluye la persistencia 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. Dado 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 el modo de navegación privada o de 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 implementar esto una vez en tu servidor y reutilizarlo en todas las plataformas compatibles.

Cómo recopilar el `rwg_token`

Cada vez que Google muestre un action_link que hayas proporcionado a través de los feeds, esa URL se modificará para incluir un parámetro de consulta único: rwg_token. El valor rwg_token es una cadena codificada que contiene algunos metadatos sobre el vínculo en el que hizo clic el usuario. Almacenarás este token y lo devolverás como parte del evento de conversión.

En cada página de destino o punto de entrada de la aplicación, debes analizar el valor establecido para el parámetro de búsqueda rwg_token y almacenarlo. Los requisitos para almacenar este parámetro se describen en el paso Cómo conservar el parámetro rwg_token.

A continuación, se incluye un ejemplo de cómo se puede analizar este token para el seguimiento a nivel del dispositivo a través del navegador. Como alternativa, puedes recopilar este token en el servidor cuando respondas a la solicitud:

<script>
  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;
    }
  }
</script>

Cómo conservar el `rwg_token`

Nota: Conservar el valor de rwg_token es clave para implementar correctamente la ventana de atribución requerida. Para obtener más detalles sobre los requisitos de atribución, consulta la sección Requisitos de atribución de conversiones a continuación.

Deberás conservar el parámetro de URL rwg_token, que se agregará a todos los vínculos de acción que proporciones, durante un período total de 30 días. El valor de rwg_token se debe almacenar y devolver sin ninguna edición. Si hay un token existente que se conservó de una visita anterior, se debe reemplazar el token anterior y se debe restablecer el período de 30 días para el almacenamiento.

Cuando persistas el token, puedes almacenarlo a nivel del dispositivo o del usuario:

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 nivel del usuario incluye la persistencia 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.

A continuación, se muestra un ejemplo del seguimiento de conversiones a nivel del dispositivo, en el que se almacena este token en un navegador web a través de una cookie propia. En este ejemplo, se supone que analizaste el valor del token en una variable, como en el ejemplo anterior. Para usar este ejemplo, deberás actualizar "rootdomain" a tu dominio.

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

Cuando se utiliza el seguimiento de conversiones a nivel del usuario, el rwg_token debe almacenarse en el servidor y asociarse con el usuario.

Envía datos de conversiones

Cuando un usuario completa una transacción que se puede atribuir a un vínculo de acción de lugar de Google, 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

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

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

Tanto en el entorno de pruebas como en el de producción, deberás proporcionar un rwg_token válido cuando envíes un evento de conversión. Para realizar pruebas en el entorno de zona de pruebas, puedes usar el siguiente token de prueba.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Nota: En producción, no debes enviar eventos de conversión que no se atribuyan a esta integración. Asegúrate de verificar que haya un valor de rwg_token válido y que no haya vencido antes de enviar el evento.

A continuación, se incluye un ejemplo completo del seguimiento de conversiones a nivel del dispositivo (con una cookie en el dispositivo del usuario) en JavaScript sobre cómo realizar esta solicitud POST:

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
    })
  });
}

Cuando uses el seguimiento de conversiones a nivel del usuario, debes recuperar el token asociado al usuario (independientemente de la plataforma en la que se encuentre) desde tu mecanismo de almacenamiento del servidor y enviarlo con los mismos extremos de producción o de zona de pruebas.

Nota: Los eventos de conversión se pueden enviar desde un cliente web o de aplicación, o desde el servidor. Puedes tomar esta decisión según tus necesidades y el lugar donde se almacena el token, siempre y cuando se envíe un evento de conversión exactamente una vez por conversión y se incluya un valor de rwg_token válido.

Requisitos de atribución de conversiones

El estándar requerido de Google para la atribución de conversiones es una ventana de atribución de 30 días para cualquier interacción con una vinculación de lugar en cualquier tienda.

Esta ventana de atribución significa que esperamos 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 en la misma sesión.
Un usuario sigue un vínculo de acción de lugar y, luego, regresa desde un canal diferente dentro del período de 30 días para realizar un pedido.
Un usuario sigue un vínculo de acción de lugar y, luego, realiza un pedido en una tienda diferente, ya sea en la misma sesión o en una sesión diferente dentro de un período de 30 días.

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

Aplicaciones web para computadoras de escritorio 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 (consulta cómo conservar el token), se espera que proporciones atribución multidispositivo. Es decir, 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) 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 multidispositivo. En este caso, cada dispositivo tendría un token independiente persistente 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.