Cette page a été traduite par l'API Cloud Translation.

Suivi des conversions

Avertissement: Assurez-vous que, dans les données de conversion, l'identification personnelle de l'utilisateur Les informations permettant d'identifier personnellement l'utilisateur ne sont pas envoyées à Google.

Implémentation

Résumé

La mise en œuvre du suivi des conversions s'effectue en trois étapes:

Collecter les rwg_token et les merchant_id à partir de la page de destination ou de l'application point d'entrée.
Conserver les rwg_token et merchant_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.

Mise à jour en temps réel