Cette page a été traduite par l'API Cloud Translation.

Livre de recettes sur le débogage d'Attribution Reporting

Partie 3 sur 3 sur le débogage d'Attribution Reporting. Découvrez comment utiliser les rapports de débogage.

Vous y trouverez des instructions sur l'utilisation des 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 du rapport est l'origine qui [définit les en-têtes de source et de déclencheur Attribution Reporting. Tous les rapports générés par le navigateur sont envoyés à cette origine. Dans ces conseils, nous utilisons https://adtech.example comme exemple d'origine du rapport.
Un rapport d'attribution (rapport en abrégé) est le rapport final (au niveau de l'événement 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 un événement de source ou de déclencheur. La réception 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 sont plus 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'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).
Les rapports de débogage détaillés permettent de suivre les rapports manquants et de vous aider à déterminer pourquoi. Ils 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é ni envoyé pour une raison quelconque. Les rapports de débogage de type "verbose" incluent un champ type qui décrit la raison pour laquelle un événement source, un événement déclencheur ou un rapport sur l'attribution n'ont pas été générés. Les rapports de débogage détaillés sont disponibles à partir de Chrome 109 (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 les inclura dans tous les rapports sur l'attribution et 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.

Procédure: 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 en savoir plus, consultez la Partie 2: Configurer des rapports de débogage.
Chaque fois que vous déployez du code Attribution Reporting, vérifiez en temps réel si vous recevez des rapports de débogage de réussite sur votre point de terminaison. Si c'est le cas, votre configuration Attribution Reporting fonctionne correctement.
Les rapports de débogage de réussite ne sont envoyés qu'en cas de conversion. À la place, vous pouvez vérifier que votre intégration est correctement configurée, quelles que soient les conversions, c'est-à-dire que les sources sont bien enregistrées. Pour ce faire, vous pouvez vous fier aux rapports de débogage de type "verbose"de l'enregistrement de la source réussi. Découvrez comment les configurer dans la Partie 2: Configurer des rapports de débogage.

Guide d'utilisation: Analyser la perte et résoudre les problèmes liés à votre intégration

Pour comparer les résultats de la mesure des conversions basées sur les cookies avec les rapports sur l'attribution, utilisez des clés de débogage et mettez en correspondance les conversions générées par 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 mapper les conversions de cookie aux rapports de débogage réussis. Avez-vous reçu un rapport de débogage de réussite pour chaque conversion effectuée au moment de la conversion ?

Si oui: vous devriez recevoir un rapport sur l'attribution ultérieurement, à quelques exceptions près, pour tous ces rapports de débogage. Pour en savoir plus, consultez le scénario du rapport de débogage de réussite.

Si ce n'est pas le cas: la conversion n'a pas été enregistrée dans Attribution Reporting. 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 aux rapports de débogage détaillés. Pour chacune de ces conversions, avez-vous reçu à un moment donné (heure 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 d'absence de rapport de débogage.
Si vous avez reçu un rapport de débogage détaillé, consultez son champ type.
- Si type est défini sur source-success, cela signifie que la source a bien été enregistrée, mais pas le déclencheur. Pour déterminer la raison pour laquelle 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 type est différent, la source ou le déclencheur n'a pas été enregistré. type vous explique pourquoi. Le rapport sur l'attribution correspondant (et le rapport de débogage de réussite) seront manquants. En fonction du type d'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 requise pour vous), ou signaler un bug ou résoudre votre problème d'implémentation. Pour en savoir plus, consultez le scénario du rapport de débogage détaillé.

Scénarios possibles

Rapport de débogage de réussite

Si vous recevez un rapport de débogage de réussite pour une conversion de cookie donnée, cela signifie que cette conversion a bien été enregistrée auprès d'Attribution Reporting.

Vous devriez recevoir ultérieurement un rapport sur l'attribution pour cette conversion⏤ à quelques exceptions près:

Comportement des utilisateurs: effacement des données après la conversion et avant l'envoi du rapport sur l'attribution, fermeture du navigateur, etc. Si un utilisateur ferme son navigateur après une conversion et n'ouvre pas son navigateur pendant une semaine, le rapport n'est pas envoyé avant une semaine ou plus. Vous pouvez considérer ce délai comme une perte.
Applicable au niveau de l'événement uniquement: un rapport au niveau des événements est remplacé par un rapport de priorité supérieure.
Problèmes éventuels liés au réseau.

Rapport de débogage détaillé de type `source-success`

Si vous avez reçu un rapport de débogage 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 a également réussi ultérieurement, vous pouvez recevoir ou non un rapport pour cette conversion.

Il y a une mise en garde à cela:

Autre type de rapport de débogage détaillé

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 réussite. Par conséquent, vous ne recevrez pas de rapport d'attribution par la suite, 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 ou du déclencheur, ainsi que la génération ou l'envoi de rapports. 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'attribut type de chaque rapport détaillé. Consultez la documentation de référence sur les rapports de type "verbose".

Aucun rapport de débogage

Si pour une conversion de cookie donnée, vous ne recevez qu'un rapport sur l'attribution (aucun rapport de débogage de type succès ni rapport 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 utilisateur (l'utilisateur a désactivé les cookies tiers)
Cookie manquant ou clés de débogage manquantes (clé de débogage effacée en raison d'un cookie manquant). Dans chrome://attribution-internals, ouvrez l'onglet Journaux et vérifiez si un problème y apparaît.
Problèmes de réseau survenus au moment de la source ou du déclencheur, mais pas lors de l'envoi du rapport sur l'attribution.

Recevez-vous des rapports sur l'attribution ?

Il s'agit d'un sous-cas de réception de rapport de débogage: si pour une conversion de cookie donnée, vous n'avez reçu aucun rapport (aucun rapport de débogage d'aucune sorte, aucun rapport d'attribution), cela signifie qu'un échec ne peut pas être signalé. 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 éventuels liés au réseau.
Les préférences utilisateur dans les paramètres du navigateur, comme la Privacy Sandbox, sont désactivées.

Documentation de référence sur les rapports de débogage détaillés

Chaque rapport de débogage de type "verbose" dispose d'un champ type qui indique la raison pour laquelle le rapport sur l'attribution correspondant a été abandonné. Utilisez cette référence pour déterminer l'action à effectuer pour chaque type du rapport détaillé.

Remarque:Si le type d'un rapport de type "verbose" commence par trigger-event, il ne peut être généré que pour les événements de source ou de déclencheur associés à des rapports au niveau des événements. Si l'élément type d'un rapport de type "verbose" commence par trigger-aggregate, il ne peut être généré que pour les événements de source ou de déclencheur associés à des rapports agrégables. Dans tous les autres cas, il s'agit d'un rapport au niveau des événements ou d'un rapport agrégable.

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 des limites de confidentialité afin de réduire les fuites d'identité intersites des utilisateurs.

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: Le rapport est généré si le nombre de rapports dépasse la limite. Vous ne pouvez enregistrer qu'une conversion pour les vues et trois pour les clics. Notez que vous pouvez configurer les rapports que vous souhaitez recevoir en définissant des priorités. Détails et corps du rapport

Rapports sur les limites de l'espace de stockage

Ces rapports sont attendus. Ils 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 les fenêtres. Au cas où, revérifiez les règles personnalisées correspondantes pour vous assurer que le rapport correspondant à ce rapport de type "verbose" est bien un rapport que vous souhaitez supprimer. Si c'est le cas, aucune action n'est requise de votre part.

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 que votre configuration de <reporting origin, destination> ne présente aucune erreur de configuration. Il peut également s'agir du comportement attendu 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 voir d'annonce associée. Détails et corps du rapport
trigger-aggregate-no-contributions: Ce n'est probablement pas le comportement souhaité pour votre code. Résolvez les problèmes liés au code d'enregistrement du déclencheur et assurez-vous que votre configuration de contribution est correcte. Détails et corps du rapport
trigger-aggregate-insufficient-budget: Ce n'est probablement pas le comportement souhaité pour votre code. Vérifiez le 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 du navigateur. Signalez un bug et indiquez dans votre description les étapes permettant de 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: Configurer et utiliser les cookies

Suivez les instructions de la Partie 2: Configurer des rapports de débogage pour configurer votre système afin qu'il génère des rapports de débogage de type succès et des rapports de débogage de type "verbose".

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

Imaginons que vous ayez effectué le suivi de 100 conversions à l'aide d'un 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) ayant la même paire <source_debug_key, trigger_debug_key> que cette conversion basée sur les cookies.

Imaginons que vous ayez reçu un rapport de débogage de type "réussite" pour 70 de ces conversions générées par un cookie.

Un rapport de réussite signifie que l'attribution a bien été enregistrée. Vous pouvez donc supposer que vous obtiendrez un rapport sur l'attribution correspondant à chaque rapport de réussite, à quelques exceptions près.
Vous pouvez décider de surveiller ces exceptions. Pour ce faire, étant donné que les rapports sur l'attribution sont envoyés à votre point de terminaison au cours des prochains jours/semaines (en fonction de l'expiration), recherchez les rapports sur l'attribution qui ont la même paire de clés de débogage que chaque rapport de débogage de réussite. Attendez un peu, car il est possible que les rapports ne soient pas envoyés immédiatement à la fin de chaque fenêtre. Supposons que vous ne trouvez que 60 rapports sur l'attribution. Les 10 rapports sur l'attribution manquants peuvent être dus au comportement des utilisateurs.

Remarque:Il est possible que les rapports sur l'attribution au niveau des événements ne correspondent pas à une conversion basée sur les cookies. Il s'agit très probablement de rapports comportant du bruit, générés de façon aléatoire par l'API. Pour vous en assurer, recherchez des rapports de type "verbose" pour le débogage de type source-noised, qui comportent la même clé de débogage source que votre rapport au niveau des événements.

Étape 3: Brève évaluation des pertes

100-70 = il manque 30 rapports de débogage de réussite. Cela signifie que ces 30 conversions (qui ont fait l'objet d'un suivi dans votre configuration basée sur les cookies) n'ont pas été enregistrées dans Attribution Reporting. Vous ne recevrez pas de rapports sur l'attribution les concernant.

Étant donné que vous avez 100 conversions basées sur les cookies et seulement 70 basées sur l'attribution, votre perte est de 30%. Vous avez maintenant une brève évaluation des pertes.

Étape 4: Analyser les causes

Pour savoir 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 l'enregistrement de la source. Utilisez les clés des conversions basées sur les cookies pour les mettre en correspondance avec des rapports de débogage détaillés.

Supposons qu'il existe 10 clés pour lesquelles aucun rapport de débogage détaillé n'est disponible. Vérifiez s'il y a un problème d'intégration. Si ce n'est pas le cas, cela peut être dû au comportement des utilisateurs.
Vous disposez de 20 rapports de débogage détaillés. Vous pouvez maintenant affiner votre analyse des pertes. Analysez le champ type de chaque rapport détaillé. Voici quelques exemples :
- Il manque 10 rapports (10% dans notre exemple) pour la raison suivante : pending destination limit.
- Il manque cinq rapports (= 5%) en raison de l'erreur "trigger-aggregate-no-contributions".
- Il manque cinq rapports (= 5%) en raison de l'erreur "unknown-error".

Étape 5: Prenez les mesures nécessaires et résolvez les problèmes

Maintenant que vous savez pourquoi il manque des rapports, vous pouvez agir en conséquence.

L'action à effectuer dépend de l'attribut type de chaque rapport détaillé. Pour en savoir plus, consultez la documentation de référence sur les rapports de type "verbose". Exemple :

pending-destination-limit est un service de protection de la confidentialité. Aucune action n'est requise de votre part. Utilisez ce numéro comme point de données pour votre propre visibilité et votre surveillance.
trigger-aggregate-no-contributions peut être le signe d'un problème d'implémentation de votre part. Analysez cela plus en détail. Utilisez les détails fournis dans le corps du rapport détaillé pour résoudre ce problème et résoudre ce problème si nécessaire.
unknown-error peut être le signe d'un bug du navigateur ou d'une erreur réseau. Si vous rencontrez ce problème à plusieurs reprises, signalez un bug aux développeurs de navigateurs.