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, content_custom1_param, content_custom2_param, content_custom3_param | 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 | |||
| metrics | an array of metrics | ex.`["vast_impressions"]` will limit the results to the metrics chosen | |||
| 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"] | content_custom1_param | ["my_value1", "my_value2"] | Can also use 'content_custom2_param' and 'content_custom3_param' | |
Reporting Limits
Reports run in the API are limited to 500k rows.
...