L'API Conversion Measurement 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 de l'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
credita été supprimé, ainsi que les rapports qui auraient eu un crédit de 0.
Dans Chrome 92, l'ensemble des fonctionnalités compatibles reste inchangé : rapports au niveau des événements, pour les clics uniquement. Nous vous tiendrons informé. Après ce changement, d'autres mises à jour et fonctionnalités seront disponibles dans les prochaines versions de Chrome.
Quand ces modifications entreront-elles en vigueur ?
Ces modifications 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 ?
Si vous avez exécuté un test d'origine ou implémenté une démo pour cette API, vous avez deux options :
- Option 1 (recommandée) : migrez votre code maintenant ou dans les semaines à venir, idéalement avant la mi-juillet 2021. Votre code sera ainsi prêt pour les futurs changements et continuera de 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, puis apportez toutes les modifications de code nécessaires en une seule fois.
Migrer
Exemple de migration
Vous trouverez un exemple de migration pour une petite application de démonstration dans cette pull request (brouillon).
Mettre à jour le code de votre règlement sur les autorisations
| Ancien code | Nouveau code |
|---|---|
allow='conversion-measurement' |
allow='attribution-reporting' |
Mettre à jour votre code de détection des fonctionnalités
| Ancien code | Nouveau code |
|---|---|
document.featurePolicy.features() |
document.featurePolicy.features() |
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 initiées par window.open().
Mettez à jour ces appels si vous utilisez window.open() pour enregistrer les sources d'attribution.
Votre nouveau code doit se présenter comme suit (ce changement de 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'
);
Modifier l'URL et le paramètre de votre appel à l'enregistrement
| 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 de reporting
| Ancien code | 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 |
| Rapports entrants | Envoyés en tant que paramètres d'URL. | Envoyées 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 : anciennement impression-data, l'ID d'événement de 64 bits défini sur la source d'attribution.trigger_data : anciennement conversion-data, ensemble de données de 3 bits dans la redirection du déclencheur d'attribution.⚠️ credit a été supprimé.
|
Attribution Reporting : toutes les ressources
Consultez Rapports sur l'attribution.