Abmessungen und Felder
Dimensionen sind die primären Datenbereiche für Analysen. Klicken Sie auf den Dimensionsnamen in der Liste unten, um vollständige Anleitungen zu den einzelnen Dimensionen anzuzeigen.
Wählen Sie Dimension (en) unten, um die Felder zu sehen, die dafür zurückgegeben werden können. Sie können auch auf klicken Verfügbarkeit Knopf, um eine Beispielanforderung zu machen und die Ergebnisse zu sehen. Wenn Sie mehrere inkompatible Dimensionen auswählen, wird eine entsprechende Meldung angezeigt.
Einschränkungen
- Standardmäßig
video_view
ist das einzige Feld, das zurückgegeben wird - andere Felder werden nur zurückgegeben, wenn sie im Wert vonfields
Parameters. - Wenn Sie ein zurückzugebendes Feld angeben, das für die Dimension oder die Dimensionskombination nicht unterstützt wird, und
UNSUPPORTED_FIELD_COMBINATION_ERROR
Fehler wird zurückgegeben. - Der
bytes_delivered
Feld enthält alle Daten deliverot von Video Cloud an Kunden, einschließlich Videodaten, Bilder, Textspuren und anderer Assets sowie der player Code selbst. Einige dieser Daten stammen von CDNs und sind möglicherweise bis zu 3 Tage nicht verfügbar. - Zusätzlich zu den angezeigten Feldern für
video
Dimension können Sie auch zurückkehrenvideo.custom_fields.{field_name}
Beispiel Anfrage
Ein typischer Anwendungsfall für das Abrufen eines Berichts zu mehreren Dimensionen: Sie möchten eine Aufschlüsselung der Videoaufrufe zwischen Desktop- und Mobilgeräten und möchten außerdem wissen, wie viele Mobilgeräteansichten auf iOS- und Android-Geräten und wie viele Desktops angezeigt wurden Ansichten waren auf Macs gegen Windows-Maschinen. Momentan gibt es im Studio Analytics-Modul keinen Standardbericht, der diese Informationen bereitstellt, Sie können ihn jedoch über diesen erhalten Analytics API Anruf:
https://analytics.api.brightcove.com/v1/data?accounts=57838016001&dimensions=video,device_type,device_os&from=2014-01-01&to=2014-04-01&fields=video_view
(In diesem Fall werden Video-Views für den Zeitraum von Januar 1 bis April 1 in 2014 angefordert.)
Beispiel mit cURL
Wenn Sie die API mit ausprobieren möchten cURL, hier sind ein paar Notizen:
- Sie müssen zuerst einen bekommen Zugangstoken
- Da die URL für die Anfrage immer enthalten ist URL-Parameter, müssen Sie es in Anführungszeichen setzen (einfach oder doppelt)
Probe
Hier ist ein Beispiel cURL Befehl:
curl -s --header "Authorization: Bearer $ACCESS_TOKEN" \
"https://analytics.api.brightcove.com/v1/data?accounts=$ACCOUNT_ID&dimensions=video&from=2017-04-04&limit=100"
Wenn Sie ersetzen $ACCESS_TOKEN
mit einem gültigen Zugriffstoken und $ACCOUNT_ID
Mit Ihrer Konto-ID sollte diese Anforderung funktionieren. Beachten Sie, dass Sie verwenden können Dieses Beispiel App ein Zugriffstoken generieren.
Unterstützte Dimensionskombinationen
Zur schnellen Bezugnahme zeigt die folgende Tabelle die unterstützten oder nicht unterstützten Bemaßungskombinationen. Beachten Sie, dass es in einigen Fällen mehr als zwei Dimensionen gibt. Sie können diese mit Hilfe der Dimensionen und Felder Werkzeug oben.
account |
browser_type |
city |
country |
date |
date_hour |
destination_domain |
destination_path |
device_os |
device_manufacturer |
device_type |
live_stream |
player |
referrer_domain |
region |
search_terms |
social_platform |
source_type |
video |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
account |
n / a | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
browser_type |
![]() |
n / a | ![]() |
![]() |
|||||||||||||||
city |
![]() |
n / a | ![]() |
![]() |
![]() |
![]() |
|||||||||||||
country |
![]() |
![]() |
n / a | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||||||||||
date |
![]() |
![]() |
![]() |
![]() |
n / a | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
date_hour |
![]() |
![]() |
![]() |
![]() |
n / a | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
destination_domain |
![]() |
![]() |
![]() |
n / a | ![]() |
![]() |
|||||||||||||
destination_path |
![]() |
![]() |
![]() |
n / a | |||||||||||||||
device_os |
![]() |
![]() |
![]() |
![]() |
n / a | ![]() |
![]() |
![]() |
|||||||||||
device_manufacturer |
![]() |
![]() |
![]() |
n / a | |||||||||||||||
device_type |
![]() |
![]() |
![]() |
![]() |
n / a | ![]() |
![]() |
![]() |
|||||||||||
live_stream |
![]() |
![]() |
n / a | ||||||||||||||||
player |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
n / a | ![]() |
![]() |
![]() |
||||||||
referrer_domain |
![]() |
![]() |
![]() |
![]() |
n / a | ![]() |
![]() |
![]() |
|||||||||||
region |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
n / a | |||||||||||
search_terms |
![]() |
![]() |
![]() |
![]() |
n / a | ![]() |
|||||||||||||
social_platform |
![]() |
![]() |
n / a | ![]() |
|||||||||||||||
source_type |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
n / a | ![]() |
|||||||||||
video |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
n / a |
Parameter
Im Folgenden finden Sie eine Tabelle mit den verfügbaren Parametern in der Analytics API. Die Verwendung der Parameter wird in den folgenden Abschnitten ausführlicher erläutert.
Parameter | Erforderlich | Beschreibung | Werte | Default |
---|
Konten
Der Video Cloud Konto (n), für das Sie einen Bericht erstellen möchten, werden mithilfe von angegeben accounts
Parameter. Zum Beispiel:
https://analytics.api.brightcove.com/v1/data?accounts={account1_id,account2_id}
Wo Filter
Die allgemeine Syntax für Filter lautet:
where=dimension1==value1;dimension2==value2
Beispielsweise:
https://analytics.api.brightcove.com/v1?accounts=account_id(s)&dimensions=device_type&where=video==video_id;device_type==tablet
Kommas werden als logische ORs und Semikolons als logische UNDs behandelt. Beispielsweise, where=video==1234,5678;player==9876
wird interpretiert als "where video = 1234 OR 5678 UND player = 9876 "
Leerzeichen und Sonderzeichen
String-Werte sollten URI-codiert sein. Sie können Sonderzeichen auch mit einem "" umgehen:
where=search_terms==boston,%20ma
Sie können jede Dimension als Filter verwenden. aber ausschließlich wenn diese Dimension auch in der enthalten ist dimensions
du fragst
Filtern nach Videoeigenschaften
Das Besondere benutzen where=video.q=={property}:{value}
Filter können Sie Ihren Bericht basierend auf einer Vielzahl von Eigenschaften auf bestimmte Videos beschränken:
- Tags
- Referenz ID
- custom_fields [1]
- {a_specific_custom_field}
- hergestellt in
Einschränkungen
[1] Die grundlegende Syntax ist where=video.q==custom_fields:value
(entspricht dem Wert in einem benutzerdefinierten Feld) oder where=video.q==myfield:value
(entspricht dem Wert im spezifischen benutzerdefinierten Feld myfield
). Wenn Sie nach bestimmten benutzerdefinierten Feldern suchen, beachten Sie, dass Sie auf der Seite suchen müssen Interner Name, nicht der Anzeigename:

