Pinterest Ads dashboard: metrics, template and AI prompts
Quick answer: A Pinterest Ads report needs 14 metrics on 5 panels: spend and delivery, efficiency, campaigns, ad groups and targeting, and checkouts. Ryze AI is the best tool for pulling those numbers from several Pinterest ad accounts with a prompt, with one caveat: Pinterest is chat only in Ryze AI, so there is no saved dashboard layout to open.
Below: the metrics with Pinterest API v5 column names, a 5-panel template, Pinterest's own reporting dashboard, Ryze AI prompts and a weekly routine.
Ryze AI · Paid Ads
Pinterest Ads numbers from a prompt
- 7-day free trial, $89 a month flat
Used by 2,000+ marketers
Pinterest Ads dashboard at a glance
5 panels, read top to bottom once a week.
- 1Spend and deliveryLast 7 days vs prior 7
Metrics: Spend, paid impressions, people reached, frequency
Question it answers: What did we spend and how far did it reach?
- 2EfficiencyLast 7 days vs prior 7
Metrics: CTR, CPC, CPM, engagement rate
Question it answers: Are clicks and attention getting dearer?
- 3CampaignsLast 7 days vs prior 7
Metrics: The same metrics per campaign
Question it answers: Which campaign caused the change?
- 4Ad groups and targetingLast 30 days
Metrics: Breakdowns by age, gender, country and placement
Question it answers: Who and where are results coming from?
- 5CheckoutsLast 30 days
Metrics: Checkouts, checkout value, checkout ROAS
Question it answers: What came back for the spend?
| # | Panel | Range | Metrics | Question it answers |
|---|---|---|---|---|
| 1 | Spend and delivery | Last 7 days vs prior 7 | Spend, paid impressions, people reached, frequency | What did we spend and how far did it reach? |
| 2 | Efficiency | Last 7 days vs prior 7 | CTR, CPC, CPM, engagement rate | Are clicks and attention getting dearer? |
| 3 | Campaigns | Last 7 days vs prior 7 | The same metrics per campaign | Which campaign caused the change? |
| 4 | Ad groups and targeting | Last 30 days | Breakdowns by age, gender, country and placement | Who and where are results coming from? |
| 5 | Checkouts | Last 30 days | Checkouts, checkout value, checkout ROAS | What came back for the spend? |
The next section maps each metric to its analytics column.
The 14 Pinterest Ads dashboard metrics and their API columns
14 metrics answer 3 weekly questions: what did we spend, how far did it reach, and what came back.
Column names let a query or an AI agent pull the exact field. They come from the column list in Pinterest's API v5 OpenAPI description, which the Pinterest developer docs publish as the API reference. Definitions are plain-language readings of those names.
Spend
- Plain definition
- Amount spent in the period
- API column
- SPEND_IN_DOLLAR
- How to read it
- In the advertiser profile currency
Paid impressions
- Plain definition
- Times your ads were shown
- API column
- PAID_IMPRESSION
- How to read it
- Delivery; paid only
People reached
- Plain definition
- Unique people who saw your ads
- API column
- TOTAL_IMPRESSION_USER
- How to read it
- Unique audience for the period
Frequency
- Plain definition
- Average times each person saw an ad
- API column
- TOTAL_IMPRESSION_FREQUENCY
- How to read it
- Rising frequency with falling CTR points to fatigue
Clickthroughs
- Plain definition
- Clickthroughs on your ads
- API column
- TOTAL_CLICKTHROUGH
- How to read it
- Pinterest's total clickthrough column
Outbound clicks
- Plain definition
- Clicks that lead off Pinterest
- API column
- OUTBOUND_CLICK_1
- How to read it
- Closer to site traffic than all clickthroughs
CTR
- Plain definition
- Click-through rate
- API column
- CTR
- How to read it
- Compare within one placement and objective
CPC
- Plain definition
- Effective cost per click
- API column
- ECPC_IN_DOLLAR
- How to read it
- Spend divided by clicks
CPM
- Plain definition
- Cost per 1,000 impressions
- API column
- CPM_IN_DOLLAR
- How to read it
- Auction cost; moves with audience and season
Engagements
- Plain definition
- Actions people take on an ad
- API column
- TOTAL_ENGAGEMENT
- How to read it
- Includes saves and closeups as well as clicks
Engagement rate
- Plain definition
- Engagements divided by impressions
- API column
- ENGAGEMENT_RATE
- How to read it
- Pinterest is a save-and-browse platform, so read it next to CTR
Checkouts
- Plain definition
- Checkout conversions
- API column
- TOTAL_CHECKOUT
- How to read it
- Needs the Pinterest Tag or conversions set up
Checkout value
- Plain definition
- Value of checkout conversions
- API column
- TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR
- How to read it
- In millionths of a currency unit; divide by 1,000,000
Checkout ROAS
- Plain definition
- Return on ad spend from checkouts
- API column
- CHECKOUT_ROAS
- How to read it
- Above 1 means tracked checkout value exceeds spend
| Metric | Plain definition | API column | How to read it |
|---|---|---|---|
| Spend | Amount spent in the period | SPEND_IN_DOLLAR | In the advertiser profile currency |
| Paid impressions | Times your ads were shown | PAID_IMPRESSION | Delivery; paid only |
| People reached | Unique people who saw your ads | TOTAL_IMPRESSION_USER | Unique audience for the period |
| Frequency | Average times each person saw an ad | TOTAL_IMPRESSION_FREQUENCY | Rising frequency with falling CTR points to fatigue |
| Clickthroughs | Clickthroughs on your ads | TOTAL_CLICKTHROUGH | Pinterest's total clickthrough column |
| Outbound clicks | Clicks that lead off Pinterest | OUTBOUND_CLICK_1 | Closer to site traffic than all clickthroughs |
| CTR | Click-through rate | CTR | Compare within one placement and objective |
| CPC | Effective cost per click | ECPC_IN_DOLLAR | Spend divided by clicks |
| CPM | Cost per 1,000 impressions | CPM_IN_DOLLAR | Auction cost; moves with audience and season |
| Engagements | Actions people take on an ad | TOTAL_ENGAGEMENT | Includes saves and closeups as well as clicks |
| Engagement rate | Engagements divided by impressions | ENGAGEMENT_RATE | Pinterest is a save-and-browse platform, so read it next to CTR |
| Checkouts | Checkout conversions | TOTAL_CHECKOUT | Needs the Pinterest Tag or conversions set up |
| Checkout value | Value of checkout conversions | TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR | In millionths of a currency unit; divide by 1,000,000 |
| Checkout ROAS | Return on ad spend from checkouts | CHECKOUT_ROAS | Above 1 means tracked checkout value exceeds spend |
3 things that trip up a first dashboard
- Micro-dollars. Per the columns parameter in Pinterest's API description, any metric defined in micro-dollars returns a value in the advertiser profile's currency, in microunits (1/1,000,000). Divide checkout value by 1,000,000 before comparing it with spend.
- Attribution windows. Per the API description, click_window_days defaults to 30 and view_window_days to 1 for Pinterest Tag conversion metrics. Pinterest's help center recommends 30 days for clicks and 30 days for views in its own dashboard. A report with a different window will not match. Fix one window and use it everywhere.
- Missing columns. The API description says that if a column has no value, it may not be returned. A dashboard must treat a missing checkout column as zero or as not tracked, and check which.
Analytics exist at several levels: the ad account, campaigns, ad groups and ads each have their own analytics endpoint, and an account-level targeting endpoint returns breakdowns. Per Pinterest, outside hourly granularity you can pull data from up to 90 days before today (UTC), with a maximum range of 90 days.
The Pinterest Ads dashboard template: 5 panels
Put the 14 metrics on 5 panels, ordered from the money to the targeting.
1. Spend and delivery
- Tiles or chart
- Tiles: spend, paid impressions, people reached, frequency; daily line of spend
- Date range
- Last 7 days, 30-day line
- Compare with
- The 7 days before
2. Efficiency
- Tiles or chart
- Tiles: CTR, CPC, CPM, engagement rate
- Date range
- Last 7 days
- Compare with
- The 7 days before
3. Campaigns
- Tiles or chart
- Table, highest spend first, with spend, outbound clicks, CTR, CPC
- Date range
- Last 7 days
- Compare with
- The 7 days before
4. Ad groups and targeting
- Tiles or chart
- Bars by age bucket, gender, country and placement for spend and clicks
- Date range
- Last 30 days
- Compare with
- Share of spend vs share of clicks
5. Checkouts
- Tiles or chart
- Tiles: checkouts, checkout value, checkout ROAS; table per campaign
- Date range
- Last 30 days
- Compare with
- The 30 days before
| Panel | Tiles or chart | Date range | Compare with |
|---|---|---|---|
| 1. Spend and delivery | Tiles: spend, paid impressions, people reached, frequency; daily line of spend | Last 7 days, 30-day line | The 7 days before |
| 2. Efficiency | Tiles: CTR, CPC, CPM, engagement rate | Last 7 days | The 7 days before |
| 3. Campaigns | Table, highest spend first, with spend, outbound clicks, CTR, CPC | Last 7 days | The 7 days before |
| 4. Ad groups and targeting | Bars by age bucket, gender, country and placement for spend and clicks | Last 30 days | Share of spend vs share of clicks |
| 5. Checkouts | Tiles: checkouts, checkout value, checkout ROAS; table per campaign | Last 30 days | The 30 days before |
Read panel 1 first. If CPC rose, panel 2 shows whether CPM or CTR moved, panel 3 names the campaign, and panels 4 and 5 show whether a segment or the checkout side is behind it.
These are request shapes built from parameter and column names in Pinterest's API description (the campaign endpoint requires campaign_ids). Check the currency, window and date range before trusting the totals.
Option 1: the reporting dashboard in Pinterest Ads Manager
Pinterest has its own reporting dashboard: a graph with filters and a reporting table you can customize and export. It is free with an ad account and covers one ad account at a time.
Per Pinterest's Review reporting help page, the dashboard shows spend, impressions, Pin clicks, outbound clicks, cost per result and CTR, and you can filter by date range, time zone, objective, status and conversion settings.
- Open the reporting dashboard in Ads Manager and set the date range and time zone.
- Choose the conversion window. Pinterest recommends 30 days for clicks and 30 days for views.
- Customize the reporting table with the columns from the metrics table above.
- Optionally add a custom column with a formula. Pinterest allows as many custom columns as you like but saves 10 per custom table.
- Export the table as CSV.
Strength: native, free and the same numbers Pinterest shows elsewhere. Limits per the same page: export is CSV, data goes back 25 months, and hourly data covers 3-day ranges. It holds Pinterest data for one ad account at a time.
Option 2: the prompts that pull it through Ryze AI
Ryze AI reads Pinterest ad account analytics such as spend, paid impressions, clicks and checkouts by day, week or month, so each panel is one prompt.
Connect Pinterest Ads under Integrations with the Pinterest login that has access to your ad accounts, and approve every permission. Per the Ryze AI Pinterest Ads guide, Ryze AI then sees every ad account that login can reach; there is no ad account to pick. Then open a new chat and paste a prompt.
Behind these prompts sits the pinterest_ads__read tool, which reads any Pinterest API v5 resource including campaigns, ad groups, ads and ad account analytics; pinterest_ads__listAccounts lists the ad accounts the login can access. There is no dedicated report tool, so analytics come through the read tool.
The same pulls in Claude or ChatGPT
The same tools load in Claude and ChatGPT through the Ryze AI connector; the full tool list and setup are on the Pinterest Ads MCP page.
Check approvals first. In the Ryze AI chat, the Tool approvals setting starts on Skip all approvals; switch it in the chat composer to Approve write & delete. In Claude, set write and delete tools to Needs approval under Customize > Connectors > Ryze AI. The same connection also has write and delete tools, so every prompt here tells the agent to change nothing.
A weekly review routine for the dashboard
Spend 20 minutes on the same day each week and read the panels in order.
1
- Panel
- Spend and delivery
- What to check
- Spend vs plan; frequency vs prior 7 days
- Action if off
- Open panels 2 and 3 to find the cause
2
- Panel
- Efficiency
- What to check
- CPM, CTR and CPC direction
- Action if off
- High CPM: audience or season. Low CTR: creative
3
- Panel
- Campaigns
- What to check
- The campaign with the largest change
- Action if off
- Review budget and targeting of that campaign
4
- Panel
- Ad groups and targeting
- What to check
- Spend share vs click share by segment
- Action if off
- Ask whether a segment spends more than it returns
5
- Panel
- Checkouts
- What to check
- Checkout ROAS vs prior 30 days
- Action if off
- Check the Pinterest Tag before judging the campaign
| Step | Panel | What to check | Action if off |
|---|---|---|---|
| 1 | Spend and delivery | Spend vs plan; frequency vs prior 7 days | Open panels 2 and 3 to find the cause |
| 2 | Efficiency | CPM, CTR and CPC direction | High CPM: audience or season. Low CTR: creative |
| 3 | Campaigns | The campaign with the largest change | Review budget and targeting of that campaign |
| 4 | Ad groups and targeting | Spend share vs click share by segment | Ask whether a segment spends more than it returns |
| 5 | Checkouts | Checkout ROAS vs prior 30 days | Check the Pinterest Tag before judging the campaign |
Re-read last week too: conversion data can settle after the day it is first reported, so recent days may change.
Scheduled version
The Ryze AI help center describes scheduled tasks. They run without an approval step, so keep the prompt read only.
Pinterest reporting vs Ryze AI for a Pinterest Ads dashboard
Pinterest's reporting dashboard gives a saved layout in Pinterest. Ryze AI gives answers to new questions across ad accounts.
Price
- Pinterest reporting dashboard
- Free with an ad account
- Ryze AI
- Paid Ads $89/mo, 7-day free trial
Accounts
- Pinterest reporting dashboard
- One ad account at a time
- Ryze AI
- Every Pinterest ad account the connected login reaches
Custom columns
- Pinterest reporting dashboard
- Formula columns, 10 saved per custom table
- Ryze AI
- Ask for any analytics column through the read tool
History
- Pinterest reporting dashboard
- 25 months, per Pinterest
- Ryze AI
- Whatever the Pinterest analytics API returns; 90 days back outside hourly
Saved fixed layout
- Pinterest reporting dashboard
- Yes, with CSV export
- Ryze AI
- No saved layout; Pinterest is chat only, with no Ads Performance dashboard
Acting on findings
- Pinterest reporting dashboard
- Edit campaigns in Ads Manager
- Ryze AI
- Can pause or archive campaigns and ads through the write tool
| Question | Pinterest reporting dashboard | Ryze AI |
|---|---|---|
| Price | Free with an ad account | Paid Ads $89/mo, 7-day free trial |
| Accounts | One ad account at a time | Every Pinterest ad account the connected login reaches |
| Custom columns | Formula columns, 10 saved per custom table | Ask for any analytics column through the read tool |
| History | 25 months, per Pinterest | Whatever the Pinterest analytics API returns; 90 days back outside hourly |
| Saved fixed layout | Yes, with CSV export | No saved layout; Pinterest is chat only, with no Ads Performance dashboard |
| Acting on findings | Edit campaigns in Ads Manager | Can pause or archive campaigns and ads through the write tool |
Pinterest's developer docs overview on the build day did not mention an MCP server, so no Pinterest-run server is listed here; check Pinterest's docs for any later launch. The Ryze AI connector at https://connector.get-ryze.ai/mcp also covers the other platforms Ryze AI connects.
Which Pinterest Ads dashboard to use
Pick by how many ad accounts you read and how often the questions change.
One ad account, a fixed layout and CSV export
- Use
- Pinterest's reporting dashboard
Several ad accounts or changing questions
- Use
- Ryze AI prompts
Own storage or a custom chart
- Use
- The analytics API with the columns above
Acting on what the numbers show
- Use
- Ryze AI write tool, with approvals switched on
| Situation | Use |
|---|---|
| One ad account, a fixed layout and CSV export | Pinterest's reporting dashboard |
| Several ad accounts or changing questions | Ryze AI prompts |
| Own storage or a custom chart | The analytics API with the columns above |
| Acting on what the numbers show | Ryze AI write tool, with approvals switched on |
You can use both: keep a saved Pinterest view for the fixed numbers and ask Ryze AI for the why.
Sources
- Pinterest API v5 OpenAPI descriptionAnalytics endpoints, columns, windows, 90-day limit, version 5.28.0. Opened Nov 16, 2026.
- Pinterest developer docsAPI reference. Opened Nov 16, 2026.
- Pinterest help: Review reportingReporting dashboard, CSV export, 25 months, conversion window. Opened Nov 16, 2026.
- Ryze AI Pinterest Ads guideConnection, access and tools.
The verdict
A Pinterest Ads dashboard is 14 metrics on 5 panels read in the same order each week. Build the fixed version in Pinterest's reporting dashboard if one ad account is enough.
Use Ryze AI when you read several ad accounts or want to ask new questions of the same data. Connect Pinterest Ads, paste the prompts above and keep them read only.
Frequently asked questions
What should a Pinterest Ads dashboard include?
Does Pinterest have a built-in dashboard?
Which attribution window does the Pinterest API use?
How far back can the Pinterest analytics API go?
Show 7 more questionsShow fewer questions
Why are my checkout values so large?
Can I break results down by age, gender or placement?
Can Ryze AI build a Pinterest Ads dashboard?
Which Ryze AI tools read Pinterest data?
Can the agent change my account while I build a dashboard?
Does Pinterest have its own MCP server?
How much does Ryze AI cost for this?
Related guides
Pinterest Ads MCP server
The Ryze AI connector's Pinterest Ads tools, setup and example prompts.
Meta Ads dashboard
14 Meta Ads metrics with Insights API field names and a 5-panel template.
Google Ads dashboard
14 Google Ads metrics with API field names and a 5-panel template.
Google Analytics dashboard (GA4)
15 GA4 metrics with Data API names and an 11-card template.





