The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak.
The Google Play Reports Statistics endpoint allows you to fetch different reports related to your Google Play Reports integrations in AppTweak.
Available history
We fetch all the available CSVs. In other words, we fetch all the available historical data.
Update frequency
We're fetching the data on a daily basis.
Delay in the Data
You may notice a couple of days' delay between today and the last registered data point. Google never provides the data until today, there is usually a 3-day difference between the last available data in the console and today. This delay can sometimes be longer.
Input parameters
The following table lists the property parameters to access different type of data from your Google Play Report integration
| path parameter property | returned metrics |
|---|---|
| units | The number of new users installs and the number of new device installs. |
| uninstalls | The number of users who uninstalled your app from all of their devices. |
| sales | The number of app sales, in-app product sales, or subscription sales. |
| subscriptions | The number of new subscriptions, active subscriptions and cancelled subscriptions. |
Response format
Each property will return one or multiple metrics from the Google Play Reports.
units
The units property will return the following fields in the response
| response field | description |
|---|---|
| daily_devices | The list of new daily device installs for the given date range. |
| total_devices | The total amount of device installs for the given date range. |
| daily_users | The list of new daily user installs for the given date range. |
| total_users | The total amount of user installs for the given date range. |
| devices_growth | The average of daily device installs for the given date range. |
| users_growth | The average of daily user installs for the given date range. |
| devices_growth_variation | The variation between the daily device installs growth for the selected date range and the previous equivalent date range. |
| users_growth_variation | The variation between the daily user installs growth for the selected date range and the previous equivalent date range. |
Please find a response example below:
{
"result": {
"my.dummy.app": [
{
"fr": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"daily_devices": [ // List of daily new device installs
23, // The first entry corresponds to the start_date
13
],
"total_devices": 36, // Sum of all the new device installs over the daterange
"daily_users": [ // List of daily new user installs
20, // The first entry corresponds to the start_date
7
],
"total_users": 27, // Sum of all the new users installs over the datarange
"devices_growth": 18,
"users_growth": 13.5,
"devices_growth_variation": -5.5,
"users_growth_variation": -5.5
}
}
]
},
"metadata": {
"request": {
"path": "/api/public/integrations/accounts/reports",
"params": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"id": "{my-api-account-id}",
"devices": [
"android"
],
"property": "units",
"apps": null,
"countries": [
"fr"
]
},
"cost": 1,
"max_credit_cost": 1,
"status": 200
},
"response": null
}
}
uninstalls
The uninstalls property will return the following fields in the response
| response field | description |
|---|---|
| daily_users_uninstalls | The list of daily user uninstalls for the given date range. |
| total_users_uninstalls | The total amount of user uninstalls for the given date range. |
| users_uninstalls_growth | The average of daily user uninstalls for the given date range. |
| users_uninstalls_growth_variation | The variation between the daily user uninstalls growth for the selected date range and the previous equivalent date range. |
Please find a response example below:
{
"result": {
"my.dummy.app": [
{
"fr": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"daily_users_uninstalls": [
12,
4
],
"total_users_uninstalls": 16,
"users_uninstalls_growth": 8,
"users_uninstalls_growth_variation": -3.5
}
}
]
},
"metadata": {
"request": {
"path": "/api/public/integrations/accounts/reports",
"params": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"id": "{my-api-account-id}",
"devices": [
"android"
],
"property": "uninstalls",
"apps": null,
"countries": [
"fr"
]
},
"cost": 1,
"max_credit_cost": 1,
"status": 200
},
"response": null
}
}
sales
To get the sales for Android apps, we fetch the data coming from Financial Reports > Earnings Report from your Google Play Console, we convert all earnings to USD and then we sum all your earnings to compute your app's total revenue.
The sales property will return the following fields in the response
| response field | description |
|---|---|
| values | List of values of the daily revenues for the given date range. |
Please find a response example below:
{
"result": {
"my.dummy.app": [
{
"uy": {
"start_date": "2022-11-14",
"end_date": "2022-11-15",
"values": [
72.72,
110.25
]
}
}
]
},
"metadata": {
"request": {
"path": "/api/public/integrations/accounts/reports",
"params": {
"start_date": "2022-11-14",
"end_date": "2022-11-15",
"id": "{my-api-account-id}",
"devices": [
"android"
],
"property": "sales",
"apps": null,
"countries": [
"us"
]
},
"cost": 1,
"max_credit_cost": 1,
"status": 200
},
"response": null
}
}
subscriptions
You can find object properties of the request response in the following table:
| response field | type | description |
|---|---|---|
| new_subscriptions | integer array | The list of new subscriptions for all dates in the given date range. |
| total_new_subscriptions | integer | The amount of new subscriptions during all the date range. |
| active_subscriptions | integer array | The list of active subscriptions for all dates in the given date range. |
| total_active_subscriptions | integer | The amount of active subscriptions during all the date range. |
| cancelled_subscriptions | integer array | The list of cancelled subscriptions for all dates in the given date range. |
| total_cancelled_subscriptions | integer | The amount of cancelled subscriptions during all the date range. |
| new_subscriptions_growth | double | The average of new subscriptions during all the date range. |
| active_subscriptions_growth | double | The average of active subscriptions during all the date range. |
| cancelled_subscriptions_growth | double | The average of cancelled subscriptions during all the date range. |
| new_subscriptions_growth_variation | double | The variation between the new subscriptions growth for the selected date range and the previous equivalent date range. |
| active_subscriptions_growth_variation | double | The variation between the active subscriptions growth for the selected date range and the previous equivalent date range |
| cancelled_subscriptions_growth_variation | double | The variation between the cancelled subscriptions growth for the selected date range and the previous equivalent date range. |
Please find a response example below:
{
"result": {
"my.dummy.app": [
{
"dk": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"new_subscriptions": [
232,
320
],
"total_new_subscriptions": 552,
"active_subscriptions": [
2107,
909
],
"total_active_subscriptions": 3096,
"cancelled_subscriptions": [
339,
151
],
"total_cancelled_subscriptions": 490,
"new_subscriptions_growth": 276,
"active_subscriptions_growth": 1548,
"cancelled_subscriptions_growth": 245,
"new_subscriptions_growth_variation": 499,
"active_subscriptions_growth_variation": 356,
"cancelled_subscriptions_growth_variation": 245
}
}
]
},
"metadata": {
"request": {
"path": "/api/public/integrations/accounts/reports",
"params": {
"start_date": "2022-12-14",
"end_date": "2022-12-15",
"id": "{my-api-account-id}",
"devices": [
"android"
],
"property": "subscriptions",
"apps": null,
"countries": [
"dk"
]
},
"cost": 1,
"max_credit_cost": 1,
"status": 200
},
"response": null
}
}