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

L'API Conversion Measurement change 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 d'API dans Chrome évolue. Voici ce qui va changer :

  • Nom de l'API et nom de la règle d'autorisation
  • Noms des 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é, de même que les rapports qui n'auraient eu aucun crédit.

Ce qui reste inchangé dans Chrome 92, c'est l'ensemble de fonctionnalités compatibles: les rapports au niveau des événements, pour les clics uniquement. Attendez-vous à des mises à jour à ce sujet. D'autres mises à jour et fonctionnalités seront ensuite publiées dans les futures versions de Chrome.

Quand ces modifications prendront-elles effet ?

Ces modifications prendront effet à partir du 92, version stable le 20 juillet 2021. La version bêta de Chrome 92 a été publiée le 3 juin 2021.

Que devez-vous faire ?

Si vous exécutiez une phase d'évaluation ou avez implémenté une version de démonstration pour cette API, vous disposez options:

  • Option 1 (recommandée): migrez votre code maintenant ou au cours des prochaines semaines, idéalement avant mi-juillet 2021. De cette façon, votre codebase sera prêt pour de futures modifications continuent à travailler pour les nouveaux clients Chrome.
  • Option 2: Attendez que d'autres mises à jour et fonctionnalités soient publiées dans les futures versions de Chrome. et d'apporter toutes les modifications nécessaires au code en une seule fois.

Migrer

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 règle d'autorisation

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

Mettre à jour votre code de détection de caractéristiques

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 window.open() arguments

Vous pouvez enregistrer une source d'attribution pour les navigations initiées par window.open(). Mettez à jour 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 suit les attributs HTML changement de nom):

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 de votre 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 du point de terminaison des 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és 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 le paramètre clés suivantes:
source_event_id: anciennement impression-data, l'ID d'événement 64 bits défini sur la source d'attribution.
trigger_data: précédemment conversion-data, l'ensemble de données 3 bits dans le déclencheur d'attribution .

⚠️ credit a été supprimé.

Attribution Reporting: toutes les ressources

Consultez Attribution Reporting.