Modifications apportées à Attribution Reporting en juin 2022

La proposition Attribution Reporting change pour la version 104 de Chrome, avec de nouveaux mécanismes et fonctionnalités d'API ainsi que des mises à jour du service d'agrégation.

À qui s'adressent ces modifications ?

Ces mises à jour sont destinées à vous si:

  • Vous connaissez déjà l'API, par exemple si vous avez observé ou participé aux discussions sur le dépôt WICG et que vous souhaitez comprendre les modifications apportées à l'API.
  • Vous utilisez l'API Attribution Reporting dans une démonstration ou un plan de test dans la phase d'évaluation.

Si vous débutez avec cette API et/ou si vous ne l'avez pas encore testée, passez directement à la page Présentation de l'API.

Mises à jour de l'API Attribution Reporting

La démonstration d'Attribution Reporting a été mise à jour pour refléter les dernières modifications apportées à l'API Attribution Reporting côté client.

La plupart des modifications ne nécessitent aucune action. Ceux qui nécessitent une mise à jour sont mis en évidence ci-dessous.

(Action requise) En-têtes unifiés pour l'enregistrement

Les en-têtes ont été unifiés. Il n'existe désormais qu'un en-tête pour les sources et un autre pour les déclencheurs, au format JSON.

  • Pour enregistrer des sources d'attribution, vous pouvez répondre aux requêtes d'enregistrement comportant l'en-tête Attribution-Reporting-Register-Source.
  • Pour terminer l'enregistrement du déclencheur, définissez l'en-tête Attribution-Reporting-Register-Trigger.

Cette modification nécessite une action. Consultez le guide du développeur de l'API pour en savoir plus.

(Action requise) Les clés d'agrégation sont désormais un dictionnaire

Pour enregistrer des sources d'attribution, continuez à utiliser aggregation_keys, mais cet enregistrement est désormais stocké sous forme de dictionnaire JSON plutôt que de liste.

Exemple :

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

Cette modification nécessite une action. Pour en savoir plus, consultez le manuel de l'API.

Création de rapports

Vous pouvez choisir de ne générer que des rapports agrégables, qui peuvent être regroupés dans des rapports de synthèse. Si vos filtres ne correspondent à aucun déclencheur d'événement, aucun rapport au niveau des événements ne sera généré.

Paramètre de clé de débogage unifiée

La clé de débogage doit désormais être définie dans les en-têtes de la source et du déclencheur, au lieu d'utiliser des en-têtes distincts. Découvrez comment déboguer les rapports.

Enregistrer des sources d'attribution

Les tags de script peuvent désormais être utilisés pour enregistrer des sources d'attribution, de la même manière que la balise <img> est compatible.

Plus de mises à jour de l'API

Voici d'autres modifications qui ont été apportées et citées dans le manuel de l'API:

  • Les sources peuvent être enregistrées avec les API de requête JavaScript.
  • window.registerSource a été supprimé.
  • Il est désormais facultatif d'inclure une valeur pour attributionsrc lors de l'enregistrement des sources.
  • L'en-tête Attribution-Reporting-Eligible a été ajouté aux demandes entrantes d'enregistrement de la source.
  • Un changement mineur a été apporté à encodeURIComponent.
  • La clé de budget pour la confidentialité a été supprimée du champ shared_info dans les rapports agrégables.

Compatibilité avec le service d'agrégation

Dans Chrome 104, nous prévoyons de mettre à jour le format de certaines informations dans les rapports agrégables. Nous préparons actuellement la prise en charge de ce changement dans le service d'agrégation. Ce document, ainsi que le journal des modifications, seront mis à jour une fois les modifications envoyées.

Nous avons rassemblé des stratégies et des conseils pratiques pour générer des rapports récapitulatifs. Il contient de nombreux insights, y compris les suivants:

  • Présentation du bruit dans la génération de rapports de synthèse
  • Explication détaillée des dimensions, des clés et des valeurs
  • Clés d'agrégation en pratique, y compris une carte de structure clé
  • Valeurs agrégables en pratique et implications du budget de contribution
  • Guide de test epsilon

En savoir plus sur les modifications

L'image d'en-tête provient de Diana Polekhina sur Unsplash.