Dimensions Cheat Sheet

🚧
Guidelines

Make sure to pass all required filters.

Follow the 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_item`	`start_date` `end_date`	`campaign`, `platform` `country`, `site_id`	Returns the top 1,000 rows, sorted by `spent`. Response includes item columns. max date range = 24h The `item` filter is not supported.
`by_item_by_smallest_time_bucket`	`start_date` `end_date` `item`* *Seenotes	`platform` `country` `site_id`	Returns all rows. Response does not include item columns. max date range = 24h The `item` filter is required. To pass more than 20 `item` filters, limit the date range to 1h.

Dimension

Required Filters

Optional Filters

Notes

by_item

start_date
end_date

campaign,
platform
country,
site_id

Returns the top 1,000 rows, sorted by spent.

Response includes item columns.

max date range = 24h

The item filter is not supported.

by_item_by_smallest_time_bucket

start_date
end_date
item*

*Seenotes

platform
country
site_id

Returns all rows.

Response does not include item columns.

max date range = 24h

The item filter is required.

To pass more than 20 item filters, limit the date range to 1h.

🚧
by_item_by_smallest_time_bucket
When using the by_item_by_smallest_time_bucket dimension, the item filter is required.
As such, the recommended practice is not to pass a campaign filter.
(The items passed will determine the relevant campaigns.)

🚧
by_item
When using the by_item dimension, the item filter is not suppoprted.
You can, however, filter on 1 or more campaigns.

Dimensions Cheat Sheet

Guidelines

smallest_time_bucket

`by_item_by_smallest_time_bucket`

`by_item`