Thrad dashboard: metrics, API fields and an AI prompt

Thrad dashboard at a glance

4 panels, read top to bottom once a week.

The next section maps each metric to its field in the Thrad insights API.

The 6 Thrad dashboard metrics and their API fields

Thrad insights return 6 metrics. They answer 3 weekly questions: what did we spend, what did it deliver, and what did it cost.

Field names come from the Thrad Advertiser API insights reference. The same names are used to select, filter and sort, and there is no bare spend or ctr field.

4 things that trip up a first Thrad dashboard

• Micros. Money fields are integers where $1 is 1,000,000. Per Thrad, the *_micros value is the one to parse; the *_display string is for people and its format may change.
• Two supplies by default. Insights combine Thrad and ChatGPT (OpenAI Ads) supply. Set source to thrad or openai, or split rows with the source segment, to see them apart. The two sub-rows sum to the combined total.
• ChatGPT rows are daily only. Thrad says ChatGPT (OpenAI Ads) insights have no hourly buckets, and a combined hourly request reports Thrad supply only. Build the dashboard on daily rows.
• No conversion field. The insights fields listed in Thrad's docs stop at the 6 above. Thrad documents a browser tag and a server-to-server Conversions API for attribution, but conversions are not among the insights fields, so this template has no ROAS or CPA panel.

The Thrad dashboard template: 4 panels

Put the 6 metrics on 4 panels, ordered from the money to the creative.

These 3 requests follow the examples in Thrad's insights reference, with the dates changed. They were not run against a live account for this page, so test them with your own key first. Replace the date range and ids with yours.

Per Thrad, there are no separate list endpoints: ask for a deeper aggregation_level to find the ids of the campaigns, ad groups and ads under a scope.

Option 1: the Thrad Platform dashboard

Thrad runs its own web dashboard, the Thrad Platform, and it is where you create the API key the other two options use.

Per Thrad's advertiser docs, you sign in at the Thrad Platform, create an advertiser organization, and manage billing, campaigns and the key under Settings > API keys. Thrad's site describes a build, launch and optimize flow with results tracking in that dashboard. Its public pages do not list the reports, columns or export options of the Platform, so this page does not describe them. Check the screens in your own account.

Key management is for organization owners and admins, and there is one active key per organization. Thrad also publishes a separate publisher insights endpoint with revenue, impressions and fill rate for publishers. That is a different product from the advertiser insights this page covers.

Option 2: build your own with the Thrad insights API

The Thrad Advertiser API has 4 read-only insights endpoints, one for each level of the account, so a BI tool or a script can draw the template above.

Limits to know before you build

• Auth. A Bearer key that starts with ak_, one active key per organization. Rotating keeps the old key working for a short grace window.
• Rate limit. Thrad states 1,000 requests per hour per key.
• Rows. limit runs from 1 to 2000 and defaults to 20; paging uses the before and after cursors from first_id and last_id.
• Time. Buckets are hourly, daily (default), monthly or none. Each window spans at most 366 days, or 25 hours when hourly. Without time_ranges, Thrad uses a trailing 30 days. Timestamps are UTC.
• Segments. At most one per request. source works at every level. country and device work only at ad group or ad scope, on Thrad supply, with none or daily granularity.
• Filters and sort. Metric filters take GREATER_THAN or LESS_THAN with the value in the field's own unit, so spend_micros greater than 100000000 means over $100.

The API gives the most control and costs the most work: you host the dashboard, store the key and handle paging and refresh yourself.

Option 3: the prompt that reads it in Ryze AI

Ryze AI reads Thrad through 2 read tools, thrads__read and thrads__insights, so you ask for the panels in chat instead of calling the API.

Per the Ryze AI Thrad guide, you paste your Thrad API key into the Thrad card under Integrations and click Continue. The thrads__insights tool returns impressions, clicks, spend, CTR, CPC and CPM across Thrad and ChatGPT (OpenAI Ads) supply, and thrads__read reads the account, campaigns, ad groups, ads and assets. The Thrad MCP page lists all 5 Thrad tools. Open a new chat and paste:

What comes back is an answer in the chat with tables for each panel, built from the numbers Thrad returns. The Ryze AI help center lists Thrad as chat only, so it does not appear on the Ads Performance dashboard and cannot run Managed Campaigns.

The same report in Claude or ChatGPT

The Ryze AI connector exposes the same Thrad tools in Claude and ChatGPT over one URL, https://connector.get-ryze.ai/mcp. ChatGPT needs a plan that allows custom MCP connectors with write access; on Pro, OpenAI limits custom connectors to read and fetch, which is enough for a report. Connecting is free; the tools need an active Ryze AI plan or trial.

A weekly routine for the Thrad dashboard

Review the numbers once a week, on the same day, for the last 7 complete days against the 7 before.

Write each change in a note, and re-read the week before. Whether to pause or edit something is your call; the Ryze AI Thrad tools can activate and pause campaigns, ad groups and ads when you ask, so approve those changes on purpose.

Thrad Platform vs the insights API vs Ryze AI

The Thrad Platform suits a quick look, the API suits a fixed dashboard you host, and Ryze AI suits questions asked in chat.

Thrad's advertiser docs list no MCP server of their own, so this page compares only the 3 ways above. If you find one, check its auth and scope before connecting it to a live account.

Which Thrad dashboard to use

Match the option to how often the layout changes and who reads it.

For the other ad platforms, see the Google Ads dashboard page and how to build ad dashboards with Claude. For ChatGPT ads background, read the ChatGPT Ads API guide for developers and agencies.

Ryze AI's limits for this job: it is paid after the trial, it returns the 6 insights metrics and no conversions, Thrad does not appear on the Ads Performance dashboard, and its Thrad tools need an active plan or trial.

Sources

The verdict

A Thrad dashboard needs 6 metrics on 4 panels and a weekly review. The Thrad Platform covers a quick look, and the insights API covers a fixed dashboard you host and maintain.

Ryze AI reads the same 6 metrics from one prompt for $89 a month after a 7-day free trial, in chat or in Claude and ChatGPT. It has no conversion data for Thrad and no live dashboard page, so use it for questions rather than a screen on the wall.