Ira Bodnar··Updated ·11 min read

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

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

Pinterest Ads dashboard at a glance

5 panels, read top to bottom once a week.

  1. 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?

  2. 2EfficiencyLast 7 days vs prior 7

    Metrics: CTR, CPC, CPM, engagement rate

    Question it answers: Are clicks and attention getting dearer?

  3. 3CampaignsLast 7 days vs prior 7

    Metrics: The same metrics per campaign

    Question it answers: Which campaign caused the change?

  4. 4Ad groups and targetingLast 30 days

    Metrics: Breakdowns by age, gender, country and placement

    Question it answers: Who and where are results coming from?

  5. 5CheckoutsLast 30 days

    Metrics: Checkouts, checkout value, checkout ROAS

    Question it answers: 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.

  1. Spend

    Plain definition
    Amount spent in the period
    API column
    SPEND_IN_DOLLAR
    How to read it
    In the advertiser profile currency
  2. Paid impressions

    Plain definition
    Times your ads were shown
    API column
    PAID_IMPRESSION
    How to read it
    Delivery; paid only
  3. People reached

    Plain definition
    Unique people who saw your ads
    API column
    TOTAL_IMPRESSION_USER
    How to read it
    Unique audience for the period
  4. 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
  5. Clickthroughs

    Plain definition
    Clickthroughs on your ads
    API column
    TOTAL_CLICKTHROUGH
    How to read it
    Pinterest's total clickthrough column
  6. 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
  7. CTR

    Plain definition
    Click-through rate
    API column
    CTR
    How to read it
    Compare within one placement and objective
  8. CPC

    Plain definition
    Effective cost per click
    API column
    ECPC_IN_DOLLAR
    How to read it
    Spend divided by clicks
  9. CPM

    Plain definition
    Cost per 1,000 impressions
    API column
    CPM_IN_DOLLAR
    How to read it
    Auction cost; moves with audience and season
  10. 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
  11. 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
  12. Checkouts

    Plain definition
    Checkout conversions
    API column
    TOTAL_CHECKOUT
    How to read it
    Needs the Pinterest Tag or conversions set up
  13. 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
  14. 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

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. 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. 2. Efficiency

    Tiles or chart
    Tiles: CTR, CPC, CPM, engagement rate
    Date range
    Last 7 days
    Compare with
    The 7 days before
  3. 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. 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. 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

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.

Analytics request: panel 1, 30-day daily trend
GET https://api.pinterest.com/v5/ad_accounts/<AD_ACCOUNT_ID>/analytics ?start_date=<YYYY-MM-DD> &end_date=<YYYY-MM-DD> &granularity=DAY &columns=SPEND_IN_DOLLAR,PAID_IMPRESSION,TOTAL_IMPRESSION_USER,TOTAL_IMPRESSION_FREQUENCY
Analytics request: panel 3, campaign table
GET https://api.pinterest.com/v5/ad_accounts/<AD_ACCOUNT_ID>/campaigns/analytics ?campaign_ids=<ID1>,<ID2> &start_date=<YYYY-MM-DD> &end_date=<YYYY-MM-DD> &granularity=TOTAL &columns=CAMPAIGN_NAME,SPEND_IN_DOLLAR,OUTBOUND_CLICK_1,CTR,ECPC_IN_DOLLAR
Targeting analytics request: panel 4, breakdowns
GET https://api.pinterest.com/v5/ad_accounts/<AD_ACCOUNT_ID>/targeting_analytics ?targeting_types=AGE_BUCKET,GENDER,PLACEMENT &start_date=<YYYY-MM-DD> &end_date=<YYYY-MM-DD> &granularity=TOTAL &columns=SPEND_IN_DOLLAR,TOTAL_CLICKTHROUGH

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.

  1. Open the reporting dashboard in Ads Manager and set the date range and time zone.
  2. Choose the conversion window. Pinterest recommends 30 days for clicks and 30 days for views.
  3. Customize the reporting table with the columns from the metrics table above.
  4. Optionally add a custom column with a formula. Pinterest allows as many custom columns as you like but saves 10 per custom table.
  5. 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.

