API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

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.

DimensionRequired FiltersOptional FiltersNotes
by_hourstart_date
end_date
campaign
platform
country
max date range = 24h
by_smallest_time_bucketstart_date
end_date
campaign
platform
country
max date range = 24h
by_campaignstart_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_bucketstart_date
end_date
campaign*

----
* See notes
platform
country
campaign filter:

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_sitestart_date
end_date
campaign
platform
country
max date range = 24h

Returns the top 10,000 sites (sorted by spent).
by_site_by_smallest_time_bucketstart_date
end_date
site_id*

----
* See notes
campaign
platform
country
site_id filter:

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.