Table of Contents
...
Polling request body (example)
**NOTE that you must add the report_id to the initial payload.
Code Block |
---|
{ "report_id": "15118956000004308405d5cf3f869a6208b768f0295eb", "start_date": "2017-11-28", "end_date": "2015-11-15", "interval": "day", "dimensions": ["supply_type"], "async": "true" } |
...
parameter | options (if applicable) | notes |
---|---|---|
start_date | "2015-12-01 00:00:00" or "2015-12-01" | minutes and seconds are ignored ie must be "yyyy-mm-dd hh:00:00" |
end_date | "2015-12-02 00:00:00" or "2015-12-01" | minutes and seconds are ignored ie must be "yyyy-mm-dd hh:00:00" |
interval | "hour", "day", "cumulative" | |
timezone | "UTC", "America/New_York" | defaults to America/New_York |
date_range | Today, Yesterday, Last 7 Days | date_range takes precedence over start_date/end_date |
sort | an array of dimensions | ex. `["supply_tag_id desc"]` |
dimensions | supply_tag_id, demand_tag_id, declared_domain, detected_domain, demand_type, supply_type, supply_router_id, supply_partner_id, demand_partner_id, supply_tag_label, demand_tag_label, key_values, country, declared_player_size, detected_player_size, demand_code, device_id, marketplace_type, buying_demand_tag_id, selling_supply_tag_id, campaign_id, campaign_name, environment, vpaid_type, app_name, app_bundle, os_id, adomain, content_id, content_title, channel_name, content_genre, content_episode, content_season, content_series, network_name, production_quality, rating, livestream, language | domain is only available when using date_range of Today, Yesterday, or Last 7 Days to add a specific key as a dimension: "key:my_key" please note that some dimensions are mutually exclusive, you cannot run a key-value report with adomain or content dimensions, for example |
the following parameters act as filters; pass an array of values (usually IDs) | ||
supply_router_ids | [1234, 5678] | |
supply_tag_ids | [22423,22375, 25463] | can filter by one or more supply tag |
demand_tag_ids | [22423,22375, 25463] | |
declared_domains | ["nytimes.com", "weather.com"] | |
detected_domains | ["nytimes.com", "weather.com"] | |
supply_types | ["Syndicated","Third-Party"] | |
supply_partner_ids | [30,42,41] | |
supply_tag_label_ids | [13,15,81] | |
demand_partner_ids | [3,10,81] | |
demand_tag_label_ids | [4, 8, 10] | |
demand_types | ["Vast Only","FLASH"] | |
demand_codes | [10023, 13341, 12343] | |
account_id | 103 | Relevant if you have access to multiple account ids. Cannot be a list of ids. |
limit | 10 | Limit the number of records returned |
page | 10 | The page requested for results over 20K rows. If there are 20,000 entries in your result, you need to call multiple pages, until you get an empty response. |
keys | ["my_key1", "my_key2"] | |
key_values | {"my_key":"my_value"} | |
environments | ["desktop", "mobile"] | |
buying_demand_tag_ids | [134523, 198523, 123413] | |
selling_supply_tag_ids | [93471, 51235, 102345] | |
vpaid_types | ["both", "flash"] | |
campaign_ids | [1151, 1142] | |
country_codes | ["US", "AU"] | |
declared_player_sizes | ["small", "medium"] | 'small', 'medium', 'large', 'x-large' |
detected_player_sizes | ["small", "medium"] | |
device_ids | [1,2] | 0=Other, 1=Computer, 2=Mobile, 3=Tablet, 4=Game Console, 5=Digital Media Receiver, 6= Wearable Computer, 7= Connected TV |
marketplace_type_ids | [2,3] | 1 = managed, 2 = DC Sold, 3 = DC to DC, 4 = DC Bought |
app_names | ["solitare", "candy crush"] | |
app_bundles | ["com.myfitnesspal.android", "com.roku.ae"] |
...