Berichte über die Nutzung

Die Reports API kann aufschlussreiche Daten über Ihre Video API Nutzung. Nutzen Sie diese Daten zur Vereinfachung der Kundenabrechnung, zum Vergleich von Nutzungsmustern und zur Verbesserung Ihrer Business Intelligence, indem Sie Rohdaten in umsetzbare Wachstumsstrategien verwandeln.

Einen Bericht generieren

Die Reports API bietet detaillierte Dokumentation um Sie bei der Erstellung von Berichten für Ihre Video API Projekt oder einem anderen Vonage Projekt. Es enthält Schritt-für-Schritt-Anleitungen, Code-Schnipsel und Tutorials, die Sie beim Abrufen und Analysieren Ihrer Daten unterstützen.

Um Informationen über die Verwendung der Video API in Ihrem Projekt abzurufen, fügen Sie Folgendes ein VIDEO-API als Produktparameter bei der Erstellung des Berichts.git

Wie Sie Ihre Daten interpretieren

Arten von Veranstaltungen

Hier finden Sie eine Liste der häufigsten Ereignisse und ihre Bedeutung:

  • Rundfunk und Fernsehen: Zeigt den Beginn einer Übertragung an. Übertragungen können verwendet werden, um Inhalte in Echtzeit an mehrere Teilnehmer zu streamen.
  • Abonnenten-Minuten: Verfolgt die Gesamtminuten, die ein Teilnehmer mit einer Sitzung verbunden ist. Nützlich für Nutzungsmetriken und Abrechnungsberechnungen.
  • Video-Sitzung: Stellt den Beginn einer Video API-Sitzung dar, in der sich die Teilnehmer treffen, interagieren und Audio/Video austauschen. Dieses Ereignis kann mehrfach für dieselbe Sitzung ausgelöst werden, wenn mehrere meeting_id erzeugt werden.
  • Archivierung: Zeigt an, dass die Audio-, Video- oder Daten einer Sitzung aufgezeichnet und zum späteren Abruf gespeichert wurden.
  • HLS: Zeigt den Beginn einer HLS-Übertragung an. Bitte beachten Sie, dass HLS-Ereignisse mit einer Verzögerung von bis zu 2,5 Stunden erscheinen können, wenn die DVR-Funktion aktiviert ist.
  • SIP-Zusammenschaltung: Verfolgt die Nutzung durch SIP-Interconnect-Anrufe, die PSTN/SIP-Endpunkte mit einer Video API-Sitzung verbinden.
  • Audio-Anschluss: Accounts für Minuten, die von Audio Connector verbraucht werden, der Sitzungsaudio an externe AI- oder Telefondienste streamt.
  • Live-Unterschriften: Erfasst die Verwendung, wenn Live Captions aktiviert sind, um eine Echtzeit-Transkription innerhalb einer Sitzung zu ermöglichen.
  • Komponist erleben: Zeigt an, dass der Experience Composer zum Stream hinzugefügt wurde.

Ereignis-Eigenschaften

account_id: Die eindeutige Kennung Ihres Accounts.

feature_name: Der Name des verfolgten Ereignisses. Einige Ereignisse sind rein informativ, während andere zusätzliche Daten enthalten, die mehr Kontext über das Ereignis liefern.

session_id: Die eindeutige Kennung einer Video API-Sitzung, in der sich die Teilnehmer treffen und unterhalten. Sitzungen können als virtuelle Räume betrachtet werden. Zu finden in den Ereignissen "Videositzung".

meeting_id: Die eindeutige Kennung einer Besprechung, die automatisch innerhalb einer Sitzung erstellt wird, wenn Teilnehmer hinzukommen. Wenn eine Sitzung leer wird und Teilnehmer später hinzukommen, wird eine neue Sitzungs-ID erstellt. Diese Kennung wird ausschließlich zur Verfolgung der Sitzungsnutzung in Berichten verwendet.

subscriber_id: Die eindeutige Kennung eines Benutzers, der eine Sitzung abonniert hat. Verfügbar für feature_name Werte Subscriber_Minutes, SIP_Interconnect, Audio_Connectorund Live_Captions.

archive_id: Der eindeutige Bezeichner einer aus einer Sitzung archivierten Datei.

broadcast_id: Der eindeutige Bezeichner einer Sendung. Er kann verwendet werden, um detaillierte Informationen über diese Sendung abzurufen.

hls_id: Die Kennung des HLS Broadcast-Ereignisses. Er entspricht dem Broadcast-Identifikator.

composer_id: Die eindeutige ID für den Experience Composer, der in der Sitzung verwendet wird.

application_id: Die eindeutige Kennung der Anwendung, die das Ereignis ausgelöst hat.

duration: Bei zeitrelevanten Ereignissen die Zeitdauer des Ereignisses.

date_start: Das Datum und die Uhrzeit, zu der das Ereignis ausgelöst wurde.

date_end: Bei Ereignissen mit einer Dauer das Datum und die Uhrzeit, zu der das Ereignis endete. Bei Ereignissen ohne Dauer entspricht dies date_start.

total_price: Die mit dem Ereignis verbundenen Gesamtkosten. Bei Veranstaltungen ohne Kosten ist dieses Feld 0. Die Währung für diesen Betrag wird im Feld currency Eigentum.

currency: Die Währung, in der das Ereignis total_price ausgedrückt wird.

id: Eindeutige Kennung des Ereignisses.

Zusätzliche Ressourcen

  • Reports API: Erfahren Sie, wie Sie Berichte für Ihre Vonage-Applikationen erstellen können.