Partie 3 sur le débogage d'Attribution Reporting. Découvrez comment utiliser les rapports de débogage.
Ce guide vous explique comment utiliser les rapports de débogage pour différents cas d'utilisation décrits dans la partie 1: Présentation des rapports de débogage.
Glossaire
- L'origine des rapports est l'origine qui définit les en-têtes de source et de déclencheur d'Attribution Reporting.
Tous les rapports générés par le navigateur sont envoyés à cette origine. Dans ce guide, nous utilisons
https://adtech.examplecomme exemple d'origine de création de rapports. - Un rapport sur l'attribution (rapport en abrégé) est le rapport final (au niveau des événements ou agrégable) qui contient les données de mesure que vous avez demandées.
- Un rapport de débogage contient des données supplémentaires sur un rapport sur l'attribution, ou sur une source ou un événement déclencheur. L'envoi d'un rapport de débogage ne signifie pas nécessairement que quelque chose ne fonctionne pas correctement. Il existe deux types de rapports de débogage.
- Un rapport de débogage de transition est un rapport de débogage qui nécessite la définition d'un cookie pour être généré et envoyé. Les rapports de débogage de transition ne seront pas disponibles si aucun cookie n'est défini et une fois les cookies tiers obsolètes. Tous les rapports de débogage décrits dans ce guide sont des rapports de débogage de transition.
- 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).
- Les rapports de débogage détaillés peuvent suivre les rapports manquants et vous aider à déterminer pourquoi ils sont manquants. Elles indiquent les cas où le navigateur n'a enregistré aucun événement de source ou déclencheur (ce qui signifie qu'il ne génère pas de rapport sur l'attribution), et les cas où un rapport sur l'attribution ne peut pas être généré ou envoyé pour une raison quelconque.
Les rapports de débogage détaillés incluent un champ
typequi décrit la raison pour laquelle un événement source, un événement déclencheur ou un rapport d'attribution n'a pas été généré. Les rapports de débogage détaillés sont disponibles à partir de Chrome 109 (version stable en janvier 2023). - Les clés de débogage sont des identifiants uniques que vous pouvez définir côté source et côté déclencheur. Les clés de débogage vous permettent de mapper les conversions basées sur les cookies et les conversions basées sur l'attribution. Une fois que vous avez configuré votre système pour générer des rapports de débogage et définir des clés de débogage, le navigateur inclut ces clés de débogage dans tous les rapports sur l'attribution et dans tous les rapports de débogage.
Pour découvrir d'autres concepts et termes clés utilisés dans notre documentation, consultez le glossaire de la Privacy Sandbox.
Guide: Vérifier votre intégration en temps réel
- Configurez votre système pour générer des rapports de débogage de réussite. Pour savoir comment procéder, consultez la section Partie 2: Configurer les rapports de débogage.
- Chaque fois que vous déployez du code de création de rapports sur l'attribution, vérifiez en temps réel si vous recevez des rapports de débogage de réussite sur votre point de terminaison. Si tel est le cas, votre configuration Attribution Reporting fonctionne.
- Les rapports de débogage de réussite ne sont envoyés que lorsqu'une conversion a lieu. Vous pouvez plutôt vérifier que votre intégration est correctement configurée, indépendamment des conversions. Autrement dit, vous devez vérifier que les sources sont bien enregistrées. Pour ce faire, vous pouvez vous appuyer sur les rapports de débogage détaillés sur l'inscription réussie de la source. Découvrez comment les configurer dans la partie 2: Configurer les rapports de débogage.
Guide: Analyser les pertes et résoudre les problèmes d'intégration
Pour comparer les résultats de mesure des conversions basés sur les cookies avec les rapports sur l'attribution, utilisez des clés de débogage et mappez les conversions basées sur les cookies avec les rapports de débogage. N'oubliez pas que les rapports de débogage sont envoyés immédiatement à votre point de terminaison.
Présentation
Utilisez les clés de débogage (paire <source_debug_key, trigger_debug_key>) pour mettre en correspondance les conversions de cookies avec les rapports de débogage de réussite.
Avez-vous reçu un rapport de débogage de réussite correspondant pour chaque conversion par cookie au moment de la conversion ?
Si oui: vous devriez recevoir un rapport d'attribution plus tard pour tous ces rapports de débogage de réussite, à quelques exceptions près. Pour en savoir plus, consultez le scénario de rapport de débogage de réussite.
Sinon, cela signifie que la conversion n'a pas été enregistrée dans les rapports sur l'attribution. Utilisez la paire <source_debug_key, trigger_debug_key> (ou la clé de débogage source si la clé de débogage du déclencheur est absente) pour mapper les conversions de cookies sur des rapports de débogage détaillés. Pour chacune de ces conversions, avez-vous reçu à un moment donné (au moment de la source ou du déclencheur) un rapport de débogage détaillé correspondant ?
Si vous n'avez pas reçu de rapport de débogage détaillé, cela peut être dû au comportement de l'utilisateur ou à un problème d'intégration. Pour en savoir plus, consultez le scénario sans rapport de débogage.
Si vous avez reçu un rapport de débogage détaillé, examinez son champ
type.Si
typeestsource-success, cela signifie que la source a bien été enregistrée, mais pas le déclencheur. Pour déterminer pourquoi le rapport de débogage de réussite est manquant, recherchez un rapport de débogage détaillé correspondant de tout autre type. Ce rapport indiquera un problème côté déclencheur.Si son
typeest autre chose: la source ou le déclencheur n'ont pas été enregistrés.typevous explique pourquoi. Le rapport sur l'attribution (et le rapport de débogage "success") correspondant ne sera pas disponible. En fonction de l'typed'un rapport de débogage détaillé, vous pouvez simplement considérer ces informations comme un point de données d'analyse des pertes (en d'autres termes, aucune action n'est requise de votre part), ou vous pouvez signaler un bug ou résoudre les problèmes liés à votre implémentation. Pour en savoir plus, consultez le scénario de rapport de débogage détaillé.
Scénarios possibles
Rapport de débogage de réussite
Si vous avez reçu un rapport de débogage de réussite pour une conversion par cookie donnée, cela signifie que cette conversion a bien été enregistrée dans les rapports sur l'attribution.
Vous devriez recevoir ultérieurement un rapport sur l'attribution de cette conversion⏤, à quelques exceptions près:
- Comportement des utilisateurs: effacement des données après la conversion et avant l'envoi du rapport d'attribution, fermeture du navigateur, etc. Si un utilisateur ferme son navigateur après avoir réalisé une conversion et ne l'ouvre pas pendant une semaine, le rapport ne sera pas envoyé avant une semaine ou plus. Vous pouvez considérer ce délai comme une perte.
- Applicable au niveau des événements uniquement: un rapport au niveau des événements est remplacé par un autre rapport de priorité supérieure.
- Problèmes réseau possibles.
Rapport de débogage de type "verbose" de type source-success
Si vous avez reçu un rapport de débogage détaillé de type source-success pour la source d'une conversion de cookie donnée, cela signifie que l'enregistrement de la source a réussi. Selon que l'enregistrement du déclencheur aboutit ou non, vous recevrez ou non un rapport pour cette conversion.
Il y a une exception:
Rapport de débogage de type "verbose" de tout autre type
Si, pour une conversion de cookie donnée, vous avez reçu un rapport de débogage détaillé d'un autre type, vous ne recevrez pas de rapport de débogage de succès, et donc plus tard aucun rapport d'attribution⏤, car un rapport détaillé signifie qu'un échec pouvant être signalé s'est produit. Un problème a empêché l'enregistrement de la source, du déclencheur, la génération ou l'envoi du rapport. Causes possibles :
- Limites de confidentialité
- Limites de stockage
- Règles personnalisées
- Problème d'implémentation dans votre code
- Bug du navigateur
Certains d'entre eux sont attendus. L'action à effectuer dépend de l'type de chaque rapport détaillé. Consultez la documentation de référence sur les rapports détaillés.
Aucun rapport de débogage
Si, pour une conversion de cookie donnée, vous n'avez reçu qu'un rapport d'attribution (aucun rapport de débogage de réussite ni de débogage détaillé), cela signifie qu'un élément a empêché la génération des rapports de débogage. Causes possibles :
- Préférences de l'utilisateur (l'utilisateur a désactivé les cookies tiers)
- Cookie ou clés de débogage manquants (clé de débogage effacée en raison d'un cookie manquant). Dans
chrome://attribution-internals, ouvrez l'onglet Journals et vérifiez si un problème s'affiche. - Problèmes de réseau survenus au moment de la source ou du déclencheur, mais pas au moment de l'envoi du rapport d'attribution.
Recevez-vous des rapports sur l'attribution ?
Il s'agit d'un cas particulier de non-réception d'un rapport de débogage: si vous n'avez reçu aucun rapport d'attribution ni de débogage pour une conversion de cookie donnée, cela signifie qu'un échec non signalable s'est produit. Causes possibles :
- Problème d'intégration fondamental. Découvrez comment les résoudre dans Résoudre les problèmes d'intégration fondamentaux.
- Problèmes réseau possibles.
- Préférences de l'utilisateur dans les paramètres du navigateur, comme la désactivation de la Privacy Sandbox.
Référence des rapports de débogage de type "verbose"
Chaque rapport de débogage détaillé contient un champ type qui indique pourquoi le rapport d'attribution correspondant a été supprimé. Utilisez la référence pour déterminer l'action à effectuer pour chaque type du rapport détaillé.
Enregistrement de la source réussi
Une source a bien été enregistrée.
source-success- Détails et corps du rapport
Rapports sur les limites de confidentialité
Ces rapports sont attendus. Ils indiquent les limites de confidentialité afin de réduire la fuite d'identité utilisateur intersites.
source-destination-limit- Détails et corps du rapport
source-noised- Détails et corps du rapport
trigger-attributions-per-source-destination-limit- Détails et corps du rapport
trigger-reporting-origin-limit- Détails et corps du rapport
trigger-event-noise- Détails et corps du rapport
trigger-event-excessive-reports- Ce message s'affiche si le nombre de conversions du rapport dépasse la limite. Vous ne pouvez enregistrer qu'une seule conversion pour les vues et trois pour les clics. Notez que vous pouvez configurer les rapports à recevoir en définissant des priorités. Détails et corps du rapport
Rapports sur les limites de stockage
Ces rapports sont attendus. Elles indiquent les limites de stockage pour éviter une utilisation excessive des ressources.
source-storage-limit- Détails et corps du rapport
trigger-event-storage-limit- Détails et corps du rapport
trigger-aggregate-storage-limit- Détails et corps du rapport
Rapports sur les règles personnalisées
Ces rapports sont attendus si vous utilisez le filtrage, la déduplication, les priorités ou le filtrage basé sur des périodes. Pour être sûr, vérifiez les règles personnalisées correspondantes pour vous assurer que le rapport correspondant à ce rapport détaillé est bien celui que vous souhaitez supprimer. Si c'est bien le cas, aucune action de votre part n'est requise.
trigger-no-matching-filter-data- Détails et corps du rapport
trigger-event-no-matching-configuration- Détails et corps du rapport
trigger-event-deduplicated- Détails et corps du rapport
trigger-aggregate-deduplicated- Détails et corps du rapport
trigger-event-low-priority- Détails et corps du rapport
trigger-event-report-window-passed- Détails et corps du rapport
trigger-aggregate-report-window-passed- Détails et corps du rapport
Autres rapports de type "verbose"
Ces rapports peuvent indiquer des problèmes d'implémentation potentiels dans votre code.
trigger-no-matching-source- Il peut s'agir d'un problème d'implémentation. Vérifiez qu'il n'y a pas de mauvaise configuration dans votre configuration de
<reporting origin, destination>. Il peut également s'agir d'un comportement normal de l'API. Par exemple, l'utilisateur a effacé des données à un moment donné après avoir interagi avec une annonce et avant d'effectuer une conversion, ou il a effectué une conversion sans avoir vu l'annonce associée. Détails et corps du rapport trigger-aggregate-no-contributions- Ce n'est probablement pas le comportement que vous souhaitez pour votre code. Résolvez les problèmes liés à votre code d'enregistrement du déclencheur. Assurez-vous que la configuration de votre contribution est correcte. Détails et corps du rapport
trigger-aggregate-insufficient-budget- Ce n'est probablement pas le comportement que vous souhaitez pour votre code. Vérifiez votre code d'enregistrement du déclencheur pour vous assurer que la somme de toutes les contributions ne dépasse pas le budget de contribution. Détails et corps du rapport
Erreurs inattendues (bugs potentiels du navigateur)
Ces rapports sont inattendus. Cela peut être dû à un bug de navigateur. Signalez un bug et indiquez dans votre description la procédure à suivre pour le reproduire.
source-unknown-error- Détails et corps du rapport
trigger-unknown-error- Détails et corps du rapport
Exemple d'analyse des pertes
Étape 1: Configuration et mappage avec des cookies
Suivez les instructions de la partie 2: Configurer les rapports de débogage pour configurer votre système afin qu'il génère des rapports de débogage de réussite et des rapports de débogage détaillés.
Vous pouvez ainsi utiliser les informations de conversion basées sur les cookies pour rechercher les rapports de débogage ou d'attribution correspondants.
Étape 2: Identifiez les enregistrements réussis et les rapports manquants
Dans cet exemple, supposons que vous ayez suivi 100 conversions avec votre système basé sur les cookies.
Chaque fois que vous enregistrez une conversion basée sur les cookies, recherchez le rapport de débogage de réussite (envoyé immédiatement) qui comporte la même paire <source_debug_key, trigger_debug_key> que cette conversion basée sur les cookies.
Supposons que vous ayez reçu un rapport de débogage de réussite pour 70 de ces conversions par cookie.
- Les rapports "Succès" signifient que l'attribution a bien été enregistrée. Vous pouvez donc supposer que vous recevrez un rapport d'attribution correspondant à chaque rapport "Succès", à quelques exceptions près.
- Vous pouvez choisir de surveiller ces exceptions. Pour ce faire, lorsque les rapports d'attribution sont envoyés à votre point de terminaison au cours des prochains jours/semaines (selon l'expiration), recherchez les rapports d'attribution qui ont la même paire de clés de débogage que chaque rapport de débogage de succès. Attendez un peu: les rapports ne sont pas toujours envoyés immédiatement à la fin de chaque période. Supposons que vous ne trouviez que 60 rapports sur l'attribution. Les 10 rapports d'attribution manquants peuvent être dus au comportement des utilisateurs.
Étape 3: Évaluation rapide de la perte
100-70 = 30 rapports de débogage de réussite manquants. Cela signifie que ces 30 conversions (qui ont été suivies dans votre implémentation basée sur les cookies) n'ont pas été enregistrées avec les rapports sur l'attribution. Vous ne recevrez pas de rapports sur l'attribution pour ces campagnes.
Étant donné que vous avez 100 conversions basées sur les cookies et seulement 70 conversions basées sur l'attribution, votre perte est de 30%. Vous disposez maintenant d'une évaluation succincte de la perte.
Étape 4: Analyser les causes
Pour déterminer pourquoi ces rapports sont manquants, recherchez les rapports de débogage détaillés correspondants que vous avez reçus au moment de la conversion (enregistrement du déclencheur) ou avant, au moment de l'enregistrement de la source. Utilisez les clés des conversions basées sur les cookies pour les mapper sur des rapports de débogage détaillés.
- Supposons qu'il existe 10 clés pour lesquelles il n'existe pas de rapport de débogage détaillé. Vérifiez s'il existe un problème d'intégration. Si ce n'est pas le cas, cela peut être dû au comportement de l'utilisateur.
- Vous avez 20 rapports de débogage détaillés. Vous pouvez maintenant affiner votre analyse des pertes. Analysez le champ
typede chaque rapport détaillé. Par exemple, vous pouvez constater :- 10 rapports (soit 10% dans notre exemple) sont manquants en raison de
pending destination limit - Cinq rapports (soit 5%) sont manquants en raison de
trigger-aggregate-no-contributions. - Cinq rapports (soit 5%) sont manquants en raison de
unknown-error.
- 10 rapports (soit 10% dans notre exemple) sont manquants en raison de
Étape 5: Prenez les mesures nécessaires et effectuez le dépannage
Maintenant que vous savez pourquoi des rapports sont manquants, vous pouvez agir en conséquence.
L'action à effectuer dépend de l'type de chaque rapport détaillé. Pour en savoir plus, consultez la documentation de référence sur les rapports détaillés. Exemple :
pending-destination-limitest une protection de la confidentialité. Aucune action n'est requise de votre part. Utilisez ce nombre comme point de données pour votre propre visibilité et surveillance.trigger-aggregate-no-contributionspeut être le signe d'un problème d'implémentation de votre côté. Analysez cela plus en détail. Utilisez les informations du corps du rapport détaillé pour résoudre le problème, le cas échéant.unknown-errorpeut être le signe d'un bug de navigateur ou d'une erreur réseau. Si ce problème se produit de manière répétée, signalez un bug aux développeurs de navigateur.