Collecte de données Debug Analytics
Cet article explique les éléments à vérifier lorsque vous déboguez des données envoyées à Adobe Analytics. Recherchez votre méthode d’implémentation dans le tableau suivant et suivez sa section. Si vous recherchez des données de rapport inattendues, commencez par Comparer des requêtes avec des rapports.
Pour connaître les étapes et les outils qui s’appliquent à toutes les collectes de données Adobe, comme la capture des requêtes réseau, l’activation de la journalisation du débogage et l’enquête sur les requêtes annulées, voir Débogage et dépannage de la collecte de données.
AppMeasurement et l’extension Analytics appmeasurement
Rechercher la requête appmeasurement-find
Capturez les requêtes réseau et filtrez les /b/ss/. Les débogueurs de balises tels qu’Adobe Experience Platform Debugger identifient et décodent ces requêtes pour vous.
Si aucune requête /b/ss/ n’apparaît :
- Recherchez les erreurs JavaScript dans la console du navigateur.
- Si vous utilisez l’extension de balise Analytics, vérifiez que le code incorporé de balise se trouve dans l’élément
<head>de la page et que votre bibliothèque est publiée dans l’environnement que vous testez. Mode de débogage des balises indique si la règle qui envoie l’accès a été déclenchée. - Si vous hébergez vous-même AppMeasurement, ouvrez directement l’URL de la bibliothèque pour confirmer que le fichier se charge et contient du code.
- Désactivez les extensions de navigateur, telles que les bloqueurs d’annonces publicitaires, qui peuvent empêcher l’envoi de requêtes.
- Debugger ne reconnaît pas les requêtes envoyées depuis un iframe. Utilisez plutôt les outils de développement du navigateur . Voir Utilisation d’AppMeasurement avec des iFrames.
Vérifier ce qu’Analytics a reçu appmeasurement-contents
- Suites de rapports : le segment de chemin d’accès après
/b/ss/répertorie les identifiants de suite de rapports qui reçoivent l’accès. Vérifiez qu’il s’agit bien des suites de rapports attendues, par exemple une suite de rapports de développement sur les pages de développement. - Variables : 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
v1et prop1 commec1. Voir la référence de variable. Lorsqu’une requête est trop longue, AppMeasurement l’envoie avec desPOSTHTTP, de sorte que les variables apparaissent dans le corps de la requête au lieu de l’URL. - Type d’accès : les requêtes envoyées par
tl()incluent le paramètrepeet n’incrémentent pas les pages vues. Les demandes envoyées part()n’incluent pas depe.
Si les valeurs sont présentes, mais incorrectes, consultez Dépannage de l’implémentation de JavaScript pour des causes courantes, telles que les guillemets, les majuscules et les espaces.
Vérifier la réponse appmeasurement-response
Une réponse 2xx confirme uniquement que le serveur de collecte de données a reçu la requête, et non que l’accès a été enregistré. Avec le type de réponse par défaut, une requête peut renvoyer un succès même lorsque l’accès est ignoré. Une réponse 302 à la première demande d’un nouveau visiteur est attendue. Voir Codes de réponse HTTP.
AppMeasurement envoie avec navigator.sendBeacon() les demandes de lien de sortie et toutes les demandes lorsqu’useBeacon est activé. Les outils de développement peuvent étiqueter ces requêtes comme annulées même lorsque le navigateur les a envoyées. Pour plus d’informations, consultez la section Demandes abandonnées.
SDK web web-sdk
Rechercher la requête web-sdk-find
Avec Web SDK, le navigateur envoie les événements à Edge Network plutôt que directement à Analytics, de sorte que vous ne voyez pas de requête /b/ss/. Inspectez la requête Edge Network et confirmez les éléments suivants :
- Le paramètre
configIdcorrespond à un flux de données pour lequel le service Adobe Analytics est activé avec les suites de rapports attendues. - La payload est qualifiée de page vue ou d’événement de lien. Analytics ignore les payloads qui ne contiennent ni détails de page, ni type d’interaction web. Voir Types d’événements Edge Network dans Adobe Analytics.
Vérifier ce qu’Analytics a reçu web-sdk-contents
Démarrez une Edge Trace et reproduisez l’action. Recherchez la ligne commençant par Mappage automatique Analytics, puis développez mappedQueryParams et l’identifiant de la suite de rapports en dessous.
- Variables : les valeurs mappées utilisent les mêmes noms de paramètres de requête que les requêtes AppMeasurement, parfois sous une forme abrégée, comme
gnpour le nom de page etplpour les produits. Voir Mappage des champs d’objet XDM et Mappage des champs d’objet de données. - Données contextuelles : les champs XDM qui ne sont pas mappés à une variable Analytics apparaissent comme des données contextuelles avec le préfixe
c.a.x.. Utilisez des règles de traitement pour les affecter à des variables. - Suites de rapports : si vous utilisez des remplacements de suite de rapports, la ligne de configuration du flux de données dans Edge Trace affiche les suites de rapports utilisées par Edge Network.
Traitement des chèques web-sdk-processing
Dans la session Assurance ouverte par Edge Trace, recherchez des hitdebugger dans les événements. Ces événements utilisent l’com.adobe.analytics.hitdebugger du fournisseur et leurs payloads affichent des valeurs après le traitement d’Analytics, telles que l’Experience Cloud ID (mcvisId) et pageName.
Pour une présentation guidée, voir Configuration d’Adobe Analytics avec Adobe Experience Platform Web SDK.
Comparaison des requêtes avec les rapports reports
Un accès qui atteint Analytics n’apparaît pas immédiatement dans les rapports et les valeurs signalées peuvent différer des valeurs de la requête :
- Latence : les données complètes apparaissent généralement dans les rapports environ deux heures après leur collecte. Certaines données, telles que les accès horodatés, peuvent prendre plus de temps. Voir Disponibilité et latence des données .
- Traitement : les règles de traitement, les règles VISTA, les règles de robots et d’autres étapes de traitement peuvent modifier ou exclure des valeurs après la collecte. Voir Ordre de traitement des données dans Adobe Analytics. Les données post-traitées d’Assurance affichent le résultat du traitement d’un accès individuel.
- Suite de rapports : vérifiez que vous affichez la même suite de rapports que celle ciblée par la requête ou le flux de données.
- Valeurs inattendues : si une dimension affiche des pics ou des valeurs inattendus, consultez Collisions de hachage.
Pour des modifications de trafic plus larges, voir Résolution des problèmes liés aux pics et aux baisses de données.