La proposition relative à Attribution Reporting évolue pour la version Chrome 104, avec de nouveaux mécanismes, nouvelles fonctionnalités et mises à jour d'API au service d'agrégation.
À qui s'adressent ces mises à jour ?
Ces nouveautés peuvent vous être utiles si:
- Vous connaissez déjà l'API. Par exemple, si vous avez observé ou participer aux discussions sur le référentiel WICG et les modifications apportées à l'API.
- Vous utilisez l'API Attribution Reporting dans une démonstration ou prévoyez d'effectuer un test dans la Phase d'évaluation.
Si vous débutez avec cette API et/ou si vous n'avez pas encore testé accédez directement à la page de présentation API.
Mises à jour de l'API Attribution Reporting
Démonstration d'Attribution Reporting ont été mises à jour pour refléter les dernières modifications apportées à Attribution Reporting. API côté client.
La plupart des modifications ne nécessitent aucune action. Ceux qui nécessitent une mise à jour mise en œuvre sont mises en évidence ci-dessous.
(Action requise) En-têtes unifiés pour l'enregistrement
Les en-têtes ont été unifiés. Il n'y a plus qu'un seul 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 demandes d'enregistrement
avec l'en-tête
Attribution-Reporting-Register-Source
. - Pour terminer l'enregistrement du déclencheur, définissez le
En-tête
Attribution-Reporting-Register-Trigger
.
Cette modification nécessite une action de votre part. Consultez le Guide du développeur de l'API pour en savoir plus.
(Action requise) Les clés d'agrégation deviennent un dictionnaire
Pour enregistrer des sources d'attribution, procédez comme suit :
continuent à utiliser aggregation_keys
, mais sont désormais stockés sous la forme d'un dictionnaire JSON.
d'une 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 de votre part. Consultez le Manuel de l'API pour en savoir plus.
Création de rapports
Vous pouvez choisir de ne générer que des rapports agrégables, qui peuvent être agrégés en rapports récapitulatifs. Si vos filtres ne correspondent à aucun déclencheur d'événement, aucun des rapports au niveau des événements sont générés.
Paramètre de clé de débogage unifié
La clé de débogage devrait désormais être définie dans les en-têtes de source et de déclencheur, au lieu de avec des en-têtes distincts. En savoir plus sur le débogage rapports.
Enregistrer des sources d'attribution
Les tags de script permettent désormais d'enregistrer des sources d'attribution,
pour la balise <img>
.
Plus de mises à jour de l'API
Voici d'autres modifications apportées et mentionnées dans le manuel de l'API:
- Les sources peuvent être enregistrées avec des 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 sources. - En-tête
Attribution-Reporting-Eligible
ajouté à la source entrante de demandes d'enregistrement. - Une modification mineure a été apportée à
encodeURIComponent
. - La clé de budget Privacy a été supprimée
à partir 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 des rapports agrégables. Nous élaborons actuellement la prise en charge de ce changement dans la Service d'agrégation Ce document sera mis à jour, de même que les changelog, après l'expédition des modifications.
Nous avons rassemblé un document contenant des stratégies et conseils pratiques pour générer des résumés rapports. Voici quelques exemples:
- Présentation du bruit dans la génération de rapports récapitulatifs
- Explication détaillée des dimensions, des clés et des valeurs
- Les clés d'agrégation en pratique, y compris un mappage de structure de clés
- Valeurs agrégables dans la pratique et implications du budget de contribution
- Guide de test de la valeur epsilon
En savoir plus sur les mises à jour
- Consultez la section Ce que vous devez savoir sur l'API.
- Consultez Tester les rapports sur l'attribution: stratégie et conseils pour les rapports récapitulatifs.
L'image d'en-tête provient de Diana Polekhina sur Unsplash.