Dimensions Cheat Sheet

๐Ÿšง

Guidelines

  1. Make sure to pass all required filters.
  2. Follow the guidelines provided in the Notes column.

๐Ÿ“˜

smallest_time_bucket

The smallest_time_bucket denotes a time interval of 5 minutes.

DimensionRequired FiltersOptional FiltersNotes
by_itemstart_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_bucketstart_date
end_date
item*

----
* See notes
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.