Débogage et dépannage de la collecte de données

Le débogage de la collecte de données implique de vérifier à la fois le comportement de votre implémentation et ce qui arrive aux données qu’elle envoie. Commencez par le symptôme, puis suivez l’événement à chaque étape de la collecte jusqu’à ce que vous trouviez où il s’arrête de se comporter comme prévu.

La journalisation du débogage expose les commandes SDK, l’exécution des balises, les avertissements et les erreurs dans l’exécution du navigateur ou de l’application. L’inspection des requêtes expose les payloads, les réponses et, pour les workflows pris en charge, le traitement côté serveur. Ces approches se complètent souvent : un journal peut expliquer pourquoi un événement a été retardé, tandis qu’une capture réseau peut montrer si une requête a été envoyée.

Suivre l’événement à travers la collection diagnostic-workflow

Examinez les étapes suivantes dans l’ordre. La preuve qu’une étape a réussi ne prouve pas que les étapes suivantes ont également réussi.

  1. Exécution de l’implémentation : la commande SDK ou la règle de balise s’est-elle exécutée ? Vérifiez les messages de diagnostic et les erreurs. Si la gestion du consentement ou de l’identité retarde un événement, vérifiez cet état avant de rechercher une requête réseau. Voir Activer la journalisation du débogage.
  2. Requête sortante : la requête a-t-elle été envoyée et contenait-elle les données attendues ? Inspectez la payload et comparez-la à vos entrées de commande ou à vos éléments de données. Voir Inspection des requêtes web ou Inspection des requêtes mobiles et de serveur.
  3. Réception du serveur : le point d’entrée de collection a-t-il reçu la requête ? Inspectez la réponse si disponible ou utilisez une trace côté serveur prise en charge. Un journal client indiquant qu’une demande a été envoyée n’est pas une confirmation de réception.
  4. Traitement et routage Edge : l’événement a-t-il utilisé le flux de données prévu et les services configurés ? Pour Web SDK, le paramètre configId de la requête indique le flux de données utilisé et Edge Trace indique comment Edge Network a traité l’événement.
  5. Traitement en aval : la destination a-t-elle accepté et traité l’événement comme prévu ? Utilisez les conseils débogage spécifique au produit de la destination. Une réponse réussie d’Edge Network ne prouve pas que les données sont disponibles dans chaque rapport ou magasin en aval.

Choisir un point de départ choose-a-starting-point

Le tableau suivant présente des preuves utiles pour les tâches courantes. Lorsque les deux approches s’appliquent, elles répondent à différentes parties de l’enquête. Les messages et outils disponibles dépendent de votre SDK, du runtime et des services configurés.

Tâche ou symptôme
Journalisation du débogage
Demander une inspection
Vérification suivante
Un événement attendu n’apparaît pas
Vérifiez l’exécution de la commande ou de la règle, les erreurs et les messages concernant les retards de consentement ou d’identité.
Vérifiez si une requête a été émise et examinez sa payload et sa réponse.
Commencez par journalisation, puis inspecter les requêtes. Pour les symptômes liés à l’identité, voir ​ Dépannage des identités ​.
Une requête contient des données inattendues
Comparez les entrées de commande SDK et l’exécution de la balise aux valeurs que vous aviez l’intention d’envoyer.
Inspectez la payload sortante réelle. Comparez-la à Edge Trace si des transformations sont impliquées.
Vérifiez les éléments de données, les entrées de commande et la configuration du flux de données.
Une requête apparaît annulée pendant la navigation
Vérifiez si le SDK a tenté d’envoyer l’événement ou le retenait toujours.
Inspectez la requête et, si possible, la réponse du serveur ou Edge Trace. Le libellé annulé du navigateur seul n’est pas concluant.
Voir Requêtes abandonnées et documentUnloading de Web SDK.
Les requêtes semblent réussies, mais les données de destination sont manquantes
Définissez la configuration et les entrées utilisées pour l’implémentation. Les journaux client ne peuvent pas confirmer le traitement en aval.
Utilisez Edge Trace, Assurance et des diagnostics spécifiques aux destinations.
Vérifiez le flux de données, les services activés, le routage et le traitement de la destination. Voir Traitement Trace Edge Network et Débogage spécifique au produit.
Les événements apparaissent dupliqués
Recherchez les appels de commande répétés ou l’exécution de la règle de balise.
Comparez les nombres de requêtes, les payloads et les identifiants. Plusieurs demandes de clients ne sont pas la seule source possible de duplication.
Enquêter sur les reprises et la diffusion au moins une fois ainsi que sur l’exécution répétée du client. Voir Gestion de la duplication des événements.
Une implémentation mobile ou serveur se comporte de manière inattendue
Examinez la sortie SDK dans l’exécution de l’application ou du serveur, plutôt que dans la seule console du navigateur.
Utilisez Assurance pour les workflows mobiles pris en charge ou examinez le trafic HTTP de l’application. Les outils du navigateur ne peuvent pas afficher les appels sortants de votre serveur.
Voir Journalisation de Mobile SDK et de Server SDK et Inspecter les requêtes mobiles et de serveur.

Débogage spécifique au produit product-specific

Les articles de cette section s’appliquent à toutes les collectes de données Experience Platform. Les applications Adobe qui reçoivent vos données peuvent utiliser leurs propres points d’entrée, formats de requête, vues de validation et traitement. Après avoir confirmé que l’Edge Network a reçu et acheminé un événement, ou lorsque votre implémentation envoie directement des données à une application, continuez avec les conseils de débogage de cette application :

Poursuivre votre enquête next-steps

Avant de partager des journaux, des traces ou des captures réseau, supprimez les informations d’identification, les identifiants visiteur et d’autres informations sensibles en fonction des politiques de votre entreprise.

recommendation-more-help
experience-platform-help-collection