--- title: "Changes to Get targeting analytics for ad groups" method: GET path: "/ad_accounts/{ad_account_id}/ad_groups/targeting_analytics" --- # Changes to Get targeting analytics for ad groups `GET /ad_accounts/{ad_account_id}/ad_groups/targeting_analytics` > Every recorded change to this operation, newest first. ## Timeline Changed in 12 of 29 revisions. - **2026-06-04** (v5) `b698c180678a`: 23 info - **2025-12-11** (v5) `79f62f71f05b`: 2 info - **2025-10-16** (v5) `14c297539b64`: 3 breaking, 7 info - **2025-07-16** (v5) `43134ca41f18`: 1 breaking, 7 info - **2025-04-04** (v5) `10f9eba4ad97`: 12 info - **2024-08-14** (v5) `89c27ed39cfd`: 2 info - **2024-04-23** (v5) `f9321315766f`: 1 info - **2024-02-08** (v5) `7529b464d5cb`: 2 info - **2023-07-14** (v5) `52586a274771`: 22 info - **2023-05-12** (v5) `689b4b267639`: 19 info - **2023-02-14** (v5) `be19b77aa78a`: 1 breaking - **2022-11-14** (v5) `e041d7b0cef0`: 1 info ## Changes - **2026-06-04** (v5) `b698c180678a`: 23 info - added the new optional `query` request parameter `sort_ascending` - added the new optional `query` request parameter `sort_columns` - added the enum value `COLLECTION_PIN_ITEM_CLICKTHROUGH_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `COLLECTION_PIN_ITEM_CLICKTHROUGH_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `COLLECTION_PIN_ITEM_IMPRESSION_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `COLLECTION_PIN_ITEM_IMPRESSION_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_SKAN_APP_INSTALL` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_SKAN_APP_INSTALL_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_SKAN_APP_INSTALL_COST_PER_ACTION` to the property `items/` of the `query` request parameter `columns` - added the enum value `INAPP_SKAN_ASSISTED_APP_INSTALL` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_COLLECTION_PIN_ITEM_CLICKTHROUGH` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_COLLECTION_PIN_ITEM_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - for the `query` request parameter `click_window_days`, the type was generalized from `integer` to `number` - for the `query` request parameter `engagement_window_days`, the type was generalized from `integer` to `number` - for the `query` request parameter `view_window_days`, the type was generalized from `integer` to `number` - added the non-success response with the status `400` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `404` - added the non-success response with the status `429` - added the required property `data/items/metrics` to the response with the `200` status - added the required property `data/items/targeting_type` to the response with the `200` status - added the required property `data/items/targeting_value` to the response with the `200` status - **2025-12-11** (v5) `79f62f71f05b`: 2 info - added the enum value `TOTAL_APP_INSTALL_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_INAPP_APP_INSTALL_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - **2025-10-16** (v5) `14c297539b64`: 3 breaking, 7 info - removed the enum value `HOUSEHOLD` from the `query` request parameter `attribution_types` - removed the enum value `INDIVIDUAL` from the `query` request parameter `attribution_types` - for the `query` request parameter `attribution_types`, the type changed from `string` to `array` - for the `query` request parameter `ad_group_ids`, the maxItems was increased from `100` to `250` - added the enum value `TOTAL_ADD_TO_WISHLIST` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_SUBSCRIBE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_VIDEO_15SEC_UNIQUE_VIEWS` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_15SEC_UNIQUE_VIEWS_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_15SEC_UNIQUE_VIEWS_2` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_3SEC_VIEWS_1` to the property `items/` of the `query` request parameter `columns` - **2025-07-16** (v5) `43134ca41f18`: 1 breaking, 7 info - for the `query` request parameter `targeting_types`, the maxItems was decreased from `15` to `14` - added the new optional `query` request parameter `reporting_timezone` - added the enum value `AD_GROUP_BUDGET_IN_LOCAL_CURRENCY` to the property `items/` of the `query` request parameter `columns` - added the enum value `AD_GROUP_BUDGET_TYPE` to the property `items/` of the `query` request parameter `columns` - added the enum value `CAMPAIGN_BRAND_LABEL` to the property `items/` of the `query` request parameter `columns` - added the enum value `CAMPAIGN_BUDGET_OPTIMIZATION` to the property `items/` of the `query` request parameter `columns` - added the enum value `CREATIVE_ENHANCEMENTS` to the property `items/` of the `query` request parameter `targeting_types` - added the enum value `PRODUCT_GROUP_AD_VIDEO_TAG` to the property `items/` of the `query` request parameter `columns` - **2025-04-04** (v5) `10f9eba4ad97`: 12 info - the endpoint scheme security `client_credentials` was added to the API - added the enum value `AD_GROUP_BID_MULTIPLIER` to the property `items/` of the `query` request parameter `columns` - added the enum value `AD_GROUP_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `AD_GROUP_OPTIMIZATION` to the property `items/` of the `query` request parameter `columns` - added the enum value `AD_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `COST_PER_OUTBOUND_CLICK_IN_DOLLAR_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `IS_PREMIERE_CAMPAIGN` to the property `items/` of the `query` request parameter `columns` - added the enum value `OUTBOUND_CTR_1` to the property `items/` of the `query` request parameter `columns` - added the enum value `PRODUCT_GROUP_AD_IMAGE_TAG` to the property `items/` of the `query` request parameter `columns` - added the enum value `PROMO_ID` to the property `items/` of the `query` request parameter `columns` - added the enum value `PROMO_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_SPEND_IN_DOLLAR` to the property `items/` of the `query` request parameter `columns` - **2024-08-14** (v5) `89c27ed39cfd`: 2 info - added the enum value `PAID_VIDEO_VIEWABLE_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `QUIZ_PIN_RESULT_OPEN` to the property `items/` of the `query` request parameter `columns` - **2024-04-23** (v5) `f9321315766f`: 1 info - added the enum value `AGE_BUCKET_AND_GENDER` to the property `items/` of the `query` request parameter `targeting_types` - **2024-02-08** (v5) `7529b464d5cb`: 2 info - added the enum value `COST_PER_OUTBOUND_CLICK_IN_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `VIDEO_MRC_VIEWS_1` to the property `items/` of the `query` request parameter `columns` - **2023-07-14** (v5) `52586a274771`: 22 info - added the new enum value `0.00` to the `query` request parameter `click_window_days` - added the new enum value `0.00` to the `query` request parameter `engagement_window_days` - added the new enum value `0.00` to the `query` request parameter `view_window_days` - added the new enum value `14.00` to the `query` request parameter `click_window_days` - added the new enum value `14.00` to the `query` request parameter `engagement_window_days` - added the new enum value `14.00` to the `query` request parameter `view_window_days` - added the enum value `CAMPAIGN_OBJECTIVE_TYPE` to the property `items/` of the `query` request parameter `columns` - added the enum value `CUSTOM_ROAS` to the property `items/` of the `query` request parameter `columns` - added the enum value `ORDER_LINE_ID` to the property `items/` of the `query` request parameter `columns` - added the enum value `ORDER_LINE_NAME` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_AVERAGE_SUBPAGE_CLOSEUP_PER_SESSION` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_ADD_TO_CART_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_CHECKOUT_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_CUSTOM_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_LEAD_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_PAGE_VISIT_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_SEARCH_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_SIGNUP_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_UNKNOWN_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_VIEW_CATEGORY_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_WATCH_VIDEO_CONVERSION_RATE` to the property `items/` of the `query` request parameter `columns` - **2023-05-12** (v5) `689b4b267639`: 19 info - added the enum value `COST_PER_LEAD` to the property `items/` of the `query` request parameter `columns` - added the enum value `LEADS` to the property `items/` of the `query` request parameter `columns` - added the enum value `QUIZ_COMPLETED` to the property `items/` of the `query` request parameter `columns` - added the enum value `QUIZ_COMPLETION_RATE` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_CARD_THUMBNAIL_SWIPE_BACKWARD` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_CARD_THUMBNAIL_SWIPE_FORWARD` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_PIN_CLICKTHROUGH` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_CLICKTHROUGH` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_CLOSEUP` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_REPIN` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_SWIPE_LEFT` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPAGE_SWIPE_RIGHT` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_CLICKTHROUGH` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_REPIN` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_SWIPE_LEFT` to the property `items/` of the `query` request parameter `columns` - added the enum value `SHOWCASE_SUBPIN_SWIPE_RIGHT` to the property `items/` of the `query` request parameter `columns` - added the enum value `TOTAL_IMPRESSION` to the property `items/` of the `query` request parameter `columns` - **2023-02-14** (v5) `be19b77aa78a`: 1 breaking - removed the enum value `AUDIENCE_EXCLUDE` from the property `items/` of the `query` request parameter `targeting_types` - **2022-11-14** (v5) `e041d7b0cef0`: 1 info - endpoint added --- [Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/ad_groups/targeting_analytics/get.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/ad_groups/targeting_analytics/get)