Pinterest Ads Updates

Updates on the Pinterest Ads data source, including new metrics, dimensions, and other features.

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