L'API de mesure des conversions 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 de l'API dans Chrome évolue. Voici ce qui va changer :
- Nom de l'API et nom de la règle d'autorisations.
- 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 signalements :
credita été supprimé, ainsi que les signalements qui n'auraient pas donné lieu à un crédit.
L'ensemble des fonctionnalités compatibles reste inchangé dans Chrome 92 : les 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 publiées dans les futures versions de Chrome.
Quand ces modifications entreront-elles en vigueur ?
Ces modifications prennent effet à partir de la version stable Chrome 92, publiée le 20 juillet 2021. La version bêta de Chrome 92 est sortie le 3 juin 2021.
Que devez-vous faire ?
Si vous exécutiez un essai d'origine ou que vous avez implémenté une démonstration de cette API, vous avez deux options :
- Option 1 (recommandée) : migrez votre code dès maintenant ou dans les semaines à venir, dans l'idéal avant la mi-juillet 2021. De cette façon, votre codebase sera prêt pour les futurs changements et continuera de fonctionner pour les clients Chrome plus récents.
- Option 2 : attendre que d'autres mises à jour et fonctionnalités soient publiées dans les futures versions de Chrome, puis effectuer toutes les modifications de code nécessaires en une seule fois.
Migrer
Exemple de migration
Vous pouvez consulter un exemple de migration pour une petite application de démonstration dans cette pull request (brouillon).
Mettre à jour le code de votre stratégie d'autorisation
| Code ancien | Nouveau code |
|---|---|
allow='conversion-measurement' |
allow='attribution-reporting' |
Mettre à jour votre code de détection de fonctionnalités
| Code ancien | Nouveau code |
|---|---|
document.featurePolicy.features() |
document.featurePolicy.features() |
Modifier les attributs HTML
| Code ancien | Nouveau code |
|---|---|
conversiondestination |
attributiondestination |
impressiondata |
attributionsourceeventid |
impressionexpiry |
attributionexpiry |
reportingorigin |
attributionreportto |
Modifier les arguments window.open()
Une source d'attribution peut être enregistrée pour les navigations lancé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 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 d'enregistrement
| Code ancien | 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 création de rapports
| Code ancien | 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é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 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é.
|
Rapports sur l'attribution : toutes les ressources
Consultez Rapports sur l'attribution.