Abmessung: player

In diesem Thema erfahren Sie mehr über die Analytics API player Dimension. Die player dimension bietet Analysen für Videoplayer.

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
  }
}}