Überblick über Analysen und Protokolle

Das Verify Analysen und Protokolle Abschnitte im Dashboard für Entwickler ermöglichen Ihnen die Überwachung, Suche und Analyse von Aktivitäten im Zusammenhang mit der Verify API. Diese Tools bieten wertvolle Einblicke in die Anfragedaten und helfen Ihnen, Ihre API-Nutzung und -Leistung zu verstehen.

In diesem Dokument erfahren Sie mehr über:

Analytics verifizieren

Die Analytics verifizieren können Sie aggregierte Metriken und Daten zur Nutzung und Leistung der Verify API untersuchen und analysieren.

In diesem Unterkapitel lernen Sie, wie man:

Zugang Verify Analytics

Für den Zugriff auf die Analytics verifizieren Seite:

  1. Gehen Sie zum Dashboard für Entwickler -> Analytik.
  2. Klicken Sie auf V2 Analytics verifizieren.

Analytics-Ansicht verifizieren

Sobald Sie die V2 Analytics verifizieren Seite gelangen Sie zu einer speziellen Ansicht, die Einblicke in die Nutzung und Leistung Ihrer Verify-API bietet. Diese Ansicht enthält eine Übersicht über die Gesamtanzahl der Anfragen sowie eine detaillierte Aufschlüsselung nach Land und Kommunikationskanal.

Sie haben auch die Möglichkeit, die Daten als Excel-Bericht herunterzuladen, indem Sie die Option Bericht herunterladen Taste.

View of the Verify Analytics page in the Developer Dashboard

Registerkarte "Anfragen verifizieren

Die Anfragen verifizieren Die Registerkarte "Verify API" bietet Gesamtmetriken für Verify-API-Anfragen über einen bestimmten Datumsbereich. Sie können die Ergebnisse anhand vordefinierter Zeitoptionen oder eines benutzerdefinierten Datums- und Zeitbereichs filtern.

Das Diagramm zeigt die Metriken:

  • Erfolgreich - Anzahl der umgewandelten (erfolgreichen) Anfragen. Sie können sie ein- oder ausschalten.
  • Erfolglos - Anzahl der Anfragen, die nicht erfolgreich waren (fehlgeschlagen, abgelaufen, abgelehnt, user_rejected, abgebrochen, blockiert). Sie können sie ein- oder ausschalten.
View of the Verify Requests Tab in the Developer Dashboard

Unterhalb des Diagramms werden in der Tabelle die Anfragedaten je nach gewähltem Filter nach Monaten oder Wochen aufgeschlüsselt dargestellt. Die Tabelle enthält:

  • Monat - Der Monat, in dem der Antrag/die Anträge gestellt wurden.
  • Land - Land, für das die Anträge gestellt wurden.
  • Zählen Sie - Numbers der in diesem Zeitraum gestellten Anträge.
  • Erfolgreich - Numbers der umgewandelten (erfolgreichen) Anfragen.
  • Erfolglos - Numbers of requests other than successful (failed, expired, rejected, user_rejected, canceled, blocked).
  • Gebühr verifizieren - Nur die Plattformgebühr verifizieren.
  • Kosten - Verify-Plattformgebühr plus die Kanalgebühr, je nachdem, welche(r) Kanal(e) verwendet wird/werden. Für Kunden mit Erfolgstarif sind die Gesamtkosten gleich der Verify-Gebühr, da keine Kanalgebühr erhoben wird. Für Kunden, die die Verify-Gebühr nicht zahlen, entsprechen die Gesamtkosten nur der Kanalgebühr.
View of the Verify Requests Table in the Developer Dashboard

Registerkarte Kanalereignisse

Die Veranstaltungen nach Kanal Auf der Registerkarte können Sie sehen, wie viele Anfragen für jeden unterstützten Kanal gestellt wurden.

View of the Verify Events by Channel tab in the Developer Dashboard

