Pinterest is a unique visual discovery platform where users actively search for inspiration, plan purchases, and save ideas for future action. This intent-rich environment makes Pinterest advertising especially powerful for brands in retail, home decor, fashion, food, travel, and lifestyle categories. Understanding the full landscape of Pinterest Ads dimensions and metrics is essential for running effective campaigns on the platform.

This guide provides a complete reference of every dimension and metric available in Pinterest Ads as of 2026. We've organized them by level — campaign, ad group, and pin — with practical context on when and how to use each one. Whether you're building custom dashboards, pulling data through the Pinterest Ads API, or optimizing campaigns in the Pinterest Ads Manager, this reference covers everything you need.

What Are Pinterest Ads Dimensions vs Metrics?

Before diving into the full reference, it's important to understand the fundamental difference between dimensions and metrics — two concepts that serve different purposes in advertising data analysis.

Dimensions are descriptive attributes that define what you're looking at. They are the labels, categories, and identifiers that let you organize and filter your data. Examples include campaign name, ad group ID, pin format, targeted interests, and geographic location. Dimensions answer the question: "How do I want to slice this data?"

Metrics are quantitative measurements that tell you how things performed. They are the numbers: impressions, clicks, saves, spend, conversions, CTR, CPC. Metrics answer the question: "What happened with my ads?"

Breakdowns are a special type of dimension that you can apply across any metric to segment performance. For example, you can break down your conversion metrics by placement (browse vs. search vs. related pins) to understand where users are most likely to take action.

Pinterest also has a unique concept of earned metrics — organic impressions, saves, and clicks that result from users interacting with your promoted pins and sharing them further. These earned metrics extend the value of your paid investment beyond the initial ad delivery.

How Is Pinterest Ads Data Structured?

Pinterest Ads follows a three-level hierarchy: Campaign > Ad Group > Pin/Ad. Campaigns define the objective and overall budget strategy. Ad groups control targeting (interests, keywords, audiences, demographics, placements), bid strategy, budget allocation, and schedule. Pins/Ads contain the actual creative — the visual, text, destination URL, and format. Metrics can be queried at any level, with pin-level data rolling up to ad group and campaign totals.

The Pinterest Ads API returns dimensions as object fields and metrics through reporting and analytics endpoints. Most metrics are available at all levels, while some dimensions are level-specific (e.g., targeting parameters only exist at the ad group level). Pinterest's reporting supports date range filtering, granularity settings, and multiple breakdown dimensions.

Campaign-Level Dimensions

Campaign-level dimensions define the top-level structure of your Pinterest advertising. These fields identify the campaign, its objective, budget configuration, and operational status. Use these dimensions to organize reporting by campaign and understand the strategic setup behind your results.

DimensionAPI FieldDescription
Campaign IDidUnique identifier for the campaign
Campaign NamenameThe name of the campaign as set by the advertiser
Objectiveobjective_typeCampaign goal: AWARENESS, CONSIDERATION, VIDEO_VIEW, CONVERSIONS, CATALOG_SALES, or SHOPPING
Campaign Statuseffective_statusComputed status: ACTIVE, PAUSED, ARCHIVED, COMPLETED, or DRAFT
Configured StatusstatusStatus explicitly set by the advertiser (ACTIVE, PAUSED)
Daily Spend Capdaily_spend_capMaximum daily spend for the campaign in microcurrency
Lifetime Spend Caplifetime_spend_capMaximum total spend across the campaign's lifetime in microcurrency
Budget Typebudget_typeWhether the campaign uses DAILY or LIFETIME budget pacing
Pacing Typepacing_typeBudget pacing strategy: STANDARD (even distribution) or ACCELERATED (spend as fast as possible)
Start Timestart_timeCampaign start date/time in ISO 8601 format
End Timeend_timeCampaign end date/time (null if running indefinitely)
Created Timecreated_timeTimestamp when the campaign was first created
Updated Timeupdated_timeTimestamp of the last modification to the campaign

Ad Group-Level Dimensions

Ad group dimensions control who sees your ads, where they appear, and how they're optimized. Pinterest offers a rich set of targeting options including interest categories, search keywords, audience lists, demographics, and placement controls. The ad group level is where most campaign optimization happens.

