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:

Recopilar los elementos rwg_token y merchant_id de la página de destino o la app punto de entrada.
Persiste los rwg_token y merchant_id para la atribución adecuada en la ventana modal.
Compara los merchant_id y los merchant_id persistentes en el momento de la conversión (reserva completa).
Se envía un evento de conversión en el momento de la conversión (se completó la reserva).

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

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

El nivel de dispositivo incluye el uso de cookies del navegador, almacenamiento local, uso local de la app almacenamiento o cualquier otro método que pueda conservar el token durante 30 días ventana de atribución. Debido a que el token se almacenaría localmente en el dispositivo, si el usuario cambia el dispositivo que está usando, borrará su configuración almacenamiento o cookies, o usa un modo de navegación privada o incógnito, es posible que no se atribuya correctamente el evento de conversión. Al usar el nivel del dispositivo seguimiento de conversiones, debe volver a implementarlo en todos los plataforma (incluidos los dispositivos móviles).
El nivel de usuario incluye mantenerlo en la base de datos de tu aplicación, mediante un sistema de análisis del servidor, o bien otros sistemas del servidor. Debido a que el token se almacenaría en el servidor, si el usuario cambia el dispositivo están usando, borra su almacenamiento local o las cookies, o usa un navegación o 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 a nivel del usuario, en la arquitectura de su sistema, podrá implementarlo una vez en su del servidor y reutilizarlos 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 El valor rwg_token es una cadena codificada que contiene algunos metadatos sobre el el vínculo en el que hizo clic el usuario, pero no hay datos del usuario. Debes almacenar este token y y pasarla como parte del evento de conversión.

En cada página de destino o punto de entrada de la aplicación, debe analizar el valor establecido para el rwg_token y guárdalo. Requisitos para almacenar se describe en el paso Persistencia de 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. Como alternativa, puedes recopilar este token en del servidor cuando se responde a la solicitud:

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

Cómo recopilar el `merchant_id`

Si implementas la lógica del seguimiento de conversiones en el frontend, en la página debes implementar una secuencia de comandos personalizada que busque y capture merchant_id Por lo general, es posible que merchant_id ya esté presente en el en la página de destino o en la URL para poder capturarlo desde allí. De lo contrario, debes busca la manera de exponerlo en algún lugar para que sea capturable, lo que probablemente implique de los cambios de backend.

Si implementas la lógica del seguimiento de conversiones en el backend, es posible que veas el merchant_id junto con los datos que consultan tu sistema interno para generar la página de frontend.

Este merchant_id debe ser el mismo que compartiste con Google en tu feed.

Cómo conservar `rwg_token` y `merchant_id`

Deberás conservar el parámetro de URL rwg_token, que se a todos los vínculos de acción que hayas proporcionado, por un período total de 30 días. El valor de rwg_token se debe almacenar y mostrar sin modificaciones.

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

Si hay un token existente persistente de una visita anterior, lo anterior Deben reemplazarse rwg_token y merchant_id, y el período de 30 días para el almacenamiento debe restablecerse.

Si conservas el par anterior, puedes almacenar los valores en el dispositivo o a nivel del usuario:

El nivel de dispositivo incluye el uso de cookies del navegador, almacenamiento local, uso local de la app almacenamiento o cualquier otro método que pueda conservar el token durante 30 días ventana de atribución.
El nivel de usuario incluye mantenerlo en la base de datos de tu aplicación, mediante un sistema de análisis del servidor, o bien otros sistemas del servidor.

A continuación, se muestra un ejemplo del seguimiento de conversiones a nivel del dispositivo, donde almacenar estos valores en en un navegador web que usa una cookie propia. En este ejemplo, se da por sentado que ya analizaste el valor del token en una variable, como en el ejemplo anterior. Para usar este ejemplo, es necesario actualizar rootdomain.com en tu dominio.

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

Cuando se utiliza el seguimiento de conversiones a nivel del usuario, se deben cumplir los siguientes requisitos: rwg_token y merchant_id 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 lugar de Google Place Action, debes enviar una solicitud HTTP POST al extremo de conversión. Existen 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 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
}

Ejemplo (comercio sin cambios con el token de prueba para el socio 20123456):

{
  "conversion_partner_id": 20123456,
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": 2
}

El valor merchant_changed se utiliza para determinar si se modificó el comercio. del 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 salga del sitio web original del comercio y completar 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 mediante la entidad original (Comercio).

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

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Para realizar pruebas en la zona de pruebas, debes agregar manualmente el siguiente parámetro de URL al los vínculos de tu zona de pruebas:

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

Ejemplo completo del seguimiento de conversiones en el nivel del dispositivo (mediante una cookie en la (dispositivo) en JavaScript sobre cómo realizar esta solicitud de publicación se incluye 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,
      merchant_changed: merchantChanged
    })
  });
}

Cuando se utiliza el seguimiento de conversiones a nivel del usuario, se debe recuperar el token que se asocia con el usuario (independientemente de la plataforma en la que se encuentre) de tu mecanismo de almacenamiento del servidor y enviar el token usando los mismos recursos extremos de la zona de pruebas.

Requisitos de atribución de conversiones

El estándar requerido de Google para la atribución de conversiones es la atribución de 30 días para cualquier interacción con el vínculo de un lugar, en cualquier tienda.

Esta ventana de atribución significa que Google esperaría que un evento de conversión enviados 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 del comercio = 2)
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 para el mismo comercio. (Comercio Cambiar valor = 2)
Un usuario sigue un vínculo de acción de lugar y, luego, realiza un pedido en un lugar diferente en la tienda, ya sea en la misma sesión o en una sesión diferente en un plazo de 30 días en la ventana modal. ( Valor de cambio del comercio = 1)

Además, Google espera que los eventos de conversión se envíen desde todas las plataformas al 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 intent de aplicación registrado para tu dominio

Si el token se almacena a nivel del usuario (consulta cómo conservar el token), se esperaba que proporcionara la atribución en varios dispositivos. Es decir, un usuario que sigue un vínculo de acción en el escritorio y, luego, completa la transacción en el dispositivo móvil (con la misma cuenta de usuario) deben activar un evento de conversión.

Si el token se almacena exclusivamente en el nivel del dispositivo, como en el navegador cookies, no se espera que proporcione atribución en varios dispositivos. En este caso, cada dispositivo tendría un token individual persistente si el usuario hubiera seguido un vínculo de acción en ese dispositivo, y cada uno seguiría la atribución por separado.

Feeds

Revisión de la integración