Kontakt Support
Systemstatus
video Abmessungen. Das video dimension bietet Analysen per Video. HINWEIS: Wenn Sie ein "Video" einfügen möchten. Felder (wie z video.name) In der Antwort müssen Ihre Client-Anmeldeinformationen die Berechtigung CMS: Video read enthalten. Beachten Sie auch, dass Sie nicht zurückkehren können video.custom_fieldskönnen Sie zurückkehren 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 | ja | Eine oder mehrere Konto-IDs als durch Kommas getrennte Liste | keine |
dimensions |
Die Dimension (en), über die berichtet werden soll | ja | eine oder mehrere Dimensionen als durch Kommas getrennte Liste (einige Kombinationen sind nicht gültig) | keine |
where |
Wird verwendet, um Filter für Berichte festzulegen | nicht | {dimension} == {value} - eine oder mehrere als durch Semikolons getrennte Liste | keine |
limit |
Anzahl der zurückzugebenden Artikel | nicht | positive ganze Zahl | 10 |
offset |
Anzahl der zu überspringenden Elemente | nicht | positive ganze Zahl | 0 |
sort |
Feld, nach dem Elemente sortiert werden sollen | nicht | ein gültiges Feld für die Anfrage | Videoansicht |
fields |
Felder, die zurückgegeben werden sollen | nicht | variiert je nach Dimension, über die Sie berichten | Videoansicht |
format |
Formatieren, um Ergebnisse in zurückzugeben | nicht | Json | csv | xlxs | JSON |
reconciled |
Wenn enthalten, werden die Ergebnisse auf historische oder Echtzeitdaten begrenzt | nicht | wahr | falsch | was immer dies auch sein sollte. |
from |
Der Beginn des Datumsbereichs für die Anforderung | nicht | Ein ISO 8601-Datum (JJJJ-MM-TT), eine Epochenzeit in Millisekunden, die Zeichenfolge aller Zeiten oder ein relatives Datum (-1 m); Nur Termine innerhalb der letzten 32 Tage sind für Engagement-Endpunkte zulässig oder wenn abgeglichen = falsch. | 30 Tage zuvor |
to |
Das Ende des Datumsbereichs für die Anforderung | nicht | Ein ISO 8601-Datum (JJJJ-MM-TT), eine Epochenzeit in Millisekunden, die Zeichenfolge jetzt oder relative Daten (+ 7d); Nur Termine innerhalb der letzten 32 Tage sind für Engagement-Endpunkte zulässig oder wenn abgeglichen = falsch. | Jetzt |
Felder verfügbar
Die folgenden Felder können für die Dimension zurückgegeben werden.
ad_mode_begin- wie oft die player Anzeigenmodus aufgerufenad_mode_complete- wie oft die player Anzeigenmodus abgeschlossenbytes_delivered- Gesamtbytes deliverot auf Client-Maschinen für die player und zugehörige Medienengagement_score- die Partitur für ein Videoplay_request- Gesamtzahl der Aufrufe der Videowiedergabeplay_rate- die durchschnittliche Wiedergaberate (Videoansichten geteilt durch Impressionen) für ein Videovideo- die Video-IDvideo_duration- die Videodauer (falls angegeben)video_engagement_1- Die Anzahl der Aufrufe am 1-Prozentpunkt des Videosvideo_engagement_100- Die Gesamtzahl der Aufrufe zum 100-Prozentpunkt der Videodauervideo_engagement_25- Die Gesamtzahl der Aufrufe zum 25-Prozentpunkt der Videodauervideo_engagement_50- Die Gesamtzahl der Aufrufe zum 50-Prozentpunkt der Videodauervideo_engagement_75- Die Gesamtzahl der Aufrufe zum 75-Prozent-Punkt der Videodauervideo_impression- Die Gesamtanzahl der Ladevorgänge des Videos playersvideo_name- Name des Videos zum Zeitpunkt des letzten Eindrucks im Zeitrahmenvideo_percent_viewed- Die Summe des Prozentsatzes des Videos, der für alle Videoansichten angezeigt wird. Wenn der Zeitraum beispielsweise zwei Ansichten enthielt und der Prozentsatz, der in einer Ansicht angezeigt wurde, 78% und in der anderen 59% war, ist dervideo_percent_viewedzurückgekehrt wäre 137.video_seconds_viewed- Gesamtsekunden für jede Videoansichtvideo_view- wie oft die Videowiedergabe begonnen hatvideo.reference_id- die Referenz-ID des Videosvideo.name- der aktuelle Name des Videosvideo.description- die aktuelle Beschreibung des Videosvideo.complete- ob die Videobearbeitung abgeschlossen istvideo.created_at- Datum und 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 aktuell istACTIVEorINACTIVEvideo.tags- die Tags des Videosvideo.updated_at- Datum und Uhrzeit der letzten Änderung des Videosvideo.custom_fields.{field_name}- Wert für das benutzerdefinierte Feld des Videos{field_name}video_download_request- Anzahl der Downloadanforderungen für ein Video, das für die Offline-Wiedergabe aktiviert istvideo_download_complete- wie oft ein für die Offline-Wiedergabe aktiviertes Video vollständig heruntergeladen wurdevideo_download_cancellation- Anzahl der Downloads eines für die Offline-Wiedergabe aktivierten Videos wurde abgebrochen (einschließlich der Zeiten, zu denen die Seite geschlossen wurde, bevor der Download abgeschlossen wurde).video_download_error- Die Anzahl der Downloads eines für die Offline-Wiedergabe aktivierten Videos ist aufgrund eines Fehlers fehlgeschlagen
Werte filtern
Als Filter verwendet, können Sie mit einer Dimension die Ergebnisse eingrenzen.
Filterwerte: Video-IDs als kommagetrennte Liste oder video.q == {Videofeld}: {Wert}
Dimensionen kombinieren
Um zu sehen, mit welchen Dimensionen diese Option kombiniert werden kann und welche Felder für die Kombination verfügbar sind, siehe Dimension und Felder.
Anfrage Beispiele
Dimensionsanforderung
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video
Filteranfrage
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=video&where=video==4093643993001,1754276206001
Antwort
Response will appear here when you test a request