Abmessungen: device

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
device_os das Gerätebetriebssystem
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_load- wie oft ein Player geladen wurde
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: android, bada, ios, rim, symbian, web_os, windows, os_x, mac, linux, andere

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

Anfrage filtern

    https://analytics.api.brightcove.com/v1/data? accounts=1752604059001&dimensions=video&where=device_os==os_x, mac, ios

Beispielantwort

{
  "Artikel_Zahl": 7,
  "Elemente": [
    {
      "video_view": 2,
      "device_os": "chrome_os"
    },
    {
      "video_view": 54,
      "device_os": "andere"
    },
    {
      "video_view": 609,
      „device_os“: „Linux“
    },
    {
      "video_view": 4318,
      „gerät_os“: „iOS“
    },
    {
      "video_view": 6443,
      "device_os": "os_x"
    },
    {
      "video_view": 13812,
      „device_os“: „Android“
    },
    {
      "video_view": 19895,
      "device_os": "Windows"
    }
  ],
  "Zusammenfassung": {
    "video_view": 45133
  }
}}

Abmessung: device_os