Retention Data (Beta)

We recognize that retention analysis is very powerful to understand health and viability of your app. You can now query retention metrics for individual app or at company level.

Below are metrics that are available for reporting.

Metric

Description

returnRate

active devices returning to the app post first launch measured independently of usage in future periods .

rollingRate

number of active devices returning to the app post first launch measured to help understand user churn

In case you want to review retention metrics for your app outside of Flurry portal, then you can request csv format on the request. We transform the API results such that you can open the csv in Excel or Google sheets and require minimal formatting changes on your end. Just as other Flurry Metrics API queries, default response is in json format. For csv format, please add &format=csv to the query.

Retention Data time Grain

  • day

  • week

  • month

Clarification points on Retention API requests

  • Request must include both metrics: returnRate and rollingRate

  • Request can support daily, weekly and monthly retention queries. You will need to adjust the query period accordingly

  • Only app and company dimensions are supported on filters. Furthermore, only id, name and apiKey (for app only) dimension attributes are permitted on filters.

  • aggregation by dimensions is not supported

  • topN, sort and having clauses are not supported

Sample query

Request:

https://api-metrics.flurry.com/public/v1/data/retention/day?metrics=returnRate,rollingRate&dateTime=2018-01-08/2018-01-15&filters=app|apiKey-in[<flurry_api_key_here>]&token=<programmatic_token>

Since response is very large, example below has basic outline to illustrate sections that you should expect to see.

Response structure (json):

{
"rows": [{
        "dateTime": "2018-01-08 00:00:00.000-08:00",
        "returnRate": {
                "cohort": 123456,
                "measurement": [{
                        "period": "day1",
                        "ratio": 0.189
                }... {
                        "period": "day30",
                        "ratio": 0.02
                }],
                "summary": [{
                        "period": "day1",
                        "ratio": 0.192
                }... {
                        "period": "day30",
                        "ratio": 0.02
                }]
        },
        "rollingRate": {
                "cohort": 123456,
                "measurement": [{
                        "period": "day1",
                        "ratio": 0.313
                }... {
                        "period": "day30",
                        "ratio": 0.02
                }],
                "summary": [{
                        "period": "day1",
                        "ratio": 0.192
                }... {
                        "period": "day30",
                        "ratio": 0.02
                    }]
                }
        },
     }, {
        "dateTime": "2018-01-09 00:00:00.000-08:00",
        …
    }]
}

Response structure (csv):

"Install Date","Cohort Size","Metric Type",day1,day2,day3,day4,day5,day6,day7,day8,day9,day10,day11,day12,day13,day14,day15,day16,day17,day18,day19,day20,day21,day22,day23,day24,day25,day26,day27,day28,day29,day30

01/08/18,20,rollingRate,0.4000,0.4000,0.3500,0.3500,0.2500,0.2000,0.1500,0.0500,,,,,,,,,,,,,,,,,,,,,, 01/08/18,20,returnRate,0.1000,0.2500,0.0500,0.2000,0.1000,0.1000,0.1000,0.0500,,,,,,,,,,,,,,,,,,,,,, 01/09/18,6,rollingRate,0.5000,0.3333,0.0000,0.0000,0.0000,0.0000,0.0000,,,,,,,,,,,,,,,,,,,,,,, 01/09/18,6,returnRate,0.5000,0.3333,0.0000,0.0000,0.0000,0.0000,0.0000,,,,,,,,,,,,,,,,,,,,,,, 01/10/18,9,rollingRate,0.3333,0.3333,0.3333,0.3333,0.2222,0.1111,,,,,,,,,,,,,,,,,,,,,,,, 01/10/18,9,returnRate,0.2222,0.0000,0.1111,0.2222,0.2222,0.1111,,,,,,,,,,,,,,,,,,,,,,,, 01/11/18,16,rollingRate,0.3125,0.3125,0.3125,0.2500,0.1250,,,,,,,,,,,,,,,,,,,,,,,,, 01/11/18,16,returnRate,0.1875,0.0000,0.0625,0.1250,0.1250,,,,,,,,,,,,,,,,,,,,,,,,, 01/12/18,8,rollingRate,0.5000,0.2500,0.1250,0.1250,,,,,,,,,,,,,,,,,,,,,,,,,, 01/12/18,8,returnRate,0.5000,0.2500,0.0000,0.1250,,,,,,,,,,,,,,,,,,,,,,,,,, 01/13/18,15,rollingRate,0.2667,0.1333,0.0667,,,,,,,,,,,,,,,,,,,,,,,,,,, 01/13/18,15,returnRate,0.2000,0.1333,0.0667,,,,,,,,,,,,,,,,,,,,,,,,,,, 01/14/18,11,rollingRate,0.0000,0.0000,,,,,,,,,,,,,,,,,,,,,,,,,,,, 01/14/18,11,returnRate,0.0000,0.0000,,,,,,,,,,,,,,,,,,,,,,,,,,,, 01/15/18,20,”rollingRate Summary”,0.3176,0.2588,0.2297,0.2542,0.1765,0.1429,0.1154,0.0500,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000 01/15/18,20,”returnRate Summary”,0.2000,0.1294,0.0541,0.1525,0.1176,0.0857,0.0769,0.0500,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000