When you connect Pinterest, you pick a Level that matches how detailed you want your data to be. If you are unsure, start with Campaign. Each level includes the dimensions of the levels above it. Levels are not interchangeable: some metrics are only available at some levels, so compare Funnel to the same level in Pinterest Ads Manager.
Funnel gets data from the Pinterest Marketing API version 5.
Which report type should you choose?
Report type | When to use it |
Campaign | Use this for performance per campaign, including reach and frequency over 7, 30 and 90 days. Start here if you are unsure. |
Ad Group | Use this for performance per ad group. In the connection form, this is Ad Group (Campaign -> Ad Group). |
Product Group | Use this for performance per product group in Catalog Sales and Shopping campaigns. Only downloads data from those campaigns. In the connection form, this is Product Group (Campaign -> Ad Group -> Product Group). |
Pin Promotion | Use this for performance per ad (Pin promotion), including the destination URL and Pin metadata. Doesn't download data from Catalog Sales and Shopping campaigns. In the connection form, this is Pin Promotion (Campaign -> Ad Group -> Pin Promotion). |
Options when you connect
Include Archived Campaigns: At Campaign level, select Archived Campaigns to also get data for archived campaigns.
Include Pin Metadata: At Pin Promotion level, select Pin Metadata to add the title, description, image URLs and link of the Pin each ad uses.
Attribution Settings: Choose the click and view attribution windows, from 60d Click / 60d View to 1d Click / 1d View.
Attribution Date: Choose whether conversions are reported on the date of the ad event (impression, click or engagement), which is the default, or on the date of the conversion.
Targeting Breakdown: Optionally, break the data down by one targeting type. See Targeting breakdowns below.
Historical data
Funnel can get data from up to 913 days back, as stated in the Pinterest Marketing API reporting documentation. You can't get older data because of limits in the Pinterest Marketing API.
Targeting breakdowns
A data source can have one of these targeting breakdowns, at any level:
Age Bucket
App Type
Audience Include
Country
Gender
Geo
Keyword
Location
Pinner Interest
Placement
Region
Targeted Interest
If you select a targeting breakdown, its value is shown in these dimensions:
Targeting Breakdown: The targeting type you selected.
Targeting Value: The targeting value, for example a country or an age range.
Note: Frequency 1 Day and Reach 1 Day aren't available with a targeting breakdown. Data sources with a targeting breakdown also don't get any data for Performance+ campaigns. If you need those campaigns, connect without a breakdown.
All levels
Dimensions
Campaign Entity Status: The entity lifecycle status of the campaign. Reflects the last known value, as of our most recent update, and may not always match the live value shown elsewhere.
Campaign ID
Campaign Managed Status
Campaign Name
Campaign Status: The summary status of the campaign. Reflects the last known value, as of our most recent update, and may not always match the live value shown elsewhere.
Objective
Advertiser ID
Advertiser Name
Campaign Start Date: The start date of the campaign.
Campaign End Date: The end date of the campaign. Reflects the last known value, as of our most recent update, and may not always match the live value shown elsewhere.
Metrics
Click-through conversions (Add to cart): Number of add to cart events resulting from clicks on your ad.
Click-through conversions (Category view)
Click-through conversions (Page visit)
Click-through value (Add to cart): Total value of add to cart events resulting from clicks on your ad.
Conversion Quantity From Page Visit - Clicks
Conversion Quantity From Page Visit - Views
Conversion Quantity From Page Visits
Conversions
Earned engagements: Earned actions from ads saved to boards.
Earned impressions: Total number of times your ad was viewed after being saved to another person's board.
Earned Outbound Clicks
Earned Pin Clicks: Total number of pin clicks from ads saved to another person's board.
Earned saves: Number of times your ad was saved from another person's board.
Engagement conversions (Page visit)
Outbound Clicks: Sum of Paid Outbound Clicks and Earned Outbound Clicks.
Paid engagements: Paid actions taken as a result of your ads.
Paid impressions: The number of times your ad was seen.
Paid Outbound Clicks
Paid Pin Clicks: Total number of pin clicks from your ads.
Paid saves: Total number of saves for your ad.
Spend: Total amount you've spent during the reporting time period.
Total Conversion Quantity: Total number of conversions for all event types using the Pinterest Tag integration after an ad interaction.
Total Conversion Value
Total Conversions From Add To Cart Clicks
View-through conversions (Category view)
View-through conversions (Page visit)
Campaign, Ad Group and Pin Promotion levels
These metrics are available at the Campaign, Ad Group and Pin Promotion levels if the field is available in your Pinterest account.
Metrics
App install desktop action -> desktop conversion
App install desktop action -> mobile conversion
App install desktop action -> tablet conversion
App install mobile action -> desktop conversion
App install mobile action -> mobile conversion
App install mobile action -> tablet conversion
App install tablet action -> desktop conversion
App install tablet action -> mobile conversion
App install tablet action -> tablet conversion
Buyable Pin In-App Checkout Value
Buyable Pin In-App Checkouts
Click-through conversions (App install)
Click-through conversions (Checkout): Total number of checkout events resulting from clicks on your ad.
Click-through conversions (Custom)
Click-through conversions (Lead): Number of lead events resulting from clicks on your ad.
Click-through conversions (Signup): Number of signup events resulting from clicks on your ad.
Click-through conversions (Unknown)
Click-through conversions (Watch video)
Click-through conversions (Website search)
Click-through order quantity (Checkout)
Click-through order value (Checkout): Total value of checkout events resulting from clicks on your ad.
Click-through value (App install)
Click-through value (Category view)
Click-through value (Custom)
Click-through value (Lead): Total value of lead events resulting from clicks on your ad.
Click-through value (Page visit)
Click-through value (Signup): Total value of signup events resulting from clicks on your ad.
Click-through value (Unknown)
Click-through value (Watch video)
Click-through value (Website search)
Conversion Quantity From Add To Cart: The sum of Conversion Quantity From Add To Cart Clicks, Conversion Quantity From Add To Cart Engagements and Conversion Quantity From Add To Cart Views.
Conversion Quantity From Custom: The sum of Conversion Quantity From Custom Clicks, Conversion Quantity From Custom Engagements and Conversion Quantity From Custom Views.
Conversion Quantity From Custom - Clicks
Conversion Quantity From Custom - Engagements
Conversion Quantity From Custom - Views
Conversion Quantity From Lead: The sum of Conversion Quantity From Lead Clicks, Conversion Quantity From Lead Engagements and Conversion Quantity From Lead Views.
Conversion Quantity From Search: The sum of Conversion Quantity From Search Clicks, Conversion Quantity From Search Engagements and Conversion Quantity From Search Views.
Conversion Quantity From Signup: The sum of Conversion Quantity From Signup Clicks, Conversion Quantity From Signup Engagements and Conversion Quantity From Signup Views.
Conversion Quantity From Signup - Clicks
Conversion Quantity From Signup - Engagements
Conversion Quantity From Signup - Views
Conversion quantity from unknown - clicks
Conversion quantity from unknown - engagements
Conversion quantity from unknown - views
Conversion Quantity From View Category: The sum of Conversion Quantity From View Category Clicks, Conversion Quantity From View Category Engagements and Conversion Quantity From View Category Views.
Conversion Quantity From Watch Video: The sum of Conversion Quantity From Watch Video Clicks, Conversion Quantity From Watch Video Engagements and Conversion Quantity From Watch Video Views.
Conversions (Add to cart): The sum of Click-through conversions (Add to cart), Engagement conversions (Add to cart) and View-through conversions (Add to cart)
Conversions (App install): Total number of app install events resulting from interactions with your ad.
Conversions (Category view): The sum of Click-through conversions (Category view), Engagement conversions (Category view) and View-through conversions (Category view)
Conversions (Checkout): The sum of Click-through conversions (Checkout), Engagement conversions (Checkout) and View-through conversions (Checkout)
Conversions (Custom): The sum of Click-through conversions (Custom), Engagement conversions (Custom) and View-through conversions (Custom)
Conversions (Lead): The sum of Click-through conversions (Lead), Engagement conversions (Lead) and View-through conversions (Lead)
Conversions (Page visit): The sum of Click-through conversions (Page visit), Engagement conversions (Page visit) and View-through conversions (Page visit)
Conversions (Signup): The sum of Click-through conversions (Signup), Engagement conversions (Signup) and View-through conversions (Signup)
Conversions (Unknown): Total number of unknown events resulting from interactions with your ad.
Conversions (Watch video): The sum of Click-through conversions (Watch video), Engagement conversions (Watch video) and View-through conversions (Watch video)
Conversions (Website search): The sum of Click-through conversions (Website search), Engagement conversions (Website search) and View-through conversions (Website search)
Cost per 95% video view, Ad Group: The average cost per 95% video view. Only available at Ad Group level.
Cost per 95% video view, Campaign: The average cost per 95% video view. Only available at Campaign level.
Cost per 95% video view, Pin Promotion: The average cost per 95% video view. Only available at Pin Promotion level.
Cost per completed video view, Ad Group: The average cost per completed video view. Only available at Ad Group level.
Cost per completed video view, Campaign: The average cost per completed video view. Only available at Campaign level.
Cost per completed video view, Pin Promotion: The average cost per completed video view. Only available at Pin Promotion level.
Cost per video view, Ad Group: The average cost per video view. Only available at Ad Group level.
Cost per video view, Campaign: The average cost per video view. Only available at Campaign level.
Cost per video view, Pin Promotion: The average cost per video view. Only available at Pin Promotion level.
Earned average video play time (seconds), Ad Group: The average time in seconds someone spent playing the video on saved instances of your Promoted Pin. Only available at Ad Group level.
Earned average video play time (seconds), Campaign: The average time in seconds someone spent playing the video on saved instances of your Promoted Pin. Only available at Campaign level.
Earned average video play time (seconds), Pin Promotion: The average time in seconds someone spent playing the video on saved instances of your Promoted Pin. Only available at Pin Promotion level.
Earned saves: Number of times your ad was saved from another person's board.
Earned video starts: Total number of times your video ad stared playing after it was saved to another person's board.
Earned video views: The number of times your video ad played continuously for 2 seconds while 50% in view after being saved to another person's board.
Earned video watched at 100%: Total number of times your video ad reached 100% of its length after it was saved to another person's board, including views that skipped ahead to this point.
Earned video watched at 25%: Total number of times your video ad reached 25% of its length after it was saved to another person's board, including views that skipped ahead to this point.
Earned video watched at 50%: Total number of times your video ad reached 50% of its length after it was saved to another person's board, including views that skipped ahead to this point.
Earned video watched at 75%: Total number of times your video ad reached 75% of its length after it was saved to another person's board, including views that skipped ahead to this point.
Earned video watched at 95%: Total number of times your video ad reached 95% of its length after it was saved to another person's board, including views that skipped ahead to this point.
Earned video watched for 3 seconds: Number of times your earned video ad played continuously for 3 seconds while at least 50% in view.
Engagement conversions (Add to cart): Total number of add to cart events resulting from engagements with your ad (save, closeup or swipe).
Engagement conversions (App install)
Engagement conversions (Category view)
Engagement conversions (Checkout): Total number of checkout events resulting from engagements with your ad (save, closeup or carousel swipe)
Engagement conversions (Custom)
Engagement conversions (Lead): Total number of lead events resulting from engagements with your ad (save, closeup or swipe)
Engagement conversions (Signup): Total number of signup events resulting from engagements with your ad (save, closeup or swipe)
Engagement conversions (Unknown)
Engagement conversions (Watch video)
Engagement conversions (Website search)
Engagement order quantity (Checkout)
Engagement order value (Checkout): Total value of checkout events resulting from engagements with your ad (save, closeup or carousel swing)
Engagement value (Add to cart): Total value of add to cart events resulting from engagements with your ad (save, closeup or swipe)
Engagement value (App install)
Engagement value (Category view)
Engagement value (Custom)
Engagement value (Lead): Total value of lead events resulting from engagements with your ad (save, closeup or swipe)
Engagement value (Page visit)
Engagement value (Signup): Total value of signup events resulting from engagements with your ad (save, closeup or swipe).
Engagement value (Unknown)
Engagement value (Watch video)
Engagement value (Website search)
Frequency 1 Day, Ad Group: The average number of times each user saw your ad. Only available at Ad Group level.
Frequency 1 Day, Campaign: The average number of times each user saw your ad. Only available at Campaign level.
Frequency 1 Day, Pin Promotion: The average number of times each user saw your ad. Only available at Pin Promotion level.
Offline Checkout ROAS
Order quantity (Checkout): The sum of Click-through order quantity (Checkout), Engagement order quantity (Checkout) and View-through order quantity (Checkout)
Order value (Checkout): The sum of Click-through order value (Checkout), Engagement order value (Checkout) and View-through order value (Checkout)
Paid average video play time (seconds), Ad Group: The average time in seconds someone spent playing the video included in your Promoted Pin. Only available at Ad Group level.
Paid average video play time (seconds), Campaign: The average time in seconds someone spent playing the video included in your Promoted Pin. Only available at Campaign level.
Paid average video play time (seconds), Pin Promotion: The average time in seconds someone spent playing the video included in your Promoted Pin. Only available at Pin Promotion level.
Paid video starts: Number of times your video ad started playing.
Paid video views: The number of times your video ad played continuously for 2 seconds while 50% in view.
Paid video watched at 100%: Number of times your video ad reached 100% of its length, including views that skipped ahead to this point.
Paid video watched at 25%: Number of times your video ad reached 25% of its length, including views that skipped ahead to this point.
Paid video watched at 50%: Number of times your video ad reached 50% of its length, including views that skipped ahead to this point.
Paid video watched at 75%: Number of times your video ad reached 75% of its length, including views that skipped ahead to this point.
Paid video watched at 95%: Number of times your video ad reached 95% of its length, including views that skipped ahead to this point.
Paid video watched for 3 seconds: Number of times your paid video ad played continuously for 3 seconds while at least 50% in view.
Quiz completed: Number of times a quiz ad was completed.
Reach 1 Day, Ad Group: Total number of unique users who saw your ad group during a day. Only available at Ad Group level.
Reach 1 Day, Campaign: Total number of unique users who saw your campaign during a day. Only available at Campaign level.
Reach 1 Day, Pin Promotion: Total number of unique users who saw your pin promotion during a day. Only available at Pin Promotion level.
Showcase avg subpage closeup per session, Ad Group: Average number of showcase subpage closeups per session. Only available at Ad Group level.
Showcase avg subpage closeup per session, Campaign: Average number of showcase subpage closeups per session. Only available at Campaign level.
Showcase avg subpage closeup per session, Pin Promotion: Average number of showcase subpage closeups per session. Only available at Pin Promotion level.
Showcase pin clickthrough: Number of clickthroughs on a showcase pin.
Showcase subpage clickthrough: Number of clickthroughs on a showcase subpage.
Showcase subpage closeup: Number of closeup views on a showcase subpage.
Showcase subpage impression: Number of impressions on a showcase subpage.
Showcase subpage repin: Number of repins on a showcase subpage.
Showcase subpin clickthrough: Number of clickthroughs on a showcase subpin.
Showcase subpin impression: Number of impressions on a showcase subpin.
Showcase subpin repin: Number of repins on a showcase subpin.
Total Add To Cart Desktop Action To Desktop Conversions
Total Add To Cart Desktop Action To Mobile Conversions
Total Add To Cart Desktop Action To Tablet Conversions
Total Add To Cart Mobile Action To Desktop Conversions
Total Add To Cart Mobile Action To Mobile Conversions
Total Add To Cart Mobile Action To Tablet Conversions
Total Add To Cart Tablet Action To Desktop Conversions
Total Add To Cart Tablet Action To Mobile Conversions
Total Add To Cart Tablet Action To Tablet Conversions
Total average video play time (seconds), Ad Group: The average time in seconds someone spent playing the video and static image cards included in your Pin (paid + earned combined) Only available at Ad Group level.
Total average video play time (seconds), Campaign: The average time in seconds someone spent playing the video and static image cards included in your Pin (paid + earned combined) Only available at Campaign level.
Total average video play time (seconds), Pin Promotion: The average time in seconds someone spent playing the video and static image cards included in your Pin (paid + earned combined) Only available at Pin Promotion level.
Total Checkout Desktop Action To Desktop Conversions
Total Checkout Desktop Action To Mobile Conversions
Total Checkout Desktop Action To Tablet Conversions
Total Checkout Mobile Action To Desktop Conversions
Total Checkout Mobile Action To Mobile Conversions
Total Checkout Mobile Action To Tablet Conversions
Total Checkout Tablet Action To Desktop Conversions
Total Checkout Tablet Action To Mobile Conversions
Total Checkout Tablet Action To Tablet Conversions
Total Conversions From Add To Cart Engagements
Total Conversions From Add To Cart Views
Total Conversions From Lead Clicks
Total Conversions From Lead Engagements
Total Conversions From Lead Views
Total Conversions From Search Clicks
Total Conversions From Search Engagements
Total Conversions From Search Views
Total Conversions From View Category Clicks
Total Conversions From View Category Engagements
Total Conversions From View Category Views
Total Conversions From Watch Video Clicks
Total Conversions From Watch Video Engagements
Total Conversions From Watch Video Views
Total Custom Desktop Action To Desktop Conversions
Total Custom Desktop Action To Mobile Conversions
Total Custom Desktop Action To Tablet Conversions
Total Custom Mobile Action To Desktop Conversions
Total Custom Mobile Action To Mobile Conversions
Total Custom Mobile Action To Tablet Conversions
Total Custom Tablet Action To Desktop Conversions
Total Custom Tablet Action To Mobile Conversions
Total Custom Tablet Action To Tablet Conversions
Total In-App Signups (Click)
Total In-App Signups (View)
Total Lead Desktop Action To Desktop Conversions
Total Lead Desktop Action To Mobile Conversions
Total Lead Desktop Action To Tablet Conversions
Total Lead Mobile Action To Desktop Conversions
Total Lead Mobile Action To Mobile Conversions
Total Lead Mobile Action To Tablet Conversions
Total Lead Tablet Action To Desktop Conversions
Total Lead Tablet Action To Mobile Conversions
Total Lead Tablet Action To Tablet Conversions
Total Offline Checkout
Total Offline Checkout Value
Total Offline Signups (Click)
Total Offline Signups (View)
Total Onsite Checkouts
Total Page Visit Desktop Action To Desktop Conversions
Total Page Visit Desktop Action To Mobile Conversions
Total Page Visit Desktop Action To Tablet Conversions
Total Page Visit Mobile Action To Desktop Conversions
Total Page Visit Mobile Action To Mobile Conversions
Total Page Visit Mobile Action To Tablet Conversions
Total Page Visit Tablet Action To Desktop Conversions
Total Page Visit Tablet Action To Mobile Conversions
Total Page Visit Tablet Action To Tablet Conversions
Total Search Desktop Action To Desktop Conversions
Total Search Desktop Action To Mobile Conversions
Total Search Desktop Action To Tablet Conversions
Total Search Mobile Action To Desktop Conversions
Total Search Mobile Action To Mobile Conversions
Total Search Mobile Action To Tablet Conversions
Total Search Tablet Action To Desktop Conversions
Total Search Tablet Action To Mobile Conversions
Total Search Tablet Action To Tablet Conversions
Total Signup Desktop Action To Desktop Conversions
Total Signup Desktop Action To Mobile Conversions
Total Signup Desktop Action To Tablet Conversions
Total Signup Mobile Action To Desktop Conversions
Total Signup Mobile Action To Mobile Conversions
Total Signup Mobile Action To Tablet Conversions
Total Signup Tablet Action To Desktop Conversions
Total Signup Tablet Action To Mobile Conversions
Total Signup Tablet Action To Tablet Conversions
Total video watched for 3 seconds: Total number of times your video ad played continuously for 3 seconds while at least 50% in view (paid + earned)
Total View Category Desktop Action To Desktop Conversions
Total View Category Desktop Action To Mobile Conversions
Total View Category Desktop Action To Tablet Conversions
Total View Category Mobile Action To Desktop Conversions
Total View Category Mobile Action To Mobile Conversions
Total View Category Mobile Action To Tablet Conversions
Total View Category Tablet Action To Desktop Conversions
Total View Category Tablet Action To Mobile Conversions
Total View Category Tablet Action To Tablet Conversions
Total Watch Video Desktop Action To Desktop Conversions
Total Watch Video Desktop Action To Mobile Conversions
Total Watch Video Desktop Action To Tablet Conversions
Total Watch Video Mobile Action To Desktop Conversions
Total Watch Video Mobile Action To Mobile Conversions
Total Watch Video Mobile Action To Tablet Conversions
Total Watch Video Tablet Action To Desktop Conversions
Total Watch Video Tablet Action To Mobile Conversions
Total Watch Video Tablet Action To Tablet Conversions
Total Web Checkout
Total Web Checkout Value
Total Web Signups (Click)
Total Web Signups (View)
Unknown desktop action -> desktop conversion
Unknown desktop action -> mobile conversion
Unknown desktop action -> tablet conversion
Unknown mobile action -> desktop conversion
Unknown mobile action -> mobile conversion
Unknown mobile action -> tablet conversion
Unknown tablet action -> desktop conversion
Unknown tablet action -> mobile conversion
Unknown tablet action -> tablet conversion
Value (App install): The sum of Click-through value (App install), Engagement value (App install) and View-through value (App install)
Value (Category view): The sum of Click-through value (Category view), Engagement value (Category view) and View-through value (Category view)
Value (Lead): The sum of Click-through value (Lead), Engagement value (Lead) and View-through value (Lead)
Value (Page visit): The sum of Click-through value (Page visit), Engagement value (Page visit) and View-through value (Page visit)
Value (Signup): The sum of Click-through value (Signup), Engagement value (Signup) and View-through value (Signup)
Value (Unknown): The sum of Click-through value (Unknown), Engagement value (Unknown) and View-through value (Unknown)
Value (Watch video): The sum of Click-through value (Watch video), Engagement value (Watch video) and View-through value (Watch video)
Value (Website search): The sum of Click-through value (Website search), Engagement value (Website search) and View-through value (Website search)
View-through conversions (Add to cart): Total number of add to cart events resulting from views of your ad.
View-through conversions (App install)
View-through conversions (Checkout): Total number of checkout events resulting from views of your ad.
View-through conversions (Custom)
View-through conversions (Lead): Total number of lead events resulting from views of your ad.
View-through conversions (Signup): Total number of signup events resulting from views of your ad.
View-through conversions (Unknown)
View-through conversions (Watch video)
View-through conversions (Website search)
View-through order quantity (Checkout)
View-through order value (Checkout): Total value of checkout events resulting from views of your ad.
View-through value (Add to cart): Total value of add to cart events resulting from views of your ad.
View-through value (App install)
View-through value (Category view)
View-through value (Custom)
View-through value (Lead): Total value of lead events resulting from views of your ad.
View-through value (Page visit)
View-through value (Signup): Total value of signup events resulting from views of your ad.
View-through value (Unknown)
View-through value (Watch video)
View-through value (Website search)
Web Checkout ROAS
Note: Fields with "(Custom)" in their name, such as Conversions (Custom), Click-through conversions (Custom), View-through conversions (Custom) and Engagement conversions (Custom), show one combined total across all your custom events. The same applies to the Conversion Quantity From Custom fields and the Total Custom cross-device fields. These fields don't break the value down per custom event.
Campaign level
Metrics
Frequency 90 Days, Campaign: The average number of times each user saw your ad.
Reach 90 Days, Campaign: Total number of unique users who saw your campaign the last 90 days.
Reach 7 days, Campaign: Total number of unique users who saw your campaign the last 7 days.
Frequency 7 days, Campaign: The average number of times each user saw your ad.
Reach 30 days, Campaign: Total number of unique users who saw your campaign the last 7 days.
Frequency 30 days, Campaign: The average number of times each user saw your ad.
Ad Group level
Dimensions
Ad Group Entity Status: The entity lifecycle status of the ad group. Reflects the last known value, as of our most recent update, and may not always match the live value shown elsewhere.
Ad Group ID
Ad Group Name
Ad Group Status: The summary status of the ad group. Reflects the last known value, as of our most recent update, and may not always match the live value shown elsewhere.
Metrics
Frequency 90 Days, Ad Group: The average number of times each user saw your ad.
Reach 90 Days, Ad Group: Total number of unique users who saw your ad group the last 90 days.
Reach 7 days, Ad Group: Total number of unique users who saw your ad group the last 7 days.
Frequency 7 days, Ad Group: The average number of times each user saw your ad.
Frequency 30 days, Ad Group: The average number of times each user saw your ad.
Product Group level
Dimensions
Product Group ID
Metrics
Frequency 1 Day, Product Group: The average number of times each user saw your ad.
Reach 1 Day, Product Group: Total number of unique users who saw your product group during a day.
Pin Promotion level
Dimensions
Ad Entity Status: The entity lifecycle status of the pin promotion/ad. Reflects the last known value, as of our most recent update, and may not always match the live value shown elsewhere.
Pin Promotion ID
Pin Promotion Name
Pin Promotion Status: The summary status of the pin promotion. Reflects the last known value, as of our most recent update, and may not always match the live value shown elsewhere.
Pin Promotion Destination Url
Ad Creative Type
Pin ID
Pin metadata dimensions
These dimensions are only available if you select Pin Metadata when you connect.
Pin Title: Title of the organic Pin that this Pin Promotion serves.
Pin Description: Description of the organic Pin that this Pin Promotion serves.
Pin Cover Image URL: Cover image URL for the organic Pin's media (video pins only; null for image pins).
Pin Image URL: Largest available image URL from the organic Pin's media (1200x, 600x, 400x300, or 150x150).
Pin Image URLs: Comma-separated largest available image URLs from the Pin's media (1200x, 600x, 400x300, or 150x150). Multiple values for carousel pins.
Pin Image Hashes: Comma-separated 32-char hex image hashes extracted from the largest available Pin media URLs. Multiple values for carousel pins.
Pin Link: Organic destination link configured on the Pin (distinct from the ad's destination URL).
API documentation
For full field definitions and updates, see the Pinterest Marketing API documentation.
Change history
Added quiz, showcase and 3-second video metrics
From 11 Sep, 2026, Quiz completed, the Showcase metrics and Total video watched for 3 seconds are available at the Campaign, Ad Group and Pin Promotion levels.
Added video play time and cost per video view metrics
From 27 Aug, 2026, the average video play time metrics (paid, earned and total) and Cost per video view, Cost per completed video view and Cost per 95% video view are available at the Campaign, Ad Group and Pin Promotion levels.
Added Pin metadata
From 4 Jun, 2026, you can select Pin Metadata at Pin Promotion level to get the title, description, image URLs and link of the Pin each ad uses.
Added Ad Creative Type
From 29 Jan, 2026, the Ad Creative Type dimension is available at Pin Promotion level.
Added campaign start and end dates
From 14 Nov, 2025, the Campaign Start Date and Campaign End Date dimensions are available at all levels.