Partie 1 sur 3 sur le débogage d'Attribution Reporting. Découvrez l'importance du débogage et quand utiliser les rapports de débogage dans les 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 entre les résultats des mesures 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.
Des rapports de débogage sont nécessaires pour effectuer ces tâches. Par conséquent, nous vous recommandons vivement de les configurer.
Glossaire
Principales caractéristiques 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 de réussite
Les rapports de débogage de réussite permettent d'analyser la génération 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 de type "verbose"
Les rapports de débogage détaillés vous offrent une meilleure visibilité sur les événements de source et de déclencheur. Vous pouvez ainsi vérifier que les sources ont bien été enregistrées, ou suivre les rapports manquants et déterminer pourquoi ils manquent (échec au niveau des événements de source 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 correctement enregistré une source.
- Cas où le navigateur n'a pas enregistré de source ni de déclencheur d'événement (ce qui signifie qu'il ne génère pas de rapport sur l'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 de type "verbose" incluent un champ type qui décrit soit un enregistrement de la source réussi, soit 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 de type "Réussite de l'enregistrement des sources" qui ont été ajoutés ultérieurement dans Chrome 112.
Consultez des exemples de rapports dans la 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 des rapports est un tiers, ce cookie est considéré comme un cookie tiers. Cela a quelques conséquences clés:
- 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 du rapport. Cela diffère 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 lors de l'enregistrement de la source ou du déclencheur.
Les chemins d'accès aux points de terminaison pour les rapports de débogage sont 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:
- Rapports de débogage success du point de terminaison, au niveau des événements
- Rapports de débogage réussie du point de terminaison, 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 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.
Pour savoir comment procéder, consultez 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 la confidentialité intégrées, conçues pour trouver l'é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 les cookies. Les conversions que vous pouvez suivre à l'aide de cookies tiers ne génèrent pas toutes un rapport sur l'attribution.
Par exemple, pour les rapports au niveau des événements, vous pouvez enregistrer au maximum une 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 réalisé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 enregistrées, le nombre de conversions non enregistrées, celles qui sont comptabilisées 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 mise en œuvre 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 résoudre un problème d'implémentation de votre côté, ou pour 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 avancée de la configuration
Certaines fonctionnalités de l'API Attribution Reporting vous permettent de personnaliser les comportements de l'API. Les règles de filtrage, les règles de déduplication et les règles de priorité en sont quelques exemples.
Lorsque vous utilisez ces fonctionnalités, servez-vous des rapports de débogage pour vérifier que votre logique aboutit au comportement souhaité en production, sans attendre les rapports sur l'attribution. Pour savoir comment procéder, consultez la Partie 3: Livre de recettes sur le débogage.
Test en local avec rapports cumulables
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 le contenu de ces rapports et pour générer des rapports récapitulatifs à l'aide de l'outil d'agrégation local à des fins de test.
Retraitement des rapports du service d'agrégation
Le mode débogage vous permet également de traiter à nouveau les rapports. Par conséquent, assurez-vous d'activer les rapports de débogage pour traiter les rapports plusieurs fois. Vous pouvez traiter à nouveau des rapports dans les cas suivants:
- pour tenter 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 de rapport. Cela est utile en cas de problèmes liés au service d'agrégation, tels que des services indisponibles ou non réactifs qui peuvent entraîner l'échec de la génération de rapports récapitulatifs.