Dimensions Cheat Sheet

🚧
Guidelines
For each dimension:

Make sure to pass all required filters.

Follow the specific guidelines provided in the Notes column.

📘
smallest_time_bucket
The smallest_time_bucket denotes a time interval of 5 minutes.

Dimension	Required Filters	Optional Filters	Notes
`by_hour`	`start_date` `end_date`	`campaign` `platform` `country`	max date range = 24h
`by_smallest_time_bucket`	`start_date` `end_date`	`campaign` `platform` `country`	max date range = 24h
`by_campaign`	`start_date` `end_date`	`platform` `country` `fetch_config`	max date range = 24h If you pass `fetch_config=true`, the report returns the top 1,000 campaigns (sorted by `spent`). Otherwise, it returns the top 10,000 campaigns.
`by_campaign_by_smallest_time_bucket`	`start_date` `end_date` `campaign`* See notes	`platform` `country`	`campaign`filter: For this dimension, the `campaign` filter is recommended. If passed, then max date range = 24h Else, max date range = 1h To pass more than 20 `campaign` filters, limit the date range to 1h.
`by_site`	`start_date` `end_date`	`campaign` `platform` `country`	max date range = 24h Returns the top 10,000 sites (sorted by `spent`).
`by_site_by_smallest_time_bucket`	`start_date` `end_date` `site_id`* See notes	`campaign` `platform` `country`	`site_id`filter: For this dimension, the `site_id` filter is recommended. If passed, then max date range = 24h Else, max date range = 1h To pass more than 20 `site_id` filters, limit the date range to 1h.
`by_site_by_campaign`	`start_date` `end_date`	`campaign` `platform` `country`	max date range = 24h Returns one row per site-campaign combination (includes `campaign_id` and `campaign_name`). Returns the top 10,000 site-campaign combinations (sorted by `spent`).
`by_country`	`start_date` `end_date`	`campaign` `platform`	max date range = 24h Returns the top 10,000 countries (sorted by `spent`).
`by_country_by_smallest_time_bucket`	`start_date` `end_date` `country`* See notes	`campaign` `platform`	`country`filter: For this dimension, the `country` filter is recommended. If passed, then max date range = 24h Else, max date range = 1h To pass more than 20 `country` filters, limit the date range to 1h.
`by_platform`	`start_date` `end_date`	`campaign` `country`	max date range = 24h Returns all platform rows.
`by_platform_by_smallest_time_bucket`	`start_date` `end_date` `platform`* See notes	`campaign` `country`	`platform`filter: For this dimension, the `platform` filter is recommended. If passed, then max date range = 24h Else, max date range = 1h To pass more than 3 `platform` filters, limit the date range to 1h.