Abmessung: date_hour

Die date_hour dimension stellt Analysedaten in stündlichen Segmenten bereit. Der Benutzer kann die Parameter von und bis im Format yyyy-MM-DD oder die Epochenzeit im Millisekunden-Format angeben. Für Berichte über einen Zeitraum von mehreren Stunden müssen Sie das Millisekundenformat verwenden, wobei die Werte von to und from innerhalb der Start- und Endstunden liegen, für die Sie eine Abfrage durchführen möchten. Jeder vom Benutzer angegebene Datumsbereich wird auf die aktuelle Zeitzone für das Konto interpretiert. date_hour Berichte sind nur für Bereiche innerhalb der letzten 32 Tage gültig. Wenn der from-Wert mehr als 32 Tage zurückliegt, wird ein Fehler zurückgegeben.

Überblick

Die Dimension date_hour stellt Analysedaten in stündlichen Segmenten bereit. Der Benutzer kann die Parameter von und bis im Format JJJJ-MM-TT oder die Epochenzeit im Millisekundenformat angeben. Für Berichte über einen Zeitraum von mehreren Stunden müssen Sie das Millisekundenformat verwenden, wobei die Werte von to und from innerhalb der Start- und Endstunden liegen, für die Sie eine Abfrage durchführen möchten. Jeder vom Benutzer angegebene Datumsbereich wird auf die aktuelle Zeitzone für das Konto interpretiert. date_hour Berichte sind nur für Bereiche innerhalb der letzten 32 Tage gültig. Wenn der from-Wert mehr als 32 Tage zurückliegt, wird ein Fehler zurückgegeben.

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
  • date_hour- Datum-Uhrzeit im ISO 8601-Datum-Uhrzeit-Format
  • engagement_score- der durchschnittliche Engagement-Score für Videos
  • 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_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 Dimension date_hour 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_hour&from=-6h

Anfrage filtern

    Unzutreffend
Beispielantwort 
{
  "Artikel_Zahl": 7,
  "Elemente": [
    {
      "Datum_Stunde": „2022-05-30T 11:00:00-04:00 „,
      "video_view": 8
    },
    {
      "Datum_Stunde": „2022-05-30T 10:00:00-04:00 „,
      "video_view": 11
    },
    {
      "Datum_Stunde": „2022-05-30T 08:00:00-04:00 „,
      "video_view": 26
    },
    {
      "Datum_Stunde": „2022-05-30T 07:00:00-04:00 „,
      "video_view": 30
    },
    {
      "Datum_Stunde": „2022-05-30T 09:00-04:00“,
      "video_view": 34
    },
    {
      "Datum_Stunde": „2022-05-30T 06:00:00-04:00 „,
      "video_view": 43
    },
    {
      "Datum_Stunde": „2022-05-30T 05:00:00-04:00 „,
      "video_view": 46
    }
  ],
  "Zusammenfassung": {
    "video_view": 198
  }
}}