Data reference

Introduction

Pinterest Ads is the paid advertising side of Pinterest, the visual discovery platform. It is used by brand and performance marketers to deliver promoted pins, shopping ads, and video ads to Pinterest users who are actively searching for inspiration in categories such as fashion, home, food, and travel. Pinterest Ads supports CPC, CPM, and CPV payment models across campaign objectives ranging from awareness through conversions and catalog sales. The connector imports the resulting structure and performance data through the Pinterest Ads API v5. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across sources without additional configuration. To connect this data source, see How to connect Pinterest Ads to Adriel.

Data refresh strategy

Architecture data

Architecture covers ad accounts, campaigns, ad sets, and ads. It refreshes twice daily at 4:00 PM UTC and 5:00 AM UTC. On data source creation, the cache fills with 365 days of historical data for the ad account, campaign, ad set, and ad levels.

Reports data

Reports include daily performance metrics for ad accounts, campaigns, ad sets, and ads. Cache-only. Report data comes from cached daily performance snapshots. Dashboard queries always read from the last snapshot, never live from Pinterest, so very recent changes inside Pinterest Ads Manager appear only after the next scheduled sync. Uniqueness caveat. Metrics based on uniqueness, such as reach, can be overvalued when viewed over date ranges longer than one day, because uniqueness is computed per snapshot rather than across the full range. Refresh schedule. Reports refresh on this cadence:

6:00 PM UTC — syncs the last 7 days for these breakdowns (each per ad account): search term view, OS, gender, location, platform placement, country, audience, and age.
5:00 PM UTC — syncs the last 9 days for the ad account, campaign, ad set, and ad levels.
9:00 PM UTC and 6:00 AM UTC — sync the last 3 days for the ad account, campaign, ad set, and ad levels.
3:00 AM UTC and 8:00 AM UTC — sync the last 1 day for the ad account, campaign, ad set, and ad levels.
3:00 PM UTC on day 3 of the month — syncs the last 35 days for the ad account, campaign, ad set, and ad levels.

Data is reliable within the cache sync period. Data outside this range may be incomplete or inaccurate.

Architecture levels

Ad account → Campaign → Ad set (ad group) → Ad (promoted pin)

Date range limits

Breakdown	Max range
Daily	93 days
Weekly	1 year
Monthly	2 years

Metrics

How to read the columnsData type uses Adriel’s vocabulary — Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean. API Key in code style like TOTAL_IMPRESSION is the literal Pinterest Ads API field; italic marks a value Adriel computes or derives on its side rather than a single API field. Several Pinterest value fields are returned in micro-dollars (millionths of a unit), which Adriel converts to currency; currency values are reported in each ad account’s configured Pinterest currency.

Campaign Attributes

Metric	Description	Data type	API Key
Active Status	Whether the campaign, ad set, or ad is currently active.	Text	Adriel-side
Ad Account Name	Name of the Pinterest ad account.	Text	Adriel-side
Ad Name	Name of the Pinterest ad.	Text	Adriel-side
Ad Set Name	Name of the Pinterest ad group.	Text	Adriel-side
Ad Spend	Total amount spent on ads during the reporting period.	Currency	`SPEND_IN_DOLLAR`
Bid Cap	Bid cap on the ad set or campaign.	Currency	Adriel-side
Bid Strategy	Bidding or budget strategy values associated with the entity when Pinterest returns them.	Text	Adriel-side
Budget	Budget details returned for the campaign or ad group, including amount and budget type when available.	Text	Adriel-side
Campaign Name	Name of the Pinterest campaign.	Text	Adriel-side
Creative Type	Creative format used by the ad, such as image, video, or collection.	Text	Adriel-derived
Creative URL	Creative asset URLs associated with the ad, such as image or video files.	URL	Adriel-side
Daily Budget	Daily budget amount set for the campaign when Pinterest returns a daily spend cap.	Currency	Adriel-side
Ends	Campaign end date.	Date	Adriel-side
Landing URL	Landing page URLs used by the ad.	URL	Adriel-side
Lifetime Budget	Lifetime budget amount set for the campaign when Pinterest returns a lifetime spend cap.	Currency	Adriel-side
Objective	Campaign objective associated with the entity.	Text	Adriel-side
Starts	Campaign start date.	Date	Adriel-side
Status (Text)	A human-readable label for the current delivery status.	Text	Adriel-side
Status (Toggle)	Current delivery or lifecycle status of the entity.	Text	Adriel-side
UTM Campaign	UTM campaign value parsed from the ad landing URL when present.	Text	Adriel-side
UTM Content	UTM content value parsed from the ad landing URL when present.	Text	Adriel-side
UTM Medium	UTM medium value parsed from the ad landing URL when present.	Text	Adriel-side
UTM Source	UTM source value parsed from the ad landing URL when present.	Text	Adriel-side
UTM Term	UTM term value parsed from the ad landing URL when present.	Text	Adriel-side

