Live Analytics-Endpunkte
In Ergänzung zu live_stream
In diesem Thema behandelte Dimension gibt es auch spezielle Endpunkte zum Abrufen zusätzlicher Analysedaten für Brightcove Live-Streaming-Jobs. Siehe die Analytics-API-Referenz für Details.
URL-Parameter
Analytics-API-Berichte unterstützen die folgenden URL-Parameter.
Parameter | Beschreibung | Erforderlich | Werte | Standardwert |
---|---|---|---|---|
account |
Die Konten, über die Sie berichten möchten | Ja | eine oder mehrere Konto-IDs als durch Kommas getrennte Liste | keiner |
dimensions |
Die Dimension(en), über die berichtet werden soll | Ja | eine oder mehrere Dimensionen als kommagetrennte Liste (einige Kombinationen sind nicht gültig - verwenden Sie das interaktive Tool hier, um festzustellen, ob eine Kombination gültig ist) | keiner |
where |
Wird verwendet, um Filter für Berichte anzugeben | nein | {Dimension}=={Wert} - eine oder mehrere als durch Semikolon getrennte Liste. Der Wert ist ein oder mehrere Werte für die primäre Metrik der betreffenden Dimension. Zum Beispiel: video==video_id , country=country-code , oder viewer=viewer_id (im letzten Fall variiert die Form der viewer_id, je nachdem, ob Sie selbst eine Art von Viewer_ID erfassen und senden, oder abhängig von dem vom Analysesystem generierten Wert). |
keiner |
limit |
Anzahl der zurückzugebenden Artikel | nein | positive ganze Zahl | 10 |
offset |
Anzahl der zu überspringenden Elemente | nein | positive ganze Zahl | 0 |
sort |
Feld zum Sortieren von Elementen | nein | jedes Feld, das von der Anfrage zurückgegeben wird | video_view |
fields |
Felder zum Zurückgeben | nein | variiert je nach Dimension, über die Sie berichten | Video, Videoansicht |
format |
Format, um Ergebnisse in zurückzugeben | nein | json (Standard) | csv | xlxs | json |
reconciled |
Falls vorhanden, werden die Ergebnisse auf historische oder Echtzeitdaten beschränkt. Analysedaten stammen aus mehreren Quellen: Einige werden vom Player gesendet, andere werden von CDNs und dem Video Cloud-System gesammelt. Um Analysen so schnell wie möglich bereitzustellen, beginnen wir mit der Bereitstellung von "Echtzeit"-Daten, sobald diese verfügbar sind, und passen die Analysen später an, wenn Daten aus allen Quellen gesammelt und verarbeitet wurden. Die vollständig verarbeiteten Daten werden als abgestimmte | nein | wahr | falsch | wahr |
from |
Der Anfang des Datumsbereichs für die Anfrage | nein |
Einer der folgenden:
Für Engagement-Endpunkte sind nur Daten innerhalb der letzten 32 Tage zulässig oder wenn reconciled=false. |
-30d |
to |
Das Ende des Zeitraums für die Anfrage | nein |
Einer der folgenden:
Für Engagement-Endpunkte sind nur Daten innerhalb der letzten 32 Tage zulässig oder wenn reconciled=false. |
jetzt |
Verfügbare Felder
Die folgenden Felder können für die Dimension zurückgegeben werden.
bytes_delivered
- Gesamtzahl der für Livestreams gelieferten Bytes, einschließlich des Players und aller zugehörigen Medienorigin_bytes_delivered
- gelieferte Bytes für die Livestreams selbstlive_stream
- ID des Livestreams, falls verfügbar
Filterwerte
Eine Dimension, die als Filter verwendet wird, ermöglicht es Ihnen, die Ergebnisse einzugrenzen.
Filterwerte:
Dimensionen kombinieren
Um zu sehen, mit welchen Dimensionen dies kombiniert werden kann und welche Felder für die Kombination verfügbar sind, siehe Dimension und Felder.
Beispiele anfordern
Maßanfrage
https://analytics.api.brightcove.com/v1/data? accounts=1752604059001&dimensions=live_stream
Anfrage filtern
Unzutreffend
Beispielantwort
{
"Artikel_Zahl": 1,
"Elemente": [
{
„live_stream“: null
}
],
"Zusammenfassung": {}
}}