[Obsolète] Guide de migration (Chrome 92): API de mesure des conversions vers l'API Attribution Reporting

L'API de mesure des conversions va changer dans Chrome 92.

Ce qui change

Suite aux modifications apportées à la proposition d'API au cours des premiers mois de 2021, l'implémentation des API dans Chrome évolue. Voici ce qui va changer :

  • Le nom de l'API et le nom de la règle d'autorisation.
  • Noms d'attributs HTML et URL .well-known.
  • Format des rapports. Les rapports sont désormais envoyés au format JSON dans le corps de la requête.
  • Le contenu des rapports credit a été supprimé, ainsi que les rapports qui n'auraient aucun crédit.

Ce qui reste inchangé dans Chrome 92, ce sont les fonctionnalités compatibles: les rapports au niveau des événements, pour les clics uniquement. Des informations supplémentaires seront disponibles à ce sujet. Après ce changement, d'autres mises à jour et fonctionnalités seront disponibles dans les futures versions de Chrome.

Quand ces modifications prendront-elles effet ?

Ces modifications prendront effet à partir de Chrome 92, stable le 20 juillet 2021. La version bêta de Chrome 92 est disponible depuis le 3 juin 2021.

Que devez-vous faire ?

Si vous étiez en train d'exécuter une phase d'évaluation ou si vous avez mis en œuvre une version de démonstration pour cette API, deux options s'offrent à vous:

  • Option 1 (recommandée): migrez votre code maintenant ou dans les semaines à venir, idéalement avant la mi-juillet 2021. De cette façon, votre codebase sera prêt pour les modifications futures et continuera de fonctionner pour les clients Chrome les plus récents.
  • Option 2: attendez que d'autres mises à jour et fonctionnalités soient disponibles dans les futures versions de Chrome, puis apportez simultanément toutes les modifications de code nécessaires.

Migration

Exemple de migration

Vous trouverez un exemple de migration pour une petite application de démonstration dans cette demande d'extraction (brouillon).

Mettre à jour le code de votre stratégie d'autorisations

Ancien code Nouveau code
allow='conversion-measurement' allow='attribution-reporting'

Mettre à jour le code de détection des fonctionnalités

Ancien code Nouveau code
document.featurePolicy.features()
.includes('conversion-measurement')		 document.featurePolicy.features()
.includes('attribution-reporting')

Mettre à jour les attributs HTML

Ancien code Nouveau code
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

Mettre à jour les arguments window.open()

Une source d'attribution peut être enregistrée pour les navigations lancées par window.open(). Modifiez ces appels si vous utilisez window.open() pour enregistrer des sources d'attribution.

Votre nouveau code doit se présenter comme suit (ce changement de nom fait suite au renommage des attributs HTML):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

Mettre à jour l'URL et le paramètre d'appel d'inscription

Ancien code Nouveau code
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Mettre à jour le code de votre point de terminaison pour les rapports

Ancien code Nouveau code
Requêtes attendues du navigateur .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Rapports entrants Envoyé en tant que paramètres d'URL. Envoyé au format JSON dans le corps de la requête.

Les données du rapport sont incluses dans le corps de la requête en tant qu'objet JSON avec les clés suivantes:
source_event_id: auparavant impression-data, l'ID d'événement 64 bits défini sur la source d'attribution.
trigger_data: anciennement conversion-data, ensemble de données 3 bits dans la redirection du déclencheur d'attribution.

⚠️ credit a été supprimé.

Attribution Reporting: toutes les ressources

Consultez Attribution Reporting.