--- title: "Pinterest Ads updates and field changes | Supermetrics" slug: "pinterest-ads-updates" description: "Learn about updates to the Pinterest Ads data source, including new or deprecated fields and other relevant changes. " updated: 2026-10-05T11:47:23Z published: 2026-10-05T11:47:23Z canonical: "docs.supermetrics.com/pinterest-ads-updates" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt > Use this file to discover all available pages before exploring further. # Pinterest Ads updates Updates on the Pinterest Ads data source, including new metrics, dimensions, and other features. ## April 2025 2025-04-01 We’ve updated the labels of the attribution window setting to remove the "Engagements" part, as well as updating the conversion attribution behavior to match Pinterest’s. Here’s a guide showing the changes to all the currently available options: | Old setting label | New setting label | Notes | | --- | --- | --- | | 60 d click + 60 d engagement + 60 d view | 60 d click + 60 d view | | | 60 d click + 60 d engagement + 30 d view | 60 d click + 30 d view | | | 60 d click + 60 d engagement + 7 d view | - | Removed. Use 60 d click + 7 d view | | 60 d click + 60 d engagement + 1 d view | - | Removed. Use 60 d click + 1 d view | | 60 d click + 30 d engagement + 30 d view | - | Removed. Use 60 d click + 30 d view | | 60 d click + 30 d engagement + 7 d view | - | Removed. Use 60 d click + 7 d view | | 60 d click + 30 d engagement + 1 d view | - | Removed. Use 60 d click + 1 d view | | 60 d click + 7 d engagement + 7 d view | - | Removed. Use 60 d click + 7 d view | | 60 d click + 7 d engagement + 1 d view | - | Removed. Use 60 d click + 1 d view | | 60 d click + 1 d engagement + 1 d view | - | Removed. Use 60 d click + 1 d view | | 30 d click + 60 d engagement + 1 d view | - | Removed. Use (Default) 30 d click + 1 d view | | 30 d click + 30 d engagement + 30 d view | 30 d click + 30 d view | | | 30 d click + 30 d engagement + 7 d view | 30 d click + 7 d view | | | 30 d click + 30 d engagement + 1 d view | (Default) 30 d click + 1 d view | | | 30 d click + 7 d engagement + 7 d view | (Deprecated) 30 d click + 7 d engagement + 7 d view | Will still work. Use 30 d click + 7 d view instead | | 30 d click + 7 d engagement + 1 d view | (Deprecated) 30 d click + 7 d engagement + 1 d view | Will still work. Use 30 d click + 1 d view instead | | 30 d click + 1 d engagement + 1 d view | (Deprecated) 30 d click + 1 d engagement + 1 d view | Will still work. Use 30 d click + 1 d view instead | | 7 d click + 7 d engagement + 7 d view | 7 d click + 7 d view | | | 7 d click + 7 d engagement + 1 d view | 7 d click + 1 d view | | | 7 d click + 1 d engagement + 1 d view | (Deprecated) 7 d click + 1 d engagement + 1 d view | Will still work. Use 7 d click + 1 d view instead | | 1 d click + 1 d engagement + 1 d view | 1 d click + 1 d view | | | 7 d click | 7 d click | | | 1 d click | 1 d click | | | - | 60 d click + 7 d view | New | | - | 60 d click + 1 d view | New | Note that the backend text of setting will remain the same, but it will behave as its new version. For example, "60 d click + 60 d view" will still be represented as `ATTRIBUTION_WINDOW_60_60_60`, but will behave as 60 day click + 60 day view. ## February 2025 2025-02-25 New fields: - Term (utm) - Source (utm) - Medium (utm) - Content (utm) - Campaign (utm) ## October 2024 2024-10-15 The following fields have been added: - Campaign start date - Campaign end date - Ad group start date - Ad group end date ## September 2024 2024-09-25 New field added: - Three second video views ## June 2024 2024-06-05 New fields added: - Budget - Budget type ## September 2023 2023-09-21 New dimensions added: - Age group - App type - Audience include - Country code - Feed type - Gender - Keyword - Pinner interest - Placement - Region code - Targeted interest ## May 2023 2023-05-25 We have updated the data source to Pinterest API v5. These fields have been marked as deprecated, as they are no longer supported in the new API version: - Advertiser created date - Advertiser is one-tap - Advertiser type - Advertiser updated date - Business address - Is a test account - Is agency - Is paying agency - Merchant ID - Represented country - VAT exempt number - VAT number ## February 2022 2022-02-17 These fields have been marked as deprecated, please remove them from your reporting: - Total onsite checkouts - Total onsite checkouts value - Total onsite checkouts CPA ## January 2022 2022-01-20 We have updated the data source to Pinterest API v4. These fields have been marked as deprecated, as they are no longer supported in the new API version: - View window days - Engagement window days - Click window days ## December 2021 2021-12-14 The following display names have changed: - CTR → CTR (%) - CTR paid → CTR paid (%) - CTR earned → CTR earned (%) The following backend names have changed: - ctr_rate → ctr_rate_perc - ctr_rate_paid → ctr_rate_paid_perc - ctr_rate_earned → ctr_rate_earned_perc ## May 2021 2021-05-05 - Added new metrics to help support Pinterest Ads in our Ad Data + GA connector in Data Studio: Conversion rate Cost per conversion ## Dec. 2020 2020-12-17 - Added new totals fields: - Web conversions (Signup) - Web order value (Signup) - Web conversions (Page visit) - Web order value (Page visit) - Web ROAS (Page visit) - Web CPA (Page visit) - Web conversions (Custom) - Web order value (Custom) - Web conversions (Lead) - Web order value (Lead) - Conversion value (Signup) - CPA (Signup) - ROAS (Signup) - In-app ROAS (App install) - In-app conversions (Signup) - In-app order value (Signup) - Offline order value (Custom) - Offline conversions (Lead) - Offline order value (Lead) - Offline conversions (Signup) - Offline order value (Signup) - CPA (Add to cart) - ROAS (Add to cart) - Conversions (Add to Cart) - Conversions Value (Add to cart) - Conversions (Checkout) - Conversions Value (Checkout) - ROAS (Checkout) - CPA (Checkout) - Conversions (Custom) - Conversion value (Custom) - CPA (Custom) - ROAS (Custom) - Conversion value (Lead) - CPA (Lead) - ROAS (Lead) ## May 2020 2020-05-27 New metrics have been added: - Clicks app install - Clicks app install value - Engagements app install - Engagements app install value - Views app install - Views app install value - App install desktop action to desktop conversion - App install desktop action to mobile conversion - App install desktop action to tablet conversion - app install mobile action to desktop conversion - App install mobile action to mobile conversion - App install mobile action to tablet conversion - App install tablet action to desktop conversion - App install tablet action to mobile conversion - App install tablet action to tablet conversion - In-app app install CPA - In-app app install ROAS - Total in-app app install - Total in-app app install value - In-app clicks app install - In-app clicks app install value - In-app engagements app install - In-app engagements app install value - In-app views app install - In-app views app install value - App install CPA - Total app install ## April 2020 2020-04-07 New metrics added for video views/conversions: - Clicks watch video - Clicks watch video quantity - Clicks watch video value - Engagements watch video - Engagements watch video quantity - Engagements watch video value - Views watch video - Views watch video quantity - Views watch video value - Watch video desktop action to desktop conversion - Watch video desktop action to mobile conversion - Watch video desktop action to tablet conversion - Watch video mobile action to desktop conversion - Watch video mobile action to mobile conversion - Watch video mobile action to tablet conversion - Watch video tablet action to desktop conversion - Watch video tablet action to mobile conversion - Watch video tablet action to tablet conversion - Total web watch video - Total web watch video value - Web clicks watch video - Web clicks watch video value - Web engagements watch video - Web engagements watch video value - Web views watch video - Web views watch video value - Web watch video CPA - Web watch video ROAS - Video avg. watch time (s) paid - Video avg. watch time (s) earned - Video views paid - Video views earned - Video starts paid - Video starts earned - Video views at 100% paid - Video views at 100% earned - Video views at 25% paid - Video views at 25% earned - Video views at 50% paid - Video views at 50% earned - Video views at 75% paid - Video views at 75% earned - Video views at 95% paid - Video views at 95% earned ## March 2020 2020-03-17 The following fields were added to support Promoted Pin details: - Promoted pin ID - Pin ID - Promoted pin name - Promoted pin status - Promoted pin created date - Promoted pin updated date - Android deep link - Android click tracking URL - Creative type - Destination URL - IOS deep link - Is pin deleted - Review status - Tracking URLs - View tracking URL ## Feb. 2020 2020-02-11 Added feature to allow to select attribution window for conversions. New leads conversion metrics added: - Clicks lead - Clicks lead quantity - Clicks lead value - Engagements lead - Engagements lead quantity - Engagements lead value - Views lead - Views lead quantity - Views lead value - Leads desktop action to desktop conversion - Leads desktop action to mobile conversion - Leads desktop action to tablet conversion - Leads mobile action to desktop conversion - Leads mobile action to mobile conversion - Leads mobile action to tablet conversion - Leads tablet action to desktop conversion - Leads tablet action to mobile conversion - Leads tablet action to tablet conversion 2020-02-18 The metric "Spend" has been renamed to "Cost". The following currency conversion metrics have been added: - Cost (EUR) - Cost (USD) - Cost (GBP) The following conversion totals fields has been added: - Leads - Sign-ups 2020-02-26 The following fields have been added: - Clicks add to cart - Clicks add to cart quantity - Clicks add to cart value - Engagements add to cart - Engagements add to cart quantity - Engagements add to cart value - Views add to cart - Views add to cart quantity - Views add to cart value - Add to cart desktop action to desktop conversion - Add to cart desktop action to mobile conversion - Add to cart desktop action to tablet conversion - Add to cart mobile action to desktop conversion - Add to cart mobile action to mobile conversion - Add to cart mobile action to tablet conversion - Add to cart tablet action to desktop conversion - Add to cart tablet action to mobile conversion - Add to cart tablet action to tablet conversion - In-app add to cart CPA - In-app add to cart ROAS - Total in-app add to cart - Total in-app add to cart value - In-app clicks add to cart - In-app clicks add to cart value - In-app engagements add to cart - In-app engagements add to cart value - In-app views add to cart - In-app views add to cart value - Total web add to cart - Total web add to cart value - Web clicks add to cart - Web clicks add to cart value - Web engagements add to cart - Web engagements add to cart value - Web views add to cart - Web views add to cart value - Web add to cart CPA - Web add to cart ROAS