Abmessung: account

In diesem Thema erfahren Sie mehr über die Analytics API account Dimension. Die account Dimension wird verwendet, um allgemeine Analysedaten für das Konto abzurufen.

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.

  • account- die Konto-ID
  • account.name- der Name des Kontos
  • active_media- die Anzahl der aktiven Videos im Konto
  • 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
  • daily_unique_viewers- durchschnittliche tägliche Unique User
  • 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 Kontodimension 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=account

Anfrage filtern

    Unzutreffend
Beispielantwort
{
  "Artikel_Zahl": 1,
  "Elemente": [
    {
      "video_view": 45850,
      "Konto": "1752604059001"
    }
  ],
  "Zusammenfassung": {
    "video_view": 45850
  }
}}