UTM values are parsed by Adriel, not returned by Pinterest. Adriel reads the UTM query parameters from each ad’s configuration or landing URL and exposes them as metrics for rollup.

Campaign Structure

Metric	Description	Data type	API Key
Ad Account ID	Pinterest ad account identifier used by the connector.	Text	Adriel-side
Ad ID	Pinterest ad identifier.	Text	Adriel-side
Ad Set ID	Pinterest ad group identifier.	Text	Adriel-side
Campaign ID	Pinterest campaign identifier.	Text	Adriel-side
Channel	Sub-channel classifications reported for the entity when available.	Text	Adriel-side
Keyword ID	Pinterest keyword identifier when available.	Text	Adriel-side
Keyword Name	Keyword text associated with the row when keyword targeting is used.	Text	Adriel-side

Click Performance

Metric	Description	Data type	API Key
Clicks (All)	The total number of clicks on your Pin to content on or off of Pinterest (paid and earned).	Number	`TOTAL_CLICKTHROUGH`
CPC	Cost per click — spend divided by clicks.	Currency	Adriel-computed
CPM	Cost per thousand impressions — spend divided by impressions, times 1,000.	Currency	Adriel-computed
CTR	Click-through rate — clicks divided by impressions.	Percentage	Adriel-computed
Impressions	Number of times someone saw your ad (paid and earned).	Number	`TOTAL_IMPRESSION`
Link Clicks	The total number of clicks on your Pin to content on or off of Pinterest (paid and earned).	Number	`TOTAL_CLICKTHROUGH`
Reach	Total number of unique users who saw your ads.	Number	`TOTAL_IMPRESSION_USER`

Computed Metrics

These are calculated by Adriel from other metrics; they have no single underlying Pinterest field.

Metric	Description	Data type	API Key
Frequency	Average number of times each user saw the ads (impressions divided by reach).	Ratio	Adriel-computed
ROAS	Return on ad spend — conversion value divided by spend.	Ratio	Adriel-computed
Video Played To 100% (%)	Plays reaching 100% of video length as a share of video impressions.	Percentage	Adriel-computed
Video Played To 25% (%)	Plays reaching 25% of video length as a share of video impressions.	Percentage	Adriel-computed
Video Played To 50% (%)	Plays reaching 50% of video length as a share of video impressions.	Percentage	Adriel-computed
Video Played To 75% (%)	Plays reaching 75% of video length as a share of video impressions.	Percentage	Adriel-computed
View Rate	Video views as a share of video impressions.	Percentage	Adriel-computed

Conversion Performance

