Amazon Mobile Analytics
User Guide

Querying Retention Data

Note

After April 30, 2018, Amazon Mobile Analytics features will be provided only by Amazon Pinpoint. If you're new to Mobile Analytics, use Amazon Pinpoint instead. If you're currently using Mobile Analytics, see Migrating from Amazon Mobile Analytics to Amazon Pinpoint.

These KPIs return retention data for an app.

The URLs for week 1, week 2, and week 3 retention KPIs are:

https://mobileanalytics.us-east-1.amazonaws.com/2014-06-05/apps/<YOUR APP ID>/kpis/week-1-retention/count https://mobileanalytics.us-east-1.amazonaws.com/2014-06-05/apps/<YOUR APP ID>/kpis/week-2-retention/count https://mobileanalytics.us-east-1.amazonaws.com/2014-06-05/apps/<YOUR APP ID>/kpis/week-3-retention/count

The URLs for day 1, day 3, day 5, and day 7 retention KPIs are:

https://mobileanalytics.us-east-1.amazonaws.com/2014-06-05/apps/<YOUR APP ID>/kpis/day-1-retention/count https://mobileanalytics.us-east-1.amazonaws.com/2014-06-05/apps/<YOUR APP ID>/kpis/day-3-retention/count https://mobileanalytics.us-east-1.amazonaws.com/2014-06-05/apps/<YOUR APP ID>/kpis/day-5-retention/count https://mobileanalytics.us-east-1.amazonaws.com/2014-06-05/apps/<YOUR APP ID>/kpis/day-7-retention/count

Example Response

Here is an example of the JSON returned in the response for the day 7 retention count query. The value in the rows attribute contains the KPI values by day.

{ "_links" : { "self" : { "href" : "/2014-06-05/apps/<YOUR APP ID>/kpis/day-7-retention-per-user/count?start=2015-12-01&end=2015-12-08", "name" : "count" }, "example" : [{ "href" : "/2014-06-05/apps/<YOUR APP ID>/kpis/day-7-retention-per-user/count?start=7-days-ago&end=today", "name" : "last-7-days-all-platforms", "title" : "Last 7 Days All Platforms" }, { "href" : "/2014-06-05/apps/<YOUR APP ID>/kpis/day-7-retention-per-user/count?start=30-days-ago&end=today", "name" : "last-30-days-all-platforms", "title" : "Last 30 Days All Platforms" }, { "href" : "/2014-06-05/apps/<YOUR APP ID>/kpis/day-7-retention-per-user/count?start=60-days-ago&end=today", "name" : "last-60-days-all-platforms", "title" : "Last 60 Days All Platforms" } ], "up" : [{ "href" : "/2014-06-05/apps/<YOUR APP ID>/kpis/day-7-retention-per-user", "name" : "day-7-retention-per-user" } ] }, "columns" : { "day" : { "colIndex" : 0, "type" : "Qualitative", "dataType" : "ISODateTime", "unit" : null, "name" : "day", "displayName" : "Date" }, "Day7RetentionPerUser" : { "colIndex" : 1, "type" : "Quantitative", "dataType" : "Double", "unit" : null, "name" : "Day7RetentionPerUser", "displayName" : "Day 7 Retention Per User" } }, "rows" : [ ["2015-12-01", 0.0], ["2015-12-02", 0.0], ["2015-12-03", 0.0], ["2015-12-04", 0.0], ["2015-12-05", 0.0], ["2015-12-06", 0.0], ["2015-12-07", 0.0], ["2015-12-08", 0.0]], "scope" : { "appId" : "<YOUR APP ID>", "kpiName" : "day-7-retention-per-user", "aggregate" : "count" }, "weightedAverage" : 0.0 }

On this page: