Daily Ads Metrics

Returns daily ads metrics broken down by ad size, country, window, and ad container. This is the data behind the Daily Ads Metrics table. Returns one row per day for each combination of ad size, country, window, and container. Use the filters to narrow the results.

To see results per ad placement, set a container ID on your ad units. For more information, see OwAd Container ID for Native apps (containerId) or owadview Container ID for Electron apps (cid).

Opportunities data is available from late July 2026. Earlier dates show no opportunities data.

Request

Method: GET
Endpoint: https://console.overwolf.com/api/stats/revenue-v2/daily-ads-metrics

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: Last 30 Days.

Allowed values: Yesterday, Last 30 Days

ad_size

string

An ad size, or All Sizes. Default: All Sizes.

window_name

string

An app window name, or All Windows. Default: All Windows.

country

string

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

container_id

string

An ad container ID, or All Containers. Default: All Containers.

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
`revenue_date`	The date.
`ad_size`	Ad container size.
`window_name`	App window name, or `All Windows` for all windows combined.
`container_id`	Ad container ID.
`total_impressions`	Ads actually shown.
`Opportunities`	Times an ad slot was requested or available. Note the capital `O`.
`total_gross_revenue`	Gross ads revenue, in USD.
`total_net_revenue`	Net ads revenue, in USD.
`gross_cpm`	Gross revenue per 1,000 impressions, in USD.
`net_cpm`	Net revenue per 1,000 impressions, in USD.
`country_name`	Country name, or `All Countries` for all countries combined.
`country`	Country identifier for `country_name`.
`app_id`	Your app UID.
`updated_at`	When the data was last updated.

200

Daily Ads Metrics

Field	Type
`columns.name`	string
`columns.friendly_name`	string
`columns.type`	string
`rows.revenue_date`	string
`rows.ad_size`	string
`rows.window_name`	string
`rows.container_id`	string
`rows.total_impressions`	integer
`rows.Opportunities`	integer
`rows.total_gross_revenue`	number
`rows.total_net_revenue`	number
`rows.gross_cpm`	number
`rows.net_cpm`	number
`rows.country_name`	string
`rows.country`	string
`rows.app_id`	string
`rows.updated_at`	string

Request

https://console.overwolf.com/api/stats/revenue-v2/daily-ads-metrics?app_id=YOUR_APP_ID&days_back=Last%2030%20Days&ad_size=All%20Sizes&window_name=All%20Windows&country=All%20Countries&container_id=All%20Containers

Response

{
  "columns": [
    {
      "name": "revenue_date",
      "friendly_name": "revenue_date",
      "type": "date"
    },
    {
      "name": "ad_size",
      "friendly_name": "ad_size",
      "type": "string"
    },
    {
      "name": "window_name",
      "friendly_name": "window_name",
      "type": "string"
    },
    {
      "name": "container_id",
      "friendly_name": "container_id",
      "type": "string"
    },
    {
      "name": "total_impressions",
      "friendly_name": "total_impressions",
      "type": "integer"
    },
    {
      "name": "Opportunities",
      "friendly_name": "Opportunities",
      "type": "integer"
    },
    {
      "name": "total_gross_revenue",
      "friendly_name": "total_gross_revenue",
      "type": "float"
    },
    {
      "name": "total_net_revenue",
      "friendly_name": "total_net_revenue",
      "type": "float"
    },
    {
      "name": "gross_cpm",
      "friendly_name": "gross_cpm",
      "type": "float"
    },
    {
      "name": "net_cpm",
      "friendly_name": "net_cpm",
      "type": "float"
    },
    {
      "name": "country_name",
      "friendly_name": "country_name",
      "type": "string"
    },
    {
      "name": "country",
      "friendly_name": "country",
      "type": "string"
    },
    {
      "name": "app_id",
      "friendly_name": "app_id",
      "type": "string"
    },
    {
      "name": "updated_at",
      "friendly_name": "updated_at",
      "type": "datetime"
    }
  ],
  "rows": [
    {
      "revenue_date": "YYYY-MM-DD",
      "ad_size": "All Sizes",
      "window_name": "All Windows",
      "container_id": "All Containers",
      "total_impressions": 0,
      "Opportunities": 0,
      "total_gross_revenue": 0,
      "total_net_revenue": 0,
      "gross_cpm": 0,
      "net_cpm": 0,
      "country_name": "All Countries",
      "country": "<country>",
      "app_id": "YOUR_APP_ID",
      "updated_at": "YYYY-MM-DDTHH:MM:SS"
    }
  ]
}