Eine schnelle Überprüfung, ob Sie den richtigen Namen verwenden: Der interne Name wird sein alles Kleinbuchstaben und enthalten keine Leerzeichen.
Beispiele
Hier sind einige Beispiele where
Filter für die Suche nach Tags und benutzerdefinierten Feldern:
Einfaches Tag
where=video.q==tags:foo
Mehrere Tags:
where=video.q==tags:foo,bar
Benutzerdefinierte Felder
where=video.q==custom_fields:foo
Tags und benutzerdefinierte Felder
where=video.q==tags:foo,bar+custom_fields:fish
Beachten Sie, dass die video.q
Suchfunktion umfasst AND
, OR
bzw. unter NOT
Logik wie folgt:
- A + (Plus-) Zeichen vor dem Suchbegriff bedeutet Ergebnisse sollen diesen Begriff einschließen.
- A - (Minus) Zeichen vor dem Suchbegriff bedeutet Ergebnisse Muss nicht diesen Begriff einschließen.
- Wenn weder ein Plus- noch ein Minuszeichen vorhanden ist, können die Ergebnisse diesen Begriff enthalten oder nicht.
Die folgenden Beispiele veranschaulichen die Verwendung dieser Logik.
where Filtern |
Ergebnisse |
---|---|
where=video.q==tags:red%20tags:blue%tags:green |
Videos mit den Tags red OR blue OR green Wird zurückgegeben |
where=video.q==+tags:red%20tags:blue%tags:green |
zurückgegebene Videos MÜSSEN den Tag haben red UND kann die Tags haben blue OR green |
where=video.q==+tags:red%20tags:blue%-tags:green |
zurückgegebene Videos MÜSSEN den Tag haben red UND kann das Tag haben blue , darf aber NICHT das Tag haben green |
Eine vollständige Erläuterung dieser Abfragesyntax finden Sie unter Verwendung der CMS API: Suche nach Videos.
Zusammenfassung der Filter und zulässigen Werte
Die folgende Tabelle zeigt zulässige Werte für jede Dimension, die als Filter verwendet wird:
Dimensionsfilter | Zulässige Werte |
---|
Datumsbereiche
Datumsbereiche, angegeben in from
bzw. unter to
Parameter für alle Arten von Berichten können in verschiedenen Formaten angezeigt werden:
- Textwerte:
to=now
(verfügbar und der Standardwert für alle Anfragen)
- Epochenzeitwerte in Millisekunden, wie z
1377047323000
- Daten, die im internationalen Datumsformat ISO 8601 ausgedrückt werden:
YYYY-MM-DD
Format, wie z2013-09-12
. Für Daten in diesem Format ausgedrückt:- Jeder angegebene Datumsbereich wird interpretiert in der für das Konto festgelegten Zeitzone
- Die Uhrzeit für das Datum wird als Mitternacht interpretiert (
00:00:00
) zum angegebenen Datum in der für das Konto festgelegten Zeitzone
- Relative Daten: Sie können entweder die
to
bzw. unterfrom
Werte relativ zu den anderen in d (Tage) oder h (Stunden). Beispielsweise:from=2015-01-01&to=31d
from=-48h&to=now
from=-2d&to=now
(wird die gleichen Ergebnisse wie das vorherige Beispiel geben)from=-365d&to=2014-12-31
Beachten Sie, dass negative Zahlen (-2d) als "vor" (der andere Wert) interpretiert werden und positive Zahlen (48h) als "von" (der andere Wert) behandelt werden.
Um einen Bericht zu einer Dimension wie "Video" für einen einzelnen Tag zu erstellen, legen Sie die Werte für "An" und "Von" auf das Datum fest:
...&dimensions=video&from=2013-11-01&to=2013-11-01
Limit und Offset
Der limit
ist die Anzahl der zurückzugebenden Elemente (Standard: 10). Um alle Artikel zurückzugeben, verwenden Sie limit=all
. offset
ist die Anzahl der zu überspringenden Elemente (Standard: 0). Sie können verwenden limit
bzw. unter offset
zusammen, um eine App zu erstellen, die die Ergebnisse durchsucht.
Abgestimmte Daten
Der reconciled
Parameter ist ein boolescher Wert. Wenn es auf eingestellt ist true
, werden die Ergebnisse auf abgeglichene Daten beschränkt. Ob false
Die Ergebnisse sind auf Echtzeitdaten (stündlich nicht abgestimmt) beschränkt.
Geografische Berichte
Dimensionen für die geografische Analyse
country
- Als ISO-3611-1 Ländercode. zB: "USA"region
- Als ISO-3611-2-Regionscode. zB: 'US-WA'city
- Stadtname. zB: Seattle
Hinweis: Für unbekanntes Land oder Region gibt die API "ZZ" als Code zurück (gemäß ISO-3611-alpha2).
Felder und Sortieren
Verwenden Sie das fields
Parameter, um die Felder anzugeben, die Sie zurückgeben möchten. Standardmäßig, video_view
wird zurückgegeben und das Feld, das der Dimension entspricht, über die Sie berichten (z. B. destination_domain
) werden zurückgegeben. Sehen Dimensionen und Felder für weitere Informationen kontaktieren.
Verwenden Sie das sort
Parameter, um anzugeben, welches Metrikfeld zum Sortieren der zurückgegebenen Elemente verwendet wird; beispielsweise: sort=video_view
. Sie können die Sortierreihenfolge umkehren, indem Sie das Sortierfeld negieren: sort= -video_view
Berechnete Felder
Sie können berechnete Felder zu Ihren API-Anforderungen hinzufügen, indem Sie die folgende Syntax verwenden:
fields=calulated_field_name:expression
Sie können berechnete Felder verwenden, um eigene benutzerdefinierte Felder aus vorhandenen Metriken zu erstellen oder ein vorhandenes Feld umzubenennen.
Der Name für das berechnete Feld kann eine beliebige URI-kompatible Zeichenfolge sein. Der Ausdruck kann reguläre Feldnamen und die folgenden arithmetischen Operatoren enthalten:
+
(Zusatz)-
(Subtraktion)*
(Multiplikation)/
(Aufteilung)^
(Exponent)()
(Klammern)
Beispiele
fields=avg_seconds_viewed:video_seconds_viewed/video_view,video.name
fields=avg_incomplete_ads:(ad_mode_begin-ad_mode_complete)/video_view,video.name
fields=Video%20Views:video_view,video.name
Musteranfrage
Beispielantwort (auf die obige Anfrage)
{
"item_count": 110,
"items": [
{
"avg_seconds_viewed": 2152.2519913106444,
"video.name": "Flamingos",
"video_seconds_viewed": 2972260,
"video": "4825279519001",
"video_view": 1381
},
{
"avg_seconds_viewed": 14.016225448334756,
"video.name": "Tiger",
"video_seconds_viewed": 16413,
"video": "4093643993001",
"video_view": 1171
},
{
"avg_seconds_viewed": 12.06,
"video.name": "Zebra",
"video_seconds_viewed": 9045,
"video": "3851389913001",
"video_view": 750
},
{
"avg_seconds_viewed": 23.343065693430656,
"video.name": "Sea-SeaTurtle",
"video_seconds_viewed": 15990,
"video": "1754276205001",
"video_view": 685
}
],
"summary": {
"avg_seconds_viewed": 274.27374399301004,
"video_seconds_viewed": 3139063,
"video_view": 11445
}
}