Get ad account analytics
GET {{baseUrl}}/ad_accounts/:ad_account_id/analytics?start_date=2003-02-24&end_date=2003-02-24&columns=SPEND_IN_DOLLAR,SPEND_IN_DOLLAR&granularity=HOUR&click_window_days=1&engagement_window_days=30&view_window_days=1&conversion_report_time=TIME_OF_AD_ACTION
Get analytics for the specified adaccountid, filtered by the specified options.
- The token's user_account 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.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
start_date | string | (Required) Metric report start date (UTC). Format: YYYY-MM-DD | |
end_date | string | (Required) Metric report end date (UTC). Format: YYYY-MM-DD | |
columns | string | (Required) Columns to retrieve, encoded as a comma-separated string. NOTE: Any metrics defined as MICRO_DOLLARS returns a value based on the advertiser profile's currency field. For USD,($1/1,000,000, or $0.000001 - one one-ten-thousandth of a cent). it's microdollars. Otherwise, it's in microunits of the advertiser's currency.<br/>For example, if the advertiser's currency is GBP (British pound sterling), all MICRO_DOLLARS fields will be in GBP microunits (1/1,000,000 British pound).<br/>If a column has no value, it may not be returned | |
granularity | string | (Required) Granularity | |
click_window_days | number | Number of days to use as the conversion attribution window for a pin click action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to 30 days. | |
engagement_window_days | number | Number of days to use as the conversion attribution window for an engagement action. Engagements include saves, closeups, link clicks, and carousel card swipes. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to 30 days. | |
view_window_days | number | Number of days to use as the conversion attribution window for a view action. Applies to Pinterest Tag conversion metrics. Prior conversion tags use their defined attribution windows. If not specified, defaults to 1 day. | |
conversion_report_time | string | The date by which the conversion metrics returned from this endpoint will be reported. There are two dates associated with a conversion event: the date that the user interacted with the ad, and the date that the user completed a conversion event. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
[{"DATE":"2021-04-01","AD_ACCOUNT_ID":"547602124502","SPEND_IN_DOLLAR":30,"TOTAL_CLICKTHROUGH":216},{"DATE":"2021-04-01","AD_ACCOUNT_ID":"547602124502","SPEND_IN_DOLLAR":30,"TOTAL_CLICKTHROUGH":216}]