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

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 ?

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 type de 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.

É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-limit est 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-contributions peut ê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-error peut ê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.