Any MCP-compatible appRead live data
- Spend, impressions, clicks and conversions
- Video views and completion rates
- Campaign, ad group and ad breakdowns
- Creative-level engagement
Connect once, use it two ways
Connect TikTok Ads to Jepto once. What you build in Jepto and what you ask in Claude or ChatGPT read the same data, so the numbers match wherever you look.
Add the Jepto MCP server and ask about TikTok Ads in plain English, across all your brands. Included on every plan.
and any MCP-compatible appJepto runs a hosted TikTok Ads MCP server at mcp.jepto.com. Connect it once and Claude, ChatGPT, Cursor or any MCP-compatible app can query 258 TikTok Ads fields across every account you manage, next to your other channels. There's nothing to install and no TikTok developer app to set up. It reads your TikTok Ads data and never changes it.
Paste the URL into your AI assistant, or find Jepto in Claude's connector directory or ChatGPT's Plugins page. Sign in to Jepto once and every conversation can use your live TikTok Ads data.
Works with
OAuth sign-in. Each person sees only the brands their Jepto login can.
Your assistant shows a preview. Nothing saves until you confirm.
Nothing. The Jepto MCP reads your TikTok Ads data and never changes it.
Paste one into Claude or ChatGPT once Jepto is connected. Swap [brand] for one of yours.
“Which TikTok ads had the highest video completion rate last month, and what did they cost per conversion?”
“Show [brand]'s spend, video views and conversions by campaign for the last 30 days.”
“Which ad groups drove conversions at the lowest cost this week?”
“Compare TikTok cost per conversion with Meta for the same period.”
“Show daily TikTok spend this month against the same days last month.”
“Create a $2,000 monthly TikTok budget for [brand] and alert me if it's pacing over.”
TikTok's own server can change campaigns, and Jepto can't. Jepto is for comparing TikTok with Meta, Google and the rest, across every brand you manage.
| Compared on | Jepto MCP | TikTok's official Ads MCP | Community servers |
|---|---|---|---|
| Setup | Hosted. Paste one URL, or pick Jepto in the Claude or ChatGPT directory, then sign in. | Authorised through TikTok for Business. Availability varies by account. | You install, host and update it, and supply your own API credentials. |
| Accounts | Every TikTok Ads account you've connected, across all your brands, in one connection. | Ad accounts your TikTok login can reach. | Usually one login or token at a time. |
| Other channels | Ask across TikTok Ads and every other connected source in the same question. | TikTok only. | One platform per server. You combine servers yourself. |
| Brand context | Reads each brand's details and knowledgebase, so answers reflect what the business sells and what it's aiming for. | None. | None. |
| Field guidance | Ships a query guide the AI reads first, so it picks the right TikTok Ads fields and says what isn't available. | TikTok's own tools. | Raw API fields. The AI works out what they mean. |
| Changes | Read-only in TikTok Ads. Budgets and KPI targets in Jepto can be set from chat, with a confirm step. | Read and write. | Varies. Some write to your account with no confirm step. |
| Cost | Included on every Jepto plan, with no usage limits. | Free. | Free code. Your time to run and maintain it. |
Every TikTok Ads metric and dimension in the Jepto data model, with its definition. Each one works the same way in Reports, Data Chat and the Jepto MCP.
| How you connect | Sign in with TikTok. You need access to the TikTok ad accounts. |
| Levels | Advertiser, campaign, ad group, ad, age, gender, country, placement |
| Use it in | Reports, Data Chat, KPI forecasting, budget tracking, anomaly alerts and the Jepto MCP |
| AI assistants | Claude, ChatGPT, Cursor and any MCP client, at https://mcp.jepto.com |
| Changes from chat | None. The MCP reads your data and never changes it |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
ImpressionstiktokAds.impressions | Number of times your ads were shown. | Metric | number | Sum | — |
ClickstiktokAds.clicks | Number of clicks to your destination URL (landing page) from your ads. | Metric | number | Sum | — |
ReachtiktokAds.reach | Number of unique users who saw your ads at least once. | Metric | number | Maximum | — |
Total landing page viewstiktokAds.totalLandingPageView | Total number of landing page views attributed to your ads. | Metric | number | Sum | — |
Gross impressionstiktokAds.grossImpressions | Total gross impressions including duplicate counts. | Metric | number | Sum | — |
FrequencytiktokAds.frequency | Average number of times each person saw your ad. | Metric | number | Average | — |
Paid engaged views (6s)tiktokAds.paidEngagedView | Number of paid 6-second engaged views on your video ad. | Metric | number | Sum | — |
Paid engaged views (15s)tiktokAds.paidEngagedView15s | Number of paid 15-second engaged views on your video ad. | Metric | number | Sum | — |
Music disc clickstiktokAds.clicksOnMusicDisc | Number of clicks on the music disc in your ad. | Metric | number | Sum | — |
Duet clickstiktokAds.duetClicks | Number of clicks on the Duet button in your ad. | Metric | number | Sum | — |
Stitch clickstiktokAds.stitchClicks | Number of clicks on the Stitch button in your ad. | Metric | number | Sum | — |
Sound usage clickstiktokAds.soundUsageClicks | Number of clicks on the Use Sound option in your ad. | Metric | number | Sum | — |
Anchor clickstiktokAds.anchorClicks | Number of clicks on an anchor link in your ad. | Metric | number | Sum | — |
Hashtag challenge clickstiktokAds.clicksOnHashtagChallenge | Number of clicks on the hashtag challenge in your ad. | Metric | number | Sum | — |
Playlist visitstiktokAds.ttPlaylistVisit | Number of visits to a TikTok playlist from your ad. | Metric | number | Sum | — |
Complete paymentstiktokAds.completePayment | Number of complete payment events attributed to your ads. | Metric | number | Sum | — |
Total page viewstiktokAds.totalPageview | Total number of page views on your landing page attributed to your ads. | Metric | number | Sum | — |
Button clickstiktokAds.buttonClick | Number of button clicks on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) Add to carttiktokAds.webEventAddToCart | Web event measured on your landing page after an ad click. | Metric | number | Sum | — |
Initiate checkouttiktokAds.initiateCheckout | Number of checkout initiations on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) SearchtiktokAds.pageEventSearch | Number of search events on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) OrdertiktokAds.onWebOrder | Web event measured on your landing page after an ad click. | Metric | number | Sum | — |
Add billingtiktokAds.addBilling | Number of payment info additions attributed to your ads. | Metric | number | Sum | — |
(Page) Add to wishlisttiktokAds.onWebAddToWishlist | Number of add-to-wishlist events on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) Add to wishlist per clicktiktokAds.onWebAddToWishlistPerClick | Wishlist add events per click on your landing page. | Metric | number | Sum | — |
(Page) SubscribetiktokAds.onWebSubscribe | Number of subscription events on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) Subscribe per clicktiktokAds.onWebSubscribePerClick | Subscription events per click on your landing page. | Metric | number | Sum | — |
Form submissionstiktokAds.form | Number of form submissions attributed to your ads. | Metric | number | Sum | — |
Download startstiktokAds.downloadStart | Number of download starts attributed to your ads. | Metric | number | Sum | — |
(Page) Custom eventstiktokAds.customPageEvents | Number of custom events on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) Browse viewstiktokAds.pageBrowseView | Number of browse events on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) Online consultstiktokAds.onlineConsult | Number of online consult events on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) Content viewstiktokAds.pageContentViewEvents | Number of content view events on your landing page attributed to your ads. | Metric | number | Sum | — |
(Page) Product detail viewstiktokAds.productDetailsPageBrowse | Number of product detail page views attributed to your ads. | Metric | number | Sum | — |
Real-time app installstiktokAds.realTimeAppInstall | App installs tracked in real time during the reporting period. | Metric | number | Sum | — |
Total add to cart (App)tiktokAds.totalAppEventAddToCart | Total number of add-to-cart events in your app attributed to your ads. | Metric | number | Sum | — |
Checkouts (App)tiktokAds.checkout | Number of checkout events in your app attributed to your ads. | Metric | number | Sum | — |
Total checkouts (App)tiktokAds.totalCheckout | Total number of checkout events in your app attributed to your ads. | Metric | number | Sum | — |
Content views (App)tiktokAds.viewContent | Number of content view events in your app attributed to your ads. | Metric | number | Sum | — |
Total content views (App)tiktokAds.totalViewContent | Total number of content view events in your app attributed to your ads. | Metric | number | Sum | — |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
SpendtiktokAds.spend | Total amount spent on ads during the reporting period in TikTok Ads Manager. | Metric | number | Sum | Currency |
CPCtiktokAds.cpc | Average cost per click (spend divided by clicks). Shown in account currency. | Metric | number | Average | Currency |
CPMtiktokAds.cpm | Average cost per 1,000 impressions. Shown in account currency. | Metric | number | Average | Currency |
Cost per 1,000 people reachedtiktokAds.costPer1000Reached | Average cost to reach 1,000 unique people (CPM-style reach efficiency). | Metric | number | Average | Currency |
Cost per complete paymenttiktokAds.costPerCompletePayment | Average spend per complete payment: spend ÷ complete payments. | Metric | number | Average | Currency |
Value per complete paymenttiktokAds.valuePerCompletePayment | Average value per complete payment event. | Metric | number | Average | Currency |
Cost per landing page viewtiktokAds.costPerLandingPageView | Average spend per landing page view: spend ÷ landing page views. | Metric | number | Average | Currency |
Cost per page viewtiktokAds.costPerPageview | Average spend per page view: spend ÷ page views. | Metric | number | Average | Currency |
Avg value per page viewtiktokAds.avgValuePerPageview | Average revenue per page view on your landing page. | Metric | number | Average | Currency |
Total value per page viewtiktokAds.totalValuePerPageview | Total revenue attributed to page views on your landing page. | Metric | number | Average | Currency |
Cost per button clicktiktokAds.costPerButtonClick | Average spend per button click: spend ÷ button clicks. | Metric | number | Average | Currency |
Value per button clicktiktokAds.valuePerButtonClick | Average value per button click on your landing page. | Metric | number | Average | Currency |
Total button click valuetiktokAds.totalButtonClickValue | Total value attributed to button click events on your landing page. | Metric | number | Sum | Currency |
Cost per add to cart (Page)tiktokAds.costPerWebEventAddToCart | Average spend per add-to-cart event on your landing page: spend ÷ add to carts. | Metric | number | Average | Currency |
Value per add to cart (Page)tiktokAds.valuePerWebEventAddToCart | Average value per add-to-cart event on your landing page. | Metric | number | Average | Currency |
Total add to cart value (Page)tiktokAds.totalWebEventAddToCartValue | Total revenue attributed to add-to-cart events on your landing page. | Metric | number | Sum | Currency |
Cost per initiate checkouttiktokAds.costPerInitiateCheckout | Average spend per checkout initiation: spend ÷ initiate checkouts. | Metric | number | Average | Currency |
Value per initiate checkouttiktokAds.valuePerInitiateCheckout | Average value per checkout initiation on your landing page. | Metric | number | Average | Currency |
Total initiate checkout valuetiktokAds.totalInitiateCheckoutValue | Total revenue attributed to checkout initiations on your landing page. | Metric | number | Sum | Currency |
Cost per search (Page)tiktokAds.costPerPageEventSearch | Average spend per search event on your landing page: spend ÷ searches. | Metric | number | Average | Currency |
Value per search (Page)tiktokAds.valuePerPageEventSearch | Average value per search event on your landing page. | Metric | number | Average | Currency |
Total search value (Page)tiktokAds.totalPageEventSearchValue | Total revenue attributed to search events on your landing page. | Metric | number | Sum | Currency |
Cost per order (Page)tiktokAds.costPerOnWebOrder | Average spend per order on your landing page: spend ÷ orders. | Metric | number | Average | Currency |
Value per order (Page)tiktokAds.valuePerOnWebOrder | Average value per order on your landing page. | Metric | number | Average | Currency |
Total order value (Page)tiktokAds.totalOnWebOrderValue | Total revenue attributed to orders on your landing page. | Metric | number | Sum | Currency |
Cost per add billingtiktokAds.costPerAddBilling | Average spend per payment info addition: spend ÷ add billing events. | Metric | number | Average | Currency |
Value per add billingtiktokAds.valuePerAddBilling | Average value per payment info addition. | Metric | number | Average | Currency |
Total add billing valuetiktokAds.totalAddBillingValue | Total value attributed to payment info addition events. | Metric | number | Sum | Currency |
Cost per add to wishlist (Page)tiktokAds.costPerOnWebAddToWishlist | Average spend per add-to-wishlist event on your landing page: spend ÷ wishlist adds. | Metric | number | Average | Currency |
Value per add to wishlist (Page)tiktokAds.valuePerOnWebAddToWishlist | Average value per add-to-wishlist event on your landing page. | Metric | number | Average | Currency |
Total add to wishlist value (Page)tiktokAds.totalOnWebAddToWishlistValue | Total revenue attributed to add-to-wishlist events on your landing page. | Metric | number | Sum | Currency |
Cost per subscribe (Page)tiktokAds.costPerOnWebSubscribe | Average spend per subscription event on your landing page: spend ÷ subscribes. | Metric | number | Average | Currency |
Value per subscribe (Page)tiktokAds.valuePerOnWebSubscribe | Average value per subscription event on your landing page. | Metric | number | Average | Currency |
Total subscribe value (Page)tiktokAds.totalOnWebSubscribeValue | Total revenue attributed to subscription events on your landing page. | Metric | number | Sum | Currency |
Cost per formtiktokAds.costPerForm | Average spend for each form submission: spend ÷ form submissions. | Metric | number | Average | Currency |
Value per formtiktokAds.valuePerForm | Average value per form submission. | Metric | number | Average | Currency |
Total form valuetiktokAds.totalFormValue | Total value attributed to form submissions. | Metric | number | Sum | Currency |
Cost per download starttiktokAds.costPerDownloadStart | Average spend per download start: spend ÷ download starts. | Metric | number | Average | Currency |
Value per download starttiktokAds.valuePerDownloadStart | Average value per download start. | Metric | number | Average | Currency |
Total download start valuetiktokAds.totalDownloadStartValue | Total value attributed to download start events. | Metric | number | Sum | Currency |
Cost per custom event (Page)tiktokAds.costPerCustomPageEvent | Average spend per custom event on your landing page: spend ÷ custom events. | Metric | number | Average | Currency |
Value per custom event (Page)tiktokAds.valuePerCustomPageEvent | Average value per custom event on your landing page. | Metric | number | Average | Currency |
Total custom event value (Page)tiktokAds.customPageEventsValue | Total value attributed to custom events on your landing page. | Metric | number | Sum | Currency |
Cost per browse view (Page)tiktokAds.costPerPageBrowseView | Average spend per browse event on your landing page: spend ÷ browse views. | Metric | number | Average | Currency |
Total browse view value (Page)tiktokAds.totalPageBrowseViewValue | Total value attributed to browse events on your landing page. | Metric | number | Sum | Currency |
Value per browse view (Page)tiktokAds.valuePerPageBrowseView | Average value per browse event on your landing page. | Metric | number | Average | Currency |
Cost per online consult (Page)tiktokAds.costPerOnlineConsult | Average spend per online consult event: spend ÷ online consults. | Metric | number | Average | Currency |
Value per online consult (Page)tiktokAds.valuePerOnlineConsult | Average value per online consult event on your landing page. | Metric | number | Average | Currency |
Total online consult value (Page)tiktokAds.totalOnlineConsultValue | Total value attributed to online consult events on your landing page. | Metric | number | Sum | Currency |
Cost per content view (Page)tiktokAds.costPerPageContentViewEvent | Average spend per content view event on your landing page: spend ÷ content views. | Metric | number | Average | Currency |
Value per content view (Page)tiktokAds.valuePerPageContentViewEvent | Average value per content view event on your landing page. | Metric | number | Average | Currency |
Total content view value (Page)tiktokAds.totalPageViewContentEventsValue | Total value attributed to content view events on your landing page. | Metric | number | Sum | Currency |
Cost per product detail view (Page)tiktokAds.costPerProductDetailsPageBrowse | Average spend per product detail page view: spend ÷ product detail views. | Metric | number | Average | Currency |
Value per product detail view (Page)tiktokAds.valuePerProductDetailsPageBrowse | Average value per product detail page view. | Metric | number | Average | Currency |
Total product detail view value (Page)tiktokAds.totalProductDetailsPageBrowseValue | Total value attributed to product detail page views. | Metric | number | Sum | Currency |
Billed costtiktokAds.billedCost | Total amount billed to your account during the reporting period. | Metric | number | Sum | Currency |
Cash spendtiktokAds.cashSpend | Amount of spend charged against your cash balance. | Metric | number | Sum | Currency |
Voucher spendtiktokAds.voucherSpend | Amount of spend charged against your voucher balance. | Metric | number | Sum | Currency |
Real-time app install costtiktokAds.realTimeAppInstallCost | Real-time cost per app install: spend ÷ real-time app installs. | Metric | number | Sum | Currency |
Cost per app installtiktokAds.costPerAppInstall | Average spend per app install: spend ÷ app installs. | Metric | number | Average | Currency |
Cost per add to cart (App)tiktokAds.costPerAppEventAddToCart | Average spend per add-to-cart event in your app: spend ÷ add to carts. | Metric | number | Average | Currency |
Cost per total add to cart (App)tiktokAds.costPerTotalAppEventAddToCart | Average spend per total add-to-cart in your app: spend ÷ total add to carts. | Metric | number | Average | Currency |
Value per add to cart (App)tiktokAds.valuePerTotalAppEventAddToCart | Average value per add-to-cart event in your app. | Metric | number | Average | Currency |
Total add to cart value (App)tiktokAds.totalAppEventAddToCartValue | Total revenue attributed to add-to-cart events in your app. | Metric | number | Sum | Currency |
Cost per checkouttiktokAds.costPerCheckout | Average spend for each checkout event: spend ÷ checkouts. | Metric | number | Average | Currency |
Cost per total checkout (App)tiktokAds.costPerTotalCheckout | Average spend per checkout in your app: spend ÷ total checkouts. | Metric | number | Average | Currency |
Value per checkout (App)tiktokAds.valuePerCheckout | Average value per checkout event in your app. | Metric | number | Average | Currency |
Total checkout value (App)tiktokAds.totalCheckoutValue | Total revenue attributed to checkout events in your app. | Metric | number | Sum | Currency |
Cost per content view (App)tiktokAds.costPerViewContent | Average spend per content view event in your app: spend ÷ content views. | Metric | number | Average | Currency |
Cost per total content view (App)tiktokAds.costPerTotalViewContent | Average spend per content view in your app: spend ÷ total content views. | Metric | number | Average | Currency |
Value per content view (App)tiktokAds.valuePerTotalViewContent | Average value per content view event in your app. | Metric | number | Average | Currency |
Total content view value (App)tiktokAds.totalViewContentValue | Total revenue attributed to content view events in your app. | Metric | number | Sum | Currency |
Total complete payment valuetiktokAds.totalCompletePaymentValue | Total revenue attributed to complete payment events. | Metric | number | Sum | Currency |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
CTRtiktokAds.ctr | Click-through rate: clicks divided by impressions. Shown as a percentage in TikTok Ads Manager. | Metric | number | Average | Percentage |
Anchor click ratetiktokAds.anchorClickRate | Percentage of impressions that resulted in an anchor click: anchor clicks ÷ impressions. | Metric | number | Average | Percentage |
Instant Experience page duration avg.tiktokAds.ixPageDurationAvg | Average time users spent on a page in Instant Experience ads (full-screen mobile experience). | Metric | number | Average | Decimal (×) |
Instant Experience page view rate avg.tiktokAds.ixPageViewrateAvg | Average percentage of an Instant Experience page viewed by users. | Metric | number | Average | Percentage |
Playlist visit ratetiktokAds.ttPlaylistVisitRate | Percentage of impressions that led to a playlist visit: playlist visits ÷ impressions. | Metric | number | Average | Percentage |
Complete payment ratetiktokAds.completePaymentRate | Percentage of clicks that resulted in a complete payment: complete payments ÷ clicks. | Metric | number | Average | Percentage |
Total complete payment ratetiktokAds.totalCompletePaymentRate | Percentage of total impressions that resulted in a complete payment: complete payments ÷ impressions. | Metric | number | Average | Percentage |
Landing page view ratetiktokAds.landingPageViewRate | Percentage of clicks that resulted in a landing page view: landing page views ÷ clicks. | Metric | number | Average | Percentage |
Page view ratetiktokAds.pageviewRate | Percentage of clicks that resulted in a page view: page views ÷ clicks. | Metric | number | Average | Percentage |
Button click ratetiktokAds.buttonClickRate | Percentage of clicks that resulted in a button click on your landing page: button clicks ÷ clicks. | Metric | number | Average | Percentage |
(Page) Add to cart ratetiktokAds.webEventAddToCartRate | Percentage of clicks that resulted in an add-to-cart event on your landing page: add to carts ÷ clicks. | Metric | number | Average | Percentage |
Initiate checkout ratetiktokAds.initiateCheckoutRate | Percentage of clicks that resulted in a checkout initiation: initiate checkouts ÷ clicks. | Metric | number | Average | Percentage |
(Page) Search ratetiktokAds.pageEventSearchRate | Percentage of clicks that resulted in a search event on your landing page: searches ÷ clicks. | Metric | number | Average | Percentage |
(Page) Order ratetiktokAds.onWebOrderRate | Percentage of clicks that resulted in an order on your landing page: orders ÷ clicks. | Metric | number | Average | Percentage |
Add billing ratetiktokAds.addBillingRate | Percentage of clicks that resulted in a payment info addition: add billing events ÷ clicks. | Metric | number | Average | Percentage |
Form submission ratetiktokAds.formRate | Percentage of clicks that resulted in a form submission: form submissions ÷ clicks. | Metric | number | Average | Percentage |
Download start ratetiktokAds.downloadStartRate | Percentage of clicks that resulted in a download start: download starts ÷ clicks. | Metric | number | Average | Percentage |
(Page) Custom event ratetiktokAds.customPageEventRate | Percentage of clicks that resulted in a custom event on your landing page: custom events ÷ clicks. | Metric | number | Average | Percentage |
(Page) Browse view ratetiktokAds.pageBrowseViewRate | Percentage of clicks that resulted in a browse event on your landing page: browse views ÷ clicks. | Metric | number | Average | Percentage |
Online consult rate (Page)tiktokAds.onlineConsultRate | Percentage of clicks that resulted in an online consult event: online consults ÷ clicks. | Metric | number | Average | Percentage |
User registrationstiktokAds.userRegistration | Number of user registration events attributed to your ads. | Metric | number | Sum | Decimal (×) |
Cost per user registrationtiktokAds.costPerUserRegistration | Average spend per user registration: spend ÷ user registrations. | Metric | number | Average | Decimal (×) |
User registration ratetiktokAds.userRegistrationRate | Percentage of clicks that resulted in a user registration: user registrations ÷ clicks. | Metric | number | Average | Decimal (×) |
Value per user registrationtiktokAds.valuePerUserRegistration | Average value per user registration event. | Metric | number | Average | Decimal (×) |
Total user registration valuetiktokAds.totalUserRegistrationValue | Total value attributed to user registration events. | Metric | number | Average | Decimal (×) |
(Page) Content view ratetiktokAds.pageContentViewEventRate | Percentage of clicks that resulted in a content view on your landing page: content views ÷ clicks. | Metric | number | Average | Percentage |
(Page) Product detail view ratetiktokAds.productDetailsPageBrowseRate | Percentage of clicks that resulted in a product detail page view: product detail views ÷ clicks. | Metric | number | Average | Percentage |
Registrations (App)tiktokAds.registration | Number of registration events in your app attributed to your ads. | Metric | number | Sum | Decimal (×) |
Cost per registrationtiktokAds.costPerRegistration | Average spend for each registration event: spend ÷ registrations. | Metric | number | Average | Decimal (×) |
Registration rate (App)tiktokAds.registrationRate | Percentage of app installs that resulted in a registration: registrations ÷ app installs. | Metric | number | Average | Decimal (×) |
Total registrations (App)tiktokAds.totalRegistration | Total number of registration events in your app attributed to your ads. | Metric | number | Average | Decimal (×) |
Cost per total registration (App)tiktokAds.costPerTotalRegistration | Average spend per registration in your app: spend ÷ total registrations. | Metric | number | Average | Decimal (×) |
Checkout rate (App)tiktokAds.checkoutRate | Percentage of app installs that resulted in a checkout: checkouts ÷ app installs. | Metric | number | Average | Percentage |
Content view rate (App)tiktokAds.viewContentRate | Percentage of app installs that resulted in a content view: content views ÷ app installs. | Metric | number | Average | Percentage |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Video playstiktokAds.videoPlayActions | Number of times your video ad started playing. | Metric | number | Sum | — |
Video views 25%tiktokAds.videoViewsP25 | Number of times your video was watched to at least 25% completion. | Metric | number | Sum | — |
Video views 50%tiktokAds.videoViewsP50 | Number of times your video was watched to at least 50% completion. | Metric | number | Sum | — |
Video views 75%tiktokAds.videoViewsP75 | Number of times your video was watched to at least 75% completion. | Metric | number | Sum | — |
Video views 100%tiktokAds.videoViewsP100 | Number of times your video was watched to full completion. | Metric | number | Sum | — |
Video watched 2stiktokAds.videoWatched2s | Number of times your video was watched for at least 2 seconds. | Metric | number | Sum | — |
Video watched 6stiktokAds.videoWatched6s | Number of times your video was watched for at least 6 seconds. | Metric | number | Sum | — |
Avg video play durationtiktokAds.averageVideoPlay | Average duration users watched your video ad. | Metric | number | Average | — |
Avg video plays per usertiktokAds.averageVideoPlayPerUser | Average number of times each user played your video ad. | Metric | number | Average | — |
Engaged views (6s)tiktokAds.engagedView | Number of 6-second engaged views on your video ad. | Metric | number | Sum | — |
Engaged views (15s)tiktokAds.engagedView15s | Number of 15-second engaged views on your video ad. | Metric | number | Sum | — |
Instant Experience video viewstiktokAds.ixVideoViews | Metric for full-screen Instant Experience ads - total video views. | Metric | number | Sum | — |
Instant Experience video views 25%tiktokAds.ixVideoViewsP25 | Video views at 25% completion in Instant Experience ads. | Metric | number | Sum | — |
Instant Experience video views 50%tiktokAds.ixVideoViewsP50 | Video views at 50% completion in Instant Experience ads. | Metric | number | Sum | — |
Instant Experience video views 75%tiktokAds.ixVideoViewsP75 | Video views at 75% completion in Instant Experience ads. | Metric | number | Sum | — |
Instant Experience video views 100%tiktokAds.ixVideoViewsP100 | Video views at 100% completion (fully watched) in Instant Experience ads. | Metric | number | Sum | — |
Instant Experience avg. video playtiktokAds.ixAverageVideoPlay | Average number of video plays per user in Instant Experience ads. | Metric | number | Average | — |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Paid engagement viewstiktokAds.paidEngagementEngagedView | Number of paid engagement engaged views on your video ad. | Metric | number | Sum | — |
Paid engagement views (15s)tiktokAds.paidEngagementEngagedView15s | Number of paid engagement 15-second engaged views on your video ad. | Metric | number | Sum | — |
Clicks (all)tiktokAds.engagements | Total clicks on your ads, including destination, social, and interaction clicks. Separate from Clicks (destination) in TikTok Ads Manager. | Metric | number | Sum | — |
Engagement ratetiktokAds.engagementRate | Percentage of impressions that resulted in any engagement: engagements ÷ impressions. | Metric | number | Average | Percentage |
LikestiktokAds.likes | Number of likes on your ads. | Metric | number | Sum | — |
CommentstiktokAds.comments | Number of comments on your ads. | Metric | number | Sum | — |
SharestiktokAds.shares | Number of times your ads were shared. | Metric | number | Sum | — |
FollowstiktokAds.follows | Number of new followers gained from your ads. | Metric | number | Sum | — |
Profile visitstiktokAds.profileVisits | Number of visits to your TikTok profile from your ads. | Metric | number | Sum | — |
Profile visit ratetiktokAds.profileVisitsRate | Percentage of impressions that led to a profile visit: profile visits ÷ impressions. | Metric | number | Average | Percentage |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
ResultstiktokAds.result | Times your ad delivered your selected optimization goal. Not available at campaign level—use ad group or ad breakdowns. | Metric | number | Sum | — |
ConversionstiktokAds.conversion | Secondary conversion events attributed to your ads. | Metric | number | Sum | — |
Cost per conversiontiktokAds.costPerConversion | Average spend for each conversion: spend divided by conversions. | Metric | number | Average | Currency |
Conversion ratetiktokAds.conversionRate | Percentage of impressions that resulted in a conversion: conversions ÷ impressions. | Metric | number | Average | Percentage |
Conversion rate (by clicks)tiktokAds.conversionRateV2 | Percentage of clicks that resulted in a conversion: conversions ÷ clicks. | Metric | number | Average | Percentage |
Real-time conversionstiktokAds.realTimeConversion | Conversions tracked in real time during the reporting period. | Metric | number | Sum | — |
Real-time cost per conversiontiktokAds.realTimeCostPerConversion | Average spend per conversion using real-time conversion data. | Metric | number | Average | Currency |
Real-time CVRtiktokAds.realTimeConversionRate | Real-time conversion rate: conversions ÷ clicks. | Metric | number | Average | Percentage |
Real-time CVR (by impressions)tiktokAds.realTimeConversionRateV2 | Real-time conversion rate (v2): conversions ÷ impressions. | Metric | number | Average | Percentage |
Cost per resulttiktokAds.costPerResult | Average spend for each result: spend divided by results (your selected optimization goal). | Metric | number | Average | Currency |
Result ratetiktokAds.resultRate | Percentage of impressions that achieved your selected optimization goal: results ÷ impressions. | Metric | number | Average | Percentage |
Real-time resultstiktokAds.realTimeResult | Results tracked in real time during the reporting period. | Metric | number | Sum | — |
Real-time cost per resulttiktokAds.realTimeCostPerResult | Average spend per result using real-time result data. | Metric | number | Average | Currency |
Real-time result ratetiktokAds.realTimeResultRate | Real-time result rate: results ÷ impressions. | Metric | number | Average | Percentage |
Secondary goal resultstiktokAds.secondaryGoalResult | Secondary goal results attributed to your ads. | Metric | number | Sum | — |
Cost per secondary goal resulttiktokAds.costPerSecondaryGoalResult | Average spend for each secondary goal result. | Metric | number | Average | Currency |
Secondary goal result ratetiktokAds.secondaryGoalResultRate | Percentage of impressions that achieved the secondary goal: secondary goal results ÷ impressions. | Metric | number | Average | Percentage |
Complete payment ROAStiktokAds.completePaymentRoas | Return on ad spend for complete payments: total complete payment value ÷ spend. | Metric | number | Average | Decimal (×) |
App installstiktokAds.appInstall | Number of app installs attributed to your ads. | Metric | number | Sum | — |
Purchases (App)tiktokAds.purchase | Number of purchase events in your app attributed to your ads. | Metric | number | Sum | — |
Cost per purchasetiktokAds.costPerPurchase | Average spend for each purchase: spend ÷ purchases. | Metric | number | Average | Currency |
Purchase rate (App)tiktokAds.purchaseRate | Percentage of app installs that resulted in a purchase: purchases ÷ app installs. | Metric | number | Average | Percentage |
Total purchases (App)tiktokAds.totalPurchase | Total number of purchase events in your app attributed to your ads. | Metric | number | Sum | — |
Cost per total purchase (App)tiktokAds.costPerTotalPurchase | Average spend per purchase in your app: spend ÷ total purchases. | Metric | number | Average | Currency |
Value per purchase (App)tiktokAds.valuePerTotalPurchase | Average value per purchase in your app. | Metric | number | Average | Currency |
Total purchase value (App)tiktokAds.totalPurchaseValue | Total revenue attributed to purchases in your app. | Metric | number | Sum | Currency |
Total active pay ROAStiktokAds.totalActivePayRoas | Return on ad spend for active pay events: total active pay value ÷ spend. | Metric | number | Average | Decimal (×) |
Add to cart (App)tiktokAds.appEventAddToCart | Number of add-to-cart events in your app attributed to your ads. | Metric | number | Sum | — |
Add to cart rate (App)tiktokAds.appEventAddToCartRate | Percentage of app installs that resulted in an add-to-cart: add to carts ÷ app installs. | Metric | number | Average | Percentage |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Advertiser IDtiktokAds.advertiserId | Unique identifier for the TikTok Ads account. | Dimension | string | — | — |
Advertiser nametiktokAds.advertiserName | Name of the TikTok Ads account. | Dimension | string | — | — |
CurrencytiktokAds.currency | Currency used by the TikTok Ads account. | Dimension | string | — | — |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Campaign budget modetiktokAds.campaignBudgetMode | How the campaign budget is set (daily or lifetime). | Dimension | string | — | — |
Campaign budgettiktokAds.campaignBudget | Daily or lifetime budget amount set for the campaign. | Dimension | string | — | — |
Ad group scheduled budgettiktokAds.adgroupScheduledBudget | Scheduled budget for the ad group. | Dimension | string | — | — |
Bid typetiktokAds.adgroupBidType | Bid strategy type for the ad group (e.g. Bid Cap, Lowest Cost). | Dimension | string | — | — |
Ad group budgettiktokAds.adgroupBudget | Budget set for the ad group. | Dimension | string | — | — |
Billing eventtiktokAds.adgroupBillingEvent | The event you are charged for in the ad group (e.g. CPC, CPM, CPV). | Dimension | string | — | — |
Ad group budget modetiktokAds.adgroupBudgetMode | Whether the ad group runs on a daily or lifetime budget. | Dimension | string | — | — |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Campaign IDtiktokAds.campaignId | Unique identifier for the campaign in TikTok Ads. | Dimension | string | — | — |
CampaigntiktokAds.campaignName | Name of the ad campaign. Shown in campaign reports and breakdowns. | Dimension | string | — | — |
Campaign objective typetiktokAds.campaignObjectiveType | Advertising objective type for the campaign (e.g. Traffic, Conversions, App Install). | Dimension | string | — | — |
Campaign objectivetiktokAds.campaignObjective | Advertising objective for the campaign (e.g. Reach, Traffic, App Promotion). | Dimension | string | — | — |
Campaign typetiktokAds.campaignType | Type of campaign (e.g. Auction, Reach & Frequency). | Dimension | string | — | — |
Campaign statustiktokAds.campaignOperationStatus | Current delivery status of the campaign (e.g. Active, Paused, Deleted). | Dimension | string | — | — |
Campaign automation typetiktokAds.campaignAutomationType | Type of automation applied to the campaign (e.g. Smart Plus, standard). | Dimension | string | — | — |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Ad group IDtiktokAds.adgroupId | Unique identifier for the ad group in TikTok Ads. | Dimension | string | — | — |
Ad grouptiktokAds.adgroupName | Name of the ad group. Shown in ad group reports and breakdowns. | Dimension | string | — | — |
Ad group schedule starttiktokAds.adgroupScheduleStartTime | Start time of the ad group delivery schedule. | Dimension | string | — | — |
Ad group schedule endtiktokAds.adgroupScheduleEndTime | End time of the ad group delivery schedule. | Dimension | string | — | — |
Ad group secondary statustiktokAds.adgroupSecondaryStatus | Secondary delivery status of the ad group (e.g. Ad group not started, In review). | Dimension | string | — | — |
Ad group placementstiktokAds.adgroupPlacements | Ad placements selected for the ad group (e.g. TikTok, Pangle). | Dimension | string | — | — |
Schedule typetiktokAds.adgroupScheduleType | Whether the ad group runs continuously or on a set schedule. | Dimension | string | — | — |
Smart Performance CampaigntiktokAds.adgroupIsSmartPerformanceCampaign | Whether the ad group belongs to a Smart Performance Campaign. | Dimension | string | — | — |
Ad group statustiktokAds.adgroupOperationStatus | Current delivery status of the ad group (e.g. Active, Paused, Deleted). | Dimension | string | — | — |
Optimization eventtiktokAds.adgroupOptimizationEvent | Conversion event the ad group is optimizing towards. | Dimension | string | — | — |
Optimization goaltiktokAds.adgroupOptimizationGoal | Goal the ad group is optimized for (e.g. Clicks, Conversions, Reach). | Dimension | string | — | — |
Promotion typetiktokAds.adgroupPromotionType | Promotion type for the ad group (e.g. App, Website, TikTok video). | Dimension | string | — | — |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
Ad IDtiktokAds.adId | Unique identifier for the ad in TikTok Ads. | Dimension | string | — | — |
AdtiktokAds.adName | Name of the ad. Shown in ad-level reports and breakdowns. | Dimension | string | — | — |
Call to actiontiktokAds.adCallToAction | Call-to-action text shown on the ad (e.g. Shop Now, Learn More). | Dimension | string | — | — |
Landing page URLtiktokAds.adLandingPageUrl | Destination URL for the ad's landing page. | Dimension | string | — | — |
Identity typetiktokAds.adIdentityType | Type of identity used for the ad (e.g. TikTok account, Custom Identity). | Dimension | string | — | — |
App nametiktokAds.adAppName | Name of the app being promoted by the ad. | Dimension | string | — | — |
Ad formattiktokAds.adAdFormat | Format of the ad (e.g. In-Feed, TopView, Brand Takeover). | Dimension | string | — | — |
Ad statustiktokAds.adOperationStatus | Current delivery status of the ad (e.g. Active, Paused, Deleted). | Dimension | string | — | — |
ACO adtiktokAds.adIsAco | Whether the ad uses Automated Creative Optimization (ACO). | Dimension | string | — | — |
Ad display nametiktokAds.adDisplayName | Display name shown for the ad in TikTok Ads Manager. | Dimension | string | — | — |
Ad secondary statustiktokAds.adSecondaryStatus | Secondary delivery status of the ad (e.g. Ad not started, In review). | Dimension | string | — | — |
Ad optimization eventtiktokAds.adOptimizationEvent | Conversion event the ad is optimizing towards. | Dimension | string | — | — |
Ad VAST MOAT enabledtiktokAds.adVastMoatEnabled | Whether the ad has VAST MOAT viewability tracking enabled. | Dimension | string | — | — |
Ad texttiktokAds.adText | Text or caption copy used in the ad creative. | Dimension | string | — | — |
TikTok item IDtiktokAds.adTiktokItemId | Unique identifier for the TikTok organic post used in a Spark Ad. | Dimension | string | — | — |
Creative formattiktokAds.creativeFormat | Format of the ad creative (e.g. image, video). | Dimension | string | — | — |
Creative durationtiktokAds.creativeDuration | Duration of the video creative in seconds. | Dimension | string | — | — |
Ad typetiktokAds.adType | Type of TikTok ad (e.g. TopView, Brand Takeover, In-Feed Ad, Spark Ad). | Dimension | string | — | — |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
GendertiktokAds.gender | Gender of the audience who saw your ads. | Dimension | string | — | — |
AgetiktokAds.age | Age range of the audience who saw your ads. | Dimension | string | — | — |
Audience networktiktokAds.ac | Audience network placement where the ad was shown. | Dimension | string | — | — |
| Field | Description | Kind | Type | Aggregation | Format |
|---|---|---|---|---|---|
DatetiktokAds.date | Date when the ad metrics were recorded. | Dimension | time | — | — |
HourtiktokAds.statTimeHour | Hour when the ad metrics were recorded. | Dimension | string | — | — |
Search termstiktokAds.searchTerms | Search keyword entered by users that triggered your ad. | Dimension | string | — | — |
Country codetiktokAds.countryCode | Country code of the audience who saw your ads. | Dimension | string | — | — |
PlacementtiktokAds.placement | Placement where your ad was shown (e.g. TikTok In-Feed, Pangle). | Dimension | string | — | — |
Reports, budgets, forecasts and alerts all use the same TikTok Ads fields listed above.
Describe the report you want and Jepto builds it from your TikTok Ads data, then writes an analysis of what changed and why.
Explore reportingTrack TikTok Ads spend against a budget for each account or group of campaigns, and see mid-month whether you're on course to overspend.
Explore budget trackingSet a target on any TikTok Ads metric and see where the month is likely to finish, while there's still time to act.
Explore KPI forecastingAdd an anomaly alert to the TikTok Ads metrics you care about, and Jepto tells you when one moves outside its normal range.
Explore anomaly detectionSign in with the TikTok account that has access to your ad accounts.
In Jepto, add a TikTok Ads connection and sign in with a TikTok account that has access to the ad accounts.
Select the TikTok ad accounts you want to report on.
Your data is ready in Reports and Data Chat. Connect https://mcp.jepto.com to your AI assistant to ask about it from there too.
About TikTok Ads in Jepto and the Jepto MCP.
Yes. Jepto hosts an MCP server at https://mcp.jepto.com that gives Claude, ChatGPT, Cursor and other MCP-compatible apps access to your TikTok Ads data. There's nothing to install: you sign in to Jepto with OAuth, and the assistant can query every TikTok Ads field in the Jepto data model.
Yes. TikTok launched its own Ads MCP server in June 2026, and it can read and change campaigns, though availability varies by advertiser account. Jepto's hosted server is read-only, and lets one question cover TikTok, Meta, Google and your analytics across every brand you manage.
Jepto includes TikTok Ads metrics such as Spend, Impressions, Clicks, Reach, Results, Conversions, Cost per conversion and Conversion rate. You can break them down by dimensions for Account, Bidding & budget, Campaign, Ad group, Ad & creative, Audience and Segments. Every field, with its definition, is listed on this page.
No. Through the Jepto MCP, TikTok Ads data is read-only: the assistant can query it but can't change anything in TikTok Ads.
Yes. Video views at 25%, 50%, 75% and 100%, 2-second and 6-second views and average play time are all metrics.
Yes. When both are connected to the same brand, any report or chart can use fields from either source, and Data Chat and the Jepto MCP can answer questions that span the two. Cross-platform fields such as unified.spend also add TikTok Ads to totals across your other ad platforms.
No. You connect TikTok Ads to Jepto by signing in, and Jepto handles the API access. Your AI assistant then connects to Jepto at https://mcp.jepto.com.
Yes. Every TikTok Ads account connected to Jepto, across all your brands, is available through the one connection. What each person can see follows their Jepto login.
No. The Jepto MCP is included on every plan with no usage limits. Check that your AI assistant's plan lets you add connectors.
Related Articles
Start asking your data smarter questions today. Connect your first data source in minutes.
