If a filter is not listed, then it is not supported by that dimension.
Dimension | Dimension Column(s) | Mandatory Filters | Optional Filters |
|---|---|---|---|
day | date | start_date, end_date | campaign, platform, country, site |
week | date, date_end_period | start_date, end_date | campaign, platform, country, site |
month | date, date_end_period | start_date, end_date | campaign, platform, country, site |
| hour_of_day | start_date, end_date | campaign, platform, country, site |
| date, campaign, campaign_name |
|
|
| content_provider, content_provider_name | start_date, end_date | platform, country, site |
| content_provider, content_provider_name, | start_date, end_date | |
campaign_breakdown | campaign, campaign_name, campaign_learning_state | start_date, end_date |
|
site_breakdown | site, site_name, blocking_level | start_date, end_date | campaign |
country_breakdown | country, country_name | start_date, end_date | campaign |
region_breakdown | region, country | start_date, end_date | campaign |
dma_breakdown | dma, country | start_date, end_date | campaign |
platform_breakdown | platform, platform_name | start_date, end_date | campaign |
os_family_breakdown | platform, platform_name, os_family | start_date, end_date | platform, os_family, campaign |
os_version_breakdown | platform, platform_name, os_version | start_date, end_date | platform, os_version, campaign |
browser_breakdown | platform, platform_name, browser | start_date, end_date | platform, browser, campaign |
campaign_day_breakdown | date, campaign, campaign_name | start_date, end_date |
|
campaign_site_day_breakdown | date, campaign, campaign_name, site, site_name |
|
|
| data_partner_audience_id, partner_name, audience_name, | start_date, end_date |
|
contextual_breakdown | data_partner_audience_id, | start_date, end_date | campaign |
exclude_empty_campaignsBy default, the following dimensions return all campaigns:
campaign_breakdowncampaign_hour_breakdowncampaign_day_breakdowncampaign_site_day_breakdownTo exclude empty campaigns (impressions = 0), pass
exclude_empty_campaigns=true.For more detail, see thisannouncement.
by_hour_of_dayTo fetch data by hour, aggregated for a given date range, use the
by_hour_of_daydimension. You can optionally filter on a given campaign. E.g.:
.../dimensions/by_hour_of_day?start_date=2021-10-01&end_date=2021-10-07&campaign=123(theend_dateis inclusive)
- The report returns 24 rows, with aggregated data for each hour of the day.
- Reporting data is retained for 90 days.
For more detail, see thisannouncement.
campaign_hour_breakdownWhen using the
campaign_hour_breakdowndimension, pass a date and time for the reporting interval. (The values passed should reflect the time zone of that account.) E.g.
.../dimensions/campaign_hour_breakdown?start_date=2021-10-01T13:00:00&end_date=2021-10-02T12:59:59
- The report returns 1 row per campaign/date/hour in the reporting interval.
- Reporting data is retained for 90 days.
For more detail, see thisannouncement.
user_segment_breakdown
- The purpose of the
user_segment_breakdowndimension is twofold:
- For a campaign that targets 3rd Party Audience Segments (aka Marketplace Audiences), this dimension shows performance stats per targeted audience.
- For a campaign that does not target any audiences at all (i.e. a "Run On Network" or "RON" campaign), this dimension shows performance stats across all relevant audience segments - so that you can decide which audiences are good candidates for targeting.
- This dimension should be run against a single campaign (by applying the
campaignfilter).- If audience targeting was applied for any of the other audience types (e.g. Custom Audiences, Lookalike Audiences, First Party Audiences, etc), then the
user_segment_breakdowndimension will not show any data for the selected campaign. (This rule applies regardless of any 3rd Party Audience targeting for that campaign.)- The above audience targeting types are sometimes loosely referred to as First Party Audiences - because the data belongs to the advertiser. However, in our API docs, we use the term First Party Audiences to refer specifically to DMP integration.
ColumnsFor an explanation of each dimension-specific column, see Dimension Columns below.