DimensionAPI FieldDescription
Ad Group IDidUnique identifier for the ad group
Ad Group NamenameName of the ad group as defined by the advertiser
Ad Group Statuseffective_statusComputed status considering campaign and ad group settings
Bid Strategybid_strategy_typeBidding approach: AUTOMATIC (let Pinterest optimize), CUSTOM (manual bid), or MAXIMUM_SPEND (maximize results within budget)
Bid Amountbid_in_micro_currencyManual bid amount in microcurrency (when using CUSTOM bid strategy)
Budgetbudget_in_micro_currencyAd group budget in microcurrency
Budget Typebudget_typeWhether the ad group uses DAILY or LIFETIME budget
Target Intereststargeting.interestsInterest categories: Home Decor, Fashion, Food & Drink, Travel, DIY, etc. (200+ categories)
Target Keywordstargeting.keywordsSearch keywords that trigger your ad in Pinterest search results
Target Audiencestargeting.audiencesCustom audiences: website visitors, customer lists, engagement audiences, actalike audiences
Target Agestargeting.agesAge targeting ranges: 18-24, 25-34, 35-44, 45-54, 55-64, 65+
Target Genderstargeting.gendersGender targeting: MALE, FEMALE, UNSPECIFIED, or ALL
Target Locationstargeting.locationsGeographic targeting by country, region, metro area, or postal code
Target Languagestargeting.languagesLanguages targeted based on user settings
Placementsplacement_groupWhere ads appear: BROWSE (home feed), SEARCH (search results), ALL (both placements)
Ad Formatad_formatsFormats allowed: STANDARD, VIDEO, CAROUSEL, SHOPPING, IDEA, or COLLECTIONS
Optimization Goaloptimization_goal_metadataWhat Pinterest optimizes for: CLICKS, IMPRESSIONS, CONVERSIONS, VIDEO_VIEWS, or CATALOG_SALES
SchedulescheduleAd group start and end dates and scheduling parameters
Auto Targetingauto_targeting_enabledWhether Pinterest can expand targeting beyond specified parameters
Tracking URLstracking_urlsThird-party tracking URLs for impression, click, and engagement tracking

Pin/Ad-Level Dimensions

Pin-level dimensions describe the individual ad unit — its identity, creative format, visual content, and destination. Pinterest supports several formats including standard pins, video pins, carousel pins, shopping pins, idea pins, and collections. These dimensions are essential for creative performance analysis and understanding which visual content inspires action.

DimensionAPI FieldDescription
Ad IDidUnique identifier for the ad
Pin IDpin_idPinterest pin ID for the promoted content
Ad NamenameName of the ad as set by the advertiser
Ad Statuseffective_statusComputed status: ACTIVE, PAUSED, DISAPPROVED, ARCHIVED, or PENDING_REVIEW
Pin Formatcreative_typeCreative format: REGULAR (standard pin), VIDEO, CAROUSEL, SHOPPING, IDEA, or COLLECTIONS
Destination URLdestination_urlThe landing page URL users are directed to when clicking through
Pin TitletitleTitle text of the promoted pin (up to 100 characters)
Pin DescriptiondescriptionDescription text of the promoted pin (up to 500 characters)
Board IDboard_idPinterest board the promoted pin belongs to
Board Nameboard_nameName of the board containing the promoted pin
Image URLimage_urlURL of the pin's primary image
Product Group IDproduct_group_idProduct group for Shopping Ads linked to catalog items
Carousel Cardscarousel_dataArray of images/URLs for carousel pins (2-5 cards)
Tracking URLtracking_urlsThird-party click and impression tracking URLs on the ad
Created Timecreated_timeWhen the ad was first created
Updated Timeupdated_timeWhen the ad was last modified

Core Performance Metrics

These are the fundamental metrics that measure how your Pinterest ads are delivered and interacted with. Pinterest's metric model distinguishes between on-platform interactions (pin clicks, saves) and off-platform actions (outbound clicks), plus unique "earned" metrics that capture the organic amplification of your paid content.

