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
Developer Relations Engineer for security/privacy, Chrome and web
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 :
credita é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 |
|---|---|
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 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é. |
Updated on • Improve article