Abmessungen: Spieler

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 durchschnittliche Engagement-Score für ein in einem Player abgespieltes Video
play_request- Gesamtanzahl der angeforderten Videowiedergaben
play_rate- die durchschnittliche Wiedergaberate (Videoaufrufe geteilt durch Impressionen) für ein Video
player- die Spieler-ID
player_load- wie oft ein Player geladen wurde
player_name
video_engagement_1- die Anzahl der Aufrufe am 1-Prozent-Punkt des Videos
video_engagement_100- die Gesamtzahl der Aufrufe bei der 100-prozentigen Dauer der im Player abgespielten Videos
video_engagement_25- die Gesamtzahl der Aufrufe bei der 25-Prozent-Dauer der im Player abgespielten Videos
video_engagement_50- die Gesamtzahl der Aufrufe bei 50 Prozent der Dauer der im Player abgespielten Videos
video_engagement_75- die Gesamtzahl der Aufrufe bei 75 Prozent der Dauer der im Player abgespielten Videos
video_impression- die Gesamtzahl der in den Player geladenen Videos
video_percent_viewed- die prozentuale Summe der angesehenen Videos im Player
video_seconds_viewed- Gesamtsekunden der im Player angezeigten Videos
video_view- Gesamtanzahl der im Player gestarteten Videowiedergabe

Filterwerte

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

Filterwerte: Spieler-IDs als durch Kommas getrennte Liste

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

Anfrage filtern

https://analytics.api.brightcove.com/v1/data? accounts=1752604059001&dimensionsions=player&where=player==QSVOBWORX

Beispielantwort

{
  "Artikel_Zahl": 102,
  "Elemente": [
    {
      "video_view": 1,
      „Spieler“: „players.brightcove.com/1752604059001/Y4JYJKE82_Default“
    },
    {
      "video_view": 1,
      „Spieler“: „players.brightcove.com/1752604059001/AGKFATYKC_Default“
    },
    {
      "video_view": 1,
      „Spieler“: „players.brightcove.com/1752604059001/default_default/true“
    },
    {
      "video_view": 2,
      „Spieler“: „players.brightcove.com/1752604059001/1OHQDStar_Default“
    },
    {
      "video_view": 2,
      „Spieler“: „players.brightcove.com/1752604059001/HYBVHCK_Default“
    },
    {
      "video_view": 2,
      „Spieler“: „players.brightcove.com/1752604059001/27MN0S7ND_Default“
    },
    {
      "video_view": 3,
      „Spieler“: „players.brightcove.com/1752604059001/b547079e-00cc-4585-b354-04020a7ed70a_default“
    },
    {
      "video_view": 3,
      „Spieler“: „players.brightcove.com/1752604059001/WRGBJGQAE_Default“
    },
    {
      "video_view": 3,
      „Spieler“: „players.brightcove.com/1752604059001/B1ELWRGEG_DEFAULT“
    },
    {
      "video_view": 4,
      „Spieler“: „players.brightcove.com/1752604059001/yqmkekrup_Default“
    }
  ],
  "Zusammenfassung": {
    "video_view": 45135
  }
}}

Abmessung: player