Skip to content

App retention

Monthly retention estimates for an app in a country. These fields are returned by the App retention endpoint and included in the app_retention_data bulk export.

Attribute Description
app_id String, store-specific app ID. Apple App Store IDs are represented as strings; Google Play IDs are package names.
country_iso String, country code in ISO 3166-1 alpha-2 format.
year Integer, year of measurement.
month Integer, month of measurement, from 1 to 12.
retention Object mapping day keys, such as day1, day7, and day30, to numeric retention estimates. Available day keys can vary by record.

The app_retention_data export also includes the app’s category fields:

Attribute Description
primary_category_id Integer or null, store-specific primary category ID.
primary_subcategory_id Integer or null, store-specific primary subcategory ID.

Category fields can be null when app metadata is unavailable. The measurement period is identified by year and month.

This illustrative export record shows the structure:

{
"app_id": "com.example.app",
"country_iso": "US",
"year": 2026,
"month": 9,
"retention": {
"day1": 0.5,
"day7": 0.25
},
"primary_category_id": null,
"primary_subcategory_id": null
}