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.

NOTE
Les outils répertoriés sur cette page ne sont pas complets. Ils représentent des outils que les clients d’Adobe Analytics ont trouvés utiles. À l’exception des outils fournis par Adobe, Adobe ne prend pas en charge ou ne résout pas ces produits. Consultez l’éditeur de l’outil pour plus d’informations sur l’installation, l’utilisation et le support.

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.

Type d’outil
Utile lorsque
Analytics et débogueurs de balises
Vous souhaitez que les variables Analytics, les balises, les couches de données ou les requêtes de collecte soient interprétées et présentées dans un format lisible par l’utilisateur.
Outils de développement du navigateur
Vous déboguez une implémentation web et souhaitez inspecter directement les requêtes réseau sans installer d’application de débogage distincte.
Proxy de débogage HTTP(S)
Vous souhaitez inspecter le trafic HTTP des navigateurs, des applications mobiles, des vues web, des API ou d’autres clients, ou vous avez besoin de fonctionnalités autres que les outils de développement de navigateur.

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.

Outil
Disponibilité
Utile pour
Considérations
🔗
Extension de navigateur
Déboguer les implémentations de Adobe Experience Platform et de CX Enterprise, y compris Adobe Analytics, les balises, les couches de données et Experience Platform Web SDK
Outil fourni par Adobe axé sur les technologies Adobe
Omnibug ​
Navigateurs basés sur Chromium et Firefox
Décodage d’Adobe Analytics, d’Experience Platform Web SDK, des balises Adobe et des requêtes de nombreux autres fournisseurs d’analyse et de marketing
Utile pour les implémentations contenant des technologies de plusieurs fournisseurs
ObservePoint Debugger
Chrome et Edge
Inspection et décodage des balises d’analyse, de marketing et de mesure, y compris des requêtes Adobe Analytics
Débogueur basé sur un navigateur ; ObservePoint propose également des produits distincts de validation et d’implémentation automatisée
🔗
Application web dans CX Enterprise
Inspecter et valider les événements des implémentations de Mobile SDK et voir comment Edge Network a traité les événements
Outil fourni par Adobe ; connectez votre application à une session Assurance pour afficher ses événements.

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é.

Outil
Utile pour
Charles
Inspection du navigateur, de l’application, de l’appareil mobile et d’autre trafic HTTP(S)
Fiddler Partout
Capture et inspection du trafic HTTP(S) entre les applications et les appareils. Distinct de l’ancien produit Fiddler Classic.
Proxyman ​
Inspection et modification du trafic HTTP(S) provenant des navigateurs, des applications et des appareils mobiles
boîte à outils HTTP
Inspection du trafic provenant des applications, des API, des environnements de développement et des appareils mobiles, avec des workflows orientés vers le débogage des applications et des API
mitmproxy
Interception, inspection et modification HTTP(S) scriptable via des interfaces de ligne de commande et web. Convient mieux aux utilisateurs qui maîtrisent les workflows de ligne de commande.

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.

recommendation-more-help
analytics-help-implement