Outils de débogage pour les implémentations Analytics
Les outils de débogage, parfois appelés analyseurs de paquets ou renifleurs de paquets, vous permettent d’inspecter les données envoyées par votre implémentation à Adobe. Ils peuvent vous aider à confirmer que les requêtes se déclenchent avec succès, à inspecter les variables et les payloads incluses dans ces requêtes et à résoudre les problèmes de comportement d’implémentation inattendu.
Choisir un outil de débogage
Les catégories suivantes peuvent vous aider à sélectionner un outil en fonction de ce que vous souhaitez inspecter.
Analytics et les débogueurs de balises
Analytics et les débogueurs de balises reconnaissent les technologies d’analyse et interprètent leurs requêtes. Ces outils peuvent faciliter l’identification des variables Adobe Analytics, des payloads Experience Platform Web SDK, des balises et des informations d’implémentation associées sans décoder manuellement les requêtes réseau.
Outils de développement de navigateur
Chaque navigateur moderne comprend des outils de développement qui peuvent inspecter les requêtes réseau. Vous n’avez donc souvent pas besoin d’un outil distinct pour déboguer une implémentation web. Appuyez sur F12 ou Ctrl+Maj+I (Windows et Linux) ou Cmd+Option+I (macOS), puis sélectionnez l’onglet Réseau. Dans Safari, commencez par activer les fonctionnalités de développement dans les paramètres avancés de Safari.
Proxy de débogage HTTP(S)
Les proxys de débogage HTTP interceptent le trafic HTTP et HTTPS entre un client et un serveur. Ils sont utiles lorsque les outils de développement du navigateur ne fournissent pas suffisamment de visibilité ou lorsque l’implémentation s’exécute en dehors d’un navigateur web traditionnel.
L’inspection HTTPS nécessite généralement la configuration du client pour qu’il approuve un certificat fourni par le proxy de débogage. Suivez les politiques de sécurité de votre entreprise lors de l’installation de certificats ou de l’interception du trafic chiffré.
Localisation des requêtes Adobe Analytics
Pour les implémentations qui envoient directement des données à Adobe Analytics, telles qu’AppMeasurement, filtrez les requêtes réseau pour :
/ss/
Les requêtes de collecte Adobe Analytics contiennent des variables Analytics dans l’URL de requête ou la payload. Les requêtes brutes utilisent des noms de paramètres de requête plutôt que des noms de variables ; par exemple, eVar1 apparaît comme v1 et prop1 comme c1. Les débogueurs Analytics décodent ces noms pour vous. Pour les décoder vous-même, consultez la référence de variable dans la documentation de l’API Data Insertion.
Pour les codes d’état HTTP renvoyés par les serveurs de collecte de données Analytics, consultez Codes de réponse HTTP dans la documentation de l’API Data Insertion.
Pour les implémentations qui utilisent Adobe Experience Platform Web SDK, filtrez les requêtes réseau pour :
/ee/
Sélectionnez la requête et examinez sa payload pour afficher les données envoyées à Adobe Experience Platform Edge Network. Le SDK Web envoie des données à Edge Network, qui peut ensuite les transférer vers Adobe Analytics et d’autres services configurés. L’inspection de la requête du client vérifie ce que le navigateur a envoyé à Edge Network ; elle ne confirme pas en elle-même que les données ont été traitées avec succès par chaque service en aval. Pour voir comment Edge Network a traité un événement, utilisez Adobe Experience Platform Assurance.
Requêtes abandonnées
Lorsqu’une page quitte l’application, le navigateur peut annuler les requêtes qui sont toujours en cours. Firefox classe ces requêtes NS_BINDING_ABORTED ; Chrome et Edge les classent (canceled). Pour que les requêtes restent visibles après la navigation, activez Conserver le journal (Chrome et Edge) ou Conserver les journaux (Firefox).
Une demande annulée ne signifie pas nécessairement que des données ont été perdues. Le navigateur a peut-être envoyé la requête complète et cessé d’attendre uniquement la réponse. Les outils de développement de navigateur ne peuvent généralement pas afficher la différence, mais un proxy de débogage HTTP peut l’afficher.
Les requêtes envoyées avec navigator.sendBeacon() ne sont pas annulées lors de la navigation. AppMeasurement utilise des sendBeacon pour les liens de sortie et chaque fois que le useBeacon est activé. Le Web SDK l’utilise pour les événements envoyés avec documentUnloading. Si les demandes de suivi des liens sont fréquemment annulées, utilisez ces options.