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
  }
}