Create async request for an account analytics report
POST {{baseUrl}}/ad_accounts/:ad_account_id/reports
This returns a token that you can use to download the report when it is ready. Note that this endpoint requires the parameters to be passed as JSON-formatted in the request body. This endpoint does not support URL query parameters. - The token's useraccount must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via Business Access: Admin, Analyst, Campaign Manager. - If granularity is not HOUR, the furthest back you can are allowed to pull data is 914 days before the current date in UTC time and the max time range supported is 186 days. - If granularity is HOUR, the furthest back you can are allowed to pull data is 8 days before the current date in UTC time and the max time range supported is 3 days. - If level is PRODUCTITEM, the furthest back you can are allowed to pull data is 92 days before the current date in UTC time and the max time range supported is 31 days.
Request Body
{"columns"=>["TOTAL_SIGNUP_TABLET_ACTION_TO_TABLET_CONVERSION", "TOTAL_OFFLINE_SIGNUP_VALUE_IN_MICRO_DOLLAR"], "end_date"=>"8912-57-91", "granularity"=>"TOTAL", "level"=>"AD_GROUP", "start_date"=>"9634-04-04", "click_window_days"=>30, "engagement_window_days"=>30, "view_window_days"=>1, "conversion_report_time"=>"TIME_OF_AD_ACTION", "attribution_types"=>["INDIVIDUAL", "INDIVIDUAL"], "campaign_ids"=>["7731"], "campaign_statuses"=>["PAUSED"], "campaign_objective_types"=>["CONSIDERATION"], "ad_group_ids"=>["27"], "ad_group_statuses"=>["ADVERTISER_DISABLED"], "ad_ids"=>["041087"], "ad_statuses"=>["APPROVED"], "product_group_ids"=>["69139262912"], "product_group_statuses"=>["ARCHIVED"], "product_item_ids"=>["312413457"], "targeting_types"=>["AUDIENCE_INCLUDE"], "metrics_filters"=>[{"field"=>"TOTAL_IMPRESSION", "operator"=>"LESS_THAN", "values"=>["<number>"]}], "report_format"=>"JSON"}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"report_status":"DOES_NOT_EXIST","token":"\u003cstring\u003e","message":"\u003cstring\u003e"}