Guide de migration (Chrome 92) : de l'API Conversion Measurement vers l'API Attribution Reporting

L'API Conversion Measurement évolue dans Chrome 92.

Published on Updated on

Translated to: English, Español, Português, 한국어, 中文, Pусский, 日本語, Deutsch

Si vous avez des questions ou besoin d'aide pendant votre migration, rejoignez la liste de diffusion et posez votre question.

Qu'est-ce qui change ?

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

  • Le nom de l'API et le nom de la stratégie de fonctionnalité.
  • Les noms d'attribut HTML et les URL .well-known.
  • Le 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 auraient eu 0 crédit.

Ce qui reste inchangé dans Chrome 92, c'est l'ensemble des fonctionnalités prises en charge : les rapports basés sur les événements, pour les clics uniquement. Attendez-vous à des mises à jour à ce sujet. Après ce changement, d'autres mises à jour et fonctionnalités seront publiées dans les futures versions de Chrome.

Pour recevoir des mises à jour concernant la phase d'évaluation pour cette API et les fonctionnalités à venir, abonnez-vous à la liste de diffusion.

Quand ces changements prennent-ils effet ?

Ces changements prennent effet à partir de Chrome 92, stable le 20 juillet 2021. La version bêta de Chrome 92 est sortie le 3 juin 2021.

Que devez-vous faire ?

D'autres changements seront apportés à l'API dans les futures versions. Ils utiliseront la nouvelle dénomination adoptée dans Chrome 92.

Si vous exécutez une phase d'évaluation ou avez implémenté une démo pour cette API, vous avez deux options :

  • Option 1 (recommandée) : migrez votre code maintenant ou dans les semaines suivantes, idéalement avant la mi-juillet 2021. De cette façon, votre base de code sera prête pour les modifications futures et continuera à fonctionner 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 apportez toutes les modifications de code nécessaires en même temps.

Migration

Exemple de migration

Vous pouvez voir un exemple de migration pour une petite application de démonstration dans cette requête d'extraction (brouillon).

Mettre à jour votre code de stratégie de fonctionnalité

Code héritéNouveau code
allow='conversion-measurement'allow='attribution-reporting'

Mettre à jour votre code de détection de fonctionnalité

Code héritéNouveau code
document.featurePolicy.features()<br>.includes('conversion-measurement')document.featurePolicy.features()<br>.includes('attribution-reporting')

Mettre à jour les attributs HTML

Code héritéNouveau code
conversiondestinationattributiondestination
impressiondataattributionsourceeventid
impressionexpiryattributionexpiry
reportingoriginattributionreportto

Mettre à jour les arguments window.open()

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

Votre nouveau code devrait ressembler à ceci (ce nouveau nom suit le 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

Code héritéNouveau code
.well-known/register-conversion?conversion-data={DATA}.well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Mettre à jour votre code de point de terminaison de génération de rapports

Code héritéNouveau code
Requêtes à attendre du navigateur.well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100.well-known/attribution-reporting/trigger-attribution</td> </tr> <tr> <td>Incoming reports</td> <td>Sent as URL parameters.</td> <td>Sent as JSON in the request body.<br> <br> The report data is included <strong>in the request body as a JSON object</strong> with the following keys:<br> <code>source_event_id : anciennement impression-data, l'ID d'événement 64 bits défini sur la source d'attribution.
trigger_data : anciennement conversion-data, l'ensemble de données 3 bits dans la redirection du déclencheur d'attribution.

⚠️ credit a été supprimé.

Last updated: Improve article

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.