You can access Google Play Console metrics through 2 different endpoints:

• Google Play Console - Store Performance returns Store Listing Visitors and Store Listing Acquisitions with a breakdown by acquistion channel
• Google Play Console - Organic Search returns organic keyword performance by providing Store Listing Visitors and Store Listing Acquisitions per keyword

Available history

We fetch historical data up to February 25th 2020.

Update frequency

Based on the email AppTweak e-mail address that you have invited on your Google account you will have different update frequencies. Go to your Google Play Console and go on the section "Users and permissions" on the left menu to find back the AppTweak email address you've invited. You can refer to the following table to find the correspondance between the update frequency and the email address:

Delay in the Data

You may notice a couple of days' delay between today and the last registered data point. Two different reasons may cause this:

• Google has not yet provided the data for the most recent date (most common), or
• AppTweak has not yet fetched the data.

Delay due to Google
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.

Delay due to AppTweak

Extra delay can be expected depending on the email used for the integration (see Update Frequency).

Moreover for Goole Play Console - Organic Search we have seen that such data changes a lot over its first days. Therefore, we have decided to wait 6 days before tracking the data, giving it sufficient time to stabilize.

Google Play Console - Store Performance

The Google Play Console - Store Performance endpoint allows you to access:

• Store Listing Acquisitions (All users)
• Store Listing Acquisitions (New users)
• Store Listing Acquisitions (Returning users)
• Store Listing Visitors (All users)
• Store Listing Visitors (New users)
• Store Listing Visitors (Returning users)

"All users" include both new and returning users that visit your app page or installed your app. For each metric you can get the breakdown by channel of acquistion with the query parameter channel.

To get the equivalent values in your Google Play Console, go to Store performance > Store Analysis > Conversion Analysis. View by the country you want to analyse. See below for the view in your console.

If you want to have the metrics with a breakdown by channel you need to add a filter by "Traffic source" in your console.

📘

Inconsistent data

Google regularly changes the data in the console retrospectively. This can lead to inconsistencies between the data we show in AppTweak and the data shown in the console for the most recent dates. The inconsistencies are updated when we next fetch the data on the console.

Input parameters

The different sources can be accessed using the query parameter channel in the Google Play Console - Store Performance endpoint. You can pass one or multiple channels in the query parameters. In the table beneath you can find the equivalence between the channel name and Google Play Console source name.

Response format

The response for the playstore performance report request will be a JSON which contains all the info related to the google play console, without pagination. This information is organized by app, country and then channel. Both "Store Listing Visitors" and "Store Listing Acquisitions" are returned in the response.

{
  "content": {
    "dummy.app.com": {
      "us": {
        "all": { // Channel of the traffic source
          "start_date": "2021-01-01",
          "end_date": "2021-01-31",
          "visitors": [ // List of Store Listing Visitors. First entry corresponds to start date
            5,
            2,
            ...
          ],
          "visitors_new": [ // List of Store Listing Visitors. First entry corresponds to start date
            3,
            1,
            ...
          ],
          "visitors_returning": [ // List of Store Listing Visitors. First entry corresponds to start date
            2,
            1,
            ...
          ],
          "acquisition": [ // List of Store Lisiting Acquisition. First entry corresponds to start date
            0,
            1,
            ...
          ],
          "acquisition_new": [ // List of Store Lisiting Acquisition. First entry corresponds to start date
            0,
            1,
            ...
          ],
          "acquisition_returning": [ // List of Store Lisiting Acquisition. First entry corresponds to start date
            0,
            0,
            ...
          ]
        }
      }
    }
  },
  "metadata": {
    "request": {
      "path": "/accounts/8555cca4-2fbb-401e-893d-41fc9230cdc5/android/store_analysis.json",
      "params": {
        "start_date": "2021-01-01T00:00:00+00:00",
        "end_date": "2021-01-31T00:00:00+00:00",
        "app_ids": "dummy.app.com",
        "channels": "all",
        "countries": "us",
        "id": "{api-account-id}",
        "format": "json"
      },
      "performed_at": "2021-04-28 12:27:04 UTC"
    },
    "content": {}
  }
}

Google Play Console - Organic Search

Using the Organic Search endpoint, you can retrieve a list of keywords that generated organic traffic for any connected app within the specified date range. You will also get the breakdown of Store Listing Visitors & Store Listing Acquisitions per keyword.

Input parameters

You can find all the required and optional query parameters in the "QUERY PARAMS" section of the definition of the endpoint, accessible here.

Response format

The response for the playstore performance report request will be a JSON which contains all the info related to the google play console, without pagination. This information is grouped by app, country and then keyword.

{
  "result": {
    "dummy.app.com": {
      "BE": { // country code, ordered alphabetically 
        "puzzle game": [ // keyword for which you're getting SLV & SLA
          {
            "start_date": "2023-05-09",
            "end_date": "2023-05-10",
            "visitors": [
              23, // List of Store Listing Visitors. First entry corresponds to start date.
              19],
            "installs": [
              3, // List of Store Lisiting Acquisition. First entry corresponds to start date
              4]
          }],
        "word game": [
          {
            "start_date": "2023-05-09",
            "end_date": "2023-05-10",
            "visitors": [
              103, 
              69],
            "installs": [
              23, 
              14]
          }]
      },
      "FR": ...
    },     
  "metadata": {
    "request": {
      "path": "/api/public/integrations/accounts/android/organic-search.json",
      "params": {
        "start_date": "2023-05-09",
        "end_date": "2023-05-10",
        "id": "{api-account-id}",
        "apps": [
          "dummy.app.com"
        ],
        "countries": [
          "be",
          "fr"
        ]
      },
      "cost": 1,
      "max_credit_cost": 1,
      "status": 200
    },
    "response": null
  }
}