Das Diagramm stellt die Metriken dar und ermöglicht es Ihnen, zu steuern, welche Daten angezeigt werden:

  • Kanäle - Gibt die Kanäle an. Sie können bestimmte Kanäle ein- oder ausschalten.
  • Anfragen an - Gibt an, wie viele Anfragen pro Kanal gestellt wurden.

Unterhalb des Diagramms zeigt die Tabelle eine Aufschlüsselung nach Kanälen. Sie umfasst:

  • Kanal - Gibt den Kanal an.
  • Zählen Sie - Numbers der Anfragen, die für einen bestimmten Kanal gestellt wurden.
  • Erfolgreich - Numbers der umgewandelten (erfolgreichen) Anfragen.
  • Erfolglos - Numbers of requests other than successful (failed, expired, rejected, user_rejected, canceled, blocked).
  • Kosten - Verify-Plattformgebühr plus die Kanalgebühr, je nachdem, welche(r) Kanal(e) verwendet wird/werden. Für Kunden mit Erfolgstarif sind die Gesamtkosten gleich der Verify-Gebühr, da keine Kanalgebühr erhoben wird. Für Kunden, die die Verify-Gebühr nicht zahlen, entsprechen die Gesamtkosten nur der Kanalgebühr.

Veranstaltungen nach Land

Die Veranstaltungen nach Land können Sie sehen, wie viele Anfragen pro Land gestellt wurden.

View of the Verify Events by Country tab in the Developer Dashboard

Das Diagramm stellt die Metriken dar und ermöglicht es Ihnen, zu steuern, welche Daten angezeigt werden:

  • Länder - Gibt die Länder an. Sie können bestimmte Länder ein- oder ausschalten.
  • Kanäle - Gibt an, wie viele Anfragen pro Land gestellt wurden.

Die unbekannt_email zeigt die Verwendung von E-Mail-Ländern an, denen kein Land zugeordnet ist.

Unterhalb des Schaubilds enthält die Tabelle eine Aufschlüsselung nach Ländern. Sie umfasst:

  • Land - Land, für das die Anträge gestellt wurden.
  • Zählen Sie - Numbers der für ein bestimmtes Land gestellten Anträge.
  • Erfolgreich - Numbers der umgewandelten (erfolgreichen) Anfragen.
  • Erfolglos - Numbers of requests other than successful (failed, expired, rejected, user_rejected, canceled, blocked).
  • Kosten - Verify-Plattformgebühr plus die Kanalgebühr, je nachdem, welche(r) Kanal(e) verwendet wird/werden. Für Kunden mit Erfolgstarif sind die Gesamtkosten gleich der Verify-Gebühr, da keine Kanalgebühr erhoben wird. Für Kunden, die die Verify-Gebühr nicht zahlen, entsprechen die Gesamtkosten nur der Kanalgebühr.

Veranstaltungen nach Netzwerk

Die Veranstaltungen nach Netzwerk können Sie sehen, wie viele Anfragen für jedes Netz gestellt wurden.

View of the Verify Events by Network tab in the Developer Dashboard

Das Diagramm stellt die Metriken dar und ermöglicht es Ihnen, zu steuern, welche Daten angezeigt werden:

  • Netzwerke - Gibt die Netzwerke an. Sie können bestimmte Netzwerke ein- oder ausschalten.
  • Anfragen an - Gibt an, wie viele Anfragen pro Netz gestellt wurden.

Die UNBEKANNT zeigt die Verwendung von E-Mail-Ländern an, denen kein Land zugeordnet ist.

