Traduit de l'anglais à l'aide de l'IA
Veuillez noter que cet article a été traduit à l'aide de la technologie IA. Bien que nous travaillions à maintenir l'exactitude, certains détails peuvent ne pas refléter parfaitement le texte original. Si vous avez des doutes sur une information, veuillez vous référer à la version anglaise.
Qu'est-ce qu'une erreur d'API ?
Les erreurs d'API se produisent lorsque quelque chose ne va pas avec une requête API, par exemple s'il manque un paramètre ou s'il y a une faute de frappe. Certaines de ces erreurs peuvent affecter l'expérience utilisateur tandis que d'autres passent inaperçues pour les utilisateurs. Le suivi des erreurs d'API aide à s'assurer qu'une baisse de performance de votre site n'est pas due à un problème avec une requête API non réactive ou erronée.
Exemple : Si une API de fournisseur de paiement ne répond pas en raison d'une faute de frappe dans la requête, alors un utilisateur ne pourra pas finaliser son achat ; ou si une API d'inventaire ne montre pas les bonnes données parce qu'un paramètre est manquant, les utilisateurs pourraient être en mesure d'acheter un produit non disponible ; et ainsi de suite.
Configurer votre domaine d'analyse des erreurs
1. Définissez votre contexte d'analyse en haut de la page pour voir les erreurs pour les appareils, périodes et segments sélectionnés.
2. Consultez la liste des sessions impactées par des erreurs. Dans ce tableau, vous pouvez voir la liste des erreurs groupées qui se sont produites dans le cadre de votre Contexte d'analyse.
3. Recherchez une erreur spécifique ou cliquez sur un autre onglet pour filtrer par Erreurs par Écran ou Erreurs par Groupe d'Écrans.
Voir et enquêter sur les erreurs à partir d'une liste globale
Vous pouvez survoler les détails de l'erreur pour voir les détails techniques de l'erreur :
- URL de la requête, méthode et code d'état pour les erreurs d'API
- Texte de l'erreur
Enquêtez sur les détails de l'erreur en utilisant la '><' flèche pour ouvrir le panneau latéral.
Dans le panneau latéral des erreurs, vous pouvez effectuer les actions suivantes :
- Ignorer l'erreur (rôles d'administrateur ou d'utilisateur expert uniquement)
- Voir les détails généraux de l'erreur
- Copier les détails de l'erreur
- Enquêter sur l'impact de l'erreur avec un lien direct vers l'Impact Quantification et ouvrir le lecteur intégré pour voir la session où l'utilisateur a rencontré l'erreur.
Voir et enquêter sur les erreurs à partir des écrans
Utilisez l'onglet ‘Erreurs par Écran’ pour identifier les principales erreurs se produisant sur les écrans et approfondir des KPI spécifiques pour comprendre l'impact de l'erreur.
1. Cliquez sur l'onglet 'Erreurs par Écrans'
2. Cliquez sur ‘Voir ___ erreurs’ de la ligne d'erreur que vous souhaitez examiner plus en détail.
3. Vous verrez une liste d'erreurs qui se sont produites sur cet écran. Ces erreurs sont priorisées en fonction de l'opportunité manquée associée à l'objectif de conversion et de son importance statistique.
4. Enquêtez sur les détails de l'erreur en utilisant la '><' flèche pour ouvrir le panneau latéral.
Voir et enquêter sur les erreurs à partir des Groupes d'Écrans
1. Cliquez sur l'onglet 'Erreurs par Groupes d'Écrans'
2. Choisissez le mapping pertinent pour voir quelles erreurs impactent les utilisateurs qui ont atteint ce groupe d'écrans spécifique
3. Identifiez le groupe de pages avec les plus fortes conversions perdues (en utilisant les valeurs dans la colonne de somme des conversions perdues) et cliquez sur 'Voir ___ erreurs' sous le nom du groupe d'écrans.
4. Enquêtez sur les détails de l'erreur en utilisant la ‘>' flèche pour ouvrir le panneau latéral.
5. Vous pouvez facilement accéder à Session Replay, Impact Quantification et Journey Analysis.
Appels d'API que nous collectons
Dans l'analyse des erreurs (Applications), le suivi des erreurs d'API suit deux types d'APIs basées sur HTTP, envoyées par l'agent utilisateur (navigateur) aux serveurs :
- API XMLHttpRequest : L'API la plus couramment utilisée, qui peut être utilisée pour échanger des données entre un agent utilisateur (navigateur) et un serveur.
- API Fetch moderne : Semblable aux APIs XMLHttpRequest mais avec un ensemble de fonctionnalités plus puissant et flexible.
Enquêter sur le code d'état
En lisant les codes d'état, les développeurs peuvent rapidement voir ce qui se passe avec l'application et vérifier rapidement les erreurs.
Il existe deux catégories principales d'erreurs :
- Erreurs client --- statut 400 à 4xx
- L'erreur provient de la requête initiale envoyée par le navigateur/application web, ce qui signifie qu'elle contient une erreur.
- Ces erreurs sont plus problématiques, car l'erreur provient du code lui-même dans la plupart des cas, et recharger la page ou renvoyer la requête ne résoudra pas le problème.
- Erreurs serveur --- statut 500 à 5xx
- L'erreur se produit pendant le traitement de la requête par le serveur, ce qui signifie que le serveur a rencontré une erreur interne et ne peut pas résoudre la requête.
- La plupart des erreurs côté serveur sont temporaires, si l'agent utilisateur envoie la même requête plus tard, en rechargeant la page, la requête pourrait réussir.