Ira Bodnar··Updated ·10 min read

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

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

TikTok Ads dashboard at a glance

5 panels, read top to bottom once a week.

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

  2. 2EfficiencyLast 7 days vs prior 7

    Metrics: CTR, CPC, CPM, cost per conversion

    Question it answers: Are views and clicks getting dearer?

  3. 3CampaignsLast 7 days vs prior 7

    Metrics: The same metrics per campaign

    Question it answers: Which campaign moved the total?

  4. 4Creative engagementLast 7 days

    Metrics: Video plays, full views, engagements, engagement rate

    Question it answers: Which videos hold attention?

  5. 5TikTok ShopLast 30 days

    Metrics: GMV Max report, pulled separately

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

  1. Spend

    Plain definition
    Amount spent in the period
    API name
    spend
    How to read it
    In the advertiser account currency
  2. Impressions

    Plain definition
    Times your ads were shown
    API name
    impressions
    How to read it
    Delivery volume
  3. Clicks

    Plain definition
    Clicks on your ads
    API name
    clicks
    How to read it
    Read with CTR, not alone
  4. CTR

    Plain definition
    Clicks divided by impressions
    API name
    ctr
    How to read it
    Compare within one objective and creative style
  5. CPC

    Plain definition
    Cost per click
    API name
    cpc
    How to read it
    Spend divided by clicks
  6. CPM

    Plain definition
    Cost per 1,000 impressions
    API name
    cpm
    How to read it
    Auction cost; moves with audience and season
  7. Conversions

    Plain definition
    Conversions from your pixel events
    API name
    conversion
    How to read it
    Needs the TikTok pixel or events set up
  8. 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
  9. Purchases

    Plain definition
    Completed payments
    API name
    complete_payment
    How to read it
    Shop and web purchase events
  10. 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
  11. Video plays

    Plain definition
    Times a video started playing
    API name
    video_play_actions
    How to read it
    Top of the attention funnel
  12. 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
  13. 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
  14. Engagement rate

    Plain definition
    Engagements relative to delivery
    API name
    engagement_rate
    How to read it
    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. 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. 2. Efficiency

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

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.

Report request shape: panels 1 to 3
GET https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/ ?advertiser_id=<ADVERTISER_ID> &report_type=BASIC &data_level=<CAMPAIGN | ADGROUP | AD | ADVERTISER> &dimensions=["campaign_id","stat_time_day"] &metrics=["spend","impressions","clicks","ctr","cpc","cpm","conversion","cost_per_conversion"] &start_date=<YYYY-MM-DD> &end_date=<YYYY-MM-DD> &page_size=1000 Header: Access-Token: <ACCESS_TOKEN>
Report request shape: panel 5, GMV Max
GET https://business-api.tiktok.com/open_api/v1.3/gmv_max/report/get/ ?advertiser_id=<ADVERTISER_ID> &store_ids=["<STORE_ID>"] &dimensions=[...] &metrics=[...] &start_date=<YYYY-MM-DD> &end_date=<YYYY-MM-DD>

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.

  1. Create an app and get an access token for the advertiser accounts, as TikTok's authentication docs describe.
  2. Call the synchronous report for panels 1 to 4, one request per data level.
  3. Use the report task endpoints when a range is too large for a synchronous call.
  4. Call the GMV Max report for each store for panel 5.
  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.

Prompt: panels 1 to 3 in the Ryze AI chat
For the TikTok advertiser account [account name], read only: change nothing. 1. Spend, conversions and purchase ROAS for the last 7 days vs the 7 before. 2. CTR, CPC, CPM and cost per conversion for the same two periods. 3. A campaign table, highest spend first, with the same metrics. Use the account currency. Flag any metric that moved more than [20]% week over week.
Prompt: panels 4 and 5, creatives and Shop
For [account name], list the [10] ads with the most spend in the last 7 days with their spend, clicks and CTR, and show images of the running ads next to those numbers. Then pull the GMV Max report for the last 30 days with the read tool, since the report tool covers auction campaigns only, and tell me how it changes the totals. Read only.

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

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 TikTok advertiser account [account name], summarize last week, Monday to Sunday, vs the week before: spend, CTR, CPC and purchase ROAS for the account and the top [5] campaigns. Add the GMV Max report for the same week if the account has a TikTok Shop. 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.

  1. 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
  2. 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
  3. 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
  4. Auction reports

    TikTok Marketing API and SDKs
    Integrated report, sync or async
    Ryze AI
    tiktok_ads__report by advertiser, campaign, ad group or ad
  5. 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
  6. Saved fixed layout

    TikTok Marketing API and SDKs
    Whatever you build
    Ryze AI
    Prompts in chat; no layout is saved by this method
  7. 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

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.

  1. Own database or a custom chart

    Use
    The Marketing API or an SDK, with the metric names above
  2. Several advertiser accounts or changing questions

    Use
    Ryze AI prompts
  3. A TikTok Shop account

    Use
    Add the GMV Max report to whichever method you pick
  4. Acting on what the numbers show

    Use
    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

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?
14 metrics on 5 panels: spend and results, efficiency, campaigns, creative engagement and TikTok Shop. Core metric names are spend, impressions, clicks, ctr, cpc, cpm, conversion, cost_per_conversion and complete_payment_roas. Compare the last 7 days with the 7 before.
Which API endpoint returns TikTok Ads report data?
The synchronous integrated report at /open_api/v1.3/report/integrated/get/. TikTok's SDK also lists asynchronous report tasks (create, check, cancel) and a separate GMV Max report endpoint.
What is the page size limit on the TikTok integrated report?
Per TikTok's SDK specification, page_size runs from 1 to 1000. Use page and page_size to walk through large result sets.
Why do my TikTok Shop numbers look too low?
GMV Max campaigns are not in the auction integrated report. They have their own report endpoint that needs store ids, and in Ryze AI the report tool covers auction campaigns only, so GMV Max is pulled with the read tool.
Show 7 more questions
Why are conversions zero in my TikTok report?
Conversion metrics need the TikTok pixel or events connected to the ad group. A zero can mean not tracked, so check the pixel before judging a campaign.
Can Ryze AI build a TikTok Ads dashboard?
Yes, as prompts rather than a saved layout. Ryze AI runs integrated reports with spend, impressions, clicks, CTR, CPC, CPM, conversions and purchase ROAS by advertiser, campaign, ad group or ad and by day.
Which Ryze AI tools read TikTok data?
This page uses 3 of the 5 TikTok Ads tools, all read tools: tiktok_ads__listAccounts, tiktok_ads__report and tiktok_ads__read. The other 2 are tiktok_ads__write and tiktok_ads__delete.
Can I use several TikTok accounts in one chat?
Yes. Several TikTok logins can be connected to one Ryze AI workspace under View > Add one more account. Agent default accounts sets which advertiser accounts the agent works with first, and you can name any other account in chat.
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. Deletions are irreversible.
Does TikTok have its own MCP server?
TikTok's developer blog page opened on November 18, 2026 did not mention one. Ryze AI's blog covers an announcement from May 2026; check TikTok'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: TikTok Ads dashboard

7-day free trial, $89 a month flat

Start free trial