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
        }]
}