TikTok Ads dashboard: metrics, template and AI prompts
Quick answer: A TikTok Ads dashboard needs 14 metrics on 5 panels: spend and results, efficiency, campaigns, creative engagement and TikTok Shop. Ryze AI is the best tool for pulling those numbers from several TikTok advertiser accounts with a prompt, with one caveat: its report tool covers auction campaigns only, so GMV Max (TikTok Shop) campaigns need a separate pull.
Below: the metrics with TikTok Marketing API names, a 5-panel template, the report request shape, Ryze AI prompts and a weekly routine.
Ryze AI · Paid Ads
TikTok Ads reports from a prompt
- 7-day free trial, $89 a month flat
Used by 2,000+ marketers
TikTok Ads dashboard at a glance
5 panels, read top to bottom once a week.
- 1Spend and resultsLast 7 days vs prior 7
Metrics: Spend, conversions, purchases, purchase ROAS
Question it answers: What did we spend and what came back?
- 2EfficiencyLast 7 days vs prior 7
Metrics: CTR, CPC, CPM, cost per conversion
Question it answers: Are views and clicks getting dearer?
- 3CampaignsLast 7 days vs prior 7
Metrics: The same metrics per campaign
Question it answers: Which campaign moved the total?
- 4Creative engagementLast 7 days
Metrics: Video plays, full views, engagements, engagement rate
Question it answers: Which videos hold attention?
- 5TikTok ShopLast 30 days
Metrics: GMV Max report, pulled separately
Question it answers: Are Shop campaigns missing from the totals?
| # | Panel | Range | Metrics | Question it answers |
|---|---|---|---|---|
| 1 | Spend and results | Last 7 days vs prior 7 | Spend, conversions, purchases, purchase ROAS | What did we spend and what came back? |
| 2 | Efficiency | Last 7 days vs prior 7 | CTR, CPC, CPM, cost per conversion | Are views and clicks getting dearer? |
| 3 | Campaigns | Last 7 days vs prior 7 | The same metrics per campaign | Which campaign moved the total? |
| 4 | Creative engagement | Last 7 days | Video plays, full views, engagements, engagement rate | Which videos hold attention? |
| 5 | TikTok Shop | Last 30 days | GMV Max report, pulled separately | Are Shop campaigns missing from the totals? |
The next section maps each metric to its API name.
The 14 TikTok Ads dashboard metrics and their API names
14 metrics answer 3 weekly questions: what did we spend, what did people do with the ad, and what came back.
Metric names let a request or an AI agent pull the exact field. They are taken from the metric lists in the specification files of TikTok's Business API SDK, where the Smart Plus material report and the reporting endpoints are described. TikTok's Marketing API portal is the reference for which metrics each report type accepts, and its pages did not load as text on the build day, so confirm a name there before you build on it. Definitions are plain-language readings of the names.
Spend
- Plain definition
- Amount spent in the period
- API name
- spend
- How to read it
- In the advertiser account currency
Impressions
- Plain definition
- Times your ads were shown
- API name
- impressions
- How to read it
- Delivery volume
Clicks
- Plain definition
- Clicks on your ads
- API name
- clicks
- How to read it
- Read with CTR, not alone
CTR
- Plain definition
- Clicks divided by impressions
- API name
- ctr
- How to read it
- Compare within one objective and creative style
CPC
- Plain definition
- Cost per click
- API name
- cpc
- How to read it
- Spend divided by clicks
CPM
- Plain definition
- Cost per 1,000 impressions
- API name
- cpm
- How to read it
- Auction cost; moves with audience and season
Conversions
- Plain definition
- Conversions from your pixel events
- API name
- conversion
- How to read it
- Needs the TikTok pixel or events set up
Cost per conversion
- Plain definition
- Spend divided by conversions
- API name
- cost_per_conversion
- How to read it
- The efficiency number to compare week to week
Purchases
- Plain definition
- Completed payments
- API name
- complete_payment
- How to read it
- Shop and web purchase events
Purchase ROAS
- Plain definition
- Return on ad spend from purchases
- API name
- complete_payment_roas
- How to read it
- Above 1 means tracked purchase value exceeds spend
Video plays
- Plain definition
- Times a video started playing
- API name
- video_play_actions
- How to read it
- Top of the attention funnel
Full video views
- Plain definition
- Times a video was watched to the end
- API name
- video_views_p100
- How to read it
- Compare with plays to see drop-off
Engagements
- Plain definition
- Likes, comments, shares and follows combined
- API name
- engagements
- How to read it
- TikTok lists likes, comments, shares and follows as separate metrics too
Engagement rate
- Plain definition
- Engagements relative to delivery
- API name
- engagement_rate
- How to read it
- Use it to compare creatives, not accounts
| Metric | Plain definition | API name | How to read it |
|---|---|---|---|
| Spend | Amount spent in the period | spend | In the advertiser account currency |
| Impressions | Times your ads were shown | impressions | Delivery volume |
| Clicks | Clicks on your ads | clicks | Read with CTR, not alone |
| CTR | Clicks divided by impressions | ctr | Compare within one objective and creative style |
| CPC | Cost per click | cpc | Spend divided by clicks |
| CPM | Cost per 1,000 impressions | cpm | Auction cost; moves with audience and season |
| Conversions | Conversions from your pixel events | conversion | Needs the TikTok pixel or events set up |
| Cost per conversion | Spend divided by conversions | cost_per_conversion | The efficiency number to compare week to week |
| Purchases | Completed payments | complete_payment | Shop and web purchase events |
| Purchase ROAS | Return on ad spend from purchases | complete_payment_roas | Above 1 means tracked purchase value exceeds spend |
| Video plays | Times a video started playing | video_play_actions | Top of the attention funnel |
| Full video views | Times a video was watched to the end | video_views_p100 | Compare with plays to see drop-off |
| Engagements | Likes, comments, shares and follows combined | engagements | TikTok lists likes, comments, shares and follows as separate metrics too |
| Engagement rate | Engagements relative to delivery | engagement_rate | Use it to compare creatives, not accounts |
3 things that trip up a first TikTok dashboard
- Auction and GMV Max are separate reports. Per TikTok's SDK specification, the integrated report is for the AUCTION service type, and GMV Max campaigns have their own report endpoint that needs a store id. Totals for a TikTok Shop advertiser that skip it are incomplete.
- Conversion metrics depend on set-up. Conversions and purchases only fill when the pixel or events are connected to the ad group. A zero can mean not tracked, so check the pixel before you judge a campaign.
- One currency and one window. Spend comes back in the advertiser account currency. Pick one date range and compare it with the equal range before it, in every panel.
Reports can be run at advertiser, campaign, ad group or ad level, and the SDK specification shows the report type values AUDIENCE, BASIC, BC, CATALOG, PLAYABLE_MATERIAL and TT_SHOP. A BASIC report returns the performance numbers above; AUDIENCE reports hold the age, gender and country breakdowns.
The TikTok Ads dashboard template: 5 panels
Put the 14 metrics on 5 panels, ordered from the money to the creative to the Shop.
1. Spend and results
- Tiles or chart
- Tiles: spend, conversions, purchases, purchase ROAS; 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, cost per conversion
- Date range
- Last 7 days
- Compare with
- The 7 days before
3. Campaigns
- Tiles or chart
- Table, highest spend first, with spend, CTR, CPC, cost per conversion
- Date range
- Last 7 days
- Compare with
- The 7 days before
4. Creative engagement
- Tiles or chart
- Table per ad: video plays, full views, engagements, engagement rate
- Date range
- Last 7 days
- Compare with
- Ads in the same campaign
5. TikTok Shop
- Tiles or chart
- GMV Max report for each store, next to the auction totals
- Date range
- Last 30 days
- Compare with
- The 30 days before
| Panel | Tiles or chart | Date range | Compare with |
|---|---|---|---|
| 1. Spend and results | Tiles: spend, conversions, purchases, purchase ROAS; daily line of spend | Last 7 days, 30-day line | The 7 days before |
| 2. Efficiency | Tiles: CTR, CPC, CPM, cost per conversion | Last 7 days | The 7 days before |
| 3. Campaigns | Table, highest spend first, with spend, CTR, CPC, cost per conversion | Last 7 days | The 7 days before |
| 4. Creative engagement | Table per ad: video plays, full views, engagements, engagement rate | Last 7 days | Ads in the same campaign |
| 5. TikTok Shop | GMV Max report for each store, next to the auction totals | Last 30 days | The 30 days before |
Read panel 1 first. If cost per conversion rose, panel 2 shows whether CPM or CTR moved, panel 3 names the campaign, panel 4 points at the creative, and panel 5 shows whether Shop spend is outside the totals.
These shapes use the endpoint paths and parameter names in TikTok's SDK specification: report_type, data_level, dimensions, metrics, start_date, end_date, query_lifetime, order_field, order_type and filtering, with page_size between 1 and 1000. The specification does not list every allowed dimension and metric per level, so TikTok's portal is the place to check a combination. The GMV Max request needs store_ids, dimensions and metrics, and its dimension and metric values are left blank here for that reason.
Option 1: the Marketing API and the SDKs
TikTok exposes reporting through its Marketing API, with official Python, Java and JavaScript SDKs. It gives you the raw numbers and leaves the layout to you.
TikTok's Business API SDK repository describes itself as an SDK to integrate with the TikTok Business API, with Java, Python and JavaScript clients. Its reporting client lists a synchronous report, asynchronous report tasks (create, check and cancel), the GMV Max report and 2 Smart Plus material reports.
- Create an app and get an access token for the advertiser accounts, as TikTok's authentication docs describe.
- Call the synchronous report for panels 1 to 4, one request per data level.
- Use the report task endpoints when a range is too large for a synchronous call.
- Call the GMV Max report for each store for panel 5.
- Write the rows to a sheet or a BI tool and chart them with the template above.
Strength: every number comes straight from TikTok and you control the storage. Limits: you build and host the layout, handle the token and run one request per level. I could not open TikTok's Ads Manager reporting help pages on the build day, so this page does not describe its built-in reports; check them before you decide.
Option 2: the prompts that pull it through Ryze AI
Ryze AI runs TikTok integrated reports with spend, impressions, clicks, CTR, CPC, CPM, conversions and purchase ROAS by advertiser, campaign, ad group or ad and by day, so each panel is one prompt.
Connect TikTok Ads under Integrations with your TikTok for Business login and approve every permission. Per the Ryze AI TikTok Ads guide, Ryze AI then sees every advertiser account that login can reach; there is no ad account to pick. Then open a new chat and paste a prompt.
Behind these prompts sit 3 read tools: tiktok_ads__listAccounts lists the advertiser accounts the login can reach, tiktok_ads__report runs the integrated report, and tiktok_ads__read reads any Marketing API resource, including pixels, Business Center data and GMV Max reports. The same connection also has tiktok_ads__write and tiktok_ads__delete, 5 tools in all.
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 TikTok 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. Deleting a campaign, ad group or ad through the delete tool is irreversible, 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 results
- What to check
- Spend vs plan; purchase ROAS 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 cost per conversion direction
- Action if off
- High CPM: audience or season. Low CTR: the first seconds of the video
3
- Panel
- Campaigns
- What to check
- The campaign with the largest change
- Action if off
- Review budget and targeting of that campaign
4
- Panel
- Creative engagement
- What to check
- Full views vs plays on the top-spend ads
- Action if off
- Retire or rework ads with high plays and few full views
5
- Panel
- TikTok Shop
- What to check
- GMV Max results next to auction totals
- Action if off
- Add the GMV Max pull to every report that includes a Shop account
| Step | Panel | What to check | Action if off |
|---|---|---|---|
| 1 | Spend and results | Spend vs plan; purchase ROAS vs prior 7 days | Open panels 2 and 3 to find the cause |
| 2 | Efficiency | CPM, CTR and cost per conversion direction | High CPM: audience or season. Low CTR: the first seconds of the video |
| 3 | Campaigns | The campaign with the largest change | Review budget and targeting of that campaign |
| 4 | Creative engagement | Full views vs plays on the top-spend ads | Retire or rework ads with high plays and few full views |
| 5 | TikTok Shop | GMV Max results next to auction totals | Add the GMV Max pull to every report that includes a Shop account |
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.
TikTok Marketing API vs Ryze AI for a TikTok Ads dashboard
The Marketing API gives you the data and a build job. Ryze AI gives you answers to new questions across advertiser accounts.
Price
- TikTok Marketing API and SDKs
- No API fee is stated in the docs opened for this page
- Ryze AI
- Paid Ads $89/mo, 7-day free trial
Set-up
- TikTok Marketing API and SDKs
- App, access token and code for each request
- Ryze AI
- Sign in with your TikTok for Business login; no keys to copy
Accounts
- TikTok Marketing API and SDKs
- One advertiser_id per request, or advertiser_ids where the endpoint allows
- Ryze AI
- Every advertiser account the login reaches, with Agent default accounts to pick the first ones
Auction reports
- TikTok Marketing API and SDKs
- Integrated report, sync or async
- Ryze AI
- tiktok_ads__report by advertiser, campaign, ad group or ad
GMV Max reports
- TikTok Marketing API and SDKs
- Separate GMV Max report endpoint with store ids
- Ryze AI
- Through the read tool, separately from the report tool
Saved fixed layout
- TikTok Marketing API and SDKs
- Whatever you build
- Ryze AI
- Prompts in chat; no layout is saved by this method
Acting on findings
- TikTok Marketing API and SDKs
- Campaign, ad group and ad endpoints in the same API
- Ryze AI
- Write and delete tools, under your Tool approvals setting
| Question | TikTok Marketing API and SDKs | Ryze AI |
|---|---|---|
| Price | No API fee is stated in the docs opened for this page | Paid Ads $89/mo, 7-day free trial |
| Set-up | App, access token and code for each request | Sign in with your TikTok for Business login; no keys to copy |
| Accounts | One advertiser_id per request, or advertiser_ids where the endpoint allows | Every advertiser account the login reaches, with Agent default accounts to pick the first ones |
| Auction reports | Integrated report, sync or async | tiktok_ads__report by advertiser, campaign, ad group or ad |
| GMV Max reports | Separate GMV Max report endpoint with store ids | Through the read tool, separately from the report tool |
| Saved fixed layout | Whatever you build | Prompts in chat; no layout is saved by this method |
| Acting on findings | Campaign, ad group and ad endpoints in the same API | Write and delete tools, under your Tool approvals setting |
TikTok's developer blog page opened on the build day did not mention a TikTok-run MCP server, so none is listed here as a way to pull reports. Ryze AI's write-up of the May 2026 announcement is in TikTok Ads MCP: the official server and how to connect. The Ryze AI connector at https://connector.get-ryze.ai/mcp also covers the other platforms Ryze AI connects.
Which TikTok Ads dashboard to use
Pick by whether you want a stored dataset or fast answers, and by how many advertiser accounts you read.
Own database or a custom chart
- Use
- The Marketing API or an SDK, with the metric names above
Several advertiser accounts or changing questions
- Use
- Ryze AI prompts
A TikTok Shop account
- Use
- Add the GMV Max report to whichever method you pick
Acting on what the numbers show
- Use
- Ryze AI write tool, with approvals switched on
| Situation | Use |
|---|---|
| Own database or a custom chart | The Marketing API or an SDK, with the metric names above |
| Several advertiser accounts or changing questions | Ryze AI prompts |
| A TikTok Shop account | Add the GMV Max report to whichever method you pick |
| Acting on what the numbers show | Ryze AI write tool, with approvals switched on |
You can use both: keep a pipeline for fixed numbers and ask Ryze AI for the why. Other platforms follow the same template in the Meta Ads dashboard and Pinterest Ads dashboard pages.
Sources
- TikTok Business API SDK (GitHub)Reporting endpoints, parameters, report types, page_size limit, metric names in the yml_files specs. Opened Nov 18, 2026.
- TikTok API for Business portalReference for integrated report metrics, dimensions and rate limits. Opened Nov 18, 2026; the page text was minimal.
- TikTok for Business blogChecked for a TikTok-run MCP server and Ads Manager reporting updates. Opened Nov 18, 2026.
- Ryze AI TikTok Ads guideConnection, access and tools.
The verdict
A TikTok Ads dashboard is 14 metrics on 5 panels read in the same order each week, with GMV Max pulled separately for Shop accounts. Build the stored version on the Marketing API if you need your own dataset.
Use Ryze AI when you read several advertiser accounts or want to ask new questions of the same data. Connect TikTok Ads, paste the prompts above and keep them read only.
Frequently asked questions
What should a TikTok Ads dashboard include?
Which API endpoint returns TikTok Ads report data?
What is the page size limit on the TikTok integrated report?
Why do my TikTok Shop numbers look too low?
Show 7 more questionsShow fewer questions
Why are conversions zero in my TikTok report?
Can Ryze AI build a TikTok Ads dashboard?
Which Ryze AI tools read TikTok data?
Can I use several TikTok accounts in one chat?
Can the agent change my account while I build a dashboard?
Does TikTok have its own MCP server?
How much does Ryze AI cost for this?
Related guides
TikTok Ads MCP server
The Ryze AI connector's TikTok Ads tools, setup and example prompts.
Meta Ads dashboard
14 Meta Ads metrics with Insights API field names and a 5-panel template.
Pinterest Ads dashboard
14 Pinterest Ads metrics with API v5 column names and a 5-panel template.
Google Ads dashboard
14 Google Ads metrics with API field names and a 5-panel template.





