App Usage Data¶
The App Usage Data request comprises elements that can be combined to query your analytics data. The parameters that apply to this table:
Sample Request¶
https://api-metrics.flurry.com/public/v1/data/appUsage/day/app/country?metrics=sessions,activeDevices,newDevices&dateTime=2017-06-01/2017-08-01&filters=[...]&topN=[..]&sort=[..]&having=[..]&format=[..]&timeZone=[..]
App Usage Metrics¶
Below are metrics that are available for reporting.
Metric |
Description |
---|---|
sessions |
number of times users accessed the application |
activeDevices |
total unique devices that accessed the application |
activeUsers (*) |
total unique users (based on app user ID) that accessed the application |
newDevices |
new devices that installed and launched the application |
timeSpent |
time users spent (seconds) in the application |
averageTimePerDevice |
average time users spent (seconds) in the application per device |
averageTimePerSession |
average time users spent (seconds) in the application per session |
medianTimePerSession |
median time users spent (seconds) in the application per session |
(*) requires app to use SDK API for setting app user ID
App Usage Dimensions¶
Below are dimensions and dimension attributes that are available for reporting.
Dimension |
Description |
Value |
---|---|---|
company |
Flurry company account |
id, name (default) |
app |
Flurry app |
id, name (default), company|id, apiKey, platform|id, platform|name |
country |
Per country dimension totals |
id, name (default), iso |
appVersion |
App’s version ID, name, company ID, app ID, deleted and filtered. Deleted and filtered are boolean (0 or 1) and reflect current status of an app version based on developer’s action on Flurry developer portal |
id, name (default), company|id, app|id, deleted, filtered |
language |
Language ID and name |
id, name (default) |
region |
Region ID and name |
id, name (default) |
category |
App category ID and name |
id, name (default) |
Time Grain¶
day
week
month
all
There are instances when you want to know the possible values for dimensions before running metric queries. For example: list names and api keys for all apps on your company account
https://api-metrics.flurry.com/public/v1/data/appUsage/day/company/app;show=name,apiKey?metrics=...
To return a value other than default name returned for the given dimension, add
;show=all
or
;show=id (any other value listed in the value column above for the given dimension
after the dimension name
https://api-metrics.flurry.com/public/v1/data/appUsage/day/company/country;show=all/category?metrics=sessions,activeDevices,newDevices,timeSpent&dateTime=2017-05-01/2017-05-02
https://api-metrics.flurry.com/public/v1/data/appUsage/day/company/country;show=iso/category?metrics=sessions,activeDevices,newDevices,timeSpent&dateTime=2017-05-01/2017-05-02
Refer to Analytics API for all the parameters, list of error codes and other general information about this API.
Example of key App Usage metrics queries¶
For all your apps, daily Sessions, daily Active Devices, New Devices for 2 days:
Sample Request¶
https://api-metrics.flurry.com/public/v1/data/appUsage/day/app?metrics=sessions,activeDevices,newDevices&dateTime=2016-07-01/2016-07-03
Sample Response¶
{
"rows": [{
"dateTime": "2016-07-01 00:00:00.000-07:00",
"app|name": "foo",
"sessions": 372,
"activeDevices": 123,
"newDevices": 32},
{
"dateTime": "2016-07-01 00:00:00.000-07:00",
"app|name": "bar",
"sessions": 1120,
"activeDevices": 487,
"newDevices": 34},
{
"dateTime": "2016-07-02 00:00:00.000-07:00",
"app|name": "foo",
"sessions": 421,
"activeDevices": 140,
"newDevices": 12},
{
"dateTime": "2016-07-02 00:00:00.000-07:00",
"app|name": "bar",
"sessions": 1164,
"activeDevices": 453,
"newDevices": 51}]
}
For a specific app, daily Sessions, Active Devices and New Devices for 2 months:
Sample Request using Flurry API key¶
https://api-metrics.flurry.com/public/v1/data/appUsage/day?metrics=sessions,activeDevices,newDevices&dateTime=2016-06-01/2016-08-01&filters=app|apiKey-in[3WD7Q8329867K7MY6RNS]
Sample Request using App name¶
https://api-metrics.flurry.com/public/v1/data/appUsage/day?metrics=sessions,activeDevices,newDevices&dateTime=2016-06-01/2016-08-01&filters=app|name-in[appname]
Sample Response¶
{
"rows": [{
"dateTime": "2016-06-01 00:00:00.000-07:00",
"app|name": "foo",
"sessions": 12744,
"activeDevices": 6373,
"newDevices": 6373
},{
"dateTime": "2016-07-01 00:00:00.000-07:00",
"app|name": "foo",
"sessions": 13805,
"activeDevices": 6882,
"newDevices": 6882
}]
}