The TikTok connector provides dimensions and metrics in Funnel for TikTok Ads. You can connect auction ad reports (Basic, Reach and frequency, or Audience) or reservation ads, at Campaign, Adgroup, or Ad level.
Please note that the Branded Mission objective is not available in the TikTok API.
A small set of offline metrics (Purchases (offline) and Purchase value (offline)) are available in the Basic metric report. See Offline Metrics under Metrics available only in Basic metric report.
Report types and levels: what to choose
Metrics report type | Best for |
Basic | Broadest set of metrics. Use for cost, clicks, conversions, video and engagement metrics, offline metrics, website and app events, LIVE metrics, attribution (CTA/VTA), and Interactive Add-on metrics. Some metrics require country code breakdown. |
Reach and frequency | Reach, frequency, and cost per reach. Use for unique metrics (e.g. Unique Purchase, Unique Registration) with configurable time windows (1, 7, 14, 30, 60, 90 days, Month to Date, Lifetime). |
Audience | Audience breakdowns. Use for the same core metrics as Basic but sliced by audience (Age, Gender, Country, Device, Placement, etc.). Some metrics (e.g. Instant Experience) require Placement breakdown. |
Reservation ads | Guaranteed (reservation) ad inventory. Separate dimensions and metrics from auction ads; use when you run reservation campaigns. |
You can also choose the level of detail: Campaign, Adgroup, or Ad. Dimensions and some metrics vary by level (see the sections below).
Auction Ad Dimensions
Dimensions available for Campaign, Adgroup and Ad
Campaign ID
Campaign name
Campaign objective
Campaign objective type
Campaign created time
Campaign budget mode
Campaign status
Campaign type
Campaign buying type
Reservation campaign type
Campaign automation type
Dimensions available for Adgroup and Ad
Adgroup ID
Adgroup name
Adgroup optimization goal
Adgroup created time
Adgroup pacing
Adgroup placement
Adgroup placement type
Adgroup bid type
Adgroup interest
Adgroup status
Promotion type
Adgroup brand safety type
Adgroup feed type
Adgroup budget mode
Adgroup bid display mode
Adgroup schedule type
Adgroup RF purchased type
Adgroup age groups
Adgroup category ID
Adgroup delivery mode
Adgroup app profile page state
Adgroup billing event
Adgroup CPV video duration
Dimensions available for Ad
Ad ID
Ad name
Ad text
Adgroup profile image
Adgroup landing page URL
Ad call to action
Ad video ID
Ad created time
Ad image mode
Ad impression tracking URL
Ad status
Additional Dimensions
Country Code
Hour
Audience breakdowns
AC
Age
Age and Gender
Country
Gender
Language
Operating System
Province
DMA
Device
Behavior
Placement
Auction Ad Metrics
Metrics available in all metric reports
Total Cost
Metrics available in Audience and Basic metric reports
Adgroup Budget (only available for the Adgroup and Ad level)
Campaign budget
Click through rate (CTR destination)
Clicks (Destination)
Conversions
Conversion rate
Cost per action (CPA)
Cost per click (CPC destination)
Cost per mille (CPM)
Impressions
Real time conversions
Real time conversion rate
Video Metrics
2-Second Video Views
6-Second Video Views
Video Views
Video Views at 100%
Video Views at 25%
Video Views at 50%
Video Views at 75%
Video Average Watch Time Per Video View — please note that aggregation is MAX of source level-of-detail
Video Average Watch Time Per Person — please note that aggregation is MAX* of source level-of-detail
Engagement Metrics
Paid Likes
Paid Profile visits
Paid Followers
Paid Shares
Paid comments
Music Clicks
Instant Experience Average View Percentage *
Instant Experience Average View Time *
Extended Metadata Metrics
Adgroup bid price
Adgroup purchased impression
Adgroup frequency schedule
Adgroup RF estimated CPR
Adgroup RF estimated frequency
Adgroup purchased reach
*Not available in Basic report with country; for Audience report only available when breakdown Placement is selected.
Metrics available only in Basic metric report with country code
Form submissions (website)
Downloads (website)
Contacts (website)
Button clicks (website)
Purchases (website)
App installs by conversion time
LIVE Product Clicks
6-second views (Focused view)
15-second views (Focused view)
Metrics available only in Basic metric report
Engagement Metrics
Clicks (All)
Paid Followers
Paid Shares
Paid comments
Music Clicks
Anchor Clicks
Duet Clicks
Stitch Clicks
Interactive Add-on metrics
Interactive Add-on Impressions
Interactive Add-on Destination Clicks
Interactive Add-on Activity Clicks
Interactive Add-on Option A Clicks
Interactive Add-on Option B Clicks
Countdown Sticker Recall Clicks
LIVE Metrics
LIVE Views
Effective LIVE Views
LIVE Product Clicks
Offline Metrics {#offline-metrics}
Purchases (offline)
Purchase value (offline)
Attribution Metrics
CTA Conversions
CTA Purchase
CTA Registration
CTA App Install
Cost per CTA conversion
Cost per CTA purchase
Cost per CTA registration
Cost per VTA conversion
Cost per VTA purchase
Cost per VTA registration
VTA Conversion
VTA Purchase
VTA Registration
VTA App Install
Website Metrics
Add to cart value (website)
Adds to wishlist (website)
Button clicks (website)
Checkouts initiated (website)
Contacts (website)
Cost per add to cart
Cost per Complete Registration (Page Event)
Downloads (website)
Form submissions (website)
Landing page views (website)
Orders placed (website)
Orders placed value (website)
Page views (website)
Payment info added (website)
Purchases (website)
Registrations (website)
Searches (website)
Subscription value (website)
Subscriptions (website)
Total Complete Payment Value
Total Download
App Metrics
Add to Cart (app)
Add to cart value (app)
Add to wishlist (app)
Add to wishlist value (app)
App installs by conversion time
Content view value (app)
Content views (app)
Credit spends (app)
Install
Install cost
Levels achieved (app)
Payment info adds (app)
Purchase value (app)
Purchases (app)
Registration (app)
Searches (app)
Total Checkout
Total Launch App
Total Subscribe (app)
Tutorial completion value (app)
SKAN Metrics
Conversions (SKAN)
Total Achieve Level (SKAN)
Total Add to Wishlist (SKAN)
Total View Content (SKAN)
App Install (SKAN)
Total Checkout (SKAN)
Total Purchase (SKAN)
Total Registration (SKAN)
SKAN start trials
SKAN subscribes
Total Add to Cart (SKAN)
Total Add Payment Info (SKAN)
Total Complete Tutorial (SKAN)
Total Complete Tutorial Value (SKAN)
Total Unlock Achievement (SKAN)
Total Generate Lead (SKAN)
Total Login (SKAN)
Total Launch App (SKAN)
Total Join Group (SKAN)
Total Create Group (SKAN)
Result (SKAN)
Onsite Event Metrics
Total Form Submission (Onsite)
Total Purchase GMV
Metrics available in Reach and Frequency metric report
Available time windows: 1, 7, 14, 30, 60, 90, Month to Date and Lifetime
Frequency
Reach
Cost per 1000 reach
Real-time App Installs
App Install
Unique Purchase
Unique Registration
Unique Add to Cart
Unique Checkout
Unique View Content
Unique Day 1 Retention
Unique Add Payment Info
Unique Add to Wishlist
Unique Launch App
Unique Complete Tutorial
Unique Create Group
Unique Join Group
Unique Create Role
Unique Spend Credit
Unique Achieve Level
Unique Unlock Achievement
Unique Generate Lead
Unique In-App Ad Click
Unique In-App Ad Impression
Unique Loan Apply
Unique Loan Approval
Unique Loan Disbursal
Unique Login
Unique Rate
Unique Search
Unique Start Trial
Unique Subscribe
LIVE Unique Views
Reservation Ad Dimensions
Dimensions available for all levels
Campaign ID
Campaign Name
Dimensions available for Adgroup
Adgroup ID
Adgroup Name
Dimensions available for Ad
Ad ID
Ad Name
Reservation Ad Metrics
Metrics available for all levels
2-Second Video Views
6-Second Video Views
Click Through Rate (CTR destination)
Clicks (Destination)
Conversion Rate
Cost per Action (CPA)
Cost per Click (CPC destination)
Cost per Mille (CPM)
Impressions
Real Time Conversion Rate
Video Average Watch Time Per Person
Video Average Watch Time Per Video View
Video Views
Video Views at 25%
Video Views at 50%
Video Views at 75%
Video Views at 100%
Metrics available for Campaign and Adgroup
Total cost
Metrics available for Adgroup
Clicks (All)
Paid Comments
Paid Likes
Paid Shares
API documentation
For full field definitions and updates, see TikTok Marketing API documentation.