video
Abmessungen. Die video
Dimension bietet Analysen per Video. HINWEIS: Wenn Sie ein „Video“ -Felder (z. B. video.name
) in die Antwort aufnehmen möchten, müssen Ihre Client-Anmeldeinformationen das CMS enthalten: Erlaubnis zum Lesen von Videos. Beachten Sie auch, dass Sie zwar nicht zurückkehren können video.custom_fields
, aber zurückkehren können video.custom_fields.{field_name}
.URL-Parameter
Analytics-API-Berichte unterstützen die folgenden URL-Parameter.
Parameter | Beschreibung | Erforderlich | WERTE | Default |
---|---|---|---|---|
account |
Die Konten, über die Sie berichten möchten | yes | eine oder mehrere Konto-IDs als kommagetrennte Liste | kein |
dimensions |
Die Dimension (en), über die berichtet werden soll | yes | eine oder mehrere Dimensionen als kommagetrennte Liste (einige Kombinationen sind nicht gültig) | kein |
where |
Dient zur Angabe von Filtern für Berichte | Nein | {dimension} == {value} - eine oder mehrere als durch Semikolon getrennte Liste | kein |
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 | ein gültiges Feld für die Anfrage | video_view |
fields |
Felder für die Rückgabe | Nein | variiert je nach Dimension, über die Sie berichten | video_view |
format |
Formatieren, um Ergebnisse zurückzugeben | Nein | json | CSV | xln | JSON |
reconciled |
Wenn enthalten, werden die Ergebnisse auf historische oder Echtzeitdaten beschränkt | Nein | true | falsch | true |
from |
Der Anfang des Datumsbereichs für die Anfrage | Nein | Ein ISO 8601-Datum (JJJJ-MM-TT), Epochenzeit in Millisekunden, die Zeichenfolge alltime oder das relative Datum (-1m); nur Daten innerhalb der letzten 32 Tage sind für Engagement-Endpunkte zulässig oder wenn abgestimmt wurde=false. | 30 Tage vor dem Jetzt |
to |
Das Ende des Datumsbereichs für die Anfrage | Nein | Ein ISO-8601-Datum (YYYY-MM-DD), eine Epochenzeit in Millisekunden, jetzt die Zeichenfolge oder relative Daten (+7d); nur Daten innerhalb der letzten 32 Tage sind für Engagement-Endpunkte zulässig oder wenn abgestimmt wurde=false. | jetzt |
Verfügbare Felder
Die folgenden Felder können für die Dimension zurückgegeben werden.
ad_mode_begin
- wie oft der Spieler in den Anzeigenmodus gewechselt istad_mode_complete
- wie oft der Spieler den Anzeigenmodus abgeschlossen hatbytes_delivered
- Gesamtbytes, die für den Player und die zugehörigen Medien an Client-Computer geliefert werdenengagement_score
- Der Engagement-Wert für ein Videoplay_request
- Gesamtzahl der Beantragung der Videowiedergabeplay_rate
- die durchschnittliche Wiedergaberate (Videoaufrufe geteilt durch Impressionen) für ein Videovideo
- Die Video-IDvideo_duration
- die Videodauer (falls gemeldet)video_engagement_1
- die Anzahl der Aufrufe am 1-Prozent-Punkt des Videosvideo_engagement_100
- die Gesamtzahl der Aufrufe zum 100-Prozent-Punkt der Videodauervideo_engagement_25
- die Gesamtzahl der Aufrufe zum 25-Prozent-Punkt der Videodauervideo_engagement_50
- die Gesamtzahl der Aufrufe zum 50-Prozent-Punkt der Videodauervideo_engagement_75
- die Gesamtzahl der Aufrufe zum 75-Prozent-Punkt der Videodauer <video_impression
- die Gesamthäufigkeit, mit der das Video in Player geladen wurdevideo_name
- der Name des Videos zum Zeitpunkt des letzten Eindrucks im Zeitrahmenvideo_percent_viewed
- die Summe des Prozentsatzes des Videos, das für alle Videoaufrufe angesehen wird. Wenn es beispielsweise zwei Ansichten in der Periode gäbe und der in einer Ansicht betrachtete Prozentsatz 78% und in der anderen 59% betrug, würde dervideo_percent_viewed
zurückgegebene Wert sein 137.video_seconds_viewed
- Gesamtzahl der Sekunden für jede Videoansichtvideo_view
- wie oft die Videowiedergabe begannvideo.reference_id
- Die Referenz-ID des Videosvideo.name
- Der aktuelle Name des Videosvideo.description
- Die aktuelle Beschreibung des Videosvideo.complete
- ob die Videoverarbeitung abgeschlossen istvideo.created_at
- das Datum/die Uhrzeit der Erstellung des Videosvideo.duration
- Die aktuelle Dauer des Videosvideo.economics
- ob das Video für Anzeigen aktiviert istvideo.long_description
- Die ausführliche Beschreibung des Videosvideo.state
- ob das Video gerade istACTIVE
oderINACTIVE
video.tags
- Die Stichworte des Videosvideo.updated_at
- Datum/Uhrzeit, als das Video zuletzt geändert wurdevideo.custom_fields.{field_name}
- Wert für das benutzerdefinierte Feld des Videos mit dem Namen{field_name}
video_download_request
- Anzahl der Download-Anfragen für ein Video, das für die Offline-Wiedergabe aktiviert istvideo_download_complete
- Anzahl der Zeiten, die ein Video für die Offline-Wiedergabe vollständig heruntergeladen wurdevideo_download_cancellation
- Häufigkeit, mit dem der Download eines für die Offline-Wiedergabe aktivierten Videos abgebrochen wurde (einschließlich der Zeit, in der die Seite geschlossen wurde, bevor der Download abgeschlossen wurde)video_download_error
- Häufigkeit, wie der Download eines für die Offline-Wiedergabe aktivierten Videos aufgrund eines Fehlers fehlgeschlagen ist
Werte filtern
Als Filter verwendet, können Sie mit einer Dimension die Ergebnisse eingrenzen.
Werte filtern: Video-IDs als kommagetrennte Liste oder video.q== {Videofeld}: {value}
Kombinieren von Dimensionen
Informationen darüber, mit welchen Dimensionen dies kombiniert werden kann und welche Felder für die Kombination verfügbar sind, finden Sie unter Dimension und Felder.
Beispiele anfragen
Anfrage Dimension
https://analytics.api.brightcove.com/v1/data? konto=1752604059001&dimensions=video
Anfrage filtern
https://analytics.api.brightcove.com/v1/data? konto=1752604059001&dimensions=video&wo=video==4093943993001,17542766001
REAKTION
Die Antwort wird hier angezeigt, wenn Sie eine Anfrage testen