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

Seguimiento de conversiones

Implementación

Resumen

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

Cómo recopilar los rwg_token desde la página de destino o el punto de entrada de la aplicación.
Cómo conservar rwg_token para la ventana de atribución adecuada
Envío de un evento de conversión en la confirmación de la compra

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

Antes de comenzar a trabajar en la implementación del seguimiento de conversiones, debes decidir Si va a realizar un seguimiento de las conversiones a nivel del dispositivo o del usuario:

El nivel del dispositivo incluye el uso de cookies del navegador, uso almacenamiento, almacenamiento local de la app o cualquier otro método que pueda persistir el token para la ventana 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 esté usando, borra las cookies o el almacenamiento local. usa la navegación privada o el modo Incógnito, y es posible que no se atribuyan correctamente. Al usar el nivel del dispositivo seguimiento de conversiones, debe volver a implementarlo en todos plataforma compatible (incluidos los dispositivos móviles).
El nivel de usuario incluye la persistencia en tu aplicación de la base de datos, a través de un sistema de análisis del servidor u otro sistemas del servidor. Debido a que el token se almacenaría en el del servidor, si el usuario cambia el dispositivo que está usando, borra su almacenamiento local o las cookies, o bien usa un servicio de navegación modo Incógnito, el evento de conversión se seguirá atribuyendo una vez el usuario vuelva a acceder. Cuando se utiliza el seguimiento de conversiones según la arquitectura de tu sistema, es posible que puedas implementar esto una vez en el servidor y reutilizarlo en todas plataformas compatibles.

Cómo recopilar el `rwg_token`

Cada vez que Google muestra un action_link que proporcionaste a través de los feeds, la URL se modificará para incluir una consulta única parámetro: rwg_token. El rwg_token value es una cadena codificada que contiene algunos metadatos sobre el el vínculo en el que hizo clic el usuario. Almacenarás este token y lo pasarás de vuelta 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 consulta rwg_token y almacénalo. Requisitos para almacenar este parámetro se describen en el paso Cómo conservar la rwg_token

Ejemplo de cómo se puede analizar este token para el seguimiento a nivel del dispositivo mediante navegador se incluye a continuación. También puedes recopilar este token en el del servidor cuando se responde 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>

Persiste el `rwg_token`

Nota: Conservar rwg_token es clave para implementar la ventana de atribución requerida. Para obtener más detalles los requisitos de atribución, consulte la sección Requisitos para la atribución de conversiones más abajo.

Deberás conservar el parámetro de URL rwg_token, que se agregará a todos los vínculos de acción que hayas proporcionado, para un total de 30 días. El valor de rwg_token debe ser el siguiente: se almacenan y se devuelven sin modificaciones. Si hay un token existente persistente de una visita anterior, el el token anterior debe reemplazarse y el período de 30 días para su almacenamiento debe restablecerse.

Al conservar el token, puedes almacenar el token en el a nivel del dispositivo o del usuario:

El nivel del dispositivo incluye el uso de cookies del navegador, almacenamiento local, el almacenamiento local de la app o cualquier otro método que pueda conservar el token para la ventana de atribución de 30 días.
El nivel de usuario incluye mantenerlo 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 de seguimiento de conversiones a nivel del dispositivo almacenar este token en un navegador web a través de un cookie de terceros. 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, se debe hacer lo siguiente: rwg_token almacenarse en el servidor y asociarse con el usuario.

Envío de datos de conversiones

Cuando un usuario completa una transacción atribuible a un Google Place Action, debes enviar una solicitud HTTP POST al extremo de conversión. Hay dos extremos, uno para el segmento de producción uno 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 con codificación JSON que tenga el siguiente formato:

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

Tanto en los entornos de zona de pruebas como de producción, deberás hacer lo siguiente: Proporciona un rwg_token válido cuando envíes un evento de conversión. Para realizar pruebas en el entorno de la zona de pruebas, puedes usar los siguientes token de prueba.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Nota: En producción, no debes enviar eventos de conversión que no atribuida a esta integración. Asegúrate de verificar si hay una un valor de rwg_token no vencido antes de enviar el evento.

Ejemplo completo del seguimiento de conversiones en el nivel del dispositivo (con una cookie en el dispositivo del usuario) en JavaScript sobre cómo realizar esta solicitud de publicación está incluido a continuació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
    })
  });
}

Cuando utilice el seguimiento de conversiones a nivel del usuario, debe recuperar el token asociado al usuario (independientemente de la superficie (están encendidas) del mecanismo de almacenamiento del servidor y envía el token usando los mismos extremos de producción o de la zona de pruebas.

Nota: Los eventos de conversión se pueden enviar desde un cliente web o de aplicaciones. o desde el servidor. Puedes tomar esta decisión según tu y según dónde esté almacenado el token, siempre que se haya se envía exactamente una vez por conversión e incluye un Valor rwg_token.

Requisitos de atribución de conversiones

El estándar de Google para la atribución de conversiones es ventana de atribución para cualquier interacción con un vínculo de lugar, en cualquier en una tienda física.

Esta ventana de atribución indica que esperaríamos que se generara evento enviado en cualquiera de los siguientes escenarios:

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 de un a otro canal 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 un tienda diferente, ya sea dentro de la misma sesión o en una tienda en una ventana de 30 días.

Además, esperamos que los eventos de conversión se envíen desde todos plataformas a las que el usuario puede llegar desde un vínculo de acción de lugar. Esto 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 a la aplicación o de un registro intent de app para tu dominio

Si el token se almacena a nivel del usuario (consulta Cómo conservar el token), es el proceso esperado que proporcione la atribución en varios dispositivos. Es decir, un usuario que sigue un vínculo de acción del escritorio y completa el transacción en un dispositivo móvil (con la misma cuenta de usuario), debería activarse un evento de conversión.

Si el token se almacena exclusivamente en el nivel del dispositivo, por ejemplo, en cookies del navegador, no se espera que proporciones datos atribución. En este caso, cada dispositivo tendría un token independiente si el usuario siguió un vínculo de acción en ese dispositivo cada dispositivo seguiría las reglas de atribución por separado.