Partie 1 sur 3 sur le débogage d'Attribution Reporting. Découvrez pourquoi le débogage est important et quand utiliser des 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 entre les résultats de mesure de votre implémentation basée sur les cookies et celle de l'API Attribution Reporting, et résoudre les problèmes liés à votre intégration.
Vous aurez besoin de rapports de débogage pour effectuer ces tâches. Nous vous recommandons donc vivement de les configurer.
Glossaire
:Aspects clés 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 réussite permettent de suivre la génération réussie d'un rapport d'attribution. Ils se rapportent directement à 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 de type "verbose" vous offrent une meilleure visibilité sur les événements de source et de 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 ne sont pas disponibles (échec 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 les éléments suivants:
- 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ère 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 de type "verbose" incluent un champ type qui décrit un enregistrement de source réussi ou la raison pour laquelle un rapport sur une source, un déclencheur ou une attribution n'a pas été généré.
Les rapports de débogage de type "verbose" sont disponibles depuis Chrome 109 (janvier 2023), à l'exception des rapports de débogage de type "verbose" sur la réussite de l'enregistrement de la source, qui ont été ajoutés plus tard dans Chrome 112.
Consultez les exemples de rapports dans la section 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 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 des rapports. Contrairement aux 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 de type "verbose" 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 d'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 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 exhaustifs, au niveau des événements et agrégables.
Pour en savoir plus, consultez la section 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 d'attribution qui sont retardés pour protéger la confidentialité des utilisateurs. Utilisez les rapports de débogage comme signal en temps réel 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 l'utilité et la confidentialité. Cela signifie que vous ne pourrez peut-être pas collecter toutes les données de mesure que vous pourriez collecter avec les cookies avec l'API Attribution Reporting. Toutes les conversions que vous pouvez suivre avec des cookies tiers ne génèrent pas de rapport d'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 de l'utilisateur.
Utilisez les rapports de débogage pour identifier les différences entre les résultats de vos mesures basées sur les cookies et ceux que vous obtenez 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: Guide de 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 de 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 de navigateurs. Découvrez comment procéder dans 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. Il peut s'agir, par exemple, de règles de filtrage, de déduplication et de priorité.
Lorsque vous utilisez ces fonctionnalités, utilisez les rapports de débogage pour vérifier que votre logique entraîne le comportement souhaité en production, sans attendre les rapports d'attribution. Pour en savoir plus, 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.
Retraitrer les rapports du service d'agrégation
Le mode débogage vous permet également de traiter à nouveau les rapports. Par conséquent, pour traiter les rapports plusieurs fois, assurez-vous d'activer les rapports de débogage. Vous pouvez réexécuter 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 essayant différentes valeurs d'épsilon.
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 reporting. 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 du rapport récapitulatif.