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

Suivi des conversions

Présentation

Le suivi des conversions permet de suivre les conversions initiées par Google via l'une de nos intégrations Action Center. Il est nécessaire de maintenir votre intégration en bon état et en fonctionnement, car elle peut avoir une incidence sur le classement de certaines pages. Chaque fois que Google génère un action_link, l'URL spécifique est modifiée pour inclure un paramètre de requête unique: rwg_token. Vous pouvez stocker le jeton et renvoyer les valeurs appropriées lorsqu'un utilisateur effectue une réservation.

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

Analysez et stockez le rwg_token.
Analysez et stockez les informations sur le marchand.
Renvoyez les valeurs rwg_token et merchant_changed.
Testez et vérifiez le suivi des conversions.

Analyser et stocker le `rwg_token`

Pour finaliser l'intégration, vous devez collecter et stocker l'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 les informations sur le marchand qui ont généré ce action_link.

Analyser le jeton

Lorsqu'un utilisateur est redirigé vers votre page de réservation, un nouveau rwg_token est ajouté à l'URL fournie. Sur votre page de réservation, vous devez analyser la valeur du jeton.

L'exemple suivant montre comment rwg_token est analysé pour le suivi au niveau de l'appareil via un navigateur.

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 jeton ajouté à votre URL est chiffré. Consultez l'exemple suivant d'rwg_token. Utilisez cet exemple de jeton pour vous assurer que vous l'analysez correctement, ainsi que les caractères spéciaux tels que =.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Stocker le jeton

Lorsque vous stockez le rwg_token, vous pouvez implémenter le suivi des conversions à deux niveaux différents:

Au niveau de l'appareil
Au niveau de l'utilisateur

Vous pouvez stocker le jeton à n'importe quel niveau, mais vous devez le stocker pendant 30 jours après le parrainage initial.

L'exemple suivant illustre le suivi des conversions au niveau de l'appareil. Vous pouvez stocker les valeurs de jeton dans un navigateur avec le cookie propriétaire. Cet exemple suppose que vous avez analysé la valeur du jeton dans une variable. 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=/";
}

Chaque fois que Google génère un action_link que vous avez fourni via les flux, l'URL est modifiée pour inclure un paramètre de requête unique: rwg_token. Vous devez stocker ce jeton et le transmettre dans le cadre de l'événement de conversion.

Stocker 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. Le jeton est stocké localement sur l'appareil de l'utilisateur. Par conséquent, l'événement de conversion ne peut pas être attribué correctement si l'utilisateur:

Change l'appareil qu'il utilise.
Efface le stockage local ou les cookies.
Utilise un navigateur privé ou en mode navigation privée.

Lorsque vous utilisez le suivi des conversions au niveau de l'appareil, vous devez réimplémenter l'événement de conversion sur tous les appareils compatibles, y compris les mobiles.

Stocker au niveau de l'utilisateur

Au niveau de l'utilisateur, le jeton est conservé 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. Le jeton est stocké côté serveur. L'événement de conversion est donc toujours attribué correctement une fois que l'utilisateur se reconnecte.

Lorsque vous utilisez le suivi des conversions au niveau de l'utilisateur en fonction de votre architecture système, vous pouvez implémenter l'événement de conversion une fois côté serveur et le réutiliser sur tous les appareils compatibles.

Actualiser le jeton

Lorsque Google redirige un utilisateur vers le même marchand, le jeton existant, qui est déjà stocké, est remplacé par le nouveau jeton de la dernière recommandation. Après le remplacement du jeton, la période d'attribution de 30 jours du stockage du jeton est réinitialisée et toutes les nouvelles conversions pour ce marchand sont attribuées au dernier jeton.

Pour en savoir plus, consultez les Conditions requises pour l'attribution des conversions.

Analyser et stocker les informations sur le marchand

Lorsqu'un utilisateur est redirigé vers votre page de réservation, vous devez implémenter la logique permettant de trouver et de capturer les informations sur 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 les informations sur le marchand.

