Partie 1 sur 3 sur 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 des rapports de débogage ?
Si vous testez l'API Attribution Reporting, vous devez vérifier que votre intégration fonctionne correctement, comprendre les écarts de mesure entre votre implémentation basée sur les cookies et celle d'Attribution Reporting, et résoudre les problèmes liés à votre intégration.
Les rapports de débogage sont nécessaires pour effectuer ces tâches. Par conséquent, nous vous recommandons 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 réussi
Les rapports de débogage de réussite permettent d'assurer le suivi des rapports sur l'attribution générés correctement. 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 plus de visibilité sur les événements de la source et du déclencheur. Vous pouvez ainsi vous assurer que les sources ont bien été enregistrées, ou suivre les rapports manquants et déterminer pourquoi ils sont manquants (échec au niveau des événements de la source ou du déclencheur, échec lors de l'envoi ou de la génération du rapport). Les rapports de débogage de type "verbose" indiquent:
- Cas où le navigateur a bien enregistré une source.
- Cas où le navigateur n'a pas correctement enregistré un événement de source ou de déclencheur, ce qui signifie qu'il ne génère pas de rapport sur l'attribution.
- Cas dans lesquels 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 un enregistrement de source réussi, ou la raison pour laquelle une source, un déclencheur ou un rapport d'attribution n'a pas été généré.
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 concernant l'enregistrement de la source, ajoutés ultérieurement dans Chrome 112.
Examinez des exemples de rapports dans la Partie 2: Configurer les rapports de débogage.
Les rapports de débogage sont basés sur les cookies
Pour utiliser les rapports de débogage, l'origine des rapports doit définir un cookie.
Si l'origine configurée pour recevoir des rapports est un tiers, ce cookie sera un cookie tiers. Cela a plusieurs conséquences importantes:
- 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 ne seront plus disponibles une fois les cookies tiers supprimés.
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 des rapports. Ce fonctionnement est différent des rapports sur l'attribution, qui sont envoyés avec un délai.
Les rapports de débogage de réussite 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 comportent différents chemins d'accès aux points de terminaison
Comme les rapports sur l'attribution, tous les rapports de débogage sont envoyés à l'origine des rapports. 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 réussis, au niveau des événements
- Point de terminaison pour les rapports de débogage réussis, agrégables
- Point de terminaison pour les rapports de débogage verbose, 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 base de l'intégration en temps réel
Les rapports de débogage sont envoyés immédiatement à votre point de terminaison, contrairement aux rapports sur l'attribution, qui sont retardés afin de protéger la confidentialité des utilisateurs. Utilisez les rapports de débogage comme un signal en temps réel indiquant que votre intégration à l'API Attribution Reporting fonctionne.
Découvrez comment procéder dans la Partie 3: livre de recettes sur le débogage.
Analyse des pertes
Contrairement aux cookies tiers, l'API Attribution Reporting inclut des protections de 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 collectez actuellement avec des cookies. Les conversions que vous pouvez suivre avec des cookies tiers ne génèrent pas toutes un 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 ne recevrez qu'un seul rapport sur l'attribution, quel que soit le nombre de conversions effectuées par l'utilisateur.
Utilisez les rapports de débogage pour mieux comprendre les différences entre les résultats des mesures basées sur les cookies et ceux obtenus avec l'API Attribution Reporting. Identifiez les conversions qui font l'objet d'un rapport, le nombre de conversions qui ne le sont pas, et plus précisément lesquelles et pourquoi.
Découvrez comment exécuter une analyse des pertes dans la Partie 3: livre de recettes sur le débogage.
Dépannage
Bien que la perte causée par la protection de la confidentialité ou des ressources soit attendue, 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 l'absence de rapports.
Les rapports de débogage vous permettent de détecter et de corriger un problème d'implémentation de votre côté, ou de signaler un bug potentiel aux équipes chargées du navigateur. Découvrez comment procéder dans la Partie 3: livre de recettes sur le 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 les rapports de débogage pour vérifier que votre logique conduit au comportement souhaité en production, sans attendre les rapports sur l'attribution. Découvrez comment procéder dans la Partie 3: livre de recettes sur le débogage.
Tests en local avec des rapports agrégables
Contrairement aux rapports sur l'attribution agrégables qui sont 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 leur contenu et générer des rapports récapitulatifs à l'aide de l'outil d'agrégation local à des fins de test.
Rapports du service d'agrégation concernant le retraitement
Le mode débogage vous permet également de traiter à nouveau les rapports. Par conséquent, pour traiter les rapports plusieurs fois, assurez-vous d'avoir activé les rapports de débogage. Nous vous conseillons de traiter à nouveau vos rapports dans les cas suivants:
- de déboguer le service d'agrégation.
- en testant différentes stratégies de traitement par lot.
- en testant différentes valeurs epsilon.
Récupération de données
Nous recommandons aux technologies publicitaires d'activer le mode débogage pour recevoir des rapports de débogage afin de pouvoir récupérer leurs données. Cela est utile en cas de problèmes liés au service d'agrégation, tels que des services indisponibles ou non réactifs pouvant entraîner l'échec de la génération de rapports récapitulatifs.