Seguimiento de conversiones

Implementación

Resumen

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

  • Se recopila el rwg_token de la página de destino o el punto de entrada de la app.
  • Conserva el elemento rwg_token para la ventana de atribución adecuada
  • Envía un evento de conversión durante la confirmación de la compra

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

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

  • 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. Dado que el token se almacenará de forma local en el dispositivo del usuario, si el usuario cambia el dispositivo que está usando, borra las cookies o el almacenamiento local, o usa la navegación privada o el modo 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 admitidas (incluidos los dispositivos móviles).
  • 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. Dado que el token se almacenará en el servidor, si el usuario cambia el dispositivo que utiliza, borra las cookies o el almacenamiento local, o usa una navegación privada o el modo Incógnito, el evento de conversión se seguirá atribuyendo una vez que el usuario vuelva a acceder. Cuando uses el seguimiento de conversiones a nivel del usuario, según la arquitectura de tu sistema, tal vez puedas implementarlo una vez en el servidor y volver a utilizarlo en todas las plataformas compatibles.

Cómo recopilar el rwg_token

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 rwg_token es una cadena codificada que contiene algunos metadatos sobre el vínculo en el que el usuario hizo clic. Debes almacenar este token y pasarlo como parte del evento de conversión.

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

A continuación, se incluye un ejemplo de cómo se puede analizar este token para el seguimiento a nivel del dispositivo mediante el navegador. Como alternativa, puedes recopilar este token del 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

Se te solicitará que conserves el parámetro de URL rwg_token, que se adjuntará a todos los vínculos de acción que proporciones, durante un total de 30 días. El valor de rwg_token se debe almacenar y mostrar sin modificaciones.

Junto con rwg_token, debes almacenar el merchant_id asociado con el vínculo de acción.

Si se conserva un token de una visita anterior, se deben reemplazar el rwg_token y merchant_id anteriores, y se debe restablecer el período de 30 días para el almacenamiento.

Cuando conserves el par anterior, puedes almacenar los valores a nivel del dispositivo o del usuario:

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

A continuación, se muestra un ejemplo de seguimiento de conversiones a nivel del dispositivo, en el que se almacenan estos valores en un navegador web mediante 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, debes actualizar “rootdomain” a tu dominio.

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

Cuando se utiliza el seguimiento de conversiones a nivel del usuario, los atributos rwg_token + merchant_id deben almacenarse en el servidor y asociarse con el usuario.

Envío de los datos de conversiones

Cuando un usuario completa una transacción que se puede atribuir a un vínculo de acción de Google Place, 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 la 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 entrada debe ser un objeto codificado en JSON con el siguiente formato:

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

El valor merchant_changed se usa para determinar si el comercio cambió desde el comercio de redireccionamiento inicial. Hay dos valores que se pueden pasar

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

Tanto en el entorno de la zona de pruebas como en el de producción, debes proporcionar un rwg_token válido cuando envías un evento de conversión. Para realizar pruebas, usa el siguiente token de prueba en ambos entornos hasta que inicies el proceso:

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

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

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

Cuando usas el seguimiento de conversiones a nivel del usuario, debes recuperar el token que está asociado con el usuario (sin importar la plataforma en la que se encuentre) del mecanismo de almacenamiento del servidor y enviar el token con los mismos extremos de producción o de zona de pruebas.

Requisitos de atribución de conversiones

El estándar 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 indica 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(valor de cambio de comercio = 2).
  • Un usuario sigue un vínculo de acción de lugar y, luego, regresa de un canal diferente dentro del período de 30 días para realizar un pedido para 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 diferente en un período de 30 días. ( Valor de cambio del comercio = 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 de lugar. Incluye lo siguiente:

  • 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 un intent de aplicación registrado para tu dominio

Si el token se almacena a nivel del usuario (consulta cómo conservar el token), se espera que proporciones la atribución multidispositivo. Es decir, un usuario que sigue un vínculo de acción desde la 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 la 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.

Anterior
Feeds
Siguiente
Revisión de la integración