Metric	Description	Data type	API Key
Conversion Value	Total value of checkout events resulting from interactions with your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Conversions	Total number of conversions for all event types using the Pinterest Tag integration after an ad interaction. This metric may include conversions that are modeled.	Number	`TOTAL_CONVERSIONS`
Result Indicator	The metric used to represent the result for the campaign’s objective.	Text	Adriel-derived
Results	The number of results reported for the campaign’s configured objective.	Text	Adriel-derived
Revenue	Total value of checkout events resulting from interactions with your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR`

Currency values are reported in each ad account’s configured Pinterest currency. Several Pinterest value fields are returned in micro-dollars (millionths of a unit); Adriel converts them to the account currency, and to the workspace currency using the day’s exchange rate when the two differ.

Custom conversion events are imported automatically. Any conversion event tracked in the ad account is imported and appears in dashboards only while the underlying event is active in the account. For each imported event, Adriel also derives ROAS, CPA, and conversion-rate KPIs when the data is available.

Creative Attributes

Metric	Description	Data type	API Key
Creative Image	A reference to the ad’s creative image.	Text	Adriel-side

Engagement

Metric	Description	Data type	API Key
Engagement	Number of times users interacted with the ad.	Number	`TOTAL_ENGAGEMENT`
Video Impressions	Number of times a video ad was served.	Number	Adriel-side

Video Performance

Metric	Description	Data type	API Key
Video Played To 100% (Views)	Total number of times your video ad played 100% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P100_COMPLETE`
Video Played To 25% (Views)	Total number of times your video ad played 25% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P25_COMBINED`
Video Played To 50% (Views)	Total number of times your video ad played 50% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P50_COMBINED`
Video Played To 75% (Views)	Total number of times your video ad played 75% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P75_COMBINED`
Video View3sec	The number of times your video ad played continuously for 3 seconds while 50% in view after being saved to another person’s board.	Number	`VIDEO_3SEC_VIEWS_2`
Views	Total number of times your video ad played 100% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P100_COMPLETE`

Pinterest Ads-specific

These metrics exist only for Pinterest Ads and aren’t shared with other connectors.

Several of these value metrics are returned in micro-dollars (millionths of a unit) and split by attribution type (click, view, engagement, web) and event (checkout, signup, custom). Adriel converts them to the account currency.

