Abmessung: video

In diesem Thema erfahren Sie mehr über die Analytics API video Dimension. Die video dimension bietet Analysen per Video. HINWEIS: Wenn Sie ein „Video“ hinzufügen möchten. „Felder (wie video.name) in der Antwort, Ihre Kundendaten müssen das CMS enthalten: Berechtigung 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.

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:
  • Ein ISO 8601-Datum (JJJJ-MM-TT)
  • Epochenzeit in Millisekunden (Beispiel: 1659641316719 [= Donnerstag, 4. August 2022, 19:28:36 .719 Uhr GMT]). Siehe den Epoch-Zeitkonverter.
  • Eine Zeichenfolge: from=alltime
  • +/- relative Daten in Tagen (d), Wochen (w) oder Monaten (m) — Beispiel: from=-6m&to=%2B2w(der Zeitraum von vor 6 Monaten bis 2 Wochen danach — beachten Sie, dass das Pluszeichen URI-kodiert sein muss als %2B)

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:
  • Ein ISO 8601-Datum (JJJJ-MM-TT)
  • Epochenzeit in Millisekunden (Beispiel: 1659641316719 [= Donnerstag, 4. August 2022, 19:28:36 .719 Uhr GMT]). Siehe den Epoch-Zeitkonverter.
  • Eine Zeichenfolge: to=now
  • +/- relative Daten in Tagen (d), Wochen (w) oder Monaten (m) — Beispiel: from=-6m&to=%2B2w(der Zeitraum von vor 6 Monaten bis 2 Wochen danach — beachten Sie, dass das Pluszeichen URI-kodiert sein muss als %2B)

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.

  • ad_mode_begin- wie oft der Spieler in den Anzeigenmodus gewechselt ist
  • ad_mode_complete- wie oft der Spieler den Anzeigenmodus abgeschlossen hat
  • bytes_delivered- Gesamtzahl der an Client-Rechner gelieferten Bytes für den Player und die zugehörigen Medien
  • engagement_score- der Engagement-Score für ein Video
  • play_request- Gesamtanzahl der angeforderten Videowiedergaben
  • play_rate- die durchschnittliche Wiedergaberate (Videoaufrufe geteilt durch Impressionen) für ein Video
  • video- die Video-ID
  • video_duration- die Videodauer (falls gemeldet)
  • video_engagement_1- die Anzahl der Aufrufe am 1-Prozent-Punkt des Videos
  • video_engagement_100- die Gesamtzahl der Aufrufe zum 100-Prozent-Punkt der Videodauer
  • video_engagement_25- die Gesamtzahl der Aufrufe zum 25-Prozent-Punkt der Videodauer
  • video_engagement_50- die Gesamtzahl der Aufrufe zum 50-Prozent-Punkt der Videodauer
  • video_engagement_75- die Gesamtzahl der Aufrufe zum 75-Prozent-Punkt der Videodauer<
  • video_impression- wie oft das Video insgesamt in Player geladen wurde
  • video_name- der Name des Videos zum Zeitpunkt der letzten Impression im Zeitrahmen
  • video_percent_viewed- die Summe des Prozentsatzes des angezeigten Videos für alle Videoaufrufe. Wenn beispielsweise im Berichtszeitraum zwei Ansichten vorhanden waren und der Prozentsatz in einer Ansicht 78% und in der anderen 59% betrug, betrug der video_percent_viewed zurückgegeben würde sein 137.
  • video_seconds_viewed- Gesamtzahl der angesehenen Sekunden für jede Videoansicht
  • video_view- wie oft die Videowiedergabe begonnen hat
  • video.reference_id- die Referenz-ID des Videos
  • video.name- der aktuelle Name des Videos
  • video.description- die aktuelle Beschreibung des Videos
  • video.complete- ob die Videoverarbeitung abgeschlossen ist
  • video.created_at- Datum/Uhrzeit, als das Video erstellt wurde
  • video.duration- die aktuelle Dauer des Videos
  • video.economics- ob das Video für Werbung aktiviert ist
  • video.long_description- die lange Beschreibung des Videos
  • video.state- ob das Video aktuell ist ACTIVE oder INACTIVE
  • video.tags- die Tags des Videos
  • video.updated_at- Datum/Uhrzeit der letzten Änderung des Videos
  • video.custom_fields.{field_name}- Wert für das benutzerdefinierte Feld des Videos namens {field_name}
  • video_download_request- Anzahl der Download-Anfragen für ein Video, das für die Offline-Wiedergabe aktiviert ist
  • video_download_complete- wie oft ein für die Offline-Wiedergabe aktiviertes Video vollständig heruntergeladen wurde
  • video_download_cancellation- Häufigkeit, mit der der Download eines Videos, das für die Offline-Wiedergabe aktiviert war, abgebrochen wurde (einschließlich der Zeiten, in denen die Seite geschlossen wurde, bevor der Download abgeschlossen wurde)
  • video_download_error- wie oft das Herunterladen eines Videos, das für die Offline-Wiedergabe aktiviert ist, aufgrund eines Fehlers fehlgeschlagen ist

Filterwerte

Eine Dimension, die als Filter verwendet wird, ermöglicht es Ihnen, die Ergebnisse einzugrenzen.

Filterwerte: Video-IDs als durch Kommas getrennte Liste oder video.q == {Videofeld}: {Wert}

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=video

Anfrage filtern

    https://analytics.api.brightcove.com/v1/data? accounts=1752604059001&dimensions=video&where=video==4093643993001,1754276206001
Beispielantwort 
{
	"Artikel_Zahl": 123,
	"Elemente": [
		{
			"Video": "2180741085001",
			"video_view": 1
		},
		{
			"Video": "4446941108001",
			"video_view": 1
		},
		{
			"Video": "2535301903001",
			"video_view": 1
		},
		{
			"Video": "5323136098001",
			"video_view": 1
		},
		{
			"Video": "1732474228567874935",
			"video_view": 1
		},
		{
			"Video": "1723783757463121178",
			"video_view": 1
		},
		{
			"Video": "4454620114001",
			"video_view": 1
		},
		{
			"Video": "5271819050001",
			"video_view": 1
		},
		{
			"Video": "2026627035001",
			"video_view": 1
		},
		{
			"Video": "4446941103001",
			"video_view": 2
		}
	],
	"Zusammenfassung": {
		"video_view": 45136
	}
}}