Suivi des conversions

Figure 1:Présentation du suivi des conversions

Résumé

Le suivi des conversions est conçu pour suivre les conversions initiées par Google via l'une de nos intégrations Action Center. Cela est essentiel pour que votre intégration reste saine et opérationnelle, et peut avoir une incidence sur le classement de certaines pages. Chaque fois que Google affiche un action_link, cette URL est modifiée pour inclure un paramètre de requête unique: rwg_token. Il vous appartient de stocker ce jeton et de renvoyer les valeurs appropriées lorsqu'un utilisateur effectue une réservation.

Pour effectuer l'intégration, procédez comme suit:

1. Collectez et stockez le rwg_token.
2. Collectez et stockez le marchand.
3. Renvoyez les valeurs rwg_token et merchant_change.
4. Testez et vérifiez le suivi des conversions.

Collectez et stockez le rwg_token.

Pour effectuer cette intégration, vous devez collecter et stocker le rwg_token pendant 30 jours maximum à compter de la recommandation Google initiale. La valeur rwg_token est une chaîne encodée qui contient des métadonnées sur le lien et le marchand qui a généré ce lien d'action. Il est important de noter qu'aucune donnée utilisateur n'est stockée ni chiffrée dans le jeton.

Collection de jetons

Lorsqu'un utilisateur est redirigé vers votre page de réservation, un nouveau paramètre de requête, rwg_token, est ajouté à l'URL fournie. Sur votre page de réservation, vous devez analyser la valeur. Un exemple de façon dont ce jeton peut être analysé pour le suivi au niveau de l'appareil via le navigateur est inclus.

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

Le paramètre de requête ajouté à votre URL sera un jeton chiffré. Consultez l'exemple suivant d'rwg_token. Utilisez cet exemple de jeton pour vous assurer que vous l'analysez correctement, y compris les caractères spéciaux tels que "=". Voici un exemple de jeton type.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Stockage de jetons

Lorsque vous stockez le rwg_token, vous pouvez implémenter le suivi des conversions à deux niveaux différents : au niveau de l'appareil et de l'utilisateur. Vous pouvez choisir où stocker le jeton, mais vous devez le stocker pendant 30 jours à compter de la recommandation initiale.

L'exemple suivant est le suivi des conversions au niveau de l'appareil, qui stocke ces valeurs dans un navigateur Web à l'aide d'un cookie propriétaire. Cet exemple suppose que vous avez analysé la valeur du jeton dans une variable, comme dans l'exemple de stockage de jetons. Veillez à remplacer rootdomain.com par votre domaine.

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

Tenez compte des points suivants lorsque vous choisissez l'emplacement de stockage de rwg_token.

Stockage au niveau de l'appareil

Le niveau de l'appareil inclut l'utilisation de cookies de navigateur, de stockage local, de stockage local d'application ou de toute autre méthode pouvant conserver le jeton pendant la période d'attribution de 30 jours. Étant donné que le jeton est stocké localement sur l'appareil de l'utilisateur, si l'utilisateur change d'appareil, vide son espace de stockage local ou ses cookies, ou utilise la navigation privée ou le mode navigation privée, l'événement de conversion risque de ne pas être attribué correctement. Lorsque vous utilisez le suivi des conversions au niveau de l'appareil, vous devez le réimplémenter sur toutes les surfaces compatibles (y compris les mobiles).

Stockage au niveau de l'utilisateur

Le niveau utilisateur inclut la persistance dans la base de données de votre application, via un système d'analyse côté serveur ou d'autres systèmes côté serveur. Étant donné que le jeton est stocké côté serveur, si l'utilisateur change d'appareil, vide son espace de stockage local ou ses cookies, ou utilise la navigation privée ou le mode navigation privée, l'événement de conversion est toujours attribué une fois que l'utilisateur se reconnecte. Lorsque vous utilisez le suivi des conversions au niveau de l'utilisateur, selon l'architecture de votre système, vous pouvez l'implémenter une fois côté serveur et le réutiliser sur toutes les surfaces compatibles.

Chaque fois que Google affiche un action_link que vous avez fourni via les flux, cette URL est modifiée pour inclure un paramètre de requête unique: rwg_token. La valeur rwg_token est une chaîne encodée qui contient des métadonnées sur le lien sur lequel l'utilisateur a cliqué, mais aucune donnée utilisateur. Vous devez stocker ce jeton et le transmettre dans l'événement de conversion.

