Abmessungen: Datum

Abmessung: date

In diesem Thema erfahren Sie mehr über die Analytics API Datumsdimension. Die Datumsdimension gibt Analysen für einen einzelnen Tag zurück. Der Benutzer kann die from und to Parameter in jjjj-mm-tt Format. Dies ermöglicht es einem Benutzer, das Analysesystem abzufragen, um einen Bericht nach Tagen innerhalb der zu erstellen from Und to Datumsbereich. Jeder vom Benutzer angegebene Datumsbereich wird auf die aktuelle Zeitzone für das Konto interpretiert. Die Datumsbereiche für die Anfrage sind inklusiv, d. h. wenn der Benutzer eine Anfrage stellt from=2013-09-24&to=2013-09-27, enthält die Antwort Ergebnisse von 2013-09-24 00:00:00 bis 2013-09-27 00:00:00.

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
active_media- die Anzahl der aktiven Videos im Konto
bytes_delivered- Gesamtzahl der an Client-Rechner gelieferten Bytes für den Player und die zugehörigen Medien
daily_unique_viewers- durchschnittliche tägliche Unique User
date- das Datum im ISO 8601-Datumsformat (JJJJ-MM-TT)
drm_bytes_packaged- die Anzahl der verpackten DRM-Bytes
engagement_score- der durchschnittliche Engagement-Score für Videos
licenses_served- die Anzahl der bereitgestellten DRM-Lizenzen
live_seconds_streamed- die Gesamtzahl der gelieferten Live-Streaming-Sekunden
play_request- Gesamtanzahl der angeforderten Videowiedergaben
play_rate- die durchschnittliche Wiedergaberate (Videoaufrufe geteilt durch Impressionen) für Videos
player_load- die Gesamtzahl der Spielerladungen
video_engagement_1- die Gesamtzahl der Aufrufe zum 1-Prozent-Punkt der Videodauer
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 Videos insgesamt in Player geladen wurden
video_percent_viewed- Gesamtprozentsatz für alle Videoaufrufe (eine Summe, kein Durchschnitt)
video_seconds_viewed- die Gesamtzahl der angesehenen Sekunden für alle Videos
video_view- die Gesamtanzahl der Starts der Videowiedergabe

Filterwerte

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

Filterwerte: Die Datumsdimension wird nicht als Filter verwendet.

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

Anfrage filtern

    Unzutreffend

Beispielantwort

{
  "Artikel_Zahl": 31,
  "Elemente": [
    {
      "Datum": "2022-04-30",
      "video_view": 160
    },
    {
      "Datum": "2022-05-07",
      "video_view": 220
    },
    {
      "Datum": "2022-05-21",
      "video_view": 226
    },
    {
      "Datum": "2022-05-08",
      "video_view": 236
    },
    {
      "Datum": "2022-05-28",
      "video_view": 261
    },
    {
      "Datum": "2022-05-29",
      "video_view": 280
    },
    {
      "Datum": "2022-05-01",
      "video_view": 307
    },
    {
      "Datum": "2022-05-03",
      "video_view": 431
    },
    {
      "Datum": "2022-05-02",
      "video_view": 512
    },
    {
      "Datum": "2022-05-30",
      "video_view": 518
    }
  ],
  "Zusammenfassung": {
    "video_view": 45117
  }
}}

Abmessung: date