Unterhalb des Diagramms enthält die Tabelle eine Aufschlüsselung nach Netzen. Sie umfasst:

  • Netzwerk - Netz, für das Anträge gestellt wurden.
  • Land - Land, für das die Anträge gestellt wurden.
  • Zählen Sie - Numbers der für ein bestimmtes Netz gestellten Anträge.
  • Erfolgreich - Numbers der umgewandelten (erfolgreichen) Anfragen.
  • Erfolglos - Numbers of requests other than successful (failed, expired, rejected, user_rejected, canceled, blocked).
  • Kosten - Verify-Plattformgebühr plus die Kanalgebühr, je nachdem, welche(r) Kanal(e) verwendet wird/werden. Für Kunden mit Erfolgstarif sind die Gesamtkosten gleich der Verify-Gebühr, da keine Kanalgebühr erhoben wird. Für Kunden, die die Verify-Gebühr nicht zahlen, entsprechen die Gesamtkosten nur der Kanalgebühr.

Logs verifizieren

Die Logs verifizieren können Sie die Transaktionen Ihrer Verify-Anfragen untersuchen und analysieren.

In diesem Unterkapitel lernen Sie, wie man:

Der Abschnitt Verify-Protokolle enthält nur Ergebnisse für die Kanäle Verify (v2), Stille Authentifizierung und E-Mail. Protokolle für RCS, SMS, WhatsApp und Voice werden in den jeweiligen Protokollabschnitten im Fenster Dashboard für Entwickler. Bitte beachten Sie, dass RCS- und WhatsApp-Protokolle unter "Nachrichtenprotokolle" angezeigt werden.

Zugang zu Verify-Protokollen

Für den Zugriff auf die Logs verifizieren Seite:

  1. Gehen Sie zum Dashboard für Entwickler -> Protokolle.
  2. Klicken Sie auf Verify Logs -> Verify V2.

Suche Überprüfungsanfragen Ansicht

Nachdem Sie die Seite Verify Logs geöffnet haben, werden Sie auf die Seite Suche nach Verifizierungsanfragen Ansicht.

View of the Verify Logs page in the Developer Dashboard

Die Ansicht ermöglicht es Ihnen, Ihre Protokolle nach bestimmten Kriterien zu durchsuchen:

  • Zeitspanne - Suchen Sie nach Daten von bis zu 30 Tagen, indem Sie die Optionen aus der Dropdown-Liste verwenden oder einen benutzerdefinierten Zeitbereich und ein Datum auswählen. Für Protokolle, die älter als 30 Tage sind, müssen Sie die Option Reports API.
  • Telefon-Nummer - Suchen Sie nach Protokollen, indem Sie die "Bis"-Nummer eingeben und einen Zeitbereich auswählen.
  • ID anfordern - Suche nach bestimmten Protokollen anhand ihrer Request IDs.

Nachdem Sie Ihre Filter ausgewählt haben, wird die Tabelle mit allen passenden Ergebnissen angezeigt. Da Verify Folgendes unterstützt verschiedene KanäleJede Verify-Anfrage, die Sie starten, führt zu unterschiedlichen Anfragen:

  • Eine für Verify selbst, dargestellt durch v2 in den Ergebnissen.
  • Eine weitere(n) für den/die spezifischen Kanal/Kanäle, der/die verwendet wird/werden.

Aus diesem Grund werden in der Tabelle immer mehrere Anfragen für jede der gestellten Verify-Anfragen angezeigt.

Die Ansicht Verifizierungsanfragen suchen enthält nur Ergebnisse für die Kanäle Verify (v2), Stille Authentifizierung und E-Mail. Protokolle für RCS, SMS, WhatsApp und Voice werden in den jeweiligen Protokollabschnitten in der Ansicht Dashboard für Entwickler. Bitte beachten Sie, dass RCS- und WhatsApp-Protokolle unter "Nachrichtenprotokolle" angezeigt werden.

Tabelle der Suchüberprüfungsanfragen

Die Suche nach Verifizierungsanfragen Die Tabelle zeigt detaillierte Informationen zu jeder von Ihren Filtern zurückgegebenen Anfrage.

View of the Verify Logs Table in the Developer Dashboard

