Ad Revenue Metrics

This query provides detailed advertising revenue metrics for a YouTube channel over a specified time period, including gross revenue, CPM (Cost Per Mille), ad impressions, and monetized playbacks. Data can be aggregated by day or month.

Parameters

Dimension

Specifies how to aggregate the data:

• Day: Daily aggregation.
• Month: Monthly aggregation (requires start and end dates to be first day of a month).

Note: Note that rolling seven or thirty days are not supported by the Analytics API anymore.

Start Date

The beginning date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-01-01).

• Cannot be in the future.
• Must align with month start if using monthly dimension.

End Date

The end date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-09-30).

• Cannot be in the future.
• Must be after Start Date.
• Must align with month end if using monthly dimension.

Tip: For scheduled requests, you may need to update the date daily. Instead of specifying the date manually, you can use 'today' or 'yesterday' as the parameter. When the request runs, the date will automatically adjust to the desired day.

IDs

Specifies the channel for which to retrieve data.

• Options:
  • "channel==MINE": Fetches data for your own channel.
  • "channel==CHANNEL_ID": Retrieves data for a specific channel you own.

Sort (Optional)

Determines the order of results:

• Examples:

  • "-grossRevenue" for sorting by gross revenue in descending order.
  • "-adImpressions" for sorting by ad impressions in descending order.
  • "-cpm" for sorting by CPM in descending order.

  Tip: You can find the technical names of the metrics you can sort by when you click on the chart symbol at the bottom of the Parameters section.

Filters (Optional)

Defines specific data criteria:

• Examples:
  • "country==US" to filter by country.
  • 'video==VIDEO_ID' to filter by a specific video identified by its ID. Replace VIDEO_ID with the ID of a video from your channel. You can also enter a comma-separated list of video IDs to retrieve up to 200 results.

Columns

• Dimension: Day or month.

• Gross Revenue: Total revenue generated from all ad formats before any revenue sharing.

• CPM: Cost Per Mille (thousand impressions). The average amount advertisers pay per thousand ad impressions.

• Ad Impressions: Total number of ads shown to viewers. This includes all ad formats (display, overlay, skippable and non-skippable video ads).

• Monetized Playbacks: Number of video playbacks that included at least one ad impression. This metric helps understand what percentage of your views are generating ad revenue.

• Playback Based CPM: Average revenue per thousand video playbacks, regardless of how many ads were shown. This metric helps understand revenue generation on a per-view basis rather than per-impression basis.