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

Suivi des conversions

Implémentation

Résumé

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

Collecter les rwg_token de la page de destination / du point d'entrée de l'application.
Conserver la rwg_token pour la période d'attribution appropriée
Envoyer un événement de conversion lors du règlement

Cette implémentation du suivi des conversions ne nécessite pas l'utilisation Google Analytics ou tout autre code JavaScript tiers.

Avant de commencer à mettre en place le suivi des conversions, vous devez déterminer 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 de cookies de navigateur, stockage local des applications ou toute autre méthode persistante le jeton pour la période d'attribution de 30 jours. Comme le jeton sont stockées localement sur l'appareil de l'utilisateur, si celui-ci change l'appareil qu'ils utilisent, efface les cookies et les données stockées en local ; utilise le mode navigation privée, l'événement de conversion peuvent ne pas être attribués correctement. Lors de l'utilisation au niveau de l'appareil suivi des conversions, vous devez le réactiver surface compatible (y compris mobile).
Le niveau utilisateur implique de le conserver dans l'application. à l'aide d'un système d'analyse côté serveur ou d'un autre systèmes côté serveur. Comme le jeton est stocké sur le serveur côté serveur, si l'utilisateur change d'appareil, efface leur stockage/cookies en local, ou utilise un mode de navigation 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, en fonction de l'architecture de votre système, l'implémenter une fois côté serveur et la réutiliser dans toutes surfaces compatibles.

Collecte de `rwg_token`...

Chaque fois que Google affiche un action_link que vous avez fourni via les flux, cette URL sera modifiée pour inclure une requête unique : rwg_token. rwg_token est une chaîne encodée qui contient des métadonnées sur la sur lequel l'utilisateur a cliqué. Vous allez stocker ce jeton et le transmettre en tant que de l'événement de conversion.

Vous devez analyser l'ensemble de valeurs sur chaque page de destination ou point d'entrée de l'application. pour le paramètre de requête rwg_token et stockez-le. Conditions requises pour le stockage de ce paramètre sont décrits à l'étape Persistance du paramètre 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 lors de la réponse à la requête:

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

Conserver le `rwg_token`

</ph> Remarque:Il est essentiel de conserver rwg_token implémentant la période d'attribution requise. Pour en savoir plus sur les exigences d'attribution, consultez la section Exigences relatives à l'attribution des conversions ci-dessous.

Vous devrez conserver le paramètre d'URL rwg_token, qui sera ajouté à tous les liens d'action que vous avez fournis, pour un total de est de 30 jours. La valeur de rwg_token doit être stockées et renvoyées sans aucune modification. Si un jeton existant est conservé lors d'une visite précédente, le l'ancien jeton doit être remplacé, et la période de stockage de 30 jours doit être réinitialisé.

Lorsque vous conservez le jeton, vous pouvez le stocker à l'adresse au niveau de l'appareil ou de l'utilisateur:

Le niveau de l'appareil inclut l'utilisation des cookies du navigateur, le stockage local, stockage local de l'application ou toute autre méthode permettant de conserver le jeton pour la période d'attribution de 30 jours.
Le niveau utilisateur consiste à les conserver dans la base de données de l'application, par le biais d'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 des appareils, le stockage de ce jeton dans un navigateur Web via un premier un cookie tiers. Cet exemple suppose que vous avez analysé la valeur du jeton dans une variable, comme dans l'exemple ci-dessus. Pour utiliser cet exemple, vous devez remplacer "rootdomain" par votre domaine.

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

Lorsque vous utilisez le suivi des conversions au niveau de l'utilisateur, l'rwg_token doit être stocké sur le serveur et associé à l'utilisateur.

Envoi des données de conversion

Lorsqu'un utilisateur effectue une transaction imputable à un lien Google Place Action, vous devez envoyer une requête HTTP POST au point de terminaison de conversion. Il existe deux points de terminaison, un pour l'environnement de production et un autre pour l'environnement Sandbox.

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

Dans les environnements de bac à sable et de production, vous devrez fournir un rwg_token valide lors de l'envoi d'un événement de conversion. À des fins de test dans l'environnement de bac à sable, vous pouvez utiliser les éléments suivants : à un jeton de test.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

</ph> Remarque:Dans l'environnement de production, vous ne devez pas envoyer d'événements de conversion qui ne sont pas attribuée à cette intégration. Assurez-vous de vérifier la validité Valeur rwg_token non arrivée à expiration avant d'envoyer l'événement.

Exemple complet de suivi des conversions au niveau de l'appareil (utilisation d'un cookie sur appareil de l'utilisateur) en JavaScript sur la façon d'envoyer cette demande de post est inclus 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
    })
  });
}

Si vous utilisez le suivi des conversions au niveau de l'utilisateur, vous devez récupérer les qui est associé à l'utilisateur (quelle que soit la surface à partir de votre mécanisme de stockage côté serveur, puis envoyez à l'aide des mêmes points de terminaison de production ou de bac à sable.

</ph> Remarque:Les événements de conversion peuvent être envoyés depuis un client Web ou d'application, ou à partir du serveur. Vous pouvez prendre cette décision en fonction et en fonction de l'emplacement de stockage du jeton, à condition qu'une conversion est envoyé une seule fois par conversion et inclut une valeur Valeur rwg_token.

Exigences concernant l'attribution des conversions

La norme imposée par Google pour l'attribution des conversions est un modèle d'attribution pour toute interaction avec un lien de lieu, Google Store.

Avec cette période d'attribution, nous nous attendons à une conversion l'événement à envoyer dans l'un des cas suivants:

Un utilisateur suit un lien d'action pour un lieu et passe commande dans le même session
Un utilisateur suit un lien d'action pour un lieu, puis revient canal différent dans la période de 30 jours pour passer une commande.
Un utilisateur suit un lien d'action pour un lieu, puis passe commande magasin différent, qu'il s'agisse d'une même session ou sur une période de 30 jours.

De plus, les événements de conversion devraient être envoyés surfaces auxquelles l'utilisateur peut accéder à partir d'un lien d'action pour un lieu. dont

Applications Web pour ordinateur ou mobile
Applications mobiles, via un lien profond vers l'application ou un compte intent d'application pour votre domaine

Si le jeton est stocké au niveau de l'utilisateur (voir Conserver le jeton), il est normal via l'attribution multi-appareil. Autrement dit, un utilisateur qui suit un lien d'action à partir du bureau, puis complète transaction sur mobile (avec le même compte utilisateur) doit déclencher un événement de conversion.

Si le jeton est stocké exclusivement au niveau de l'appareil, par exemple dans des cookies de navigateur, vous ne devez pas fournir de données l'attribution. Dans ce cas, chaque appareil a un jeton distinct est conservée si l'utilisateur a suivi un lien d'action sur cet appareil ; chaque appareil suivrait les règles d'attribution séparément.