Metric	Description	Data type	API Key
Ad Group Status	Status of the ad group that this entity belongs to (active, paused, or archived).	Text	`AD_GROUP_ENTITY_STATUS`
Ad Spend	Total amount spent on ads during the reporting period.	Currency	Adriel-side
Add To Cart - ClickThrough Conversions	The number of add to cart events resulting from clicks on your ad. This metric may include conversions that are modeled.	Number	`TOTAL_CLICK_ADD_TO_CART`
Add To Cart - ViewThrough Conversions	Total number of add to cart events resulting from views of your ad. This metric may include conversions that are modeled.	Number	`TOTAL_VIEW_ADD_TO_CART`
Campaign Daily Budget	The maximum amount you’re willing to spend in one day.	Number	`CAMPAIGN_DAILY_SPEND_CAP`
Campaign Lifetime Budget	The maximum amount you’re willing to spend over the lifetime of your campaign.	Number	`CAMPAIGN_LIFETIME_SPEND_CAP`
Campaign Objective Type	The objective you chose for your campaign (Awareness, Traffic, App installs, Catalog sales, Conversions or Video views).	Text	`CAMPAIGN_OBJECTIVE_TYPE`
Campaign Status	Status of the campaign that this entity belongs to (active, paused, or archived).	Text	`CAMPAIGN_ENTITY_STATUS`
Checkout	Total number of checkout events that resulted from interactions with your ad. This metric may include conversions that are modeled.	Number	`TOTAL_CHECKOUT`
Checkout - ClickThrough Conversions	Total number of checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.	Number	`TOTAL_CLICK_CHECKOUT`
Checkout - ClickThrough Conversions: Conversion Value	Total value of checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Checkout - Engagement Conversions	Total number of checkout events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.	Number	`TOTAL_ENGAGEMENT_CHECKOUT`
Checkout - Engagement Conversions: Conversion Value	Total value of checkout events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.	Currency	`TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Checkout - Offline Conversions	Total number of offline checkout events resulting from clicks on your ad.	Number	`TOTAL_OFFLINE_CHECKOUT`
Checkout - ViewThrough Conversions	Total number of checkout events resulting from views of your ad. This metric may include conversions that are modeled.	Number	`TOTAL_VIEW_CHECKOUT`
Checkout - ViewThrough Conversions: Conversion Value	Total value of checkout events resulting from views of your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Checkout - Web ClickThrough Conversions	Total number of web checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.	Number	`TOTAL_WEB_CLICK_CHECKOUT`
Checkout - Web ClickThrough Conversions: Conversion Value	Total value of web checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Checkout - Web Conversions	Total number of web checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.	Number	`TOTAL_WEB_CHECKOUT`
Checkout - Web Conversions: Conversion Value	Total value of web checkout events resulting from interactions with your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Checkout - Web Engagement Conversions	Total number of web checkout events resulting from engagements with your ad (save, closeup or carousel swipe). This metric may include conversions that are modeled.	Number	`TOTAL_WEB_ENGAGEMENT_CHECKOUT`
Checkout - Web Engagement Conversions: Conversion Value	Total value of web checkout events resulting from engagements with your ad (save, closeup or carousel swipe). This metric may include conversions that are modeled.	Currency	`TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Checkout - Web ViewThrough Conversions	Total number of web checkout events resulting from views of your ad. This metric may include conversions that are modeled.	Number	`TOTAL_WEB_VIEW_CHECKOUT`
Checkout - Web ViewThrough Conversions: Conversion Value	Total value of web checkout events resulting from views of your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Checkout: Conversion Value	Total value of checkout events resulting from interactions with your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Custom	Total number of custom events resulting from interactions with your ad. This metric may include conversions that are modeled.	Number	`TOTAL_CUSTOM`
Custom: Conversion Value	Total value of custom events resulting from interactions with your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR`
Engagements	The total number of engagements on your ads, including clicks, saves, carousel swipes, and collections secondary saves.	Number	`TOTAL_ENGAGEMENT`
Engagements (Earned)	Earned actions from ads saved to boards.	Number	`ENGAGEMENT_2`
Engagements (Paid)	Paid actions taken as a result of your ads.	Number	`ENGAGEMENT_1`
Gross Impressions (Paid)	Unfiltered number of times your ad was on screen (paid).	Number	`IMPRESSION_1_GROSS`
Gross Pin Clicks (Paid)	Unfiltered number of times someone clicks your ad (paid).	Number	`CLICKTHROUGH_1_GROSS`
Impressions	Number of times someone saw your ad (paid and earned).	Number	`TOTAL_IMPRESSION`
Impressions (Earned)	Total number of times your ad was viewed after being saved to another person’s board.	Number	`IMPRESSION_2`
Impressions (Paid)	The number of times your ad was seen.	Number	`IMPRESSION_1`
Lead	Total number of lead events resulting from interactions with your ad. This metric may include conversions that are modeled.	Number	`TOTAL_LEAD`
Lead (Actual)	The number of times your ad achieved lead conversions.	Number	`LEADS`
Lead - ClickThrough Conversions	Total number of lead events resulting from clicks on your ad. This metric may include conversions that are modeled.	Number	`TOTAL_CLICK_LEAD`
Lead - Engagement Conversions	Total number of lead events resulting from engagement with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.	Number	`TOTAL_ENGAGEMENT_LEAD`
Lead - ViewThrough Conversions	Total number of lead events resulting from views of your ad. This metric may include conversions that are modeled.	Number	`TOTAL_VIEW_LEAD`
Order Line ID	Order Line ID associated with a campaign.	Text	`ORDER_LINE_ID`
Outbound Clicks	Total number of outbound clicks resulting from your ad, combining paid and earned outbound clicks.	Number	`OUTBOUND_CLICK_1 + OUTBOUND_CLICK_2`
Outbound Clicks (Earned)	The total number of clicks to the destination URL associated with your ad saved to another person’s board.	Number	`OUTBOUND_CLICK_2`
Outbound Clicks (Paid)	The total number of clicks to the destination URL associated with your ad.	Number	`OUTBOUND_CLICK_1`
Page Visits	Total number of page visit events resulting from interactions with your ad. This metric may include conversions that are modeled.	Number	`TOTAL_PAGE_VISIT`
Paid Impression	The number of impressions that you paid for.	Number	`PAID_IMPRESSION`
Pin Clicks	The total number of clicks on your Pin to content on or off of Pinterest (paid and earned).	Number	`TOTAL_CLICKTHROUGH`
Pin Clicks (Earned)	Total number of Pin clicks from ads saved to another person’s board.	Number	`CLICKTHROUGH_2`
Pin Clicks (Paid)	The total number of clicks on your Pin to content on or off of Pinterest.	Number	`CLICKTHROUGH_1`
Pin ID	Pinterest Pin ID associated with the ad creative.	Text	Adriel-side
Pin Product Tag Visits	The number of times someone taps on a product tagged within an Idea Pin, paid and earned.	Number	`TOTAL_IDEA_PIN_PRODUCT_TAG_VISIT`
Pin Product Tag Visits (Earned)	The number of times someone taps on a product tagged within an Idea ad saved to another person’s board.	Number	`IDEA_PIN_PRODUCT_TAG_VISIT_2`
Pin Product Tag Visits (Paid)	The number of times someone taps on a product tagged within an Idea Pin you promoted.	Number	`IDEA_PIN_PRODUCT_TAG_VISIT_1`
Quiz Completed	The number of quiz completed for a given ad.	Number	`QUIZ_COMPLETED`
Reach	Total number of unique users who saw your ads.	Number	`TOTAL_IMPRESSION_USER`
Saves (Earned)	Number of times your ad was saved from another person’s board.	Number	`REPIN_2`
Saves (Paid)	Total number of saves for your ad.	Number	`REPIN_1`
Showcase Card Clicks	The number of total outbound clicks from all cards.	Number	`SHOWCASE_SUBPAGE_CLICKTHROUGH`
Showcase Card Closeups	The number of total closeups for all cards.	Number	`SHOWCASE_SUBPAGE_CLOSEUP`
Showcase Card Impressions	The number of total impressions for all cards.	Number	`SHOWCASE_SUBPAGE_IMPRESSION`
Showcase Card Saves	The number of total saves for all cards.	Number	`SHOWCASE_SUBPAGE_REPIN`
Showcase Card Swipe Backward	The number of total swipes backward for all cards.	Number	`SHOWCASE_SUBPAGE_SWIPE_RIGHT`
Showcase Card Swipe Forward	The number of total swipes forward for all cards.	Number	`SHOWCASE_SUBPAGE_SWIPE_LEFT`
Showcase Card Thumbnail Swipe Backward	The number of total swipes backward on card thumbnails.	Number	`SHOWCASE_CARD_THUMBNAIL_SWIPE_BACKWARD`
Showcase Card Thumbnail Swipe Forward	The number of total swipes forward on card thumbnails.	Number	`SHOWCASE_CARD_THUMBNAIL_SWIPE_FORWARD`
Showcase Featured Pin Clicks	The number of total outbound clicks from all featured pins.	Number	`SHOWCASE_SUBPIN_CLICKTHROUGH`
Showcase Featured Pin Impressions	The number of total impressions for all featured pins.	Number	`SHOWCASE_SUBPIN_IMPRESSION`
Showcase Featured Pin Saves	The number of total saves for all featured pins.	Number	`SHOWCASE_SUBPIN_REPIN`
Showcase Featured Pin Swipe Backward	The number of total swipes backward for all featured pins.	Number	`SHOWCASE_SUBPIN_SWIPE_RIGHT`
Showcase Featured Pin Swipe Forward	The number of total swipes forward for all featured pins.	Number	`SHOWCASE_SUBPIN_SWIPE_LEFT`
Showcase Pin Clicks	The number of total outbound clicks from title pin.	Number	`SHOWCASE_PIN_CLICKTHROUGH`
Signup	Total number of signup events resulting from interactions with your ad. This metric may include conversions that are modeled.	Number	`TOTAL_SIGNUP`
Signup - ClickThrough Conversions	Number of signup events resulting from clicks on your ad. This metric may include conversions that are modeled.	Number	`TOTAL_CLICK_SIGNUP`
Signup - ClickThrough Conversions: Conversion Value	Total value of signup events resulting from clicks on your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR`
Signup - Engagement Conversions	Total number of signup events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.	Number	`TOTAL_ENGAGEMENT_SIGNUP`
Signup - Engagement Conversions: Conversion Value	Total value of signup events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.	Currency	`TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR`
Signup - ViewThrough Conversions	Number of signup events resulting from views of your ad. This metric may include conversions that are modeled.	Number	`TOTAL_VIEW_SIGNUP`
Signup - ViewThrough Conversions: Conversion Value	Total value of signup events resulting from views of your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR`
Signup: Conversion Value	Total value of signup events resulting from interactions with your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR`
Spend In Account Currency (Micro $)	The money you spend for promoted Pins, in micro dollars.	Number	`SPEND_IN_MICRO_DOLLAR`
Total Conversions	Total number of conversions for all event types using the Pinterest Tag integration after an ad interaction. This metric may include conversions that are modeled.	Number	`TOTAL_CONVERSIONS`
Total Conversions: Conversion Value	Total value of checkout events resulting from interactions with your ad. This metric may include conversions that are modeled.	Currency	`TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR`
Video Average Watch Time (s)	Averaged across all videos that begin playback, including seeks and loops. Start time triggered when video begins playback.	Number	`TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND`
Video Length	Runtime of your video ad.	Text	`VIDEO_LENGTH`
Video Played To 100%	Total number of times your video ad played 100% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P100_COMPLETE`
Video Played To 100% (Earned)	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.	Number	`VIDEO_P100_COMPLETE_2`
Video Played To 25%	Total number of times your video ad played 25% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P25_COMBINED`
Video Played To 25% (Earned)	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.	Number	`VIDEO_P25_COMBINED_2`
Video Played To 50%	Total number of times your video ad played 50% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P50_COMBINED`
Video Played To 50% (Earned)	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.	Number	`VIDEO_P50_COMBINED_2`
Video Played To 75%	Total number of times your video ad played 75% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P75_COMBINED`
Video Played To 75% (Earned)	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.	Number	`VIDEO_P75_COMBINED_2`
Video Played To 95%	Total number of times your video ad played 95% of its length, including views that skipped ahead to this point (paid and earned).	Number	`TOTAL_VIDEO_P95_COMBINED`
Video Played To 95% (Earned)	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.	Number	`VIDEO_P95_COMBINED_2`
Video Starts	Total number of times your video ad started playing (paid and earned).	Number	`TOTAL_VIDEO_P0_COMBINED`
Video Starts (Earned)	Total number of times your video ad started playing after it was saved to another person’s board.	Number	`VIDEO_P0_COMBINED_2`
Video Views	Total number of times your video ad played continuously for at least 2 seconds while 50% visible (paid and earned).	Number	`TOTAL_VIDEO_MRC_VIEWS`
Video Views (3s)	Total number of times your video ad played continuously for at least 3 seconds while 50% visible (paid and earned).	Number	`TOTAL_VIDEO_3SEC_VIEWS`
Video Views (3s, Earned)	The number of times your video ad played continuously for 3 seconds while 50% in view after being saved to another person’s board.	Number	`VIDEO_3SEC_VIEWS_2`
Video Views (Earned)	The number of times your video ad played continuously for 2 seconds while 50% in view after being saved to another person’s board.	Number	`VIDEO_MRC_VIEWS_2`
Video Views (Paid)	The number of first-order ad views where your video played for at least 2 seconds with at least 50% in view.	Number	`VIDEO_MRC_VIEWS_1`
Web Sessions	Total number of sessions loaded in a browser.	Number	`TOTAL_WEB_SESSIONS`
Web Sessions (Earned)	Number of earned sessions loaded in a browser.	Number	`WEB_SESSIONS_2`
Web Sessions (Paid)	Number of paid sessions loaded in a browser.	Number	`WEB_SESSIONS_1`