MetricAPI FieldDescriptionFormula / Notes
ImpressionsIMPRESSIONNumber of times your promoted pin was displayed on screenCounts each time the pin appears in a user's feed, search results, or related pins
Total AudienceTOTAL_AUDIENCEUnique users who saw your promoted pinDeduplicated reach — cannot be summed across time periods
Pin ClicksPIN_CLICKClicks to view the pin in closeup or interact with it on PinterestIncludes both on-platform closeup views and outbound clicks
Outbound ClicksOUTBOUND_CLICKClicks that take users off Pinterest to your websiteMost accurate measure of website traffic from Pinterest
CTR (Pin Clicks)PIN_CLICK_RATEPin click-through rate(Pin Clicks ÷ Impressions) × 100
Outbound Click RateOUTBOUND_CLICK_RATEOutbound click-through rate(Outbound Clicks ÷ Impressions) × 100
CPC (Pin Click)COST_PER_PIN_CLICKAverage cost per pin clickSpend ÷ Pin Clicks
CPC (Outbound Click)COST_PER_OUTBOUND_CLICKAverage cost per outbound click to your websiteSpend ÷ Outbound Clicks
CPMCPMCost per 1,000 impressions(Spend ÷ Impressions) × 1,000
SpendSPEND_IN_DOLLARTotal amount spent in account currencyActual billed amount for the reporting period
Earned ImpressionsEARNED_IMPRESSIONOrganic impressions generated from people interacting with your promoted pinFree impressions from saves, closeups, and shares by other users
Earned Pin ClicksEARNED_PIN_CLICKOrganic pin clicks generated from earned impressionsClicks on your pin from organic distribution after paid interaction
Earned Outbound ClicksEARNED_OUTBOUND_CLICKOrganic outbound clicks from earned impressionsWebsite traffic generated organically after paid promotion
Total ClicksTOTAL_CLICKSum of paid and earned clicks (all types)Paid Pin Clicks + Earned Pin Clicks

Conversion Metrics

Conversion metrics measure the business outcomes driven by your Pinterest ads — purchases, add-to-cart events, signups, and other valuable actions tracked through the Pinterest Tag or Conversions API. Pinterest's high-intent audience makes conversion tracking especially important, as users often save pins and convert days or weeks later.

MetricAPI FieldDescriptionNotes
Total ConversionsTOTAL_CONVERSIONSTotal conversion events across all tracked event typesSum of all Pinterest Tag/CAPI events attributed to your ads
CheckoutsCHECKOUTPurchase/checkout completion events on your websiteTracked via Pinterest Tag Checkout event
Checkout ValueCHECKOUT_VALUETotal monetary value of checkout eventsRevenue passed through the Pinterest Tag value parameter
Add to CartADD_TO_CARTItems added to shopping cart on your websiteTracked via Pinterest Tag AddToCart event
Add to Cart ValueADD_TO_CART_VALUETotal monetary value of add-to-cart eventsValue data for cart additions
Sign UpsSIGNUPAccount registration or signup eventsTracked via Pinterest Tag SignUp event
LeadsLEADLead generation events (form submissions, inquiries)Tracked via Pinterest Tag Lead event
View CategoryVIEW_CATEGORYCategory page views on your websiteTracked via Pinterest Tag ViewCategory event
Search EventsSEARCHSearch queries performed on your websiteTracked via Pinterest Tag Search event
Page VisitsPAGE_VISITGeneral page view events on your websiteTracked via Pinterest Tag PageVisit event
Custom EventsCUSTOMAdvertiser-defined custom conversion eventsTracked via Pinterest Tag Custom event
Cost Per Action (CPA)COST_PER_ACTIONAverage cost per conversion eventSpend ÷ Total Conversions
ROASROASReturn on ad spend from tracked checkout revenueCheckout Value ÷ Spend
View-Through ConversionsVIEW_THROUGH_CONVERSIONConversions from users who saw but did not click your promoted pinAttribution window: 1, 7, or 30 days (configurable)
Click-Through ConversionsCLICK_THROUGH_CONVERSIONConversions from users who clicked your promoted pin before convertingAttribution window: 1, 7, or 30 days (configurable)

Engagement Metrics

Engagement metrics on Pinterest reflect the platform's unique user behavior — saving pins to boards, viewing closeups, watching videos, and discovering products. Saves are particularly important on Pinterest because they indicate strong purchase intent and generate ongoing organic visibility long after the initial ad impression.

