Die Statistik-URL wird für jedes Präsentationsobjekt zurückgegeben:
<p>https://orbitvu.co/api/v1/presentations/<id>/statistics/[.json|.xml]</id></p>Zurückgegebene Daten
Dieser Endpunkt liefert eine Liste von URLs zu bestimmten statistischen Daten, z. B.:
<p>{
"countries": "https://orbitvu.co/api/v1/presentations/46/statistics/countries",
"cities": "https://orbitvu.co/api/v1/presentations/46/statistics/cities",
"referers": "https://orbitvu.co/api/v1/presentations/46/statistics/referers",
"views": "https://orbitvu.co/api/v1/presentations/46/statistics/views"
"views2": "https://orbitvu.co/api/v1/presentations/46/statistics/views/2/",
}</p>Jede Statistik-URL kann mit dem Parameter date_range gefiltert werden. Zurückgegebene Werte sind:
- countries
Eine Anzahl von Ansichten (und shared_views) auf die Präsentation, gruppiert nach Land im spezifischen Datumsbereich (paginiert):
<p>{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"shared_views": 7,
"country_name": "Poland",
"country_code": "PL",
"views": 245
}
]
}</p>shared_views ist eine Anzahl von Ansichten für gemeinsame Präsentationen, die aus der aktuellen Präsentation erstellt wurden.
Die gemeinsame Nutzung der Präsentationen ist nur im Rahmen von CUSTOM-Abonnements in der Orbitvu SUN Cloud möglich. Kontaktieren Sie uns, wenn Sie weitere Details wünschen.
- cities
Die Anzahl der Aufrufe (und shared_views) der Präsentation gruppiert nach Land und Stadt in einem bestimmten Datumsbereich (paginiert):
<p>{
"count": 1,
"next": null,
"previous": null,
"results": [{
"name": "Pila",
"views": 20,
"shared_views": 2,
"country": "Poland",
"country_code": "PL",
"country_name": "Poland"
}]
}</p>- referers
Die Anzahl der Ansichten (und shared_views) auf die Präsentation, gruppiert nach einem Referer-spezifischen Datumsbereich (paginiert):
<p>{
"count": 1,
"next": null,
"previous": null,
"results": [
{"shared_views": 0,
"hostname": http://orbitvu.co/001/YmPwz3333DSsiWD9peD9c6/ov3602/3/view",
"views": 10
}]}</p>Für die Referer gibt es eine zusätzliche Filtermöglichkeit. Es ist möglich, mit den Parametern date_range_start und date_range_end einen bestimmten Datumsbereich anzugeben. Einzelheiten dazu finden Sie im Abschnitt Filterung weiter unten.
- views
Die Anzahl der Ansichten in einem bestimmten Datumsbereich. Dies dient der Abwärtskompatibilität; es wird empfohlen, den Endpunkt views2 zu verwenden, der mehr Informationen liefert. Zurückgegebene Daten:
<p>[
{
"27-02-2015": 0
},
{
"28-02-2015": 0
},
{
"01-03-2015": 0
},
{
"02-03-2015": 0
},
{
"03-03-2015": 0
},
...
]</p>- views2
Die Anzahl der Ansichten in einem bestimmten Datumsbereich. Anderes Format als views, z. B.:
<p>[
{
"date": "27-02-2015",
"shared_views": 0,
"total_views": 0,
"views": 0
},
{
"date": "28-02-2015",
"shared_views": 0,
"total_views": 0,
"views": 0
},
{
"date": "01-03-2015",
"shared_views": 0,
"total_views": 0,
"views": 0
},
...
]</p>Zurückgegebene Daten:
- views ist die Anzahl der Ansichten der aktuell angezeigten Präsentation
- shared_views ist eine Anzahl von Ansichten zu Präsentationen, die von der aktuellen Präsentation geteilt wurden
- total_views ist eine Summe aus views + shared_views
Filterung
Die Filterung kann mit den Parametern date_range und (nur für referers endpoint) date_range_start, date_range_end vorgenommen werden
Mögliche Werte und Format:
- date_range values: last_year, last_month, last_week, years, this_month, this_year, range
- date_range default value: last_month
- date_range_start and date_range_end format: YYYY-mm-dd
Der Wert von range ist nur für Referer-Statistiken gültig und funktioniert nur, wenn zusätzliche Query-String-Parameter angegeben werden: date_range_start und date_range_end.
Der Wert years gilt nur für die Endpunkte views und views2. Für andere Statistiken werden die Daten bis zu einem Jahr gehalten!
Der Rückgabewert ist eine Liste von Wörterbüchern, die eine kumulative Anzahl von Ansichten für den gewählten Datumsbereich definieren, z. B. für last_week:
URL: https://orbitvu.co/api/v1/presentations/1233/statistics/views.json?date_range=last_week
Die oben angegebene URL dient nur zu Dokumentationszwecken und funktioniert nicht, wenn sie direkt aufgerufen wird!
Ergebnis:
<p>[
{
"13-09-2014": 130
},
{
"14-09-2014": 332
},
{
"15-09-2014": 265
},
{
"16-09-2014": 198
},
{
"17-09-2014": 390
},
{
"18-09-2014": 323
},
{
"19-09-2014": 302
}
]</p>Für referers mit range:
URL: https://orbitvu.co/api/v1/presentations/1234/statistics/referers.json?date_range=range&date_range_start=2015-03-01&date_range_end=2015-04-01
Ergebnis:
<p>{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"shared_views": 7,
"hostname": "http://orbitvu.co/001/YmPwzTdd3DSsiWD9peD9c6/ov3602/3/view",
"views": 0
}
]
}</p>