Breakdowns

Campaign Structure

Breakdown	Description	API Key
Ad	Groups results by Pinterest ad.	Adriel-side
Ad Account	Groups results by Pinterest ad account.	Adriel-side
Ad Name	Groups results by ad name.	Adriel-side
Ad Set	Groups results by Pinterest ad group.	Adriel-side
Ad Set Name	Groups results by ad set (ad group) name.	Adriel-side
Campaign	Groups results by Pinterest campaign.	Adriel-side
Campaign Name	Groups results by campaign name.	Adriel-side
Channel	Groups results by marketing channel.	Adriel-side
Objective	Groups results by the campaign objective.	Adriel-side
Placement	Groups results by the Pinterest placement where the ad was shown.	`PLACEMENT`
Platform	Groups results by sub-channel classification, when available.	Adriel-side
Status (Toggle)	Current delivery or lifecycle status of the entity.	Adriel-side

Creatives

Adriel post-processes ad creatives to generate these breakdowns.

Breakdown	Description	API Key
Ad Copy	Groups results by words extracted from the ad creative.	Adriel-side
Color Clustering	Groups results by the clustered color family detected in the creative.	Adriel-side
Creative Image	Groups results by the creative image hash.	Adriel-side
Emoji Analysis	Groups results by emoji usage detected in the creative.	Adriel-side

