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.
Record attributes
Section titled “Record attributes”| 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. |
Bulk export fields
Section titled “Bulk export fields”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}