Conversion Rate Benchmarks

GET 100 Credits / Request /accounts/ios/category_benchmarks

Shows the average conversion rates per category for a selected country, channel and date range.

Conversion Rate Benchmarks Request

This method returns the list of categories and their conversion rates in a given country, type of app, channel and date range.

Header parameters
X-AppTweak-Key:
Your AppTweak API Key.
Query parameters
country: string us Required

The two letter country code (ISO Alpha-2) you want to fetch the app in.

us. Get the list of our country codes, here.

type: string Required

The kind of app this benchmark is referring to.

Possible values are: free and paid

channel: string Required

The source of information the benchmark should use.

Possible values are: search (data coming from App Store Search), other (data coming from App Store Browse), appref (data coming from App Referrer), webref (data coming from Web Referrer) and all (all the sources together)

start_date: string Required

The first date for which to get data in YYYY-MM-DD format

end_date: string Required

The last date for which to get data in YYYY-MM-DD format

GET /accounts/ios/category_benchmarks

Request example
GET /accounts/ios/category-benchmarks.json?country=us&type=free&start_date=2019-05-01&end_date=2019-06-01&channel=search
cURL example
curl -X GET -H "X-Apptweak-Key: ${API_KEY}" https://api.apptweak.com/accounts/ios/category-benchmarks.json?country=us&type=free&start_date=2019-05-01&end_date=2019-06-01&channel=search

Conversion Rate Benchmarks response

The response to the Conversion Rate Benchmarks is a hash containing categories. For each category, there's the average conversion rate from impression to page views (also known as Click-through rate or CTR); the average conversion rate from page views to to install units (also known as conversion rate or CVR); the average conversion rate from impressions to install units (also known as Impression Rate or IR) and lastly, the average number of apps for which Apptweak had data for the range of dates requested.

When null values are present for a category, it means we didn't have enough data to calculate the benchmarks for that category in that interval.

Object properties
category code (e.g. 6018): hash

A hash that contains the information about the conversion rates for that category during the selected date range.

CHILD PROPERTIES

impressions_to_page_views: float

The average conversion rate of an app in this category from Impressions to Page Views. Also known as Click-through rate (CTR).

page_views_to_units: float

The average conversion rate of an app in this category from Page Views to Install Units. Also known as Conversion rate (CVR).

impressions_to_units: float

The average conversion rate of an app in this category from Impressions to Install Units. Also known as Impressions rate (IR).

num_apps: float

The average number of apps for which we had data in the date range requested for this category.

Response Example

