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 et comprendre les écarts de mesure entre basée sur les cookies et de votre mise en œuvre d'Attribution Reporting, et résolvez les éventuels problèmes liés à cette 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. Ils sont liés directement dans 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 les rapports est un tiers, ce cookie sera un tiers un cookie. Cela a plusieurs conséquences importantes:
- Les rapports de débogage ne sont générés que si les cookies tiers sont autorisé dans le navigateur de l'utilisateur.
- Les rapports de débogage ne seront plus disponibles une fois les cookies tiers est progressivement supprimé.
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 est différent des rapports sur l'attribution, qui sont envoyés avec retard.
Les rapports de débogage de réussite sont générés et envoyés dès que le le rapport sur l'attribution correspondant est généré, c'est-à-dire lors du déclenchement l'enregistrement.
Les rapports de débogage détaillés sont envoyés immédiatement après la source ou le déclencheur l'enregistrement.
Les rapports de débogage comportent différents chemins d'accès au point 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 pour protéger la confidentialité des utilisateurs. Utilisez les rapports de débogage comme un signal en temps réel indiquant que votre intégration à la 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 intègre des fonctionnalités de confidentialité conçues pour parvenir à un juste équilibre entre et confidentialité. Cela signifie qu'avec l'API Attribution Reporting, vous n'êtes peut-être pas en mesure de collecter toutes les données de mesure que vous collectez actuellement les cookies. Certaines conversions ne sont pas suivre à l'aide de cookies tiers génère un rapport sur l'attribution.
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 vos les résultats des mesures basées sur les cookies et les résultats obtenus grâce au de l'API Reporting. Identifiez les conversions enregistrées et le nombre de conversions non signalées, 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
La perte due à la protection de la confidentialité ou des ressources est attendue, mais d'autres pertes peut être involontaire. des erreurs de configuration dans votre mise en œuvre ou des bugs dans le navigateur lui-même peut entraîner l'absence de 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é. signaler un bug potentiel aux équipes en charge du navigateur. Découvrez comment procéder dans 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 comportements. 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é dans 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 des rapports de débogage agrégables et chiffrés inclure la charge utile non chiffrée.
Utiliser 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. Il peut être utile de traiter à nouveau les 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.