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.
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:
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:
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-IDaccount.name
- der Name des Kontosactive_media
- die Anzahl der aktiven Videos im Kontoad_mode_begin
- wie oft der Spieler in den Anzeigenmodus gewechselt istad_mode_complete
- wie oft der Spieler den Anzeigenmodus abgeschlossen hatbytes_delivered
- Gesamtzahl der an Client-Rechner gelieferten Bytes für den Player und die zugehörigen Mediendaily_unique_viewers
- durchschnittliche tägliche Unique Userdrm_bytes_packaged
- die Anzahl der verpackten DRM-Bytesengagement_score
- der durchschnittliche Engagement-Score für Videoslicenses_served
- die Anzahl der bereitgestellten DRM-Lizenzenlive_seconds_streamed
- die Gesamtzahl der gelieferten Live-Streaming-Sekundenplay_request
- Gesamtanzahl der angeforderten Videowiedergabenplay_rate
- die durchschnittliche Wiedergaberate (Videoaufrufe geteilt durch Impressionen) für Videosplayer_load
- die Gesamtzahl der Spielerladungenvideo_engagement_1
- die Gesamtzahl der Aufrufe zum 1-Prozent-Punkt der Videodauervideo_engagement_100
- die Gesamtzahl der Aufrufe zum 100-Prozent-Punkt der Videodauervideo_engagement_25
- die Gesamtzahl der Aufrufe zum 25-Prozent-Punkt der Videodauervideo_engagement_50
- die Gesamtzahl der Aufrufe zum 50-Prozent-Punkt der Videodauervideo_engagement_75
- die Gesamtzahl der Aufrufe zum 75-Prozent-Punkt der Videodauervideo_impression
- wie oft Videos insgesamt in Player geladen wurdenvideo_percent_viewed
- Gesamtprozentsatz für alle Videoaufrufe (eine Summe, kein Durchschnitt)video_seconds_viewed
- die Gesamtzahl der angesehenen Sekunden für alle Videosvideo_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
}
}}