Prompt: panels 1 to 3 in the Ryze AI chat
For the Pinterest ad account [account name], read only: change nothing. 1. Spend, paid impressions, people reached and frequency for the last 7 days vs the 7 before. 2. CTR, CPC, CPM and engagement rate for the same two periods. 3. A campaign table, highest spend first, with spend, outbound clicks, CTR and CPC. Use the account currency and a [30]-day click, [1]-day view window. Flag any metric that moved more than [20]% week over week.
Prompt: panels 4 and 5, targeting and checkouts
For [account name], pull the last 30 days of spend and clicks broken down by age bucket, gender, country and placement. Then show checkouts, checkout value and checkout ROAS per campaign, and say which campaigns spend more than they return. Read only.

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. 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. 2

    Panel
    Efficiency
    What to check
    CPM, CTR and CPC direction
    Action if off
    High CPM: audience or season. Low CTR: creative
  3. 3

    Panel
    Campaigns
    What to check
    The campaign with the largest change
    Action if off
    Review budget and targeting of that campaign
  4. 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. 5

    Panel
    Checkouts
    What to check
    Checkout ROAS vs prior 30 days
    Action if off
    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.

Prompt: weekly review
For Pinterest ad account [account name], summarize last week, Monday to Sunday, vs the week before: spend, outbound clicks, CTR and CPC for the account and the top [5] campaigns, and checkout ROAS where checkouts are tracked. 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.

  1. Price

    Pinterest reporting dashboard
    Free with an ad account
    Ryze AI
    Paid Ads $89/mo, 7-day free trial
  2. Accounts

    Pinterest reporting dashboard
    One ad account at a time
    Ryze AI
    Every Pinterest ad account the connected login reaches
  3. Custom columns

    Pinterest reporting dashboard
    Formula columns, 10 saved per custom table
    Ryze AI
    Ask for any analytics column through the read tool
  4. History

    Pinterest reporting dashboard
    25 months, per Pinterest
    Ryze AI
    Whatever the Pinterest analytics API returns; 90 days back outside hourly
  5. Saved fixed layout

    Pinterest reporting dashboard
    Yes, with CSV export
    Ryze AI
    No saved layout; Pinterest is chat only, with no Ads Performance dashboard
  6. Acting on findings

    Pinterest reporting dashboard
    Edit campaigns in Ads Manager
    Ryze AI
    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.

  1. One ad account, a fixed layout and CSV export

    Use
    Pinterest's reporting dashboard
  2. Several ad accounts or changing questions

    Use
    Ryze AI prompts
  3. Own storage or a custom chart

    Use
    The analytics API with the columns above
  4. Acting on what the numbers show

    Use
    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

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?
14 metrics on 5 panels: spend and delivery, efficiency, campaigns, ad groups and targeting, and checkouts. Core columns are SPEND_IN_DOLLAR, PAID_IMPRESSION, CTR, ECPC_IN_DOLLAR, CPM_IN_DOLLAR, TOTAL_CHECKOUT and CHECKOUT_ROAS. Compare the last 7 days with the 7 before.
Does Pinterest have a built-in dashboard?
Yes, the reporting dashboard in Ads Manager has a filterable graph and a reporting table you can customize and export as CSV. It is free and shows Pinterest data for one ad account at a time.
Which attribution window does the Pinterest API use?
Per Pinterest's API description, click_window_days defaults to 30 and view_window_days to 1 for Pinterest Tag conversion metrics. Pass other windows explicitly to match another report.
How far back can the Pinterest analytics API go?
Per Pinterest, outside hourly granularity you can pull data from up to 90 days before today in UTC, with a maximum range of 90 days. Hourly data reaches back 8 days.
Show 7 more questions
Why are my checkout values so large?
Pinterest returns metrics defined in micro-dollars in microunits of the advertiser profile currency, 1/1,000,000 of a unit. Divide TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR by 1,000,000.
Can I break results down by age, gender or placement?
Yes. The targeting analytics endpoint accepts targeting types such as AGE_BUCKET, GENDER, COUNTRY, PLACEMENT, KEYWORD and REGION, up to 15 per request.
Can Ryze AI build a Pinterest Ads dashboard?
Yes, as prompts rather than a saved layout. Ryze AI reads ad account analytics such as spend, paid impressions, clicks and checkouts by day, week or month. Pinterest is chat only in Ryze AI, so it does not appear on the Ads Performance dashboard.
Which Ryze AI tools read Pinterest data?
This page uses 2 of the 4 Pinterest Ads tools, both read tools: pinterest_ads__listAccounts and pinterest_ads__read. There is no dedicated report tool.
Can the agent change my account while I build a dashboard?
Only if you ask it to and the approval setting allows it. The Ryze AI chat starts on Skip all approvals, so say read only in the prompt, or switch Tool approvals to Approve write & delete.
Does Pinterest have its own MCP server?
Pinterest's developer docs overview did not mention one on November 16, 2026. Check Pinterest's docs for current details.
How much does Ryze AI cost for this?
Paid Ads is $89 a month with a 7-day free trial. Connecting the connector is free; the tools need an active plan or trial.

Related guides

Ryze AI: Pinterest Ads dashboard

7-day free trial, $89 a month flat

Start free trial