Implémentation
Résumé
La mise en œuvre du suivi des conversions s'effectue en trois étapes:
- Collecter les
rwg_token
et lesmerchant_id
à partir de la page de destination ou de l'application point d'entrée. - Conserver les
rwg_token
etmerchant_id
pour l'attribution appropriée fenêtre. - Comparer les valeurs "
merchant_id
" et "merchant_id
" persistantes au moment de la conversion (réservation terminée). - Envoi d'un événement de conversion au moment de la conversion (réservation terminée).
Cette implémentation du suivi des conversions ne nécessite pas que vous utilisiez Google Google Analytics ou tout autre code JavaScript tiers.
Avant de commencer à implémenter le suivi des conversions, vous devez Choisissez si vous comptez effectuer le suivi des conversions au niveau de l'appareil ou de l'utilisateur:
- Le niveau de l'appareil inclut l'utilisation des cookies du navigateur, le stockage local, l'utilisation en local de l'application ou toute autre méthode permettant de conserver le jeton pendant 30 jours période d'attribution. Comme le jeton est stocké localement sur le bucket appareil, si l'utilisateur change d'appareil, efface les ou des cookies, ou si vous utilisez le mode navigation privée, l'événement de conversion n'a peut-être pas été correctement attribué. Lors de l'utilisation au niveau de l'appareil le suivi des conversions, vous devez le réimplémenter dans toutes les campagnes (y compris mobile).
- Le niveau utilisateur inclut sa persistance dans la base de données de votre application, un système d'analyse côté serveur ou d'autres systèmes côté serveur. En effet, le jeton est stocké côté serveur, si l'utilisateur change d'appareil qu'il utilise, efface son stockage local ou les cookies, ou utilise un ou en mode navigation privée, l'événement de conversion est toujours attribué l'utilisateur se reconnecte. Si vous utilisez le suivi des conversions au niveau de l'utilisateur, sur l'architecture de votre système, vous pourrez peut-être l'implémenter côté serveur et de le réutiliser sur toutes les surfaces compatibles.
Collecte de rwg_token
...
Chaque fois que Google affiche un lien d'action que vous avez fourni via les flux,
cette URL est modifiée pour inclure un paramètre de requête unique: rwg_token
. La
La valeur rwg_token
est une chaîne encodée qui contient des métadonnées sur la
lien sur lequel l'utilisateur a cliqué, mais aucune donnée utilisateur. Vous devez stocker ce jeton, puis
et le transmettre dans le cadre
de l'événement de conversion.
Sur chaque page de destination / point d'entrée d'application, vous devez analyser la valeur définie pour l'attribut
rwg_token
et stockez-le. Conditions de stockage
sont décrits à l'étape "Conserver le rwg_token
".
Exemple d'analyse de ce jeton pour le suivi au niveau de l'appareil via le navigateur est inclus ci-dessous. Vous pouvez aussi collecter ce jeton côté serveur lorsque vous répondez à la requête:
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;
}
}
Collecte de merchant_id
...
Si vous implémentez la logique de suivi des conversions dans l'interface, sur la page de destination,
vous devez implémenter un script personnalisé capable de détecter et de capturer
merchant_id
En général, merchant_id
est peut-être déjà présent sur le
dans votre page de destination ou dans l'URL. Si ce n'est pas le cas, vous devez
trouver un moyen de les exposer quelque part pour qu'elles soient capturables, ce qui impliquerait probablement
les modifications du backend.
Si vous mettez en œuvre la logique de suivi des conversions dans le backend, vous constaterez peut-être que
merchant_id
avec les données qui interrogent votre système interne pour générer
la page de l'interface.
Cet merchant_id
doit être le même que celui que vous avez partagé avec Google dans
dans votre flux.
Conserver les éléments rwg_token
et merchant_id
Vous devrez conserver le paramètre d'URL rwg_token
, qui sera
à tous les liens d'action que vous avez fournis pour une durée totale de 30 jours.
La valeur de rwg_token
doit être stockée et renvoyée sans aucune modification.
En plus des rwg_token
, vous devez stocker les merchant_id
associés
avec le lien d'action.
Si un jeton existant est conservé lors d'une visite précédente, la
rwg_token
et merchant_id
doivent être remplacés, ainsi que la période de 30 jours pour
l'espace de stockage doit être réinitialisé.
Si vous conservez la paire ci-dessus, vous pouvez soit stocker les valeurs sur l'appareil, ou au niveau de l'utilisateur:
- Le niveau de l'appareil inclut l'utilisation des cookies du navigateur, le stockage local, l'utilisation en local de l'application ou toute autre méthode permettant de conserver le jeton pendant 30 jours période d'attribution.
- Le niveau utilisateur inclut sa persistance dans la base de données de votre application, un système d'analyse côté serveur ou d'autres systèmes côté serveur.
Vous trouverez ci-dessous un exemple de suivi des conversions au niveau de l'appareil, avec le stockage de ces valeurs dans
un navigateur Web à l’aide
d’un cookie propriétaire. Dans cet exemple, nous partons du principe que vous avez analysé le
du jeton dans une variable, comme dans l'exemple ci-dessus. Pour utiliser cet exemple,
vous devez mettre à jour rootdomain.com
vers votre domaine.
if (typeof rwg_token !== 'undefined') {
document.cookie =
"_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}
Lorsque vous utilisez le suivi des conversions au niveau de l'utilisateur, les éléments rwg_token
+ merchant_id
doivent
être stocké sur le serveur et associé à l'utilisateur.
Envoi des données de conversion
Lorsqu'un utilisateur effectue une transaction imputable à un lieu Lien d'action, vous devez envoyer une requête HTTP POST au point de terminaison de conversion. Il existe deux points de terminaison, l'un pour l'environnement de production et l'autre pour l'environnement environnement de bac à sable.
- Production: https://www.google.com/maps/conversion/collect
- Bac à sable: https://www.google.com/maps/conversion/debug/collect
Le corps de l'article doit être un objet encodé au format JSON au format suivant:
{
"conversion_partner_id": <partnerId>,
"rwg_token": <rwg_token_val>,
"merchant_changed": 1|2
}
Exemple (marchand inchangé avec le jeton de test pour le partenaire 20123456):
{
"conversion_partner_id": 20123456,
"rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
"merchant_changed": 2
}
La valeur merchant_changed permet de déterminer si le marchand a été modifié. du marchand à l'origine de la redirection. Vous pouvez transmettre deux valeurs
Valeur de la variation du marchand | Exigence |
---|---|
1 | Cette valeur doit être utilisée lorsqu'un utilisateur a quitté le site Web d'origine du marchand et effectué un achat via votre plate-forme auprès d'un autre marchand |
2 | Cette valeur doit être utilisée lorsque le client effectué une transaction via l'entité d'origine (Marchand). |
Dans les environnements de bac à sable et de production, vous devez fournir un
rwg_token
valide lors de l'envoi d'un événement de conversion. À des fins de test, utilisez la
le jeton de test suivant dans les deux environnements jusqu'au lancement:
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
Pour effectuer un test dans le bac à sable, vous devez ajouter manuellement le paramètre d'URL suivant à vos liens Sandbox:
rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D
Exemple complet de suivi des conversions au niveau de l'appareil (utilisation d'un cookie sur le appareil) en JavaScript expliquant comment envoyer cette demande de publication est indiquée ci-dessous:
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
})
});
}
Lorsque vous utilisez le suivi des conversions au niveau de l'utilisateur, vous devez récupérer le jeton est associée à l'utilisateur (quelle que soit la surface sur laquelle il se trouve) depuis votre de stockage côté serveur et d'envoyer le jeton en utilisant les mêmes les points de terminaison de bac à sable.
Exigences concernant l'attribution des conversions
La norme requise par Google pour l'attribution des conversions est une attribution sur 30 jours toute interaction avec un lien vers un lieu, dans n'importe quel magasin.
Avec cette période d'attribution, Google s'attend à ce qu'un événement de conversion envoyées dans l'un des scénarios suivants:
- Un utilisateur suit un lien d'action pour un lieu et passe commande pour le même marchand au cours de la même session. (Valeur de variation du marchand = 2 )
- Un utilisateur suit un lien d'action pour un lieu, puis revient depuis une autre chaîne dans les 30 jours pour passer une commande auprès du même marchand. (Marchand Modifier la valeur = 2 )
- Un utilisateur suit un lien d'action pour un lieu, puis passe commande dans un autre pendant une même session ou une autre au cours d'une période de 30 jours fenêtre. ( Valeur de l'évolution du marchand = 1)
De plus, Google s'attend à ce que les événements de conversion soient envoyés depuis toutes les surfaces l'utilisateur peut être redirigé vers la page à partir d'un lien d'action pour un lieu. dont
- Applications Web pour ordinateur ou mobile
- les applications mobiles, par le biais d'un lien profond ou d'un intent d'application enregistré pour votre domaine
Si le jeton est stocké au niveau de l'utilisateur (voir la section "Conserver le jeton"), il est vous devez fournir une attribution multi-appareil. C'est-à-dire qu'un utilisateur qui suit un lien d'action sur l'ordinateur de bureau, puis finalisent la transaction sur mobile (avec le même compte utilisateur) doivent déclencher un événement de conversion.
Si le jeton est stocké exclusivement au niveau de l'appareil, par exemple dans le navigateur vous ne devez pas fournir d'attribution multi-appareil. Dans ce chaque appareil aurait un jeton distinct conservé si l'utilisateur avait suivi un lien d'action sur cet appareil, et chaque appareil suivra l'attribution séparément.