Nous vous recommandons de stocker le merchant_id ou l'identifiant sélectionné avec le rwg_token. Lorsqu'un utilisateur confirme une réservation, vous pouvez vous reporter au marchand avant d'envoyer la demande de conversion complète. Comme pour le stockage du jeton, vous devez enregistrer les informations du marchand avec le jeton pendant 30 jours après la recommandation initiale.

L'exemple suivant modifie l'rwg_token précédemment stockée. Il suppose que vous avez analysé les informations sur le marchand à partir des métadonnées de l'URL fournie, et que vous les avez enregistrées en tant que merchant_id ou qu'elles ont été mises en correspondance avec 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_changed`.

Lorsqu'un utilisateur effectue une réservation à partir d'une recommandation action_link, vous devez envoyer une requête HTTP POST au point de terminaison de conversion. Il existe deux points de terminaison:

Environnement de production: https://www.google.com/maps/conversion/collect
Environnement de bac à sable: 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_changed de 1 ou 2. Pour en savoir plus sur merchant_changed, consultez Retourner la valeur de modification du marchand.

Le corps de la requête POST doit être un objet au format JSON encodé 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 avec un cookie sur l'appareil de l'utilisateur, é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
    })
  });
}

Renvoyer la valeur de modification du marchand

La valeur merchant_changed permet de déterminer si le marchand est remplacé par le marchand de redirection initial. Le changement de marchand est courant si votre page de destination se trouve sur une plate-forme qui inclut d'autres marchands. Dans ce cas, si un utilisateur est redirigé vers votre plate-forme par Google et décide d'accéder à un autre marchand pour effectuer une réservation, vous devez savoir qu'une conversion s'est produite avec un marchand distinct. Vous pouvez utiliser une valeur booléenne pour identifier le changement de marchand, mais pas ses informations.

Lorsque vous décidez de la valeur à attribuer à merchant_changed, vous devez prendre le marchand d'origine enregistré dans Analyser et stocker les informations sur le marchand. Vérifiez si le marchand a changé et attribuez la valeur selon vos besoins.

Exigence: lorsqu'un utilisateur quitte le site Web du marchand d'origine et effectue un achat via votre plate-forme auprès d'un autre marchand.
- Valeur de la modification du marchand: 1
Exigence: lorsque l'utilisateur effectue une transaction via le marchand d'origine.
- Valeur de la modification du marchand: 2

Tester et valider le suivi des conversions

Les cas de test suivants utilisent les jetons de test fournis dans la section Jetons de test et sont destinés à vous guider dans tous les scénarios pouvant entraîner un événement de conversion. Cela garantit que le jeton est stocké de manière appropriée, que la valeur merchant_changed est définie correctement et que l'événement de conversion est envoyé si nécessaire.

Utilisez le lien d'action ou les URL des pages de réservation fournies dans vos flux, puis exécutez chaque cas de test en ajoutant les jetons de test à la fin de l'URL. Veillez à utiliser une fenêtre de navigateur privée ou en mode navigation privée. Cela effacera tous les jetons existants associés à l'utilisateur actuel et vous disposerez d'une table rase pour travailler.

Cas de test	Description du test	Parcours utilisateur	Résultat attendu
1	Un utilisateur effectue une réservation qui n'a pas été effectuée sur Google.	Un utilisateur accède directement à la page de réservation sans être redirigé par Google ni sans avoir été redirigé par un autre site. Aucun événement de conversion ne devrait être généré.	Aucun événement de conversion, car l'utilisateur n'a pas consulté la page de réservation précédemment ou n'a pas été redirigé par Google.
2	Un utilisateur effectue une réservation qui a commencé sur Google.	Un utilisateur trouve votre marchand sur Google, est redirigé vers votre page de réservation et effectue une réservation.	Un événement de conversion est envoyé avec la valeur 2 pour Token A et merchant changed, car l'utilisateur a été redirigé vers la page de réservation par Google.
3	Un utilisateur (provenant de Google) commence le parcours de réservation, mais abandonne la session avant la fin de la réservation. Remarque: Laissez cette session ouverte pour les tests 4 et 5.	Un utilisateur est redirigé vers votre page de réservation, mais la session se termine et il ne finalise pas de réservation.	Aucune conversion, car l'utilisateur n'a pas effectué la réservation, mais le jeton B doit être stocké pendant 30 jours.
4	Un utilisateur revient sur la page de réservation, sans être redirigé depuis Google, et effectue une réservation. Remarque: L'URL du parcours de réservation ne doit pas inclure de rwg_token.	Un utilisateur revient sur la page de réservation après le test 4. Le jeton B doit être stocké pendant 30 jours, et toute conversion au cours de cette période doit renvoyer un événement de conversion.	Un événement de conversion est envoyé avec la valeur 2 pour merchant changed (Marchand modifié) et le jeton B, car l'utilisateur revient sur la page de réservation après un précédent parrainage par Google.
5	Un utilisateur effectue une nouvelle réservation depuis Google après le test 4.	Si un utilisateur revient sur votre page de réservation à l'aide d'un parrainage Google après un parrainage Google précédent, la période de stockage de 30 jours est réinitialisée et un nouveau jeton (jeton C) remplace l'ancien (jeton B). Toutes les futures conversions seront alors attribuées au jeton C.	Un événement de conversion est envoyé avec la valeur 2 pour Token C et merchant changed, car l'utilisateur a effectué la réservation et le nouveau jeton a remplacé le jeton précédemment stocké.

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

Cas de test	Description du test	Parcours utilisateur	Résultat attendu
6	Un utilisateur est redirigé vers votre page de réservation par Google et effectue une réservation auprès d'un autre marchand.	Un utilisateur est redirigé vers votre page de réservation par Google. Le jeton A est utilisé, mais avant de finaliser la réservation, il accède à une autre page et la finalise auprès d'un marchand différent de celui de la redirection initiale.	Un événement de conversion est envoyé, car l'utilisateur a effectué une réservation issue d'un site référent Google avec le jeton A et la valeur marchand modifié de 1, car l'utilisateur a effectué la réservation auprès d'un marchand différent de celui du site référent.

Lors des tests, envoyez la requête HTTP POST au point de terminaison de conversion. Il existe deux points de terminaison:

Environnement de production: https://www.google.com/maps/conversion/collect
Environnement de bac à sable: https://www.google.com/maps/conversion/debug/collect

Jetons de test

Pour tester le suivi des conversions, ajoutez l'un des jetons de test suivants à la fin des liens d'action ou des URL de pages de réservation que vous fournissez dans vos flux.

Jeton A:

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

Jeton B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Jeton C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Lorsque vous envoyez les événements de conversion réussis, vous pouvez les voir regroupés dans le centre d'action, sous le tableau de bord de suivi des conversions.

conversion-tracking-dashboard

Exigences concernant l'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 d'action dans un lieu, dans n'importe quel magasin.

Cette période d'attribution signifie que Google peut s'attendre à 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 pour le même marchand au cours de la même session. Valeur de modification du marchand = 2.
Un utilisateur suit un lien d'action liée à un lieu, puis revient depuis un autre canal dans la période d'attribution de 30 jours pour passer une commande auprès du même marchand. Valeur de modification du marchand = 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 dans une autre session dans un délai d'attribution de 30 jours. Valeur de modification du marchand = 1.

De plus, Google s'attend à envoyer des événements de conversion depuis n'importe quel appareil auquel un utilisateur peut accéder via un lien "Place Actions". Ces appareils incluent:

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, vous devez fournir une attribution inter-appareils. Pour en savoir plus, consultez la section Stocker au niveau de l'utilisateur. Dans ce cas, un utilisateur qui suit un lien d'action depuis un ordinateur de bureau, puis finalise la transaction sur un appareil 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 les cookies du navigateur, vous n'êtes pas tenu de fournir une attribution inter-appareils. Dans ce cas, chaque appareil peut conserver un jeton distinct si l'utilisateur suit un lien d'action sur cet appareil, et chaque appareil peut suivre les règles d'attribution séparément.