Dimensions Cheat Sheet

๐Ÿšง

Guidelines

For each dimension:

  1. Make sure to pass all required filters.
  2. 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*

  • Seenotes

platform
country

campaignfilter:

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*

  • Seenotes

campaign
platform
country

site_idfilter:

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_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*

  • Seenotes

campaign
platform

countryfilter:

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*

  • Seenotes

campaign
country

platformfilter:

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.