Date

Pinterest returns daily records; Adriel groups them into these views, so all time-grouping breakdowns are Adriel-side aggregations of the same underlying daily data.

Breakdown	Description	API Key
Auto Time Breakdown	Groups results by the automatically selected time granularity.	Adriel-side
Daily Breakdown	Groups results by calendar day.	Adriel-side
Monthly Breakdown	Groups results by calendar month.	Adriel-side
Quarterly Breakdown	Groups results by calendar quarter.	Adriel-side
Week Date Breakdown	Groups results by the starting date of the week bucket.	Adriel-side
Week Number Breakdown (W#)	Week number in the year for the reported data.	Adriel-side
Weekly Breakdown (Start: Mon)	Groups results by calendar week.	Adriel-side
Weekly Breakdown (Start: Sun)	Groups results into weeks running from Sunday through Saturday.	Adriel-side
Yearly Breakdown	Groups results by calendar year.	Adriel-side

Others

Returns one aggregated row without breaking the data down.

Breakdown	Description	API Key
No Grouping	Returns results without applying an additional breakdown.	Adriel-side

Target

Demographic, geographic, device, and placement breakdowns (age, gender, country, location, operating system, and placement) are reported per ad account only and cannot be combined with campaign, ad set, or ad granularity in the same query.

Breakdown	Description	API Key
Age	Groups results by the age bucket returned by Pinterest.	`AGE_BUCKET`
Country	Groups results by the country segment returned by Pinterest.	`COUNTRY`
Gender	Groups results by the reported gender segment returned by Pinterest.	`GENDER`
Location	Groups results by the location segment returned by Pinterest.	`LOCATION`
Operating System	Groups results by the operating system target returned by Pinterest.	`APPTYPE`

Pinterest Ads-specific

These breakdowns exist only for Pinterest Ads and aren’t shared with other connectors.

The audience and search-term breakdowns are reported per ad account only.

Breakdown	Description	API Key
Audience	Groups results by the included audience segment targeted by the ad.	`AUDIENCE_INCLUDE`
Pin ID	Pinterest Pin ID associated with the ad creative.	Adriel-side
Search Term View	Groups results by the keyword targeting value returned by Pinterest.	`KEYWORD`

Limitations

Ad-account-only demographic breakdowns — demographic, geographic, placement, and search-term breakdowns (age, gender, country, location, audience, OS, platform placement, search term) are reported per ad account only. They cannot be combined with campaign, ad set, or ad granularity in the same query.
Cache-only reads — dashboards never query Pinterest live for reports; all metric values come from the most recent cache snapshot, so very recent changes appear only after the next scheduled sync.
Uniqueness overcounting — uniqueness-based metrics such as reach are computed per snapshot and can be overvalued over date ranges longer than one day.
No deleted-data retention — this connector does not provide deleted elements. Data is not available after an element is deleted on the platform.
Automatic query chunking — report queries are split into chunks of at most 186 days per request and merged before parsing; this is automatic and requires no user action.
Currency conversion — when the ad account currency differs from the workspace currency, values are converted automatically using the current day’s exchange rate.

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Campaign Attributes

Campaign Structure

Click Performance

Computed Metrics

Conversion Performance

Creative Attributes

Engagement

Video Performance

Pinterest Ads-specific

Breakdowns

Campaign Structure

Creatives

Date

Others

Target

Pinterest Ads-specific

Limitations

API references

See also

​Introduction

​Data refresh strategy

​Architecture data

​Reports data

​Architecture levels

​Date range limits

​Metrics

​Campaign Attributes

​Campaign Structure

​Click Performance

​Computed Metrics

​Conversion Performance

​Creative Attributes

​Engagement

​Video Performance

​Pinterest Ads-specific

​Breakdowns

​Campaign Structure

​Creatives

​Date

​Others

​Target

​Pinterest Ads-specific

​Limitations

​API references

​See also

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Campaign Attributes

Campaign Structure

Click Performance

Computed Metrics

Conversion Performance

Creative Attributes

Engagement

Video Performance

Pinterest Ads-specific

Breakdowns

Campaign Structure

Creatives

Date

Others

Target

Pinterest Ads-specific

Limitations

API references

See also