Implementación
Resumen
La implementación del seguimiento de conversiones consta de tres partes:
- Recopilar los elementos
rwg_token
ymerchant_id
de la página de destino o la app punto de entrada. - Persiste los
rwg_token
ymerchant_id
para la atribución adecuada en la ventana modal. - Compara los
merchant_id
y losmerchant_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.