In der Tabelle mit den Ergebnissen finden Sie die folgenden Spalten:

  • Anfrage-ID & API-Schlüssel - Identifiziert eine bestimmte Anfrage und ihren API-Schlüssel.
  • Datum - Zeitpunkt, zu dem der Antrag gestellt wurde.
  • Telefon-Nummer - Die Zielrufnummer, an die die Anfrage gerichtet wurde.
  • Netzwerk - Das mit der Rufnummer verbundene Netz.
  • Kanal - Zeigt an, zu welchem Kanal die Anfrage gehört:
    • v2 - spezifisch für die Verify-Anfrage. Stellt den Gebührensatz für die Verify-Plattform dar.
    • E-Mail - spezifisch für die Anfrage des E-Mail-Kanals.
    • stille Autorisierung - spezifisch für die Kanalanforderung "Stille Authentifizierung".
  • Status - Zeigt den Status der Verify-Anfragen an. Beziehen Sie sich auf die Status-Tabelle für Einzelheiten zu den einzelnen Status.
  • Preis - Bezieht sich auf die Verify-Gebühr und die damit verbundene Kanalgebühr für jeden einzelnen Datensatz.

Interpretation der Tabelle der Suchüberprüfungsanfragen

Bei der Interpretation der Suche nach Verifizierungsanfragen In der Tabelle "Verify" wird jede Anfrage separat protokolliert, auch wenn mehrere Kanäle in einem einzigen Prüfvorgang verwendet werden. Jeder Versuch wird unabhängig protokolliert, mit eigenem Kanal, Status, Preis usw. Folglich kann eine einzelne Verifizierung mehrere Protokolleintragungen erzeugen: eine für die v2-Anfrage und weitere für jeden beteiligten Kanal.

Wenn z. B. die stille Authentifizierung und SMS zusammen verwendet werden und die Anfrage von der stummen Authentifizierung zur SMS übergeht, werden die entsprechenden Anfragen getrennt angezeigt:

  • Die silent_auth-Anfrage erscheint mit dem Status FAILED.
  • Die SMS-Anfrage erscheint mit dem Status DELIVERED.

Dieses Verhalten ist zu erwarten, da jeder Kanalversuch unabhängig verarbeitet und protokolliert wird.

Status-Tabelle

In der Tabelle sind die Details für jeden Status von Verify-Anfragen aufgeführt:

Status Beschreibung
SUCCESS Eine kostenpflichtige Transaktion, die bestätigt, dass die Authentifizierungsanfrage erfolgreich abgeschlossen wurde.
DELIVERED Eine kostenpflichtige Transaktion, die anzeigt, dass der ausgewählte Kanal erfolgreich abgeschlossen und der Benutzer authentifiziert wurde.
FAILED Eine nicht gebührenpflichtige Transaktion, die einen endgültigen Status erreicht, aber die Authentifizierung nicht erfolgreich abgeschlossen hat.
EXPIRED Der Authentifizierungsablauf hat keinen endgültigen Status erreicht. Dies kann vorkommen, wenn die Benutzer nicht über ausreichende mobile Daten verfügen, um den Fluss abzuschließen (im Falle einer stillen Authentifizierung), oder wenn der Fluss ausgelöst wurde, aber aufgrund fehlender Eingaben oder unzureichenden Fortschritts bei der Initiierung stecken bleibt.
USER_REJECTED Das bei der Verifizierung eingegebene OTP war falsch. Der Benutzer kann bis zu drei Versuche für OTP-basierte Kanäle unternehmen.
CANCELLED Der Überprüfungsprozess wurde abgebrochen, bevor ein endgültiger Status erreicht wurde.
BLOCKED Die Überprüfung wurde aufgrund von Betrugspräventionsmechanismen wie Conversion Alerts (Velocity-Regeln) oder Fraud Defender-bezogenen Ablehnungen gestoppt. Hinweis: Ein Teil des Überprüfungsverkehrs kann automatisch durch Betrugspräventionsregeln blockiert werden, die in Fraud Defender konfiguriert sind. Beachten Sie die Dokumentation zu Fraud Defender für Einzelheiten zu Konvertierungswarnungen und automatischen Netzsperren.