MetricAPI FieldDescriptionNotes
SavesSAVETimes users saved your promoted pin to one of their boardsStrongest intent signal on Pinterest — saved pins generate ongoing earned impressions
Save RateSAVE_RATESaves as a percentage of impressions(Saves ÷ Impressions) × 100
Earned SavesEARNED_SAVEOrganic saves generated from earned impressions of your promoted pinFree saves from organic distribution of your promoted content
Closeup ViewsCLOSEUPTimes users tapped on your pin to view it in full-screen closeupOn-platform engagement — user is viewing your pin in detail
Outbound Click RateOUTBOUND_CLICK_RATEPercentage of impressions resulting in outbound clicks(Outbound Clicks ÷ Impressions) × 100
Pin Click RatePIN_CLICK_RATEPercentage of impressions resulting in pin clicks(Pin Clicks ÷ Impressions) × 100
Video ViewsVIDEO_V50_MRC_VIEWVideo views meeting MRC standard (2 seconds at 50% viewability)Standard video view threshold aligned with Media Rating Council standards
Video StartsVIDEO_STARTNumber of times the video began playing (any duration)Includes autoplay starts when the pin scrolls into view
Video Watched 25%VIDEO_P25_WATCHEDTimes your video was watched through 25% of its lengthFirst quartile completion — measures opening visual hook
Video Watched 50%VIDEO_P50_WATCHEDTimes your video was watched through 50% of its lengthMidpoint completion — indicates sustained attention
Video Watched 75%VIDEO_P75_WATCHEDTimes your video was watched through 75% of its lengthThird quartile — strong engagement signal
Video Watched 95%VIDEO_P95_WATCHEDTimes your video was watched through 95% of its lengthNear-completion — Pinterest uniquely reports this threshold
Video Watched 100%VIDEO_P100_WATCHEDTimes your video was watched to full completionComplete play — highest video engagement level
Average Watch TimeVIDEO_AVG_WATCH_TIMEAverage time per video play in secondsTotal watch time ÷ video starts
Total Paid EngagementsTOTAL_ENGAGEMENTSum of all paid engagement actions (saves, pin clicks, outbound clicks)Holistic view of all paid interactions with the promoted pin
Total Earned EngagementsTOTAL_EARNED_ENGAGEMENTSum of all earned engagement actions from organic distributionOrganic interactions generated by users saving/sharing your promoted pin

Audience Breakdowns

Audience breakdowns let you segment your metrics by various dimensions to understand which audiences, placements, and contexts drive the best performance. Pinterest's placement breakdown (browse vs. search) is particularly important because user intent differs significantly between discovery and search contexts.

Demographic Breakdowns

BreakdownAPI FieldDescription
AgeAGE_BUCKETAge range: 18-24, 25-34, 35-44, 45-54, 55-64, 65+
GenderGENDERFemale, Male, Unspecified

Geographic Breakdowns

BreakdownAPI FieldDescription
CountryCOUNTRYCountry by ISO code (US, GB, FR, etc.)
RegionREGIONState or region within a country
Metro AreaMETRO_CODEMetropolitan area or designated market area

Device and Placement Breakdowns

BreakdownAPI FieldDescription
Device TypeAPPTYPEMobile (iPhone, Android Phone), Tablet (iPad, Android Tablet), Desktop (Web)
PlacementFEED_TYPEBrowse (home feed), Search (search results), Related (related pins), or All

Interest Breakdowns

BreakdownAPI FieldDescription
Interest CategoryINTERESTPerformance by Pinterest interest category (Fashion, Home Decor, Food, etc.)
KeywordKEYWORDPerformance by targeted search keyword (for search placement campaigns)

Pinterest-Specific Dimensions

Beyond standard advertising dimensions, Pinterest offers several platform-specific features that make its reporting unique. These dimensions leverage Pinterest's visual discovery model, shopping integration, and the unique way users plan and save content for future action.

Shopping Catalog Metrics

Shopping Ads are powered by your product catalog feed and automatically create pins from your product data. These metrics help you understand product-level performance within your advertising campaigns.

Dimension / MetricDescriptionNotes
Product Group PerformancePerformance data by product group from your catalogIncludes impressions, clicks, saves, and conversions per product group
Catalog Item IDIndividual product identifier from your catalog feedLinks directly to your product data (price, availability, description)
Product AvailabilityWhether the product is in stock, out of stock, or preorderPinterest pulls this from your catalog feed — out-of-stock items may still serve
Product PriceCurrent price and sale price from your catalogPrice changes in your feed are reflected in Shopping Ads automatically
Product CategoryGoogle Product Category from your catalog feedUsed for automatic categorization and interest matching

Idea Pin Metrics

Idea Pins (formerly Story Pins) are multi-page, immersive creative formats. These metrics help you understand how users engage with the multi-page format.

MetricDescriptionNotes
Page Views per Idea PinAverage number of pages viewed per idea pin interactionHigher page views indicate more engaging multi-page content
Forward TapsTaps to advance to the next page in the idea pinIndicates forward progression through your multi-page story
Backward TapsTaps to go back to a previous page in the idea pinCan indicate users re-reading content or checking details
Idea Pin SavesSaves of the idea pin to user boardsMulti-page saves have the same ongoing organic value as standard pin saves
Idea Pin Completion RatePercentage of users who viewed all pages of the idea pinKey metric for evaluating multi-page content quality

