Première partie sur trois concernant le débogage d'Attribution Reporting. Découvrez pourquoi le débogage est important et quand utiliser les rapports de débogage lors des tests.
Pourquoi avez-vous besoin de rapports de débogage ?
Si vous testez l'API Attribution Reporting, vous devez vérifier que votre intégration fonctionne correctement, comprendre les écarts dans les résultats de mesure entre votre implémentation basée sur les cookies et votre implémentation Attribution Reporting, et résoudre tout problème lié à votre intégration.
Des rapports de débogage sont nécessaires pour effectuer ces tâches. Nous vous recommandons donc vivement de les configurer.
Glossaire
Principaux aspects des rapports de débogage
Deux types de rapports de débogage
Deux types de rapports de débogage sont disponibles. Utilisez les deux, car ils répondent à des cas d'utilisation différents.
Rapports de débogage "success"
Les rapports de débogage de type "success" permettent de suivre la génération réussie d'un rapport sur l'attribution. Elles sont directement liées à un rapport sur l'attribution.
Les rapports de débogage de réussite sont disponibles depuis Chrome 101 (avril 2022).
Rapports de débogage détaillés
Les rapports de débogage détaillés vous offrent une meilleure visibilité sur les événements sources et de déclencheur. Vous pouvez ainsi vous assurer que les sources ont été enregistrées correctement, ou suivre les rapports manquants et déterminer pourquoi ils le sont (échec des événements sources ou de déclencheur, échec lors de l'envoi ou de la génération du rapport). Les rapports de débogage détaillés indiquent :
- Cas où le navigateur a bien enregistré une source.
- Cas où le navigateur n'a pas réussi à enregistrer un événement de source ou de déclencheur, ce qui signifie qu'il ne générera pas de rapport d'attribution.
- Cas où un rapport sur l'attribution ne peut pas être généré ni envoyé pour une raison quelconque.
Les rapports de débogage détaillés incluent un champ type qui décrit l'enregistrement réussi d'une source ou la raison pour laquelle une source, un déclencheur ou un rapport d'attribution n'ont pas été générés.
Les rapports de débogage détaillés sont disponibles depuis Chrome 109 (janvier 2023), à l'exception des rapports de débogage détaillés sur la réussite de l'enregistrement de la source, qui ont été ajoutés ultérieurement dans Chrome 112.
Consultez des exemples de rapports dans Partie 2 : Configurer des rapports de débogage.
Les rapports de débogage sont basés sur les cookies.
Pour utiliser les rapports de débogage, l'origine du rapport doit définir un cookie.
Si l'origine configurée pour recevoir les rapports est un tiers, ce cookie sera un cookie tiers. Cela signifie que les rapports de débogage ne sont générés que si les cookies tiers sont autorisés dans le navigateur de l'utilisateur.
Les rapports de débogage sont envoyés immédiatement.
Les rapports de débogage sont envoyés immédiatement par le navigateur à l'origine du rapport. Contrairement aux rapports sur l'attribution, qui sont envoyés avec un délai.
Les rapports de débogage "success" sont générés et envoyés dès que le rapport d'attribution correspondant est généré, c'est-à-dire lors de l'enregistrement du déclencheur.
Les rapports de débogage détaillés sont envoyés immédiatement après l'enregistrement de la source ou du déclencheur.
Les rapports de débogage ont des chemins de point de terminaison différents.
Comme les rapports sur l'attribution, tous les rapports de débogage sont envoyés à l'origine du rapport. Les rapports de débogage sont envoyés à trois points de terminaison distincts de l'origine des rapports :
- Point de terminaison pour les rapports de débogage success au niveau des événements
- Point de terminaison pour les rapports de débogage success, agrégables
- Point de terminaison pour les rapports de débogage détaillés, au niveau des événements et agrégables.
Pour en savoir plus, consultez la Partie 2 : Configurer les rapports de débogage.
Cas d'utilisation
Vérification de l'intégration de base en temps réel
Les rapports de débogage sont envoyés immédiatement à votre point de terminaison, contrairement aux rapports d'attribution qui sont différés pour protéger la confidentialité des utilisateurs. Utilisez les rapports de débogage comme signal en temps réel pour vérifier que votre intégration à l'API Attribution Reporting fonctionne.
Pour en savoir plus, consultez la partie 3 : Guide de débogage.
Analyse des pertes
Contrairement aux cookies tiers, l'API Attribution Reporting inclut des protections de la confidentialité intégrées, conçues pour trouver un équilibre entre utilité et confidentialité. Cela signifie qu'avec l'API Attribution Reporting, vous ne pourrez peut-être pas collecter toutes les données de mesure que vous pouviez collecter avec les cookies. Toutes les conversions que vous pouvez suivre avec des cookies tiers ne génèrent pas de rapport sur l'attribution.
Par exemple, pour les rapports au niveau des événements, vous ne pouvez enregistrer qu'une seule conversion par impression. Cela signifie que pour une impression d'annonce donnée, vous n'obtiendrez qu'un seul rapport sur l'attribution, quel que soit le nombre de conversions de l'utilisateur.
Utilisez les rapports de débogage pour identifier les différences entre les résultats de mesure basés sur les cookies et ceux obtenus avec l'API Attribution Reporting. Identifiez les conversions enregistrées, le nombre de conversions non enregistrées, et plus précisément lesquelles et pourquoi.
Découvrez comment effectuer une analyse des pertes dans la partie 3 du livre de recettes sur le débogage.
Dépannage
Bien que les pertes causées par la protection de la confidentialité ou des ressources soient attendues, d'autres pertes peuvent être involontaires. Des erreurs de configuration dans votre implémentation ou des bugs dans le navigateur lui-même peuvent entraîner la disparition des rapports.
Vous pouvez utiliser les rapports de débogage pour détecter et corriger un problème d'implémentation de votre côté, ou pour signaler un bug potentiel aux équipes des navigateurs. Pour savoir comment procéder, consultez la partie 3 : Guide de débogage.
Vérification de la configuration avancée
Certaines fonctionnalités de l'API Attribution Reporting vous permettent de personnaliser les comportements de l'API. Les règles de filtrage, de déduplication et de priorité en sont quelques exemples.
Lorsque vous utilisez ces fonctionnalités, utilisez des rapports de débogage pour vérifier que votre logique conduit au comportement souhaité en production, sans attendre les rapports d'attribution. Pour savoir comment procéder, consultez la partie 3 : Guide de débogage.
Tests locaux avec des rapports agrégables
Contrairement aux rapports d'attribution agrégables chiffrés, les rapports de débogage agrégables incluent la charge utile non chiffrée.
Utilisez des rapports de débogage agrégables pour valider le contenu des rapports agrégables et générer des rapports récapitulatifs avec l'outil d'agrégation local à des fins de test.
Retraiter les rapports du service d'agrégation
Un autre avantage du mode débogage est qu'il vous permet de traiter à nouveau les rapports. Par conséquent, pour traiter les rapports plusieurs fois, assurez-vous d'avoir activé les rapports de débogage. Vous pouvez être amené à retraiter des rapports dans les cas suivants :
- tentative de débogage du service d'agrégation.
- tester différentes stratégies de traitement par lot.
- en testant différentes valeurs epsilon.
Récupération de données
Nous recommandons aux ad techs d'activer le mode débogage pour recevoir des rapports de débogage et ainsi récupérer leurs données de reporting. Cela est utile en cas de problèmes liés au service d'agrégation, tels que des services indisponibles ou ne répondant pas, qui peuvent entraîner l'échec de la génération de rapports récapitulatifs.
À suivre
Partie 2 : Configurer les rapports de débogage