Updates on the Pinterest Ads data source, including new metrics, dimensions, and other features.
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