Ad Size Performance

Returns ads performance per ad container size, totalled over the selected period, for the selected country. This is the data behind the Ad Size Performance table. Returns one row per ad size, sorted by impressions.

Request

Method: GET
Endpoint: https://console.overwolf.com/api/stats/revenue-v2/ad-size-performance

Query parameters

Name

Type

Description

app_idRequired

string

The UID of an app you have access to.

days_back

string

The period to return. Default: Yesterday.

Allowed values: Yesterday, Last 30 Days, Last 90 Days

country

string

A country name as it appears in the dashboard Country filter. Default: All Countries.

Additional parameters

Name

Type

Description

AuthorizationRequired

header

string

Key <your-console-email>:<your-api-key>. For more information, see the Revenue APIs overview.

Response

The response is a JSON object with a columns array and a rows array. Each row has these fields:

Field	Description
`ad_size`	Ad container size.
`impressions`	Ads actually shown.
`gross_revenue`	Gross ads revenue, before the Overwolf revenue share, in USD.
`net_revenue`	Net ads revenue, after the Overwolf revenue share, in USD.
`gross_cpm`	Gross revenue per 1,000 impressions.
`net_cpm`	Net revenue per 1,000 impressions.
`share_of_revenue_pct`	This ad size's share of the app's total revenue.
`share_of_revenue_pct_gross`	This ad size's share of the app's total gross revenue.
`country_name`	Country name, or `All Countries` for all countries combined.
`app_id`	Your app UID.
`updated_at`	When the data was last updated.

200

Ad Size Performance

Field	Type
`columns.name`	string
`columns.friendly_name`	string
`columns.type`	string
`rows.ad_size`	string
`rows.impressions`	integer
`rows.gross_revenue`	number
`rows.net_revenue`	number
`rows.gross_cpm`	number
`rows.net_cpm`	number
`rows.share_of_revenue_pct`	number
`rows.share_of_revenue_pct_gross`	number
`rows.country_name`	string
`rows.app_id`	string
`rows.updated_at`	string

Request

https://console.overwolf.com/api/stats/revenue-v2/ad-size-performance?app_id=YOUR_APP_ID&days_back=Yesterday&country=All%20Countries

Response

{
  "columns": [
    {
      "name": "ad_size",
      "friendly_name": "ad_size",
      "type": "string"
    },
    {
      "name": "impressions",
      "friendly_name": "impressions",
      "type": "integer"
    },
    {
      "name": "gross_revenue",
      "friendly_name": "gross_revenue",
      "type": "float"
    },
    {
      "name": "net_revenue",
      "friendly_name": "net_revenue",
      "type": "float"
    },
    {
      "name": "gross_cpm",
      "friendly_name": "gross_cpm",
      "type": "float"
    },
    {
      "name": "net_cpm",
      "friendly_name": "net_cpm",
      "type": "float"
    },
    {
      "name": "share_of_revenue_pct",
      "friendly_name": "share_of_revenue_pct",
      "type": "float"
    },
    {
      "name": "share_of_revenue_pct_gross",
      "friendly_name": "share_of_revenue_pct_gross",
      "type": "float"
    },
    {
      "name": "country_name",
      "friendly_name": "country_name",
      "type": "string"
    },
    {
      "name": "app_id",
      "friendly_name": "app_id",
      "type": "string"
    },
    {
      "name": "updated_at",
      "friendly_name": "updated_at",
      "type": "datetime"
    }
  ],
  "rows": [
    {
      "ad_size": "All Sizes",
      "impressions": 0,
      "gross_revenue": 0,
      "net_revenue": 0,
      "gross_cpm": 0,
      "net_cpm": 0,
      "share_of_revenue_pct": 0,
      "share_of_revenue_pct_gross": 0,
      "country_name": "All Countries",
      "app_id": "YOUR_APP_ID",
      "updated_at": "YYYY-MM-DDTHH:MM:SS"
    }
  ]
}