Documentation

Mobile Apps Engagement

Ultimate customers who have purchased the additional Apps Engagement add-on can retrieve mobile app engagement for apps they have purchased country filters for in Google’s Play Store This includes the following:

1. Current Installs – Returns Installs minus Uninstalls for the App as a % of all Android device users in the country

2. Daily Active Users - Returns Daily Active Users as a % of all Android device users in the country

3. Sessions / User - Returns Average number of sessions per user for the requested application

4. Usage Time / Session - Returns Average Usage Time per Session for the requested application

5. Mobile Apps Retention - Returns % of returning users over past 30 days as well as loyal vs early churn % and median lifetime




Example: Current installs output for “Whatsapp”:

{
    "meta": {
        "request": {
            "granularity": "Monthly",
            "start_date": "2015-10",
            "end_date": "2015-12",
            "store": "Google",
            "app_id": "com.whatsapp",
            "format": "json",
            "country": "us"
        },
        "status": "Success",
        "last_updated": "2016-06-01"
    },
    "current_installs": [
        {
            "start_date": "2015-10-01",
            "end_date": "2015-10-31",
            "installs": 0.1664951809572903
        },
        {
            "start_date": "2015-11-01",
            "end_date": "2015-11-30",
            "installs": 0.17320933586536663
        },
        {
            "start_date": "2015-12-01",
            "end_date": "2015-12-31",
            "installs": 0.16983441497332255
        }
    ]
}

Example: Daily Active Users output for “Whatsapp”:

{
    "meta": {
        "request": {
            "granularity": "Monthly",
            "start_date": "2015-10",
            "end_date": "2015-12",
            "store": "Google",
            "app_id": "com.whatsapp",
            "format": "json",
            "country": "us"
        },
        "status": "Success",
        "last_updated": "2016-06-01"
    },
    "daily_active_users": [
        {
            "start_date": "2015-10-01",
            "end_date": "2015-10-31",
            "active_users": 0.08135469789611292
        },
        {
            "start_date": "2015-11-01",
            "end_date": "2015-11-30",
            "active_users": 0.08627763087772664
        },
        {
            "start_date": "2015-12-01",
            "end_date": "2015-12-31",
            "active_users": 0.08183614326653227
        }
    ]
}
  

Example: Sessions / User output for “Whatsapp”:

{
    "meta": {
        "request": {
            "granularity": "Monthly",
            "start_date": "2015-10",
            "end_date": "2015-11",
            "store": "Google",
            "app_id": "com.whatsapp",
            "format": "json",
            "country": "us"
        },
        "status": "Success",
        "last_updated": "2016-06-01"
    },
    "sessions_per_user": [
        {
            "start_date": "2015-10-01",
            "end_date": "2015-10-31",
            "sessions_per_user": 17.53105784468401
        },
        {
            "start_date": "2015-11-01",
            "end_date": "2015-11-30",
            "sessions_per_user": 17.068810620225854
        }
    ]
}
  

Example: Usage Time / Session output for “Whatsapp”:

{
    "meta": {
        "request": {
            "granularity": "Monthly",
            "start_date": "2015-10",
            "end_date": "2015-11",
            "store": "Google",
            "app_id": "com.whatsapp",
            "format": "json",
            "country": "us"
        },
        "status": "Success",
        "last_updated": "2016-06-01"
    },
    "usage_time_per_session": [
        {
            "start_date": "2015-10-01",
            "end_date": "2015-10-31",
            "usage_time_per_session": "00:01:38"
        },
        {
            "start_date": "2015-11-01",
            "end_date": "2015-11-30",
            "usage_time_per_session": "00:01:28"
        }
    ]
}
  

Example: Mobile Apps Retention output for “Whatsapp”:

{
    "meta": {
        "request": {
            "start_date": "2016-01",
            "end_date": "2016-03",
            "store": "Google",
            "app_id": "com.whatsapp",
            "format": "json",
            "country": "us"
        },
        "status": "Success",
        "last_updated": "2016-06-01"
    },
    "retention_list": [
        {
            "days_since_install": 0,
            "retention": 0.5400214773683334
        },
        {
            "days_since_install": 1,
            "retention": 0.44493688754408334
        },
        {
            "days_since_install": 2,
            "retention": 0.4150681131044
        },
        {
            "days_since_install": 3,
            "retention": 0.3936850254784667
        },
        {
            "days_since_install": 4,
            "retention": 0.38747885419486666
        },
        {
            "days_since_install": 5,
            "retention": 0.3827228461086334
        },
        {
            "days_since_install": 6,
            "retention": 0.3792289371410667
        },
        {
            "days_since_install": 7,
            "retention": 0.3743081080898667
        },
        {
            "days_since_install": 8,
            "retention": 0.3683107550511
        },
        {
            "days_since_install": 9,
            "retention": 0.3629385625735
        },
        {
            "days_since_install": 10,
            "retention": 0.35787159904439997
        },
        {
            "days_since_install": 11,
            "retention": 0.3545732000439667
        },
        {
            "days_since_install": 12,
            "retention": 0.3522069411203
        },
        {
            "days_since_install": 13,
            "retention": 0.3500486290762334
        },
        {
            "days_since_install": 14,
            "retention": 0.34780393282283334
        },
        {
            "days_since_install": 15,
            "retention": 0.34486337288776664
        },
        {
            "days_since_install": 16,
            "retention": 0.3419434849496
        },
        {
            "days_since_install": 17,
            "retention": 0.3387563240500333
        },
        {
            "days_since_install": 18,
            "retention": 0.33663537518663333
        },
        {
            "days_since_install": 19,
            "retention": 0.33465460887119997
        },
        {
            "days_since_install": 20,
            "retention": 0.3322778989901
        },
        {
            "days_since_install": 21,
            "retention": 0.32994086037920006
        },
        {
            "days_since_install": 22,
            "retention": 0.3269326291466
        },
        {
            "days_since_install": 23,
            "retention": 0.32403709245613327
        },
        {
            "days_since_install": 24,
            "retention": 0.32132461167433335
        },
        {
            "days_since_install": 25,
            "retention": 0.31882861630886666
        },
        {
            "days_since_install": 26,
            "retention": 0.31768088021176666
        },
        {
            "days_since_install": 27,
            "retention": 0.3169792528075667
        },
        {
            "days_since_install": 28,
            "retention": 0.3153813280014
        },
        {
            "days_since_install": 29,
            "retention": 0.3123617757064167
        },
        {
            "days_since_install": 30,
            "retention": 0.310699695341
        }
    ],
    "loyal_vs_early_churn": {
        "early_churn_share": 0.26799271686066667,
        "early_churn_median_lifetime": 0.45910326151837055,
        "loyal_share": 0.7320072831393334,
        "loyal_median_lifetime": 84.95920983875715
    }
}