Actualiser le jeton

Lorsqu'un utilisateur est redirigé par Google vers le même marchand, si un jeton existant est stocké, il est remplacé par le nouveau jeton de la dernière recommandation. Lorsque le jeton est remplacé, la période de stockage de 30 jours du jeton est réinitialisée, et toutes les nouvelles conversions pour ce marchand doivent être attribuées au dernier jeton.

Pour en savoir plus, consultez nos Exigences concernant l'attribution des conversions.

Collectez et stockez le marchand.

Lorsqu'un utilisateur est redirigé vers votre page de réservation, vous devez implémenter une logique permettant de trouver et de capturer le marchand. En règle générale, les partenaires ajoutent des métadonnées de marchand ou des merchant_id à leurs liens d'action et les utilisent pour identifier et stocker le marchand. Nous vous recommandons de stocker le merchant_id (ou l'identifiant sélectionné) avec le rwg_token afin que, lorsqu'un utilisateur confirme une réservation, vous puissiez vous reporter au marchand avant d'envoyer la demande de conversion terminée. Comme pour la période de stockage du jeton, le marchand doit être enregistré avec le jeton pendant 30 jours à compter de la recommandation initiale.

Les exemples suivants ajustent l'rwg_token précédemment stockée. Cela suppose que vous analysez le marchand à partir des métadonnées de l'URL fournie et que vous l'enregistrez en tant que merchant_id ou que vous le faites correspondre à un merchant_id existant.

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

Renvoyez les valeurs rwg_token et merchant_change.

Lorsqu'un utilisateur finalise une réservation qui a commencé à partir d'un 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 de bac à sable.

• Production:https://www.google.com/maps/conversion/collect
• Environnement de test:https://www.google.com/maps/conversion/debug/collect

Lorsque vous envoyez un événement de conversion, vous devez inclure le rwg_token stocké et une valeur merchant_change de 1 ou 2. Pour en savoir plus sur merchant_change, consultez Renvoyer la valeur de modification du marchand.

Le corps de la requête POST doit être un objet au format JSON, comme suit:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

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

L'exemple suivant inclut le suivi des conversions au niveau de l'appareil à l'aide d'un cookie sur l'appareil de l'utilisateur. Il est écrit en JavaScript:

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

Attention :Le seul type de contenu MIME accepté est text/plain. Ne définissez pas d'autre Content-Type dans l'en-tête. Dans le cas contraire, vous recevrez une erreur CORS.

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

Remarque:En production, vous ne devez pas envoyer d'événements de conversion qui ne sont pas attribués à cette intégration. Nous vous recommandons de vérifier la validité et la non-expiration de la valeur rwg_token avant d'envoyer l'événement.

Renvoyer la valeur de modification du marchand

La valeur merchant_changed permet de déterminer si le marchand a été remplacé par le marchand de redirection initial. Il est courant de changer de marchand si votre page de destination se trouve sur une plate-forme qui inclut d'autres marchands. Dans ce cas, si un utilisateur a été redirigé vers votre plate-forme par Google et a décidé d'accéder à un autre marchand et de finaliser une réservation, nous voulons savoir qu'une conversion s'est produite, mais avec un marchand différent. Nous n'avons pas besoin de connaître le marchand, mais simplement qu'un événement de conversion s'est produit et que le marchand était différent. Nous utilisons une valeur booléenne pour identifier si un marchand a changé ou non.

Lorsque vous décidez de la valeur à attribuer à merchant_change, vous devez prendre le marchand d'origine enregistré dans Collecter et stocker le marchand, vérifier si le marchand a changé, puis vous reporter au tableau suivant pour attribuer la valeur.

Si votre page de réservation ne se trouve pas sur une plate-forme ou si les utilisateurs ne peuvent pas accéder à un autre marchand, vous pouvez coder en dur la valeur de ces requêtes sur 2. Cela est courant pour les partenaires qui intègrent leurs pages de réservation au site Web de leur marchand ou qui disposent de pages de destination personnalisées pour traiter les réservations.

Valeur du changement du marchand	Exigence
1	Cette valeur doit être utilisée lorsqu'un utilisateur a quitté le site Web du marchand d'origine et effectué un achat via votre plate-forme auprès d'un autre marchand.
2	Cette valeur doit être utilisée lorsque le client a effectué une transaction via l'entité d'origine (marchand).

Testez et vérifiez le suivi des conversions.

Pour vous assurer que votre implémentation du suivi des conversions est correcte, vous devez exécuter le test suivant. Veillez à utiliser des liens d'action associés à vos marchands et à ce que les requêtes soient effectuées dans une fenêtre privée ou de navigation privée pour vous assurer que tout jeton précédent associé à cet utilisateur est effacé.

1. Effectuer une réservation en utilisant simplement un lien d'action
   • Les réservations directes sans parrainage ni jetons stockés précédemment ne doivent pas entraîner l'envoi de demandes à Google.
2. Effectuez une réservation à l'aide d'un lien avec un rwg_token ajouté.
   • Assurez-vous que la requête aboutit et est envoyée avec la valeur 2 pour rwg_token et merchant_change.
   • Assurez-vous de stocker le rwg_token pendant 30 jours.
3. Effectuez une nouvelle réservation auprès du même marchand à l'aide d'un nouveau rwg_token.
   • Assurez-vous que la requête a bien été envoyée avec la nouvelle valeur rwg_token et merchant_change de 2.
   • Assurez-vous que la période de stockage de l'attribution du jeton est actualisée pendant 30 jours.
4. Accédez directement à la page de réservation du marchand que vous testez et effectuez une nouvelle réservation sans rwg_token ajouté.
   • Assurez-vous que la requête est envoyée avec le rwg_token précédemment stocké et que la valeur merchant_change est 2.

Si votre plate-forme permet aux utilisateurs de payer avec un autre marchand, testez les éléments suivants.

1. Accédez à la page de réservation du marchand à l'aide d'un lien avec un rwg_token ajouté, puis accédez à un autre marchand et effectuez une réservation.
   • Assurez-vous que la requête est envoyée avec la valeur 1 pour rwg_token et merchant_change.

Lors des tests, envoyez la 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 de bac à sable.

• Production:https://www.google.com/maps/conversion/collect
• Environnement de test:https://www.google.com/maps/conversion/debug/collect

Vous devez ajouter le jeton suivant à votre lien d'action ou à votre URL:

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

Utilisez le jeton suivant pour les tests qui nécessitent des jetons supplémentaires.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Une fois que vous avez envoyé les événements de conversion réussis, vous pouvez les voir regroupés dans le centre d'action, sous le tableau de bord du suivi des conversions. N'oubliez pas que l'affichage des conversions dans le tableau de bord peut prendre jusqu'à une heure.

Exigences d'attribution des conversions

La norme requise de Google pour l'attribution des conversions est une période de suivi de 30 jours pour toute interaction avec un lien vers un lieu, dans n'importe quel magasin.

Cette période d'attribution signifie que Google s'attend à ce qu'un événement de conversion soit envoyé dans l'un des scénarios suivants:

• Un utilisateur suit un lien d'action vers un lieu et passe une commande auprès du même marchand au cours de la même session. (Valeur de modification du marchand = 2)
• Un utilisateur suit un lien d'action de lieu, puis revient depuis un autre canal dans les 30 jours pour passer une commande auprès du même marchand. (Merchant Change Value = 2 )
• Un utilisateur suit un lien d'action de lieu, puis passe commande dans un autre magasin, soit au cours de la même session, soit au cours d'une autre session dans un délai de 30 jours. ( Valeur de modification du marchand = 1 )

De plus, Google s'attend à ce que des événements de conversion soient envoyés depuis toutes les surfaces auxquelles un 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 d'application ou un intent d'application enregistré pour votre domaine

Si le jeton est stocké au niveau de l'utilisateur (voir la section "Persistance du jeton"), vous devez fournir une attribution multi-appareil. Autrement dit, un utilisateur qui suit un lien d'action depuis un ordinateur de bureau, puis finalise la transaction sur un appareil mobile (à l'aide du 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 les cookies du navigateur, vous n'êtes pas tenu de fournir une attribution multi-appareils. Dans ce cas, un jeton distinct est conservé pour chaque appareil si l'utilisateur a suivi un lien d'action sur cet appareil, et chaque appareil suit les règles d'attribution séparément.

Remarque :Ce framework d'attribution peut être différent de la façon dont votre système d'analyse attribue les conversions. Ce système est conçu pour fonctionner indépendamment de tout suivi des conversions que vous effectuez dans vos systèmes et ne devrait pas affecter vos analyses internes.