Organic vs Paid Comparison

DimensionDescriptionNotes
Paid ImpressionsImpressions delivered through paid promotionYour directly paid ad delivery
Earned ImpressionsOrganic impressions from user interactions with your promoted pinFree distribution when users save, click, or share your promoted content
Organic ImpressionsImpressions from your non-promoted pinsAvailable in Pinterest Analytics (separate from Ads reporting)
Paid-to-Earned RatioRatio of earned metrics to paid metricsHigher ratios indicate content that resonates and amplifies organically

How to Use Pinterest Metrics for Campaign Optimization

Knowing which metrics matter for your specific goals is what separates effective Pinterest advertisers from those who waste budget. Here's a practical framework for selecting the right metrics at each stage.

For awareness campaigns

Focus on impressions, total audience (reach), CPM, and earned impressions. The earned-to-paid impression ratio is especially important on Pinterest — content that resonates can generate 2-5x additional organic impressions. Monitor saves as a leading indicator, since saved pins continue generating impressions for weeks or months after the initial promotion.

For consideration and traffic campaigns

Prioritize outbound clicks (not pin clicks), outbound click rate, and cost per outbound click. Pin clicks include on-platform closeup views that don't drive website traffic. Also track page visits through the Pinterest Tag to measure actual landing page loads. The gap between outbound clicks and page visits reveals your bounce rate.

For conversion campaigns

Track CPA, ROAS, checkout value, and add-to-cart events. Pinterest users often save pins and convert days or weeks later — so view-through conversions and longer attribution windows (30-day) are particularly important on this platform. Break down by placement (browse vs. search) — search placements typically have higher intent and better conversion rates.

For shopping and catalog campaigns

Monitor product-level performance to identify top-performing items in your catalog. Track saves alongside conversion metrics — a product pin with high saves but low immediate conversions is building a pipeline of future purchasers. Use ROAS at the product group level to optimize your catalog feed and budget allocation.

For video campaigns

Use the video view rate and completion rate funnel (25% → 50% → 75% → 95% → 100%) to evaluate creative quality. Pinterest uniquely reports the 95% threshold, which captures viewers who watched nearly all of the video. A high 75%-to-95% ratio indicates strong content that holds attention through the end. Monitor average watch time to optimize video length for your audience.

Common Mistakes When Analyzing Pinterest Ads Data

Pinterest's unique visual discovery model creates specific pitfalls that advertisers from other platforms often encounter. Avoiding these mistakes will help you make better optimization decisions.

1. Using pin clicks instead of outbound clicks for traffic measurement

Pin clicks include on-platform interactions like closeup views — they do not all drive traffic to your website. When measuring website traffic intent, always use outbound clicks. The ratio of outbound clicks to pin clicks is typically 40-60%, meaning more than half of pin clicks stay on Pinterest.

2. Ignoring earned metrics

Earned impressions, saves, and clicks are free organic amplification of your paid content. A campaign that generates 50% earned impressions on top of paid is delivering significantly more value than the paid metrics alone suggest. Factor earned metrics into your true CPM and ROI calculations.

3. Using short attribution windows for a long-consideration platform

Pinterest users save content and return to it days or weeks later. Using a 1-day click attribution window will dramatically undercount your conversions. The 30-day window often captures 2-3x more conversions than the 7-day window on Pinterest. Always compare attribution windows before drawing conclusions about campaign performance.

4. Undervaluing saves as a performance metric

Saves are not just vanity metrics on Pinterest — they represent active intent and create ongoing organic distribution. A saved pin continues to appear in the saver's board and can be rediscovered by their followers. Pins with high save rates generate earned impressions and clicks for weeks or months, making saves one of the most valuable engagement signals on the platform.

5. Averaging ROAS across ad groups

Like all ratio metrics, ROAS cannot be averaged across ad groups or campaigns for an accurate total. Instead, sum total checkout value and total spend across all ad groups, then calculate ROAS from those totals: Total Checkout Value ÷ Total Spend.

6. Not segmenting by placement (browse vs. search)

Browse placements (home feed) and search placements serve fundamentally different user intents. Browse users are in discovery mode with lower immediate purchase intent but higher save rates. Search users have specific intent and typically convert at higher rates with lower saves. Always break down by placement to understand the dynamics and allocate budget to the highest-performing context for your specific objective.