Tiktok Ads Metrics and Dimensions

Field group
Field
Type
Data type
Description
PerformanceAmount spent
METRIC
FLOATThe estimated total amount of money you've spent on your campaign, ad group or ad during its schedule
PerformanceImpressions
METRIC
INTEGERThe number of times your ads were on screen
PerformanceGross impressions
METRIC
FLOATThe number of times an ad was seen on screen, including invalid impressions.
PerformanceClicks
METRIC
INTEGERThe number of clicks on your ads
PerformanceCPC
METRIC
FLOATThe average amount of money you have spent on a click
PerformanceCPM
METRIC
FLOATThe average amount of money you have spent per 1,000 impressions
PerformanceCTR
METRIC
FLOATThe percentage of times people saw your ad and performed a click
ReachReach
METRIC
INTEGERThe number of unique users who saw your ads at least once. This metric is estimated
ReachCost per 1,000 people reached
METRIC
FLOATThe average cost to reach 1,000 unique users. This metric is estimated
ReachFrequency
METRIC
FLOATThe average number of times each person saw your ad.
VideoVideo views
METRIC
INTEGERThe number of times your video starts to play. Replays will not be counted
Video2-second video views
METRIC
INTEGERThe number of times your video played for at least 2 seconds. Replays will not be counted
Video6-second video views
METRIC
INTEGERThe number of times your video played for at least 6 seconds. Replays will not be counted
VideoVideo views at 25%
METRIC
INTEGERThe number of times your video was played at 25% of its length. Replays will not be counted
VideoVideo views at 50%
METRIC
INTEGERThe number of times your video was played at 50% of its length. Replays will not be counted
VideoVideo views at 75%
METRIC
INTEGERThe number of times your video was played at 75% of its length. Replays will not be counted
VideoVideo views at 100%
METRIC
INTEGERThe number of times your video was played at 100% of its length. Replays will not be counted
VideoAvg video watch time per video view
METRIC
FLOATThe average time your video was played per single video view, including any time spent replaying the video.
VideoAvg video watch time per person
METRIC
FLOATThe average time your video was played per single person, including any time spent replaying the video.
VideoFocused views (6sec)
METRIC
INTEGERThe number of times your video has been played at least 6 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad.
VideoFocused views (15sec)
METRIC
INTEGERThe number of times your video has been played at least 15 seconds, or received at least 1 engagement within 1 day of the user seeing a paid ad.
LiveLIVE Views
METRIC
INTEGERThe number of times viewers visited your LIVE. Revisits will be counted.
LiveLIVE Unique Views
METRIC
INTEGERThe number of unique viewers who entered your LIVE.
LiveEffective LIVE Views
METRIC
INTEGERThe number of times viewers visited your LIVE for more than 10 seconds. Revisits will be counted.
LiveLIVE Product Clicks
METRIC
INTEGERThe number of time viewers clicked a product and viewed its details page during your LIVE.
EngagementTotal engagement
METRIC
INTEGERThe overall amount of engagement on your ad which includes likes, comments, shares, follows and clicks. Clicks consist of music, hashtags, anchor, and interactive add-on activity clicks.
EngagementEngagement rate
METRIC
FLOATThe engagement rate is the number of engagements that your ad receives divided by the number of times your ad is shown.
EngagementProfile visits
METRIC
INTEGERThe number of profile visits the ad drove during the campaign
EngagementProfile visits rate
METRIC
RATIOThe rate of profile visits per impression the paid ad drove during the campaign. This metric is only for Spark Ads.
EngagementPaid likes
METRIC
INTEGERThe total amount of likes the ad received during the campaign
EngagementPaid comments
METRIC
INTEGERThe number of comments the ad received during the campaign
EngagementPaid shares
METRIC
INTEGERThe number of shares the ad received during the campaign
EngagementPaid follows
METRIC
INTEGERThe number of new followers that were gained within 1 day of a user seeing a paid ad
EngagementClicks on music disc
METRIC
INTEGERThe number of clicks on the official music in your Spard Ads during the campaign.
EngagementDuet clicks
METRIC
INTEGERThe numbers of clicks on the "Duet" button.
EngagementStitch clicks
METRIC
INTEGERThe numbers of clicks on the "Stitch" button.
EngagementSound usage clicks
METRIC
INTEGERThe numbers of clicks on the "Use this sound" button.
EngagementAnchor clicks
METRIC
INTEGERThe number of clicks on all anchors.
EngagementAnchor click rate
METRIC
FLOATThe percentage of times viewers performed a click after seeing an anchor.
EngagementClicks on hashtag challenge
METRIC
INTEGERThe total amount of clicks on your ad's hashtag challenge during the campaign.
EngagementInstant experience avg view time
METRIC
INTEGERThe average total time that people spent viewing an Instant Experience.
EngagementInstant experience avg view %
METRIC
INTEGERThe average percentage of the Instant Experience that people viewed.
ConversionConversions
METRIC
INTEGERThe number of times your ad achieved an outcome, based on the secondary goal you selected. One campaign may have a number of different secondary goals. Calculated based on the time each ad impression occurred
ConversionCost per conversion
METRIC
FLOATThe average amount of money you have spent on a conversion (CPA). Calculated based on the time each ad impression occurred
ConversionConversion rate
METRIC
FLOATThe percentage of results you received out of all the clicks of your ads. Calculated based on the time each ad impression occurred
ConversionReal time conversions
METRIC
INTEGERThe number of times your ad achieved an outcome, based on the objective and settings you selected. Count is based on when the conversion actually happened
ConversionCost per real time conversion
METRIC
FLOATThe average amount of money you have spent on a real-time conversion (Real-time CPA). Calculated based on when the conversion actually happened
ConversionReal time conversion rate
METRIC
FLOATThe percentage of real-time conversions you received out of all the clicks of your ads. Calculated based on when the conversion actually happened
ResultResults
METRIC
INTEGERThe number of times your ad achieved an outcome, based on the optimization goal you selected. One campaign may have a number of different optimization goals. Calculated based on the time each ad impression occurred
ResultCost per result
METRIC
FLOATThe average cost for each result from your ads. Calculated based on the time each ad impression occurred
ResultResult rate
METRIC
FLOATThe percentage of results you achieved out of all of the views/clicks on your ads. Calculated based on the time each ad impression occurred
ResultReal time results
METRIC
INTEGERThe number of times your ad achieved an outcome, based on the optimization goal you selected. One campaign may have a number of different optimization goals. Count is based on when the conversion actually happened
ResultCost per real time result
METRIC
FLOATThe average cost for each real-time result from your ads. Calculated based on when the conversion actually happened
ResultReal time result rate
METRIC
FLOATThe percentage of real-time results you achieved out of all of the views/clicks on your ads. Calculated based on when the conversion actually happened
Secondary Goal ResultSecondary goal result
METRIC
INTEGERThe number of times your ad achieved an outcome, based on the secondary goal you selected. As one campaign may have a number of different secondary goals, this statistic is not supported for campaigns. Please go to ad groups or ads to view. (The total count is calculated based on the time each ad impression occurred.)
Secondary Goal ResultCost per secondary goal result
METRIC
FLOATThe average cost for each secondary goal result from your adverts. As one campaign may have a number of different secondary goals, this statistic is not supported for campaigns. Please go to ad groups or ads to view. (The total count is calculated based on the time each ad impression occurred.)
Secondary Goal ResultSecondary goal result rate
METRIC
FLOATThe percentage of Secondary goal results you achieved out of all of the views/clicks on your ads. Calculated based on when the conversion actually happened
AttributionVTA conversions
METRIC
INTEGERThe percentage of app install events you received out of all the clicks of your ads
AttributionVTA registrations
METRIC
INTEGERThe number of registration event that attribute to impression, based on information received from your measurement partner
AttributionVTA purchases
METRIC
INTEGERThe number of in-app payment event that attribute to impression, based on information received from your measurement partner
AttributionCTA conversions
METRIC
INTEGERThe number of in-app app install event that occurred on your mobile app and are attributed to the amount of clicks
AttributionCTA registrations
METRIC
INTEGERThe number of in-app registration event that attribute to click, based on information received from your measurement partner
AttributionCTA purchases
METRIC
INTEGERThe number of in-app payment event that attribute to click, based on information received from your measurement partner
Page EventComplete payment ROAS
METRIC
FLOATThe total return on ad spend (ROAS) from complete payment events that are attributed to your ads
Page EventComplete payment
METRIC
FLOATThe number of complete payment events
Page EventCost per Complete Payment
METRIC
FLOATThe average cost of each complete payment event.
Page EventTotal complete payment Value
METRIC
FLOATThe total value returned from complete payment events
Page EventLanding page views
METRIC
FLOATThe number of landing page view events from your ads
Page EventPage browse
METRIC
FLOATThe number of page browse events
Page EventButton click
METRIC
FLOATThe number of button click events
Page EventTotal button click value
METRIC
FLOATThe total value returned from button click events
Page EventOnline consultation
METRIC
FLOATThe number of online consultation events
Page EventTotal online consultation
METRIC
FLOATThe total value returned from online consultation events
Page EventUser registration
METRIC
FLOATThe number of user registration events
Page EventTotal user registration value
METRIC
FLOATThe total value returned from user registration events
Page EventProduct details page browse
METRIC
FLOATThe number of product details page browse events
Page EventTotal product details page browse value
METRIC
FLOATThe total value returned from product details page browse events
Page EventAdd to cart
METRIC
FLOATThe number of add to cart events
Page EventTotal add to cart value
METRIC
FLOATThe total value returned from add to cart events
Page EventPlace an order
METRIC
FLOATThe number of place an order events
Page EventTotal place an order value
METRIC
FLOATThe total value returned from place an order events
Page EventInitiate checkout
METRIC
FLOATThe number of initiate checkout events
Page EventTotal initiate checkout value
METRIC
FLOATThe total value returned from initiate checkout events
Page EventAdd billing
METRIC
FLOATThe number of add billing events
Page EventTotal add billing value
METRIC
FLOATThe total value returned from add billing events
Page EventSearch
METRIC
FLOATThe number of search events
Page EventTotal search value
METRIC
FLOATThe total value returned from search events
Page EventForm submission
METRIC
FLOATThe number of form submission events
Page EventTotal form submission
METRIC
FLOATThe total value returned from form submission events
Page EventDownload button click
METRIC
FLOATThe number of download button click events
Page EventTotal download button click value
METRIC
FLOATThe total value returned from download button click events
Page EventDownload button click cost
METRIC
FLOATThe average cost of each download button click events
Page EventTotal add to wishlist
METRIC
INTEGERTotal Add to Wishlist
Page EventTotal subscribe
METRIC
INTEGERTotal Subscribe
Onsite EventComplete payment ROAS (Onsite)
METRIC
FLOATThe total return on ad spend (ROAS) from complete payment events that are attributed to your ads on TikTok Store.
Onsite EventComplete payment (Onsite)
METRIC
FLOATThe number of complete payment events on TikTok Store.
Onsite EventCost per complete payment (Onsite)
METRIC
FLOATThe average cost of each 'Complete Payment' event attributed to your TikTok ads.
Onsite EventComplete payment rate (Onsite)
METRIC
FLOATThe percentage of 'Complete Payment' events out of all click events attributed to your TikTok ads.
Onsite EventValue per complete payment (Onsite)
METRIC
FLOATThe average value returned from each 'Complete Payment' event attributed to your TikTok ads.
Onsite EventTotal complete payment value (Onsite)
METRIC
FLOATThe total value returned from 'Complete Payment' events attributed to your TikTok ads.
Onsite EventInitiate checkout (Onsite)
METRIC
FLOATThe number of initiate checkout events on TikTok Store.
Onsite EventCost per initiate checkout (Onsite)
METRIC
FLOATThe average cost of each 'Initiate Checkout' event attributed to your TikTok ads.
Onsite EventInitiate checkout rate (Onsite)
METRIC
FLOATThe percentage of 'Initiate Checkout' events out of all click events attributed to your TikTok ads.
Onsite EventValue per initiate checkout (Onsite)
METRIC
FLOATThe average value returned from each 'Initiate Checkout' event attributed to your TikTok ads.
Onsite EventTotal initiate checkout value (Onsite)
METRIC
FLOATThe total value returned from 'Initiate Checkout' events attributed to your TikTok ads.
Onsite EventProduct details page view (Onsite)
METRIC
FLOATThe number of product details page view events on TikTok Store.
Onsite EventCost per product details page view (Onsite)
METRIC
FLOATThe average cost of each product detail page (PDP) view event attributed to your TikTok ads.
Onsite EventProduct details page view rate (Onsite)
METRIC
FLOATThe percentage of product detail page (PDP) view events out of all click events attributed to your TikTok ads.
Onsite EventValue per product details page view (Onsite)
METRIC
FLOATThe average value returned from each product detail page (PDP) event attributed to your TikTok ads.
Onsite EventTotal product details page view value (Onsite)
METRIC
FLOATThe total value returned from product detail page (PDP) view events attributed to your TikTok ads.
Onsite EventAdd to wishlist (Onsite)
METRIC
FLOATThe number of add to wishlist events on TikTok Store.
Onsite EventCost per add To wishlist (Onsite)
METRIC
FLOATThe average cost of each 'Add to Wishlist' event attributed to your TikTok ads.
Onsite EventAdd to wishlist rate (Onsite)
METRIC
FLOATThe percentage of 'Add to Wishlist' events out of all click events attributed to your TikTok ads.
Onsite EventValue per add to wishlist (Onsite)
METRIC
FLOATThe average value returned from each 'Add to Wishlist' event attributed to your TikTok ads.
Onsite EventTotal add to wishlist value (Onsite)
METRIC
FLOATThe total value returned from 'Add to Wishlist' events attributed to your TikTok ads.
Onsite EventAdd billing (Onsite)
METRIC
FLOATThe number of add billing events on TikTok Store.
Onsite EventCost per add billing (Onsite)
METRIC
FLOATThe average cost of each 'Add Billing' event attributed to your TikTok ads.
Onsite EventAdd billing rate (Onsite)
METRIC
FLOATThe percentage of 'Add Billing' events out of all click events attributed to your TikTok ads.
Onsite EventValue per add billing (Onsite)
METRIC
FLOATThe average value returned from each 'Add Billing' event attributed to your TikTok ads.
Onsite EventTotal add billing value (Onsite)
METRIC
FLOATThe total value returned from 'Add Billing' events attributed to your TikTok ads.
Onsite EventAdd to cart (Onsite)
METRIC
FLOATThe number of add to cart events on TikTok Store.
Onsite EventCost per add to cart (Onsite)
METRIC
FLOATThe average cost of each 'Add to Cart' event attributed to your TikTok ads.
Onsite EventAdd to cart rate (Onsite)
METRIC
FLOATThe percentage of 'Add to Cart' events out of all click events attributed to your TikTok ads.
Onsite EventValue per add to cart (Onsite)
METRIC
FLOATThe average value returned from each 'Add to Cart' event attributed to your TikTok ads.
Onsite EventTotal add to cart value (Onsite)
METRIC
FLOATThe total value returned from 'Add to Cart' events attributed to your TikTok ads.
Onsite EventForm submission (Onsite)
METRIC
FLOATThe number of form submission events on Leads Generation page.
Onsite EventCost per form submission (Onsite)
METRIC
FLOATThe average cost of each form submission event attributed to your TikTok ads.
Onsite EventForm submission rate (Onsite)
METRIC
FLOATThe percentage of form submission events out of all click events attributed to your TikTok ads.
Onsite EventValue per form submission (Onsite)
METRIC
FLOATThe average value returned from each form submission event attributed to your TikTok ads.
Onsite EventTotal form submission value (Onsite)
METRIC
FLOATThe total value returned from form submission events attributed to your TikTok ads.
Onsite EventApp store click (Onsite)
METRIC
FLOATThe number of app store click events on App Profile Page.
Onsite EventCost per app store click (Onsite)
METRIC
FLOATThe average cost of each app store click event attributed to your TikTok ads.
Onsite EventApp store click rate (Onsite)
METRIC
FLOATThe percentage of app store click events out of all click events attributed to your TikTok ads.
Onsite EventTotal page views (Onsite)
METRIC
FLOATThe number of page view events on Instant Experience pages (App Profile Page, Collection Ads, Customized Instant Page, Leads Ads).
Onsite EventCost per page view (Onsite)
METRIC
FLOATThe average cost of each page view event attributed to your TikTok ads.
Onsite EventPage view rate (Onsite)
METRIC
FLOATThe percentage of page view events out of all click events attributed to your TikTok ads.
Onsite EventCall to action button clicks (Onsite)
METRIC
FLOATThe number of call-to-action button click events on Instant Experience pages (App Profile Page, Collection Ads, Customized Instant Page, Leads Ads).
Onsite EventCost per call to action button click (Onsite)
METRIC
FLOATThe average cost of each call to action button click event attributed to your TikTok ads.
Onsite EventCall to action button Click Rate (Onsite)
METRIC
FLOATThe percentage of call to action button click events out of all click events attributed to your TikTok ads.
Onsite EventTotal product clicks (Onsite)
METRIC
FLOATThe number of product click events on Instant Experience pages (App Profile Page, Collection Ads, Customized Instant Page, Leads Ads).
Onsite EventCost per product click (Onsite)
METRIC
FLOATThe average cost of each product click event attributed to your TikTok ads.
Onsite EventProduct click Rate (Onsite)
METRIC
FLOATThe percentage of product click events out of all click events attributed to your TikTok ads.
In App EventReal time app install
METRIC
INTEGERThe number of times your mobile app was installed that were recorded as app events and attributed to your ads
In App EventApp install
METRIC
INTEGERThe number of times your mobile app was installed that were recorded as app events and attributed to your ads
In App EventUnique registration
METRIC
INTEGERThe number of unique registrations in your mobile app that were recorded as app events and attributed to your ads
In App EventRegistrations events
METRIC
INTEGERRegistration (Total No.) (The total count is based on when you were billed.)
In App EventUnique purchase
METRIC
INTEGERThe number of unique purchases event occurred in your app that were recorded by your measurement partner
In App EventPurchase events
METRIC
INTEGERPurchase (Total No.) (The total count is based on when you were billed.)
In App EventTotal purchase value
METRIC
FLOATTotal Purchase Value (The total count is based on when you were billed.)
In App EventUnique add to cart
METRIC
FLOATThe number of unique times a user added items to a shopping cart in your mobile app that were recorded as app events and attributed to your ads
In App EventAdd to cart events
METRIC
INTEGERAdd to Cart (Total No.) (The total count is based on when you were billed.)
In App EventCost per Add to Cart
METRIC
FLOATCost per Add to Cart (The total count is based on when you were billed.)
In App EventTotal add to cart value
METRIC
FLOATTotal Add to Cart Value (The total count is based on when you were billed.)
In App EventUnique checkout
METRIC
FLOATThe number of unique times a user made a checkout in your mobile app that were recorded as app events and attributed to your ads
In App EventCheckout events
METRIC
INTEGERCheckout (Total No.) (The total count is based on when you were billed.)
In App EventTotal checkout value
METRIC
FLOATTotal Checkout Value (The total count is based on when you were billed.)
In App EventUnique view content
METRIC
FLOATThe number of unique times a user viewed content in your mobile app that were recorded as app events and attributed to your ads
In App EventView content events
METRIC
INTEGERView Content (Total No.) (The total count is based on when you were billed.)
In App EventCost per View Content
METRIC
FLOATCost per View Content (The total count is based on when you were billed.)
In App EventTotal view content value
METRIC
FLOATTotal View Content Value (The total count is based on when you were billed.)
In App EventUnique day 2 retention
METRIC
FLOATThe number of unique day 2 retentions in your mobile app that were recorded as app events and attributed to your ads
In App EventDay 2 retention events
METRIC
INTEGERDay 2 Retention (Total No.) (The total count is based on when you were billed.)
In App EventUnique add payment info
METRIC
FLOATThe number of unique times a user added payment info in your mobile app that were recorded as app events and attributed to your ads
In App EventAdd payment info events
METRIC
INTEGERAdd Payment Info (Total No.) (The total count is based on when you were billed.)
In App EventUnique add to wishlist
METRIC
FLOATThe number of unique times users added items to a wishlist in your mobile app that were recorded as app events and attributed to your ads
In App EventAdd to wishlist events
METRIC
INTEGERAdd to Wishlist (Total No.) (The total count is based on when you were billed.)
In App EventTotal add to wishlist value
METRIC
FLOATTotal Add to Wishlist Value (The total count is based on when you were billed.)
In App EventUnique launch app
METRIC
FLOATThe number of unique times a user launched your mobile app that were recorded as app events and attributed to your ads
In App EventLaunch app events
METRIC
INTEGERLaunch App (Total No.) (The total count is based on when you were billed.)
In App EventUnique complete tutorial
METRIC
FLOATThe number of unique times a user completed a tutorial in your mobile app that were recorded as app events and attributed to your ads
In App EventComplete tutorial events
METRIC
INTEGERComplete Tutorial (Total No.) (The total count is based on when you were billed.)
In App EventTotal complete tutorial value
METRIC
FLOATTotal Complete Tutorial Value (The total count is based on when you were billed.)
In App EventUnique create group
METRIC
FLOATThe number of unique times a user created a group in your mobile game app that were recorded as app events and attributed to your ads
In App EventCreate group events
METRIC
INTEGERCreate Group (Total No.) (The total count is based on when you were billed.)
In App EventTotal create group value
METRIC
FLOATTotal Create Group Value (The total count is based on when you were billed.)
In App EventUnique join group
METRIC
FLOATThe number of unique times a user joined a group in your mobile game app that were recorded as app events and attributed to your ads
In App EventJoin group events
METRIC
INTEGERJoin Group (Total No.) (The total count is based on when you were billed.)
In App EventTotal join group value
METRIC
FLOATTotal Join Group Value (The total count is based on when you were billed.)
In App EventUnique create role
METRIC
FLOATThe number of unique times a user created a character or role in your mobile game app that were recorded as app events and attributed to your ads
In App EventCreate role events
METRIC
INTEGERCreate Role (Total No.) (The total count is based on when you were billed.)
In App EventTotal create role value
METRIC
FLOATTotal Create Role Value (The total count is based on when you were billed.)
In App EventUnique spend credit
METRIC
FLOATThe number of unique times a user spent credit in your mobile game app that were recorded as app events and attributed to your ads
In App EventSpend credit events
METRIC
INTEGERSpend Credit (Total No.) (The total count is based on when you were billed.)
In App EventTotal spend credit value
METRIC
FLOATTotal Spend Credit Value (The total count is based on when you were billed.)
In App EventUnique achieve level
METRIC
FLOATThe number of unique times a user achieved a level in your mobile app that were recorded as app events and attributed to your ads
In App EventAchieve level events
METRIC
INTEGERAchieve Level (Total No.) (The total count is based on when you were billed.)
In App EventTotal achieve level value
METRIC
FLOATTotal Achieve Level Value (The total count is based on when you were billed.)
In App EventUnique unlock achievement
METRIC
FLOATThe number of unique times that a user unlocked an achievement in your mobile game app that were recorded as app events and attributed to your ads
In App EventUnlock achievement events
METRIC
INTEGERUnlock Achievement (Total No.) (The total count is based on when you were billed.)
In App EventTotal unlock achievement value
METRIC
FLOATTotal Unlock Achievement Value (The total count is based on when you were billed.)
In App EventUnique generate lead
METRIC
FLOATThe number of unique leads generated in your mobile app that were recorded as app events and attributed to your ads
In App EventTotal generate lead
METRIC
INTEGERGenerate lead (Total No.) (The total count is based on when you were billed.)
In App EventTotal generate lead value
METRIC
FLOATTotal generate lead value (The total count is based on when you were billed.)
In App EventUnique in app ad click
METRIC
FLOATThe number of unique in-app ad click events that occurred in your mobile app and are attributed to your ads
In App EventIn app ad clicks
METRIC
INTEGERIn App Ad Click (Total No.) (The total count is based on when you were billed.)
In App EventTotal in app ad click value
METRIC
FLOATTotal In App Ad Click Value (The total count is based on when you were billed.)
In App EventUnique in app ad impr
METRIC
FLOATThe number of unique in-app ad impression events that occurred in your mobile app and are attributed to your ads
In App EventIn app ad impressions
METRIC
INTEGERIn-app ad impressions (The total count is based on when you were billed.)
In App EventTotal in app ad impression value
METRIC
FLOATTotal in-app ad impression value (The total count is based on when you were billed.)
In App EventUnique loan apply
METRIC
FLOATThe number of unique times a user applied for a loan in your mobile app that were recorded as app events and attributed to your ads
In App EventLoan apply events
METRIC
INTEGERLoan Apply (Total No.) (The total count is based on when you were billed.)
In App EventUnique loan approval
METRIC
FLOATThe number of unique times a user was approved a loan in your mobile app that were recorded as app events and attributed to your ads
In App EventLoan approval events
METRIC
INTEGERLoan Approval (Total No.) (The total count is based on when you were billed.)
In App EventUnique loan disbursement
METRIC
FLOATThe number of unique loan disbursal in your mobile app that were recorded as app events and attributed to your ads
In App EventLoan disbursement events
METRIC
INTEGERLoan Disbursement (Total No.) (The total count is based on when you were billed.)
In App EventUnique login
METRIC
FLOATThe number of unique logins in your mobile app that were recorded as app events and attributed to your ads
In App EventLogin events
METRIC
INTEGERLogin (Total No.) (The total count is based on when you were billed.)
In App EventUnique ratings
METRIC
FLOATThe number of unique ratings in your mobile app that were recorded as app events and attributed to your ads
In App EventTotal rate
METRIC
INTEGERRate (Total No.) (The total count is based on when you were billed.)
In App EventTotal rate value
METRIC
FLOATTotal rate value (The total count is based on when you were billed.)
In App EventUnique search
METRIC
FLOATThe number of unique searches in your mobile app that were recorded as app events and attributed to your ads
In App EventSearch events
METRIC
INTEGERSearch (Total No.) (The total count is based on when you were billed.)
In App EventUnique start trial
METRIC
FLOATThe number of unique times a user started a trial in your mobile app that were recorded as app events and attributed to your ads
In App EventStart trial events
METRIC
INTEGERStart Trial (Total No.) (The total count is based on when you were billed.)
In App EventUnique subscribe
METRIC
FLOATThe number of unique subscriptions in your mobile app that were recorded as app events and attributed to your ads
In App EventSubscribe events
METRIC
INTEGERSubscribe (Total No.) (The total count is based on when you were billed.)
In App EventTotal subscribe value
METRIC
FLOATTotal Subscribe Value (The total count is based on when you were billed.)
SKAN MetricsResult (SKAN)
METRIC
INTEGERThe number of times your ad achieved an outcome, based on the optimization goal you selected
SKAN MetricsCost per result (SKAN)
METRIC
FLOATThe average cost for each result from your ads. As one campaign may have a number of different optimization goals
SKAN MetricsResult rate (SKAN)
METRIC
FLOATThe percentage of results you achieved out of all of the views/clicks on your ads
SKAN MetricsConversion (SKAN)
METRIC
INTEGERThe number of times your ad achieved an outcome based on the objective and settings you selected
SKAN MetricsCost per conversion (SKAN)
METRIC
FLOATThe average amount of money you've spent on a conversion
SKAN MetricsConversion rate (SKAN)
METRIC
FLOATThe percentage of results you received out of all the clicks of your ads
SKAN MetricsApp install (SKAN)
METRIC
INTEGERThe number of times your mobile app was installed that were recorded as app events and attributed to your ads
SKAN MetricsUnique registration (SKAN)
METRIC
INTEGERThe number of unique registrations in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsRegistration events (SKAN)
METRIC
INTEGERRegistration (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique purchase (SKAN)
METRIC
INTEGERThe number of unique purchases event occurred in your app that were recorded by your measurement partner
SKAN MetricsPurchase events (SKAN)
METRIC
INTEGERPurchase (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal purchase value (SKAN)
METRIC
FLOATTotal Purchase Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique add to cart (SKAN)
METRIC
INTEGERThe number of unique times a user added items to a shopping cart in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsAdd to cart events (SKAN)
METRIC
INTEGERAdd to Cart (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal add to cart value (SKAN)
METRIC
FLOATTotal Add to Cart Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique checkout (SKAN)
METRIC
INTEGERThe number of unique times a user made a checkout in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsCheckout events (SKAN)
METRIC
INTEGERCheckout (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal checkout value (SKAN)
METRIC
FLOATTotal Checkout Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique view content (SKAN)
METRIC
INTEGERThe number of unique times a user viewed content in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsView content events (SKAN)
METRIC
INTEGERView Content (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal view content value (SKAN)
METRIC
FLOATTotal View Content Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique add payment info (SKAN)
METRIC
INTEGERThe number of unique times a user added payment info in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsAdd payment info events (SKAN)
METRIC
INTEGERAdd Payment Info (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique add to wishlist (SKAN)
METRIC
INTEGERThe number of unique times users added items to a wishlist in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsAdd to wishlist events (SKAN)
METRIC
INTEGERAdd to Wishlist (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal add to wishlist value (SKAN)
METRIC
FLOATTotal Add to Wishlist Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique launch app (SKAN)
METRIC
INTEGERThe number of unique times a user launched your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsLaunch app events (SKAN)
METRIC
INTEGERLaunch App (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique complete tutorial (SKAN)
METRIC
INTEGERThe number of unique times a user completed a tutorial in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsComplete tutorial events (SKAN)
METRIC
INTEGERComplete Tutorial (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal complete tutorial value (SKAN)
METRIC
FLOATTotal Complete Tutorial Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique create group (SKAN)
METRIC
INTEGERThe number of unique times a user created a group in your mobile game app that were recorded as app events and attributed to your ads
SKAN MetricsCreate group events (SKAN)
METRIC
INTEGERCreate Group (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal create group value (SKAN)
METRIC
INTEGERTotal Create Group Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique join group (SKAN)
METRIC
INTEGERThe number of unique times a user joined a group in your mobile game app that were recorded as app events and attributed to your ads
SKAN MetricsJoin group events (SKAN)
METRIC
INTEGERJoin Group (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal join group value (SKAN)
METRIC
INTEGERTotal Join Group Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique create role (SKAN)
METRIC
INTEGERThe number of unique times a user created a character or role in your mobile game app that were recorded as app events and attributed to your ads
SKAN MetricsCreate role events (SKAN)
METRIC
INTEGERCreate Role (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal create role value (SKAN)
METRIC
FLOATTotal Create Role Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique spend credit (SKAN)
METRIC
INTEGERThe number of unique times a user spent credit in your mobile game app that were recorded as app events and attributed to your ads
SKAN MetricsSpend credit events (SKAN)
METRIC
INTEGERSpend Credit (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal spend credit value (SKAN)
METRIC
FLOATTotal Spend Credit Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique achieve level (SKAN)
METRIC
INTEGERThe number of unique times a user achieved a level in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsAchieve level events (SKAN)
METRIC
INTEGERAchieve Level (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal achieve level value (SKAN)
METRIC
FLOATTotal Achieve Level Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique unlock achievement (SKAN)
METRIC
INTEGERThe number of unique times that a user unlocked an achievement in your mobile game app that were recorded as app events and attributed to your ads
SKAN MetricsUnlock achievement events (SKAN)
METRIC
INTEGERUnlock Achievement (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique generate lead (SKAN)
METRIC
INTEGERThe number of unique leads generated in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsTotal generate lead events (SKAN)
METRIC
INTEGERGenerate Lead (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal generate lead value (SKAN)
METRIC
FLOATTotal Generate Lead Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique in app ad click (SKAN)
METRIC
INTEGERThe number of unique in-app ad click events that occurred in your mobile app and are attributed to your ads
SKAN MetricsIn app ad click events (SKAN)
METRIC
INTEGERIn App Ad Click (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal an app ad click value (SKAN)
METRIC
FLOATTotal In App Ad Click Value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique in app ad impr (SKAN)
METRIC
INTEGERThe number of unique in-app ad impression events that occurred in your mobile app and are attributed to your ads
SKAN MetricsIn app ad impressions events (SKAN)
METRIC
INTEGERIn-app ad impressions (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal in app ad impressions value (SKAN)
METRIC
FLOATTotal in-app ad impression value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique loan apply (SKAN)
METRIC
INTEGERThe number of unique times a user applied for a loan in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsLoan apply event (SKAN)
METRIC
INTEGERLoan Apply (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique loan approval (SKAN)
METRIC
INTEGERThe number of unique times a user was approved a loan in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsLoan approval events (SKAN)
METRIC
INTEGERLoan Approval (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique loan disbursement (SKAN)
METRIC
INTEGERThe number of unique loan disbursal in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsLoan disbursement events (SKAN)
METRIC
INTEGERLoan Disbursement (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique login (SKAN)
METRIC
INTEGERThe number of unique logins in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsLogin events (SKAN)
METRIC
INTEGERLogin (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique rate (SKAN)
METRIC
INTEGERThe number of unique ratings in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsRate events (SKAN)
METRIC
INTEGERRates (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal rate value (SKAN)
METRIC
FLOATTotal rate value. SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique search (SKAN)
METRIC
INTEGERThe number of unique searches in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsSearch events (SKAN)
METRIC
INTEGERSearch (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique start trial (SKAN)
METRIC
INTEGERThe number of unique times a user started a trial in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsStart trial events (SKAN)
METRIC
INTEGERStart Trial (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsUnique subscribe (SKAN)
METRIC
INTEGERThe number of unique subscriptions in your mobile app that were recorded as app events and attributed to your ads
SKAN MetricsSubscribe events (SKAN)
METRIC
INTEGERSubscribe (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns
SKAN MetricsTotal subscribe value (SKAN)
METRIC
FLOATTotal Subscribe Value. SKAN metrics will only display values for iOS14 dedicated campaigns
TimeYear
DIMENSION
YEARYear
TimeYear month
DIMENSION
YEARMONTHYear month
TimeYear month number
DIMENSION
YEAR_MONTH_NUMBERYear month number
TimeMonth
DIMENSION
MONTHNAMEMonth name
TimeMonth number
DIMENSION
MONTHMonth number
TimeWeek number(sun - sat)
DIMENSION
WEEK_NUMBERWeek number(sun - sat)
TimeWeek number(mon - sun)
DIMENSION
WEEK_ISO_NUMBERWeek number(mon - sun)
TimeWeek start date(sun - sat)
DIMENSION
WEEK_START_DATEStart date of the week
TimeWeek start date(mon - sun)
DIMENSION
WEEK_ISO_START_DATEStart date of the ISO week
TimeDate
DIMENSION
DATEDate
TimeHour
DIMENSION
HOURHour
AccountAccount name
DIMENSION
STRINGName of the advertiser
AccountAccount ID
DIMENSION
STRINGThe ID of the advertiser
AccountAccount status
DIMENSION
STRINGStatus of the advertiser
AccountAccount created date
DIMENSION
DATEAdvertiser created date
AccountAccount created datetime
DIMENSION
DATETIMEAdvertiser created datetime
AccountAccount type
DIMENSION
STRINGType of the ad account. Enum values: RESERVATION (reservation ad account), AUCTION(auction ad account).
AccountAccount address
DIMENSION
STRINGAddress of the advertiser company
AccountAccount company
DIMENSION
STRINGCompany name of the advertiser
AccountAccount contact person
DIMENSION
STRINGContact Person
AccountAccount country
DIMENSION
COUNTRY_CODECountry of the advertiser company
AccountAccount currency
DIMENSION
STRINGCurrency of the advertiser account
AccountAccount brand description
DIMENSION
STRINGBrand description, i.e. promotional content
AccountAccount email
DIMENSION
STRINGAdvertiser contact email, masked format. For example, d*****h@test.com
AccountAccount industry category
DIMENSION
STRINGAdvertiser Industry Category
AccountAccount language
DIMENSION
STRINGLanguage used by advertisers
AccountAccount license no
DIMENSION
STRINGLicense number of the advertiser company
AccountAccount cellphone No
DIMENSION
STRINGphone number of the advertiser
AccountAccount role
DIMENSION
STRINGRole of the advertiser
AccountAccount telephone no
DIMENSION
STRINGAdvertiser fixed phone number, desensitised data
AccountAccount timezone
DIMENSION
STRINGTime zone of the advertiser account
AccountAccount display timezone
DIMENSION
STRINGTimezone name in the format of 'Region/City'. For example, 'Europe/London'
AccountAccount balance
DIMENSION
FLOATAvailable balance of the advertiser account
CampaignCampaign name
DIMENSION
STRINGName of the campaign
CampaignCampaign ID
DIMENSION
STRINGThe ID of the campaign
CampaignCampaign status (secondary)
DIMENSION
STRINGSecondary Status of the campaign
CampaignCampaign created date
DIMENSION
DATECreation date of the campaign
CampaignCampaign updated date
DIMENSION
DATEModification date of the campaign
CampaignCampaign created datetime
DIMENSION
DATETIMECreation date and time of the campaign
CampaignCampaign updated datetime
DIMENSION
DATETIMEModification date and time of the campaign
CampaignCampaign operation status
DIMENSION
STRINGOperation Status of the campaign
CampaignCampaign type
DIMENSION
STRINGType of the campaign
CampaignCampaign budget
DIMENSION
FLOATBudget of the campaign
CampaignCampaign budget mode
DIMENSION
STRINGBudget mode of the campaign
CampaignCampaign objective
DIMENSION
STRINGObjective of the campaign
CampaignCampaign objective type
DIMENSION
STRINGWhat kind of objective for the campaign
CampaignCampaign budget optimize on
DIMENSION
STRINGWhether Campaign Budget Optimization is enabled
CampaignIs smart performance campaign
DIMENSION
BOOLEANWhether the campaign is a Smart Performance Campaign or not.
CampaignCampaign bid type
DIMENSION
STRINGBidding strategy on the campaign level
CampaignCampaign deep bid type
DIMENSION
STRINGBidding strategy for in-app events
CampaignCampaign ROAS bid
DIMENSION
FLOATROAS goal for Value Optimization
CampaignCampaign optimization goal
DIMENSION
STRINGOptimization goal
CampaignCampaign split test variables
DIMENSION
STRINGSplit Test variables. Optional values: TARGETING, BIDDING_OPTIMIZATION , CREATIVE. See Ads-Split Test-Create a Split Test-Step 1. Null means that the campaign will not be a Split Test Campaign
CampaignApp profile page status (campaign)
DIMENSION
STRINGIndicates the status of App Profile Page. Could be "INVALID"/"UNSET"/"ON"/"OFF"
Ad GroupAd group name
DIMENSION
STRINGName of the ad group
Ad GroupAd group ID
DIMENSION
STRINGThe ID of the ad group
Ad GroupAd group status (secondary)
DIMENSION
STRINGAd group Status (Secondary Status)
Ad GroupAd group created date
DIMENSION
DATEAd group created date
Ad GroupAd group created datetime
DIMENSION
DATETIMEAd group created datetime
Ad GroupAd group operation status
DIMENSION
STRINGOperation status of the ad group
Ad GroupAd group placement type
DIMENSION
STRINGPlacement type. Allowed values: PLACEMENT_TYPE_AUTOMATIC (automatic placement), PLACEMENT_TYPE_NORMAL (manual placement)
Ad GroupAd group placements
DIMENSION
STRINGPlacement location
Ad GroupIs ad group comment disabled
DIMENSION
BOOLEANWhether to allow comments on your ads on TikTok, Vigo, Helo. Enum values: 0 (allow), 1 (restrict). The default value is allow
Ad GroupIs ad group share disabled
DIMENSION
BOOLEANWhether sharing to third-party platforms is disabled for ads in this ad group
Ad GroupAd group budget
DIMENSION
FLOATBudget of the ad group
Ad GroupAd group budget mode
DIMENSION
STRINGBudget mode of the ad group
Ad GroupAd group schedule type
DIMENSION
STRINGAd schedule type values
Ad GroupAd group schedule start time
DIMENSION
DATETIMEAd delivery start time (UTC)
Ad GroupAd group schedule end time
DIMENSION
DATETIMEAd delivery end time (UTC)
Ad GroupAd group optimization goal
DIMENSION
STRINGThe optimization goal for the ad group
Ad GroupAd group CPV video duration
DIMENSION
FLOATOptimized video playback duration
Ad GroupAd group pacing
DIMENSION
FLOATSpeed of ad delivery
Ad GroupAd group bid method
DIMENSION
STRINGBilling event for the ad group
Ad GroupAd group bidding strategy
DIMENSION
STRINGvarious types of bid
Ad GroupAd group bid price
DIMENSION
FLOATThe bid price for CPC, CPM bidding or oCPM learning bidding
Ad GroupAd group conversion bid price
DIMENSION
FLOATTarget cost per conversion for oCPM (optimized cost pe mille) conversion bid
Ad GroupAd group deep bid type
DIMENSION
STRINGTikTok specific bid type tries to automatic optimization operation
Ad GroupAd group deep CPA bid
DIMENSION
FLOATdeep bid
Ad GroupAd group frequency
DIMENSION
INTEGERAd Group Frequency, together with Ad Group Frequency Schedule, controls how often people see your ad (only available for REACH ads). For example, Ad Group Frequency = 2 Ad Group Frequency Schedule = 3 means 'show ads no more than twice every 3 day'
Ad GroupAd group frequency schedule
DIMENSION
INTEGERAd Group Frequency Schedule
Ad GroupAd group statistic type
DIMENSION
STRINGConversion bid statistic type, bid for EVERYTIME (Each Purchase)/ NONE (Unique Purchase
Ad GroupIs ad group video download disabled
DIMENSION
BOOLEANWhether users can download your video ads on TikTok. Allowed values: ALLOW_DOWNLOAD ,PREVENT_DOWNLOAD Default: ALLOW_DOWNLOAD
Ad GroupBilling method (RF ad groups)
DIMENSION
STRINGBilling method of Reach & Frequency ad groups. Returned when objective_type of the related campaign is RF_REACH
Ad GroupAd group redirection type
DIMENSION
STRINGThe types of ad redirection in the catalog. Returned when the corresponding campaign objective_type is CATALOG_SALES/PRODUCT_SALES
Ad GroupAd group brand safety type
DIMENSION
STRINGBrand safety type. Currently, the only supported value is THIRD_PARTY. To get the countries and regions that your ads can be deployed to based on your brand safety settings, use the /tools/regions/ endpoint. You need to pass in the brand safety type and brand safety partner
Ad GroupAd group brand safety partner
DIMENSION
STRINGBrand safety partner. Available only when brand_safety is THIRD_PARTY. Enum values: IAS, OPEN_SLATE. To get the countries and regions that your ads can be deployed to based on your brand safety settings, use the /tools/regions/ endpoint. You need to pass in the brand safety type and brand safety partner
Ad GroupAd group promotion website type
DIMENSION
STRINGInstant page type in your ad group. Currently, the only supported type is TIKTOK_NATIVE_PAGE, which stands for TikTok instant pages. null means no instant pages are used in the ad group
Ad GroupAd group ios quota type
DIMENSION
STRINGROAS goal for Value Optimization
Ad GroupAd group ROAS bid
DIMENSION
STRINGROAS goal for Value Optimization
Ad GroupApp profile page state (ad group)
DIMENSION
STRINGIndicates whether the ad group is using app profile page. Enum: INVALID, UNSET, ON, OFF
AdAd name
DIMENSION
STRINGName of the ad
AdAd ID
DIMENSION
STRINGThe ID of the ad
AdAd status (secondary)
DIMENSION
STRINGThe status of the ad
AdAd operation status
DIMENSION
STRINGOperation status, values include: DISABLE, ENABLE
AdAd created date
DIMENSION
DATEAd created date
AdAd updated date
DIMENSION
DATEAd modified date
AdAd created datetime
DIMENSION
DATETIMEAd created datetime
AdAd updated datetime
DIMENSION
DATETIMEAd modified datetime
AdAd identity ID
DIMENSION
STRINGThe Identity ID of the ad
AdAd identity type
DIMENSION
STRINGIdentity type. Enum: CUSTOMIZED_USER, AUTH_CODE, TT_USER
AdAd call to action
DIMENSION
STRINGThe call-to-action (CTA) text
AdAd card ID
DIMENSION
INTEGERImage card ID, gift code card ID, or premium badge ID
AdIs automated ad
DIMENSION
BOOLEANWhether the ad is an automated ad
AdAd image mode
DIMENSION
STRINGImage Mode of the Ad
AdAd format
DIMENSION
STRINGCreative Type of the ad
AdAd text
DIMENSION
STRINGText of the ad
AdAd landing page url
DIMENSION
URLLanding page url
AdAd display name
DIMENSION
STRINGThe display name of landing page or pure exposure ad
AdAd profile image url
DIMENSION
IMAGE_URLAvatar url
AdAd display monitoring url
DIMENSION
URLDisplay monitoring url
AdAd click monitoring url
DIMENSION
URLClick monitoring url
AdAd open url
DIMENSION
URLThe specific location where you want your audience to go if they have your app installed
AdAd open url type
DIMENSION
STRINGThe open URL type
AdAd fallback type
DIMENSION
STRINGIf the audience do not have the app installed, you can have them fall back to install the app, or to view a specific web page
AdAd playable material url
DIMENSION
URLPlayable material url
AdAd moat viewability verification
DIMENSION
BOOLEANWhether Moat Viewability Verification is enabled for the ad. TikTok has partnered with Moat to launch viewability measurement for Brand Auction and Reach & Frequency In-feed ads purchased on TikTok for Business
AdIs ad creative authorized
DIMENSION
BOOLEANWhether you grant displaying some of your ads in our TikTok For Business Creative Center. Only valid for non-US advertisers
AdAd DPA fallback type
DIMENSION
STRINGIn DPA scenario, the fallback behavior of deeplink evokes failed. Return when the corresponding campaign objective_type is CATALOG_SALES
AdAd DPA open url type
DIMENSION
STRINGIndicates the source of the direct link used in the ad. This field is returned when the corresponding campaign objective_type is CATALOG_SALES
AdAd DPA video template ID
DIMENSION
STRINGThe Catalog video template ID. Return when the corresponding campaign objective_type is CATALOG_SALES
AdAd promotional music status
DIMENSION
BOOLEANWhether to disable the promotional use of the music in the Spark Ad post. The default value is true. If you want to allow dueting and stitching for the Spark Ad post, you need to set this field to false. This field is only valid for Spark Ad posts.
AdAd dark post status
DIMENSION
STRINGIndicates whether the ad is a Spark Ads dark post. Value can be ON or OFF
AdAd branded content status
DIMENSION
BOOLEANDefault is false. If branded_content_disabled is true, you cannot modify dark_post_status
AdAd item duet status
DIMENSION
STRINGWhether to enable dueting for the Spark Ad post. This field is valid only when promotional_music_disabled is set to false. Enum values: ENABLE, DISABLE. This field is only valid for Spark Ad posts
AdAd item stitch status
DIMENSION
STRINGWhether to enable stitching for the Spark Ad post. This field is valid only when promotional_music_disabled is set to false. Enum values: ENABLE, DISABLE. This field is only valid for Spark Ad posts
AdAd brand safety post bid measurement partner
DIMENSION
STRINGBrand safety post bid measurement partner. Enumerations: Zefr
VideoVideo ID
DIMENSION
STRINGThe ID of the video used to create ad in ad delivery
VideoVideo preview url
DIMENSION
URLVideo preview link, valid for an hour and needs to be re-acquired after expiration
VideoVideo thumbnail url
DIMENSION
IMAGE_URLVideo cover, valid for an hour and needs to be re-acquired after expiration
VideoVideo file name
DIMENSION
STRINGVideo name
VideoVideo format
DIMENSION
STRINGVideo format
VideoVideo size
DIMENSION
INTEGERVideo size, in Bytes
VideoVideo duration
DIMENSION
FLOATVideo duration, in Seconds
VideoVideo bit rate
DIMENSION
INTEGERVideo Bit Rate, in bps
VideoVideo height
DIMENSION
INTEGERVideo Height
VideoVideo width
DIMENSION
INTEGERVideo Width
VideoIs video displayable
DIMENSION
BOOLEANWhether it can be displayed on the platform
VideoIs video downloadable
DIMENSION
BOOLEANDue to the music copyright, some materials generated by creative tools are only allowed to preview. It is prohibited to download and disseminate them
VideoAvailable video placements
DIMENSION
ARRAYDue to the music copyright, some materials generated by creative tools can only be shown on TikTok. It won't pass when they are created on other placements
VideoVideo created date
DIMENSION
DATEVideo created date
VideoVideo modified date
DIMENSION
DATEVideo modified date
VideoVideo modified datetime
DIMENSION
DATETIMEVideo modified datetime
VideoVideo modified datetime
DIMENSION
DATETIMEVideo modified datetime
AudienceGender
DIMENSION
STRINGgender of Audience
AudienceAge
DIMENSION
STRINGAge of Audience
AudienceCountry code
DIMENSION
COUNTRY_CODECountry code
AudienceCountry
DIMENSION
COUNTRYThe country of the requested insights
AudienceRegion
DIMENSION
REGIONRegion
AudienceLanguage
DIMENSION
STRINGLanguage
AudienceDevice platform
DIMENSION
STRINGReports the OS platform that received impressions of your ads (iOS, Android, etc.)
AudiencePlacement
DIMENSION
STRINGReports the apps that were served impressions of your ads
AudienceInterest category
DIMENSION
STRINGInterest category
AudienceDMA ID
DIMENSION
INTEGERDesignated Market Area (DMA) ID. Only U.S. has DMAs
AudienceDMA name
DIMENSION
STRINGDesignated Market Area (DMA) name. Only U.S. has DMAs
ConversionAd group pixel ID
DIMENSION
STRINGThe ID of the conversion pixel
ConversionAd group optimization event
DIMENSION
STRINGConversion event for the ad group
ConversionAd group secondary optimization event
DIMENSION
STRINGThe secondary goal when optimization_goal is INSTALL or VALUE
TargetingAudience rule
DIMENSION
STRINGAudience targeting inclusion and exclusion rules
TargetingAudience type
DIMENSION
STRINGAudience type values: CUSTOM_AUDIENCE (Customize your audience), EXCLUDE_INTERACT_USERS (Exclude audience who have interacted with your App), INCLUDE_INTERACT_USERS (Include audience who have interacted with your App), INCLUDE_SPECIFIC_EVENTS (Include audience who satisfy specific audience_rule), EXCLUDE_SPECIFIC_EVENTS (Exclude audience who satisfy specific audience_rule)
TargetingAd group target age groups
DIMENSION
STRINGList of targeted age groups
TargetingAd group target gender
DIMENSION
STRINGTargeted gender
TargetingAd group target language
DIMENSION
STRINGList of targeted languages
TargetingAd group target OS
DIMENSION
STRINGList of targeted operating systems
TargetingAd group target network types
DIMENSION
STRINGList of targeted network types
TargetingAd group target device price ranges
DIMENSION
STRINGTargeted device price in USD, for example: [0,300] represents price range is from $0 to $300
TargetingAd group target min android version
DIMENSION
STRINGTargeted audience minimum Android version
TargetingAd group target min ios version
DIMENSION
STRINGTargeted audience minimum iOS version
TargetingIs ad group auto targeting enabled
DIMENSION
BOOLEANWhether automated targeting is turned on. Enum values: ON, OFF