Vue d'ensemble des analyses et des journaux

Le Verify Analyses et journaux dans les sections Tableau de bord du développeur vous permettent de surveiller, de rechercher et d'analyser l'activité associée à l'API Verify. Ces outils offrent des informations précieuses sur les données des requêtes pour vous aider à comprendre l'utilisation et les performances de votre API.

Dans ce document, vous trouverez des informations sur

• Verify Analytics (en anglais) - des métriques et des données agrégées provenant de votre API Verify.
• Verify Logs (en anglais) - de vos demandes de Verify.

Verify Analytics (en anglais)

Les Verify Analytics (en anglais) vous permet d'étudier et d'analyser des mesures et des données agrégées relatives à l'utilisation et aux performances de l'API Verify.

Dans cette sous-section, vous apprendrez à :

• Accès Verify Analytics page.
• Interpréter Verify Analytics view (en anglais).

Accès à Verify Analytics

Pour accéder à la Verify Analytics (en anglais) page :

1. Aller à la page Tableau de bord du développeur -> Analyse.
2. Cliquez sur Verify V2 Analytics (en anglais).

Verify Analytics View (en anglais)

Une fois que vous avez ouvert le Verify V2 Analytics (en anglais) vous accédez à une vue dédiée qui vous donne un aperçu de l'utilisation et des performances de votre API Verify. Cette vue comprend un résumé de haut niveau du nombre total de demandes, ainsi que des ventilations détaillées par pays et par canal de communication.

Vous avez également la possibilité de télécharger les données sous forme de rapport Excel en sélectionnant l'option Télécharger le rapport bouton.

Onglet "Verify Requests

Les Verify requests fournit des mesures globales pour les requêtes de l'API Verify sur une plage de dates spécifique. Il vous permet de filtrer les résultats à l'aide d'options temporelles prédéfinies ou d'une plage de dates et d'heures personnalisée.

Le graphique présente les mesures :

