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.
| Dimension | API Field | Description |
|---|---|---|
| Campaign ID | id | Unique identifier for the campaign |
| Campaign Name | name | The name of the campaign as set by the advertiser |
| Objective | objective_type | Campaign goal: AWARENESS, CONSIDERATION, VIDEO_VIEW, CONVERSIONS, CATALOG_SALES, or SHOPPING |
| Campaign Status | effective_status | Computed status: ACTIVE, PAUSED, ARCHIVED, COMPLETED, or DRAFT |
| Configured Status | status | Status explicitly set by the advertiser (ACTIVE, PAUSED) |
| Daily Spend Cap | daily_spend_cap | Maximum daily spend for the campaign in microcurrency |
| Lifetime Spend Cap | lifetime_spend_cap | Maximum total spend across the campaign's lifetime in microcurrency |
| Budget Type | budget_type | Whether the campaign uses DAILY or LIFETIME budget pacing |
| Pacing Type | pacing_type | Budget pacing strategy: STANDARD (even distribution) or ACCELERATED (spend as fast as possible) |
| Start Time | start_time | Campaign start date/time in ISO 8601 format |
| End Time | end_time | Campaign end date/time (null if running indefinitely) |
| Created Time | created_time | Timestamp when the campaign was first created |
| Updated Time | updated_time | Timestamp 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.
| Dimension | API Field | Description |
|---|---|---|
| Ad Group ID | id | Unique identifier for the ad group |
| Ad Group Name | name | Name of the ad group as defined by the advertiser |
| Ad Group Status | effective_status | Computed status considering campaign and ad group settings |
| Bid Strategy | bid_strategy_type | Bidding approach: AUTOMATIC (let Pinterest optimize), CUSTOM (manual bid), or MAXIMUM_SPEND (maximize results within budget) |
| Bid Amount | bid_in_micro_currency | Manual bid amount in microcurrency (when using CUSTOM bid strategy) |
| Budget | budget_in_micro_currency | Ad group budget in microcurrency |
| Budget Type | budget_type | Whether the ad group uses DAILY or LIFETIME budget |
| Target Interests | targeting.interests | Interest categories: Home Decor, Fashion, Food & Drink, Travel, DIY, etc. (200+ categories) |
| Target Keywords | targeting.keywords | Search keywords that trigger your ad in Pinterest search results |
| Target Audiences | targeting.audiences | Custom audiences: website visitors, customer lists, engagement audiences, actalike audiences |
| Target Ages | targeting.ages | Age targeting ranges: 18-24, 25-34, 35-44, 45-54, 55-64, 65+ |
| Target Genders | targeting.genders | Gender targeting: MALE, FEMALE, UNSPECIFIED, or ALL |
| Target Locations | targeting.locations | Geographic targeting by country, region, metro area, or postal code |
| Target Languages | targeting.languages | Languages targeted based on user settings |
| Placements | placement_group | Where ads appear: BROWSE (home feed), SEARCH (search results), ALL (both placements) |
| Ad Format | ad_formats | Formats allowed: STANDARD, VIDEO, CAROUSEL, SHOPPING, IDEA, or COLLECTIONS |
| Optimization Goal | optimization_goal_metadata | What Pinterest optimizes for: CLICKS, IMPRESSIONS, CONVERSIONS, VIDEO_VIEWS, or CATALOG_SALES |
| Schedule | schedule | Ad group start and end dates and scheduling parameters |
| Auto Targeting | auto_targeting_enabled | Whether Pinterest can expand targeting beyond specified parameters |
| Tracking URLs | tracking_urls | Third-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.
| Dimension | API Field | Description |
|---|---|---|
| Ad ID | id | Unique identifier for the ad |
| Pin ID | pin_id | Pinterest pin ID for the promoted content |
| Ad Name | name | Name of the ad as set by the advertiser |
| Ad Status | effective_status | Computed status: ACTIVE, PAUSED, DISAPPROVED, ARCHIVED, or PENDING_REVIEW |
| Pin Format | creative_type | Creative format: REGULAR (standard pin), VIDEO, CAROUSEL, SHOPPING, IDEA, or COLLECTIONS |
| Destination URL | destination_url | The landing page URL users are directed to when clicking through |
| Pin Title | title | Title text of the promoted pin (up to 100 characters) |
| Pin Description | description | Description text of the promoted pin (up to 500 characters) |
| Board ID | board_id | Pinterest board the promoted pin belongs to |
| Board Name | board_name | Name of the board containing the promoted pin |
| Image URL | image_url | URL of the pin's primary image |
| Product Group ID | product_group_id | Product group for Shopping Ads linked to catalog items |
| Carousel Cards | carousel_data | Array of images/URLs for carousel pins (2-5 cards) |
| Tracking URL | tracking_urls | Third-party click and impression tracking URLs on the ad |
| Created Time | created_time | When the ad was first created |
| Updated Time | updated_time | When 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.
| Metric | API Field | Description | Formula / Notes |
|---|---|---|---|
| Impressions | IMPRESSION | Number of times your promoted pin was displayed on screen | Counts each time the pin appears in a user's feed, search results, or related pins |
| Total Audience | TOTAL_AUDIENCE | Unique users who saw your promoted pin | Deduplicated reach — cannot be summed across time periods |
| Pin Clicks | PIN_CLICK | Clicks to view the pin in closeup or interact with it on Pinterest | Includes both on-platform closeup views and outbound clicks |
| Outbound Clicks | OUTBOUND_CLICK | Clicks that take users off Pinterest to your website | Most accurate measure of website traffic from Pinterest |
| CTR (Pin Clicks) | PIN_CLICK_RATE | Pin click-through rate | (Pin Clicks ÷ Impressions) × 100 |
| Outbound Click Rate | OUTBOUND_CLICK_RATE | Outbound click-through rate | (Outbound Clicks ÷ Impressions) × 100 |
| CPC (Pin Click) | COST_PER_PIN_CLICK | Average cost per pin click | Spend ÷ Pin Clicks |
| CPC (Outbound Click) | COST_PER_OUTBOUND_CLICK | Average cost per outbound click to your website | Spend ÷ Outbound Clicks |
| CPM | CPM | Cost per 1,000 impressions | (Spend ÷ Impressions) × 1,000 |
| Spend | SPEND_IN_DOLLAR | Total amount spent in account currency | Actual billed amount for the reporting period |
| Earned Impressions | EARNED_IMPRESSION | Organic impressions generated from people interacting with your promoted pin | Free impressions from saves, closeups, and shares by other users |
| Earned Pin Clicks | EARNED_PIN_CLICK | Organic pin clicks generated from earned impressions | Clicks on your pin from organic distribution after paid interaction |
| Earned Outbound Clicks | EARNED_OUTBOUND_CLICK | Organic outbound clicks from earned impressions | Website traffic generated organically after paid promotion |
| Total Clicks | TOTAL_CLICK | Sum 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.
| Metric | API Field | Description | Notes |
|---|---|---|---|
| Total Conversions | TOTAL_CONVERSIONS | Total conversion events across all tracked event types | Sum of all Pinterest Tag/CAPI events attributed to your ads |
| Checkouts | CHECKOUT | Purchase/checkout completion events on your website | Tracked via Pinterest Tag Checkout event |
| Checkout Value | CHECKOUT_VALUE | Total monetary value of checkout events | Revenue passed through the Pinterest Tag value parameter |
| Add to Cart | ADD_TO_CART | Items added to shopping cart on your website | Tracked via Pinterest Tag AddToCart event |
| Add to Cart Value | ADD_TO_CART_VALUE | Total monetary value of add-to-cart events | Value data for cart additions |
| Sign Ups | SIGNUP | Account registration or signup events | Tracked via Pinterest Tag SignUp event |
| Leads | LEAD | Lead generation events (form submissions, inquiries) | Tracked via Pinterest Tag Lead event |
| View Category | VIEW_CATEGORY | Category page views on your website | Tracked via Pinterest Tag ViewCategory event |
| Search Events | SEARCH | Search queries performed on your website | Tracked via Pinterest Tag Search event |
| Page Visits | PAGE_VISIT | General page view events on your website | Tracked via Pinterest Tag PageVisit event |
| Custom Events | CUSTOM | Advertiser-defined custom conversion events | Tracked via Pinterest Tag Custom event |
| Cost Per Action (CPA) | COST_PER_ACTION | Average cost per conversion event | Spend ÷ Total Conversions |
| ROAS | ROAS | Return on ad spend from tracked checkout revenue | Checkout Value ÷ Spend |
| View-Through Conversions | VIEW_THROUGH_CONVERSION | Conversions from users who saw but did not click your promoted pin | Attribution window: 1, 7, or 30 days (configurable) |
| Click-Through Conversions | CLICK_THROUGH_CONVERSION | Conversions from users who clicked your promoted pin before converting | Attribution 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.
| Metric | API Field | Description | Notes |
|---|---|---|---|
| Saves | SAVE | Times users saved your promoted pin to one of their boards | Strongest intent signal on Pinterest — saved pins generate ongoing earned impressions |
| Save Rate | SAVE_RATE | Saves as a percentage of impressions | (Saves ÷ Impressions) × 100 |
| Earned Saves | EARNED_SAVE | Organic saves generated from earned impressions of your promoted pin | Free saves from organic distribution of your promoted content |
| Closeup Views | CLOSEUP | Times users tapped on your pin to view it in full-screen closeup | On-platform engagement — user is viewing your pin in detail |
| Outbound Click Rate | OUTBOUND_CLICK_RATE | Percentage of impressions resulting in outbound clicks | (Outbound Clicks ÷ Impressions) × 100 |
| Pin Click Rate | PIN_CLICK_RATE | Percentage of impressions resulting in pin clicks | (Pin Clicks ÷ Impressions) × 100 |
| Video Views | VIDEO_V50_MRC_VIEW | Video views meeting MRC standard (2 seconds at 50% viewability) | Standard video view threshold aligned with Media Rating Council standards |
| Video Starts | VIDEO_START | Number of times the video began playing (any duration) | Includes autoplay starts when the pin scrolls into view |
| Video Watched 25% | VIDEO_P25_WATCHED | Times your video was watched through 25% of its length | First quartile completion — measures opening visual hook |
| Video Watched 50% | VIDEO_P50_WATCHED | Times your video was watched through 50% of its length | Midpoint completion — indicates sustained attention |
| Video Watched 75% | VIDEO_P75_WATCHED | Times your video was watched through 75% of its length | Third quartile — strong engagement signal |
| Video Watched 95% | VIDEO_P95_WATCHED | Times your video was watched through 95% of its length | Near-completion — Pinterest uniquely reports this threshold |
| Video Watched 100% | VIDEO_P100_WATCHED | Times your video was watched to full completion | Complete play — highest video engagement level |
| Average Watch Time | VIDEO_AVG_WATCH_TIME | Average time per video play in seconds | Total watch time ÷ video starts |
| Total Paid Engagements | TOTAL_ENGAGEMENT | Sum of all paid engagement actions (saves, pin clicks, outbound clicks) | Holistic view of all paid interactions with the promoted pin |
| Total Earned Engagements | TOTAL_EARNED_ENGAGEMENT | Sum of all earned engagement actions from organic distribution | Organic 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
| Breakdown | API Field | Description |
|---|---|---|
| Age | AGE_BUCKET | Age range: 18-24, 25-34, 35-44, 45-54, 55-64, 65+ |
| Gender | GENDER | Female, Male, Unspecified |
Geographic Breakdowns
| Breakdown | API Field | Description |
|---|---|---|
| Country | COUNTRY | Country by ISO code (US, GB, FR, etc.) |
| Region | REGION | State or region within a country |
| Metro Area | METRO_CODE | Metropolitan area or designated market area |
Device and Placement Breakdowns
| Breakdown | API Field | Description |
|---|---|---|
| Device Type | APPTYPE | Mobile (iPhone, Android Phone), Tablet (iPad, Android Tablet), Desktop (Web) |
| Placement | FEED_TYPE | Browse (home feed), Search (search results), Related (related pins), or All |
Interest Breakdowns
| Breakdown | API Field | Description |
|---|---|---|
| Interest Category | INTEREST | Performance by Pinterest interest category (Fashion, Home Decor, Food, etc.) |
| Keyword | KEYWORD | Performance 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 / Metric | Description | Notes |
|---|---|---|
| Product Group Performance | Performance data by product group from your catalog | Includes impressions, clicks, saves, and conversions per product group |
| Catalog Item ID | Individual product identifier from your catalog feed | Links directly to your product data (price, availability, description) |
| Product Availability | Whether the product is in stock, out of stock, or preorder | Pinterest pulls this from your catalog feed — out-of-stock items may still serve |
| Product Price | Current price and sale price from your catalog | Price changes in your feed are reflected in Shopping Ads automatically |
| Product Category | Google Product Category from your catalog feed | Used 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.
| Metric | Description | Notes |
|---|---|---|
| Page Views per Idea Pin | Average number of pages viewed per idea pin interaction | Higher page views indicate more engaging multi-page content |
| Forward Taps | Taps to advance to the next page in the idea pin | Indicates forward progression through your multi-page story |
| Backward Taps | Taps to go back to a previous page in the idea pin | Can indicate users re-reading content or checking details |
| Idea Pin Saves | Saves of the idea pin to user boards | Multi-page saves have the same ongoing organic value as standard pin saves |
| Idea Pin Completion Rate | Percentage of users who viewed all pages of the idea pin | Key metric for evaluating multi-page content quality |
Organic vs Paid Comparison
| Dimension | Description | Notes |
|---|---|---|
| Paid Impressions | Impressions delivered through paid promotion | Your directly paid ad delivery |
| Earned Impressions | Organic impressions from user interactions with your promoted pin | Free distribution when users save, click, or share your promoted content |
| Organic Impressions | Impressions from your non-promoted pins | Available in Pinterest Analytics (separate from Ads reporting) |
| Paid-to-Earned Ratio | Ratio of earned metrics to paid metrics | Higher 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.