{
  "content": {
    "6018": {
      "impressions_to_page_views": 4.35,
      "page_views_to_units": 196.06,
      "impressions_to_units": 8.53,
      "num_apps": 20.25
    },
    "6000": {
      "impressions_to_page_views": 3.57,
      "page_views_to_units": 141.4,
      "impressions_to_units": 5.05,
      "num_apps": 156.34
    },
    "6022": {
      "impressions_to_page_views": null,
      "page_views_to_units": null,
      "impressions_to_units": null,
      "num_apps": null
    },
    "6017": {
      "impressions_to_page_views": 4.53,
      "page_views_to_units": 133.11,
      "impressions_to_units": 6.03,
      "num_apps": 307.56
    },
    "6016": {
      "impressions_to_page_views": 4.8,
      "page_views_to_units": 87.17,
      "impressions_to_units": 4.19,
      "num_apps": 511.09
    },
    "6015": {
      "impressions_to_page_views": 5.95,
      "page_views_to_units": 279.94,
      "impressions_to_units": 16.66,
      "num_apps": 89.47
    },
    "6023": {
      "impressions_to_page_views": 4.78,
      "page_views_to_units": 251.92,
      "impressions_to_units": 12.05,
      "num_apps": 78.91
    },
    "6013": {
      "impressions_to_page_views": 7.39,
      "page_views_to_units": 130.77,
      "impressions_to_units": 9.67,
      "num_apps": 593.03
    },
    "6012": {
      "impressions_to_page_views": 4.75,
      "page_views_to_units": 207.83,
      "impressions_to_units": 9.88,
      "num_apps": 323.5
    },
    "6020": {
      "impressions_to_page_views": 6.31,
      "page_views_to_units": 159.07,
      "impressions_to_units": 10.04,
      "num_apps": 26.25
    },
    "6011": {
      "impressions_to_page_views": 4.61,
      "page_views_to_units": 158.07,
      "impressions_to_units": 7.28,
      "num_apps": 49.59
    },
    "6010": {
      "impressions_to_page_views": 2.59,
      "page_views_to_units": 160.49,
      "impressions_to_units": 4.16,
      "num_apps": 23.81
    },
    "6009": {
      "impressions_to_page_views": 2.85,
      "page_views_to_units": 103.1,
      "impressions_to_units": 2.93,
      "num_apps": 86.13
    },
    "6021": {
      "impressions_to_page_views": 1.89,
      "page_views_to_units": 45.7,
      "impressions_to_units": 0.86,
      "num_apps": 63.16
    },
    "6008": {
      "impressions_to_page_views": 5.89,
      "page_views_to_units": 136.61,
      "impressions_to_units": 8.04,
      "num_apps": 107.22
    },
    "6007": {
      "impressions_to_page_views": 6.3,
      "page_views_to_units": 134.39,
      "impressions_to_units": 8.47,
      "num_apps": 174.25
    },
    "6006": {
      "impressions_to_page_views": 4.97,
      "page_views_to_units": 126.58,
      "impressions_to_units": 6.29,
      "num_apps": 41.44
    },
    "6005": {
      "impressions_to_page_views": 4.4,
      "page_views_to_units": 136.14,
      "impressions_to_units": 6,
      "num_apps": 107.59
    },
    "6024": {
      "impressions_to_page_views": 3.87,
      "page_views_to_units": 348.85,
      "impressions_to_units": 13.5,
      "num_apps": 55.75
    },
    "6004": {
      "impressions_to_page_views": 4.6,
      "page_views_to_units": 95.45,
      "impressions_to_units": 4.39,
      "num_apps": 136.78
    },
    "6003": {
      "impressions_to_page_views": 5.12,
      "page_views_to_units": 219.06,
      "impressions_to_units": 11.21,
      "num_apps": 153
    },
    "6002": {
      "impressions_to_page_views": 5.54,
      "page_views_to_units": 227.9,
      "impressions_to_units": 12.62,
      "num_apps": 195.41
    },
    "6001": {
      "impressions_to_page_views": 2.64,
      "page_views_to_units": 209.91,
      "impressions_to_units": 5.54,
      "num_apps": 40.63
    },
    "7001": {
      "impressions_to_page_views": 6.21,
      "page_views_to_units": 46.27,
      "impressions_to_units": 2.87,
      "num_apps": 145.22
    },
    "7002": {
      "impressions_to_page_views": 5.46,
      "page_views_to_units": 48.92,
      "impressions_to_units": 2.67,
      "num_apps": 130.91
    },
    "7003": {
      "impressions_to_page_views": 5.32,
      "page_views_to_units": 67.18,
      "impressions_to_units": 3.57,
      "num_apps": 194.38
    },
    "7004": {
      "impressions_to_page_views": 3.45,
      "page_views_to_units": 132.59,
      "impressions_to_units": 4.58,
      "num_apps": 62.41
    },
    "7005": {
      "impressions_to_page_views": 2.95,
      "page_views_to_units": 125.32,
      "impressions_to_units": 3.7,
      "num_apps": 39.34
    },
    "7006": {
      "impressions_to_page_views": 2.68,
      "page_views_to_units": 125.73,
      "impressions_to_units": 3.38,
      "num_apps": 29.44
    },
    "7007": {
      "impressions_to_page_views": null,
      "page_views_to_units": null,
      "impressions_to_units": null,
      "num_apps": null
    },
    "7008": {
      "impressions_to_page_views": null,
      "page_views_to_units": null,
      "impressions_to_units": null,
      "num_apps": null
    },
    "7009": {
      "impressions_to_page_views": 3.69,
      "page_views_to_units": 87.88,
      "impressions_to_units": 3.24,
      "num_apps": 138.06
    },
    "7010": {
      "impressions_to_page_views": null,
      "page_views_to_units": null,
      "impressions_to_units": null,
      "num_apps": null
    },
    "7011": {
      "impressions_to_page_views": null,
      "page_views_to_units": null,
      "impressions_to_units": null,
      "num_apps": null
    },
    "7012": {
      "impressions_to_page_views": 2.67,
      "page_views_to_units": 130.58,
      "impressions_to_units": 3.49,
      "num_apps": 212.41
    },
    "7013": {
      "impressions_to_page_views": 6.01,
      "page_views_to_units": 65.81,
      "impressions_to_units": 3.96,
      "num_apps": 68.28
    },
    "7014": {
      "impressions_to_page_views": 5.67,
      "page_views_to_units": 66.28,
      "impressions_to_units": 3.76,
      "num_apps": 70.88
    },
    "7015": {
      "impressions_to_page_views": 5.18,
      "page_views_to_units": 64.37,
      "impressions_to_units": 3.34,
      "num_apps": 140.16
    },
    "7016": {
      "impressions_to_page_views": 5.12,
      "page_views_to_units": 66.86,
      "impressions_to_units": 3.42,
      "num_apps": 61.09
    },
    "7017": {
      "impressions_to_page_views": 5.92,
      "page_views_to_units": 42.44,
      "impressions_to_units": 2.51,
      "num_apps": 62.75
    },
    "7018": {
      "impressions_to_page_views": 3.57,
      "page_views_to_units": 109.84,
      "impressions_to_units": 3.92,
      "num_apps": 29.34
    },
    "7019": {
      "impressions_to_page_views": 3.14,
      "page_views_to_units": 161.27,
      "impressions_to_units": 5.07,
      "num_apps": 51.22
    }
  },
  "metadata": {
    "request": {
      "path": "/accounts/ios/category-benchmarks.json",
      "params": {
        "country": "us",
        "type": "free",
        "start_date": "2019-05-01T00:00:00+00:00",
        "end_date": "2019-06-01T00:00:00+00:00",
        "channel": "search",
        "format": "json"
      },
      "performed_at": "2019-07-10 14:53:06 UTC"
    },
    "content": {
    }
  }
}