Qu'est-ce qu'une erreur d'API ?
Les erreurs d'API surviennent lorsque quelque chose ne fonctionne pas dans une requête API, par exemple si un paramètre manque ou que la requête est mal orthographiée. Certaines de ces erreurs peuvent impacter l'expérience utilisateur tandis que d'autres seront indétectables pour les utilisateurs. Monitorer les erreurs d'API permet de vous assurer qu'une baisse des performances de votre site n'est pas due à une requête comportant une erreur ou qui ne répond pas.
Exemple : Si un API de fournisseur de paiement ne répond pas à cause d'une faute d'orthographe dans la requête, alors les utilisateurs seront incapables d'effectuer des achats, ou si un API d'inventaire ne présente pas les bonnes données parce qu'un paramètre manque, les utilisateurs pourraient être en mesure d'acheter des produits qui ne sont en fait pas disponibles, et ainsi de suite...
Configurer le cadre de l'analyse d'erreurs
1. Définissez votre Contexte d'analyse en haut de la page pour voir les erreurs pour la période, le segment et le device de votre choix.
2. Visualisez la liste des sessions impactées par des erreurs. Dans le tableau, vous pouvez voir la liste des groupes d'erreurs qui sont survenues dans le cadre du Contexte d'analyse en vigueur.
3. Recherchez une erreur spécifique ou cliquez sur un onglet différent pour filtrer les erreurs par écrans ou par groupes d'écrans.
Visualiser et examiner les erreurs de la liste globale
Vous pouvez survoler les détails des erreurs et voir les informations techniques les concernant :
- URL de la requête, méthode et code du status pour les erreurs d'API
- Texte de l'erreur
Ouvrez le panneau latéral à l'aide de la flèche ">" et examinez les détails de l'erreur.
Dans le panneau latéral de l'erreur, vous pouvez effectuer les actions suivantes :
- Rejeter l'erreur (uniquement pour les utilisateurs Admin ou Expert)
- Voir les informations générales sur l'erreur
- Copier les détails de l'erreur
- Examiner l'impact de l'erreur grâce au lien direct vers Quantification d'impact et ouvrir le lecteur intégré de Session Replay pour visionner la session durant laquelle l'utilisateur a rencontré l'erreur.
Visualiser et analyser des erreurs d'écrans
Utilisez l'onglet "Erreurs par écrans" pour identifier les erreurs les plus importantes qui se produisent sur des écrans et étudier des KPI spécifiques pour comprendre l'impact de l'erreur.
1. Cliquez sur l'onglet "Erreurs par écrans"
2. Cliquez sur "Voir ___ erreurs" sur la ligne de l'erreur que vous voulez analyser plus en détails.
3. Vous verrez apparaître la liste des erreurs survenues sur cet écran. Ces erreurs sont listées par priorité en fonction de l'opportunité manquée, associée à l'objectif de conversion et au score de signification statistique.
4. Ouvrez le panneau latéral de l'erreur en cliquant sur la flèche ">" et analysez les détails de l'erreur.
Visualiser et analyser des erreurs de groupes d'écrans
1. Cliquez sur l'onglet "Erreurs par groupes d'écrans"
2. Choisissez la cartographie qui convient pour voir quelles erreurs touchent les utilisateurs qui atteignent un groupe d'écrans en particulier.
3. Identifiez le groupe d'écrans avec le plus de conversions perdues (en vous référant aux valeurs dans la colonne des sommes des conversions perdues) et cliquez sur "Voir ___ erreurs" sous le nom du groupe d'écrans.
4. Analysez les détails de l'erreur dans le panneau latéral en cliquant sur la flèche ">".
Appels API que nous collectons
Dans le module d'Analyse des Erreurs de Digital Experience Analytics Mobile, le monitoring des erreurs d'API porte sur deux types d'API basés sur le HTTP, envoyés par l'agent utilisateur (navigateur) vers les serveurs :
- API XMLHttpRequest : l'API le plus couramment utilisé, qui peut être utilisé pour échanger des données entre un agent utilisateur (navigateur) et un serveur.
- API Modern Fetch : similaire à l'API XMLHttpRequest mais avec un ensemble de fonctionnalités plus puissantes et flexibles.
Analyser le code du status
Lire le code du status permet aux développeurs de comprendre rapidement ce qui se passe avec l'application et de vérifier la présence d'erreurs.
Il existe deux principales catégories d'erreurs :
- Les erreurs client --- status 400 à 4xx
- L'erreur provient de la requête initiale envoyée par le navigateur ou l'application web, ce qui signifie qu'elle contient une erreur.
- Ces erreurs sont problématiques, car elles proviennent généralement du code lui-même et que recharger la page ou relancer la requête ne résoudra pas le problème.
- Les erreurs du serveur --- status 500 à 5xx
- L'erreur se déclenche pendant le processus de requête par le serveur, ce qui signifie que le serveur a rencontré une erreur interne et ne peut pas répondre à la requête.
- La plupart des erreurs côté serveur sont temporaires : si l'agent utilisateur envoie la même requête un peu plus tard, en rechargeant la page, celle-ci pourrait bien aboutir.