• Total des demandes - Nombre total de requêtes API Verify effectuées dans la plage de dates sélectionnée.
• Réussite - Nombre de demandes converties (réussies).
• Sans succès - Nombre de demandes autres que réussies (échouées, expirées, rejetées, rejetées par l'utilisateur, annulées, bloquées).

Sous le graphique, le tableau présente les données de la demande ventilées par mois ou par semaine, en fonction du filtre sélectionné. Le tableau comprend :

• Mois - Le mois au cours duquel la (les) demande(s) a (ont) été faite(s).
• Utilisation - Nombre de demandes effectuées au cours de cette période.
• Réussite - Nombre de demandes converties (réussies).
• Sans succès - Nombre de demandes autres que réussies (échouées, expirées, rejetées, rejetées par l'utilisateur, annulées, bloquées).
• Verify fee - Verify : frais de plate-forme uniquement.
• Coût total - Frais de plate-forme Verify plus frais de canal, selon le(s) canal(aux) utilisé(s). Pour les clients qui bénéficient de la tarification Success, le coût total est égal à la redevance Verify puisqu'aucune redevance de canal n'est facturée. Pour les clients qui ne paient pas les frais de Verify, le coût total est uniquement égal aux frais de canal.

Onglet Événements du canal

Les Événements de la chaîne vous permet de voir combien de demandes ont été faites pour chaque canal pris en charge.

Le graphique représente les mesures et vous permet de contrôler les données affichées :

• Produits - Indique le nombre de demandes effectuées par canal. Vous pouvez activer ou désactiver des canaux spécifiques.
• Utilisation du produit:
  • Total des événements - Total des événements réalisés, représenté par les lignes. Affichez ou masquez le nombre total d'événements.
  • Coût - Frais totaux, représentés par les barres. Basculer pour afficher ou masquer les coûts des canaux associés.

Sous le graphique, le tableau présente la répartition des canaux et des pays. Il comprend :

• Pays - Pays pour lesquels des demandes ont été faites (colonne affichée uniquement dans l'onglet Pays).
• Canaux - Canaux pour lesquels des demandes ont été faites.
• Evénements - Nombre total de demandes effectuées pour chaque pays et chaque chaîne.
• Livré - Nombre de demandes ayant abouti.
• Non délivré - Nombre de demandes autres que délivrées (échouées, expirées, rejetées, annulées, bloquées).
• Coût total du canal - Les frais de canal associés. Pour les clients bénéficiant de la tarification au succès, cette valeur est toujours nulle, puisque seuls les frais de Verify sont appliqués.

Verify Logs (en anglais)

Les Verify Logs (en anglais) vous permet d'explorer et d'analyser les transactions de vos demandes Verify.

Dans cette sous-section, vous apprendrez à :

• Accès Page Verify Logs (vérifier les journaux).
• Interpréter les Vue des demandes de vérification de la recherche.
• Interpréter les Tableau des demandes de vérification.

Accès aux journaux de Verify

Pour accéder à la Verify Logs (en anglais) page :

1. Aller à la page Tableau de bord du développeur -> Journaux.
2. Cliquez sur Verify Logs -> Verify V2.

Recherche Demandes de vérification Vue

Après avoir ouvert la page Verify Logs, vous êtes redirigé vers la page Demandes de vérification de recherche vue.

La vue vous permet de rechercher vos journaux par :

• Durée - Recherchez jusqu'à 30 jours de données en utilisant les options du menu déroulant ou en sélectionnant une plage de temps et une date personnalisées. Pour les journaux de plus de 30 jours, vous devez utiliser l'option Reports API.
• Numéro de téléphone - Recherchez les journaux en entrant le numéro "À" et en sélectionnant une plage de temps.
• ID de la demande - Recherche de journaux spécifiques par leurs identifiants de demande.

Après avoir sélectionné vos filtres, le tableau affichant tous les résultats correspondants s'affiche. Étant donné que Verify prend en charge les filtres de différents canauxChaque demande de Verify que vous initiez donne lieu à des demandes distinctes :

• Une pour Verify elle-même, représentée par v2 dans les résultats.
• Un autre pour le(s) canal(aux) spécifique(s) utilisé(s).

C'est pourquoi le tableau indique toujours plusieurs demandes pour chacune des demandes de Verify présentées.

Tableau des demandes de vérification de la recherche

Les Demandes de vérification de recherche Le tableau affiche des informations détaillées pour chaque demande renvoyée par vos filtres.

Les colonnes suivantes figurent dans le tableau des résultats :

• Id de la demande et clé API - Identifie une demande spécifique et sa clé API.
• Date - Heure à laquelle la demande a été faite.
• Numéro de téléphone - Le numéro de téléphone de destination auquel la demande a été adressée.
• Réseau - Le réseau associé au numéro de téléphone.
• Chaîne - Indique le canal auquel la demande appartient :
  • v2 - spécifique à la demande de Verify. Représente l'enregistrement des frais de la plate-forme de vérification.
  • courriel - spécifique à la demande de canal de messagerie.
  • authentification silencieuse - spécifique pour la demande de canal d'authentification silencieuse.
• Statut - Indique l'état des demandes de Verify. Se référer à la page Tableau d'état pour plus de détails sur chaque statut.
• Prix - Concerne la redevance Verify et la redevance de canal associée pour chaque enregistrement individuel.

Interprétation des demandes de vérification de la recherche Tableau

Lors de l'interprétation de la Demandes de vérification de recherche n'oubliez pas que les journaux de Verify affichent chaque demande séparément, même lorsque plusieurs canaux sont utilisés au sein d'un même flux de vérification. Chaque tentative est enregistrée indépendamment, avec son propre canal, son statut, son prix, etc. Par conséquent, une seule vérification peut générer plusieurs enregistrements : un pour la demande v2 et d'autres pour chaque canal impliqué.

Par exemple, lorsque l'authentification silencieuse et le SMS sont utilisés ensemble et que la demande passe de l'authentification silencieuse au SMS, les demandes correspondantes apparaissent séparément :

• La requête silent_auth apparaît avec le statut FAILED.
• La demande de SMS s'affiche avec le statut DELIVERED.

Ce comportement est normal, car chaque tentative de canal est traitée et enregistrée de manière indépendante.

Tableau d'état

Le tableau présente les détails de chaque statut des demandes de Verify :