Facebook Ads
Google Ads
Shopify
Google Analytics 4
Tiktok Ads
Linkedin Ads
Amazon Ads
Klaviyo
Microsoft/Bing Ads
Snapchat Ads
Instagram Insights
Google Search Console
Facebook Insights
Amazon Seller
WooCommerce
Pinterest Ads
Google My Business
YouTube Analytics
Google Trends
Apple Search Ads
HubSpot
Twitter AdsTiktok Ads Metrics and Dimensions
Field group | Field | Type | Data type | Description |
|---|---|---|---|---|
| Performance | Amount spent | METRIC | FLOAT | The estimated total amount of money you've spent on your campaign, ad group or ad during its schedule |
| Performance | Impressions | METRIC | INTEGER | The number of times your ads were on screen |
| Performance | Gross impressions | METRIC | FLOAT | The number of times an ad was seen on screen, including invalid impressions. |
| Performance | Clicks | METRIC | INTEGER | The number of clicks on your ads |
| Performance | CPC | METRIC | FLOAT | The average amount of money you have spent on a click |
| Performance | CPM | METRIC | FLOAT | The average amount of money you have spent per 1,000 impressions |
| Performance | CTR | METRIC | FLOAT | The percentage of times people saw your ad and performed a click |
| Reach | Reach | METRIC | INTEGER | The number of unique users who saw your ads at least once. This metric is estimated |
| Reach | Cost per 1,000 people reached | METRIC | FLOAT | The average cost to reach 1,000 unique users. This metric is estimated |
| Reach | Frequency | METRIC | FLOAT | The average number of times each person saw your ad. |
| Video | Video views | METRIC | INTEGER | The number of times your video starts to play. Replays will not be counted |
| Video | 2-second video views | METRIC | INTEGER | The number of times your video played for at least 2 seconds. Replays will not be counted |
| Video | 6-second video views | METRIC | INTEGER | The number of times your video played for at least 6 seconds. Replays will not be counted |
| Video | Video views at 25% | METRIC | INTEGER | The number of times your video was played at 25% of its length. Replays will not be counted |
| Video | Video views at 50% | METRIC | INTEGER | The number of times your video was played at 50% of its length. Replays will not be counted |
| Video | Video views at 75% | METRIC | INTEGER | The number of times your video was played at 75% of its length. Replays will not be counted |
| Video | Video views at 100% | METRIC | INTEGER | The number of times your video was played at 100% of its length. Replays will not be counted |
| Video | Avg video watch time per video view | METRIC | FLOAT | The average time your video was played per single video view, including any time spent replaying the video. |
| Video | Avg video watch time per person | METRIC | FLOAT | The average time your video was played per single person, including any time spent replaying the video. |
| Video | Focused views (6sec) | METRIC | INTEGER | The 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. |
| Video | Focused views (15sec) | METRIC | INTEGER | The 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. |
| Live | LIVE Views | METRIC | INTEGER | The number of times viewers visited your LIVE. Revisits will be counted. |
| Live | LIVE Unique Views | METRIC | INTEGER | The number of unique viewers who entered your LIVE. |
| Live | Effective LIVE Views | METRIC | INTEGER | The number of times viewers visited your LIVE for more than 10 seconds. Revisits will be counted. |
| Live | LIVE Product Clicks | METRIC | INTEGER | The number of time viewers clicked a product and viewed its details page during your LIVE. |
| Engagement | Total engagement | METRIC | INTEGER | The 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. |
| Engagement | Engagement rate | METRIC | FLOAT | The engagement rate is the number of engagements that your ad receives divided by the number of times your ad is shown. |
| Engagement | Profile visits | METRIC | INTEGER | The number of profile visits the ad drove during the campaign |
| Engagement | Profile visits rate | METRIC | RATIO | The rate of profile visits per impression the paid ad drove during the campaign. This metric is only for Spark Ads. |
| Engagement | Paid likes | METRIC | INTEGER | The total amount of likes the ad received during the campaign |
| Engagement | Paid comments | METRIC | INTEGER | The number of comments the ad received during the campaign |
| Engagement | Paid shares | METRIC | INTEGER | The number of shares the ad received during the campaign |
| Engagement | Paid follows | METRIC | INTEGER | The number of new followers that were gained within 1 day of a user seeing a paid ad |
| Engagement | Clicks on music disc | METRIC | INTEGER | The number of clicks on the official music in your Spard Ads during the campaign. |
| Engagement | Duet clicks | METRIC | INTEGER | The numbers of clicks on the "Duet" button. |
| Engagement | Stitch clicks | METRIC | INTEGER | The numbers of clicks on the "Stitch" button. |
| Engagement | Sound usage clicks | METRIC | INTEGER | The numbers of clicks on the "Use this sound" button. |
| Engagement | Anchor clicks | METRIC | INTEGER | The number of clicks on all anchors. |
| Engagement | Anchor click rate | METRIC | FLOAT | The percentage of times viewers performed a click after seeing an anchor. |
| Engagement | Clicks on hashtag challenge | METRIC | INTEGER | The total amount of clicks on your ad's hashtag challenge during the campaign. |
| Engagement | Instant experience avg view time | METRIC | INTEGER | The average total time that people spent viewing an Instant Experience. |
| Engagement | Instant experience avg view % | METRIC | INTEGER | The average percentage of the Instant Experience that people viewed. |
| Conversion | Conversions | METRIC | INTEGER | The 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 |
| Conversion | Cost per conversion | METRIC | FLOAT | The average amount of money you have spent on a conversion (CPA). Calculated based on the time each ad impression occurred |
| Conversion | Conversion rate | METRIC | FLOAT | The percentage of results you received out of all the clicks of your ads. Calculated based on the time each ad impression occurred |
| Conversion | Real time conversions | METRIC | INTEGER | The 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 |
| Conversion | Cost per real time conversion | METRIC | FLOAT | The average amount of money you have spent on a real-time conversion (Real-time CPA). Calculated based on when the conversion actually happened |
| Conversion | Real time conversion rate | METRIC | FLOAT | The percentage of real-time conversions you received out of all the clicks of your ads. Calculated based on when the conversion actually happened |
| Result | Results | METRIC | INTEGER | The 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 |
| Result | Cost per result | METRIC | FLOAT | The average cost for each result from your ads. Calculated based on the time each ad impression occurred |
| Result | Result rate | METRIC | FLOAT | The percentage of results you achieved out of all of the views/clicks on your ads. Calculated based on the time each ad impression occurred |
| Result | Real time results | METRIC | INTEGER | The 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 |
| Result | Cost per real time result | METRIC | FLOAT | The average cost for each real-time result from your ads. Calculated based on when the conversion actually happened |
| Result | Real time result rate | METRIC | FLOAT | The 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 Result | Secondary goal result | METRIC | INTEGER | The 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 Result | Cost per secondary goal result | METRIC | FLOAT | The 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 Result | Secondary goal result rate | METRIC | FLOAT | The 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 |
| Attribution | VTA conversions | METRIC | INTEGER | The percentage of app install events you received out of all the clicks of your ads |
| Attribution | VTA registrations | METRIC | INTEGER | The number of registration event that attribute to impression, based on information received from your measurement partner |
| Attribution | VTA purchases | METRIC | INTEGER | The number of in-app payment event that attribute to impression, based on information received from your measurement partner |
| Attribution | CTA conversions | METRIC | INTEGER | The number of in-app app install event that occurred on your mobile app and are attributed to the amount of clicks |
| Attribution | CTA registrations | METRIC | INTEGER | The number of in-app registration event that attribute to click, based on information received from your measurement partner |
| Attribution | CTA purchases | METRIC | INTEGER | The number of in-app payment event that attribute to click, based on information received from your measurement partner |
| Page Event | Complete payment ROAS | METRIC | FLOAT | The total return on ad spend (ROAS) from complete payment events that are attributed to your ads |
| Page Event | Complete payment | METRIC | FLOAT | The number of complete payment events |
| Page Event | Cost per Complete Payment | METRIC | FLOAT | The average cost of each complete payment event. |
| Page Event | Total complete payment Value | METRIC | FLOAT | The total value returned from complete payment events |
| Page Event | Landing page views | METRIC | FLOAT | The number of landing page view events from your ads |
| Page Event | Page browse | METRIC | FLOAT | The number of page browse events |
| Page Event | Button click | METRIC | FLOAT | The number of button click events |
| Page Event | Total button click value | METRIC | FLOAT | The total value returned from button click events |
| Page Event | Online consultation | METRIC | FLOAT | The number of online consultation events |
| Page Event | Total online consultation | METRIC | FLOAT | The total value returned from online consultation events |
| Page Event | User registration | METRIC | FLOAT | The number of user registration events |
| Page Event | Total user registration value | METRIC | FLOAT | The total value returned from user registration events |
| Page Event | Product details page browse | METRIC | FLOAT | The number of product details page browse events |
| Page Event | Total product details page browse value | METRIC | FLOAT | The total value returned from product details page browse events |
| Page Event | Add to cart | METRIC | FLOAT | The number of add to cart events |
| Page Event | Total add to cart value | METRIC | FLOAT | The total value returned from add to cart events |
| Page Event | Place an order | METRIC | FLOAT | The number of place an order events |
| Page Event | Total place an order value | METRIC | FLOAT | The total value returned from place an order events |
| Page Event | Initiate checkout | METRIC | FLOAT | The number of initiate checkout events |
| Page Event | Total initiate checkout value | METRIC | FLOAT | The total value returned from initiate checkout events |
| Page Event | Add billing | METRIC | FLOAT | The number of add billing events |
| Page Event | Total add billing value | METRIC | FLOAT | The total value returned from add billing events |
| Page Event | Search | METRIC | FLOAT | The number of search events |
| Page Event | Total search value | METRIC | FLOAT | The total value returned from search events |
| Page Event | Form submission | METRIC | FLOAT | The number of form submission events |
| Page Event | Total form submission | METRIC | FLOAT | The total value returned from form submission events |
| Page Event | Download button click | METRIC | FLOAT | The number of download button click events |
| Page Event | Total download button click value | METRIC | FLOAT | The total value returned from download button click events |
| Page Event | Download button click cost | METRIC | FLOAT | The average cost of each download button click events |
| Page Event | Total add to wishlist | METRIC | INTEGER | Total Add to Wishlist |
| Page Event | Total subscribe | METRIC | INTEGER | Total Subscribe |
| Onsite Event | Complete payment ROAS (Onsite) | METRIC | FLOAT | The total return on ad spend (ROAS) from complete payment events that are attributed to your ads on TikTok Store. |
| Onsite Event | Complete payment (Onsite) | METRIC | FLOAT | The number of complete payment events on TikTok Store. |
| Onsite Event | Cost per complete payment (Onsite) | METRIC | FLOAT | The average cost of each 'Complete Payment' event attributed to your TikTok ads. |
| Onsite Event | Complete payment rate (Onsite) | METRIC | FLOAT | The percentage of 'Complete Payment' events out of all click events attributed to your TikTok ads. |
| Onsite Event | Value per complete payment (Onsite) | METRIC | FLOAT | The average value returned from each 'Complete Payment' event attributed to your TikTok ads. |
| Onsite Event | Total complete payment value (Onsite) | METRIC | FLOAT | The total value returned from 'Complete Payment' events attributed to your TikTok ads. |
| Onsite Event | Initiate checkout (Onsite) | METRIC | FLOAT | The number of initiate checkout events on TikTok Store. |
| Onsite Event | Cost per initiate checkout (Onsite) | METRIC | FLOAT | The average cost of each 'Initiate Checkout' event attributed to your TikTok ads. |
| Onsite Event | Initiate checkout rate (Onsite) | METRIC | FLOAT | The percentage of 'Initiate Checkout' events out of all click events attributed to your TikTok ads. |
| Onsite Event | Value per initiate checkout (Onsite) | METRIC | FLOAT | The average value returned from each 'Initiate Checkout' event attributed to your TikTok ads. |
| Onsite Event | Total initiate checkout value (Onsite) | METRIC | FLOAT | The total value returned from 'Initiate Checkout' events attributed to your TikTok ads. |
| Onsite Event | Product details page view (Onsite) | METRIC | FLOAT | The number of product details page view events on TikTok Store. |
| Onsite Event | Cost per product details page view (Onsite) | METRIC | FLOAT | The average cost of each product detail page (PDP) view event attributed to your TikTok ads. |
| Onsite Event | Product details page view rate (Onsite) | METRIC | FLOAT | The percentage of product detail page (PDP) view events out of all click events attributed to your TikTok ads. |
| Onsite Event | Value per product details page view (Onsite) | METRIC | FLOAT | The average value returned from each product detail page (PDP) event attributed to your TikTok ads. |
| Onsite Event | Total product details page view value (Onsite) | METRIC | FLOAT | The total value returned from product detail page (PDP) view events attributed to your TikTok ads. |
| Onsite Event | Add to wishlist (Onsite) | METRIC | FLOAT | The number of add to wishlist events on TikTok Store. |
| Onsite Event | Cost per add To wishlist (Onsite) | METRIC | FLOAT | The average cost of each 'Add to Wishlist' event attributed to your TikTok ads. |
| Onsite Event | Add to wishlist rate (Onsite) | METRIC | FLOAT | The percentage of 'Add to Wishlist' events out of all click events attributed to your TikTok ads. |
| Onsite Event | Value per add to wishlist (Onsite) | METRIC | FLOAT | The average value returned from each 'Add to Wishlist' event attributed to your TikTok ads. |
| Onsite Event | Total add to wishlist value (Onsite) | METRIC | FLOAT | The total value returned from 'Add to Wishlist' events attributed to your TikTok ads. |
| Onsite Event | Add billing (Onsite) | METRIC | FLOAT | The number of add billing events on TikTok Store. |
| Onsite Event | Cost per add billing (Onsite) | METRIC | FLOAT | The average cost of each 'Add Billing' event attributed to your TikTok ads. |
| Onsite Event | Add billing rate (Onsite) | METRIC | FLOAT | The percentage of 'Add Billing' events out of all click events attributed to your TikTok ads. |
| Onsite Event | Value per add billing (Onsite) | METRIC | FLOAT | The average value returned from each 'Add Billing' event attributed to your TikTok ads. |
| Onsite Event | Total add billing value (Onsite) | METRIC | FLOAT | The total value returned from 'Add Billing' events attributed to your TikTok ads. |
| Onsite Event | Add to cart (Onsite) | METRIC | FLOAT | The number of add to cart events on TikTok Store. |
| Onsite Event | Cost per add to cart (Onsite) | METRIC | FLOAT | The average cost of each 'Add to Cart' event attributed to your TikTok ads. |
| Onsite Event | Add to cart rate (Onsite) | METRIC | FLOAT | The percentage of 'Add to Cart' events out of all click events attributed to your TikTok ads. |
| Onsite Event | Value per add to cart (Onsite) | METRIC | FLOAT | The average value returned from each 'Add to Cart' event attributed to your TikTok ads. |
| Onsite Event | Total add to cart value (Onsite) | METRIC | FLOAT | The total value returned from 'Add to Cart' events attributed to your TikTok ads. |
| Onsite Event | Form submission (Onsite) | METRIC | FLOAT | The number of form submission events on Leads Generation page. |
| Onsite Event | Cost per form submission (Onsite) | METRIC | FLOAT | The average cost of each form submission event attributed to your TikTok ads. |
| Onsite Event | Form submission rate (Onsite) | METRIC | FLOAT | The percentage of form submission events out of all click events attributed to your TikTok ads. |
| Onsite Event | Value per form submission (Onsite) | METRIC | FLOAT | The average value returned from each form submission event attributed to your TikTok ads. |
| Onsite Event | Total form submission value (Onsite) | METRIC | FLOAT | The total value returned from form submission events attributed to your TikTok ads. |
| Onsite Event | App store click (Onsite) | METRIC | FLOAT | The number of app store click events on App Profile Page. |
| Onsite Event | Cost per app store click (Onsite) | METRIC | FLOAT | The average cost of each app store click event attributed to your TikTok ads. |
| Onsite Event | App store click rate (Onsite) | METRIC | FLOAT | The percentage of app store click events out of all click events attributed to your TikTok ads. |
| Onsite Event | Total page views (Onsite) | METRIC | FLOAT | The number of page view events on Instant Experience pages (App Profile Page, Collection Ads, Customized Instant Page, Leads Ads). |
| Onsite Event | Cost per page view (Onsite) | METRIC | FLOAT | The average cost of each page view event attributed to your TikTok ads. |
| Onsite Event | Page view rate (Onsite) | METRIC | FLOAT | The percentage of page view events out of all click events attributed to your TikTok ads. |
| Onsite Event | Call to action button clicks (Onsite) | METRIC | FLOAT | The number of call-to-action button click events on Instant Experience pages (App Profile Page, Collection Ads, Customized Instant Page, Leads Ads). |
| Onsite Event | Cost per call to action button click (Onsite) | METRIC | FLOAT | The average cost of each call to action button click event attributed to your TikTok ads. |
| Onsite Event | Call to action button Click Rate (Onsite) | METRIC | FLOAT | The percentage of call to action button click events out of all click events attributed to your TikTok ads. |
| Onsite Event | Total product clicks (Onsite) | METRIC | FLOAT | The number of product click events on Instant Experience pages (App Profile Page, Collection Ads, Customized Instant Page, Leads Ads). |
| Onsite Event | Cost per product click (Onsite) | METRIC | FLOAT | The average cost of each product click event attributed to your TikTok ads. |
| Onsite Event | Product click Rate (Onsite) | METRIC | FLOAT | The percentage of product click events out of all click events attributed to your TikTok ads. |
| In App Event | Real time app install | METRIC | INTEGER | The number of times your mobile app was installed that were recorded as app events and attributed to your ads |
| In App Event | App install | METRIC | INTEGER | The number of times your mobile app was installed that were recorded as app events and attributed to your ads |
| In App Event | Unique registration | METRIC | INTEGER | The number of unique registrations in your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Registrations events | METRIC | INTEGER | Registration (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique purchase | METRIC | INTEGER | The number of unique purchases event occurred in your app that were recorded by your measurement partner |
| In App Event | Purchase events | METRIC | INTEGER | Purchase (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total purchase value | METRIC | FLOAT | Total Purchase Value (The total count is based on when you were billed.) |
| In App Event | Unique add to cart | METRIC | FLOAT | The 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 Event | Add to cart events | METRIC | INTEGER | Add to Cart (Total No.) (The total count is based on when you were billed.) |
| In App Event | Cost per Add to Cart | METRIC | FLOAT | Cost per Add to Cart (The total count is based on when you were billed.) |
| In App Event | Total add to cart value | METRIC | FLOAT | Total Add to Cart Value (The total count is based on when you were billed.) |
| In App Event | Unique checkout | METRIC | FLOAT | The 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 Event | Checkout events | METRIC | INTEGER | Checkout (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total checkout value | METRIC | FLOAT | Total Checkout Value (The total count is based on when you were billed.) |
| In App Event | Unique view content | METRIC | FLOAT | The 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 Event | View content events | METRIC | INTEGER | View Content (Total No.) (The total count is based on when you were billed.) |
| In App Event | Cost per View Content | METRIC | FLOAT | Cost per View Content (The total count is based on when you were billed.) |
| In App Event | Total view content value | METRIC | FLOAT | Total View Content Value (The total count is based on when you were billed.) |
| In App Event | Unique day 2 retention | METRIC | FLOAT | The number of unique day 2 retentions in your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Day 2 retention events | METRIC | INTEGER | Day 2 Retention (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique add payment info | METRIC | FLOAT | The 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 Event | Add payment info events | METRIC | INTEGER | Add Payment Info (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique add to wishlist | METRIC | FLOAT | The 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 Event | Add to wishlist events | METRIC | INTEGER | Add to Wishlist (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total add to wishlist value | METRIC | FLOAT | Total Add to Wishlist Value (The total count is based on when you were billed.) |
| In App Event | Unique launch app | METRIC | FLOAT | The number of unique times a user launched your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Launch app events | METRIC | INTEGER | Launch App (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique complete tutorial | METRIC | FLOAT | The 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 Event | Complete tutorial events | METRIC | INTEGER | Complete Tutorial (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total complete tutorial value | METRIC | FLOAT | Total Complete Tutorial Value (The total count is based on when you were billed.) |
| In App Event | Unique create group | METRIC | FLOAT | The 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 Event | Create group events | METRIC | INTEGER | Create Group (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total create group value | METRIC | FLOAT | Total Create Group Value (The total count is based on when you were billed.) |
| In App Event | Unique join group | METRIC | FLOAT | The 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 Event | Join group events | METRIC | INTEGER | Join Group (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total join group value | METRIC | FLOAT | Total Join Group Value (The total count is based on when you were billed.) |
| In App Event | Unique create role | METRIC | FLOAT | The 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 Event | Create role events | METRIC | INTEGER | Create Role (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total create role value | METRIC | FLOAT | Total Create Role Value (The total count is based on when you were billed.) |
| In App Event | Unique spend credit | METRIC | FLOAT | The 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 Event | Spend credit events | METRIC | INTEGER | Spend Credit (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total spend credit value | METRIC | FLOAT | Total Spend Credit Value (The total count is based on when you were billed.) |
| In App Event | Unique achieve level | METRIC | FLOAT | The 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 Event | Achieve level events | METRIC | INTEGER | Achieve Level (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total achieve level value | METRIC | FLOAT | Total Achieve Level Value (The total count is based on when you were billed.) |
| In App Event | Unique unlock achievement | METRIC | FLOAT | The 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 Event | Unlock achievement events | METRIC | INTEGER | Unlock Achievement (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total unlock achievement value | METRIC | FLOAT | Total Unlock Achievement Value (The total count is based on when you were billed.) |
| In App Event | Unique generate lead | METRIC | FLOAT | The number of unique leads generated in your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Total generate lead | METRIC | INTEGER | Generate lead (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total generate lead value | METRIC | FLOAT | Total generate lead value (The total count is based on when you were billed.) |
| In App Event | Unique in app ad click | METRIC | FLOAT | The number of unique in-app ad click events that occurred in your mobile app and are attributed to your ads |
| In App Event | In app ad clicks | METRIC | INTEGER | In App Ad Click (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total in app ad click value | METRIC | FLOAT | Total In App Ad Click Value (The total count is based on when you were billed.) |
| In App Event | Unique in app ad impr | METRIC | FLOAT | The number of unique in-app ad impression events that occurred in your mobile app and are attributed to your ads |
| In App Event | In app ad impressions | METRIC | INTEGER | In-app ad impressions (The total count is based on when you were billed.) |
| In App Event | Total in app ad impression value | METRIC | FLOAT | Total in-app ad impression value (The total count is based on when you were billed.) |
| In App Event | Unique loan apply | METRIC | FLOAT | The 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 Event | Loan apply events | METRIC | INTEGER | Loan Apply (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique loan approval | METRIC | FLOAT | The 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 Event | Loan approval events | METRIC | INTEGER | Loan Approval (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique loan disbursement | METRIC | FLOAT | The number of unique loan disbursal in your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Loan disbursement events | METRIC | INTEGER | Loan Disbursement (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique login | METRIC | FLOAT | The number of unique logins in your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Login events | METRIC | INTEGER | Login (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique ratings | METRIC | FLOAT | The number of unique ratings in your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Total rate | METRIC | INTEGER | Rate (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total rate value | METRIC | FLOAT | Total rate value (The total count is based on when you were billed.) |
| In App Event | Unique search | METRIC | FLOAT | The number of unique searches in your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Search events | METRIC | INTEGER | Search (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique start trial | METRIC | FLOAT | The 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 Event | Start trial events | METRIC | INTEGER | Start Trial (Total No.) (The total count is based on when you were billed.) |
| In App Event | Unique subscribe | METRIC | FLOAT | The number of unique subscriptions in your mobile app that were recorded as app events and attributed to your ads |
| In App Event | Subscribe events | METRIC | INTEGER | Subscribe (Total No.) (The total count is based on when you were billed.) |
| In App Event | Total subscribe value | METRIC | FLOAT | Total Subscribe Value (The total count is based on when you were billed.) |
| SKAN Metrics | Result (SKAN) | METRIC | INTEGER | The number of times your ad achieved an outcome, based on the optimization goal you selected |
| SKAN Metrics | Cost per result (SKAN) | METRIC | FLOAT | The average cost for each result from your ads. As one campaign may have a number of different optimization goals |
| SKAN Metrics | Result rate (SKAN) | METRIC | FLOAT | The percentage of results you achieved out of all of the views/clicks on your ads |
| SKAN Metrics | Conversion (SKAN) | METRIC | INTEGER | The number of times your ad achieved an outcome based on the objective and settings you selected |
| SKAN Metrics | Cost per conversion (SKAN) | METRIC | FLOAT | The average amount of money you've spent on a conversion |
| SKAN Metrics | Conversion rate (SKAN) | METRIC | FLOAT | The percentage of results you received out of all the clicks of your ads |
| SKAN Metrics | App install (SKAN) | METRIC | INTEGER | The number of times your mobile app was installed that were recorded as app events and attributed to your ads |
| SKAN Metrics | Unique registration (SKAN) | METRIC | INTEGER | The number of unique registrations in your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | Registration events (SKAN) | METRIC | INTEGER | Registration (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique purchase (SKAN) | METRIC | INTEGER | The number of unique purchases event occurred in your app that were recorded by your measurement partner |
| SKAN Metrics | Purchase events (SKAN) | METRIC | INTEGER | Purchase (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total purchase value (SKAN) | METRIC | FLOAT | Total Purchase Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique add to cart (SKAN) | METRIC | INTEGER | The 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 Metrics | Add to cart events (SKAN) | METRIC | INTEGER | Add to Cart (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total add to cart value (SKAN) | METRIC | FLOAT | Total Add to Cart Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique checkout (SKAN) | METRIC | INTEGER | The 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 Metrics | Checkout events (SKAN) | METRIC | INTEGER | Checkout (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total checkout value (SKAN) | METRIC | FLOAT | Total Checkout Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique view content (SKAN) | METRIC | INTEGER | The number of unique times a user viewed content in your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | View content events (SKAN) | METRIC | INTEGER | View Content (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total view content value (SKAN) | METRIC | FLOAT | Total View Content Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique add payment info (SKAN) | METRIC | INTEGER | The 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 Metrics | Add payment info events (SKAN) | METRIC | INTEGER | Add Payment Info (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique add to wishlist (SKAN) | METRIC | INTEGER | The 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 Metrics | Add to wishlist events (SKAN) | METRIC | INTEGER | Add to Wishlist (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total add to wishlist value (SKAN) | METRIC | FLOAT | Total Add to Wishlist Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique launch app (SKAN) | METRIC | INTEGER | The number of unique times a user launched your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | Launch app events (SKAN) | METRIC | INTEGER | Launch App (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique complete tutorial (SKAN) | METRIC | INTEGER | The 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 Metrics | Complete tutorial events (SKAN) | METRIC | INTEGER | Complete Tutorial (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total complete tutorial value (SKAN) | METRIC | FLOAT | Total Complete Tutorial Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique create group (SKAN) | METRIC | INTEGER | The 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 Metrics | Create group events (SKAN) | METRIC | INTEGER | Create Group (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total create group value (SKAN) | METRIC | INTEGER | Total Create Group Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique join group (SKAN) | METRIC | INTEGER | The 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 Metrics | Join group events (SKAN) | METRIC | INTEGER | Join Group (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total join group value (SKAN) | METRIC | INTEGER | Total Join Group Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique create role (SKAN) | METRIC | INTEGER | The 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 Metrics | Create role events (SKAN) | METRIC | INTEGER | Create Role (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total create role value (SKAN) | METRIC | FLOAT | Total Create Role Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique spend credit (SKAN) | METRIC | INTEGER | The 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 Metrics | Spend credit events (SKAN) | METRIC | INTEGER | Spend Credit (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total spend credit value (SKAN) | METRIC | FLOAT | Total Spend Credit Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique achieve level (SKAN) | METRIC | INTEGER | The 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 Metrics | Achieve level events (SKAN) | METRIC | INTEGER | Achieve Level (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total achieve level value (SKAN) | METRIC | FLOAT | Total Achieve Level Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique unlock achievement (SKAN) | METRIC | INTEGER | The 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 Metrics | Unlock achievement events (SKAN) | METRIC | INTEGER | Unlock Achievement (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique generate lead (SKAN) | METRIC | INTEGER | The number of unique leads generated in your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | Total generate lead events (SKAN) | METRIC | INTEGER | Generate Lead (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total generate lead value (SKAN) | METRIC | FLOAT | Total Generate Lead Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique in app ad click (SKAN) | METRIC | INTEGER | The number of unique in-app ad click events that occurred in your mobile app and are attributed to your ads |
| SKAN Metrics | In app ad click events (SKAN) | METRIC | INTEGER | In App Ad Click (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total an app ad click value (SKAN) | METRIC | FLOAT | Total In App Ad Click Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique in app ad impr (SKAN) | METRIC | INTEGER | The number of unique in-app ad impression events that occurred in your mobile app and are attributed to your ads |
| SKAN Metrics | In app ad impressions events (SKAN) | METRIC | INTEGER | In-app ad impressions (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total in app ad impressions value (SKAN) | METRIC | FLOAT | Total in-app ad impression value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique loan apply (SKAN) | METRIC | INTEGER | The 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 Metrics | Loan apply event (SKAN) | METRIC | INTEGER | Loan Apply (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique loan approval (SKAN) | METRIC | INTEGER | The 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 Metrics | Loan approval events (SKAN) | METRIC | INTEGER | Loan Approval (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique loan disbursement (SKAN) | METRIC | INTEGER | The number of unique loan disbursal in your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | Loan disbursement events (SKAN) | METRIC | INTEGER | Loan Disbursement (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique login (SKAN) | METRIC | INTEGER | The number of unique logins in your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | Login events (SKAN) | METRIC | INTEGER | Login (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique rate (SKAN) | METRIC | INTEGER | The number of unique ratings in your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | Rate events (SKAN) | METRIC | INTEGER | Rates (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total rate value (SKAN) | METRIC | FLOAT | Total rate value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique search (SKAN) | METRIC | INTEGER | The number of unique searches in your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | Search events (SKAN) | METRIC | INTEGER | Search (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique start trial (SKAN) | METRIC | INTEGER | The 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 Metrics | Start trial events (SKAN) | METRIC | INTEGER | Start Trial (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Unique subscribe (SKAN) | METRIC | INTEGER | The number of unique subscriptions in your mobile app that were recorded as app events and attributed to your ads |
| SKAN Metrics | Subscribe events (SKAN) | METRIC | INTEGER | Subscribe (Total No.). SKAN metrics will only display values for iOS14 dedicated campaigns |
| SKAN Metrics | Total subscribe value (SKAN) | METRIC | FLOAT | Total Subscribe Value. SKAN metrics will only display values for iOS14 dedicated campaigns |
| Time | Year | DIMENSION | YEAR | Year |
| Time | Year month | DIMENSION | YEARMONTH | Year month |
| Time | Year month number | DIMENSION | YEAR_MONTH_NUMBER | Year month number |
| Time | Month | DIMENSION | MONTHNAME | Month name |
| Time | Month number | DIMENSION | MONTH | Month number |
| Time | Week number(sun - sat) | DIMENSION | WEEK_NUMBER | Week number(sun - sat) |
| Time | Week number(mon - sun) | DIMENSION | WEEK_ISO_NUMBER | Week number(mon - sun) |
| Time | Week start date(sun - sat) | DIMENSION | WEEK_START_DATE | Start date of the week |
| Time | Week start date(mon - sun) | DIMENSION | WEEK_ISO_START_DATE | Start date of the ISO week |
| Time | Date | DIMENSION | DATE | Date |
| Time | Hour | DIMENSION | HOUR | Hour |
| Account | Account name | DIMENSION | STRING | Name of the advertiser |
| Account | Account ID | DIMENSION | STRING | The ID of the advertiser |
| Account | Account status | DIMENSION | STRING | Status of the advertiser |
| Account | Account created date | DIMENSION | DATE | Advertiser created date |
| Account | Account created datetime | DIMENSION | DATETIME | Advertiser created datetime |
| Account | Account type | DIMENSION | STRING | Type of the ad account. Enum values: RESERVATION (reservation ad account), AUCTION(auction ad account). |
| Account | Account address | DIMENSION | STRING | Address of the advertiser company |
| Account | Account company | DIMENSION | STRING | Company name of the advertiser |
| Account | Account contact person | DIMENSION | STRING | Contact Person |
| Account | Account country | DIMENSION | COUNTRY_CODE | Country of the advertiser company |
| Account | Account currency | DIMENSION | STRING | Currency of the advertiser account |
| Account | Account brand description | DIMENSION | STRING | Brand description, i.e. promotional content |
| Account | Account email | DIMENSION | STRING | Advertiser contact email, masked format. For example, d*****h@test.com |
| Account | Account industry category | DIMENSION | STRING | Advertiser Industry Category |
| Account | Account language | DIMENSION | STRING | Language used by advertisers |
| Account | Account license no | DIMENSION | STRING | License number of the advertiser company |
| Account | Account cellphone No | DIMENSION | STRING | phone number of the advertiser |
| Account | Account role | DIMENSION | STRING | Role of the advertiser |
| Account | Account telephone no | DIMENSION | STRING | Advertiser fixed phone number, desensitised data |
| Account | Account timezone | DIMENSION | STRING | Time zone of the advertiser account |
| Account | Account display timezone | DIMENSION | STRING | Timezone name in the format of 'Region/City'. For example, 'Europe/London' |
| Account | Account balance | DIMENSION | FLOAT | Available balance of the advertiser account |
| Campaign | Campaign name | DIMENSION | STRING | Name of the campaign |
| Campaign | Campaign ID | DIMENSION | STRING | The ID of the campaign |
| Campaign | Campaign status (secondary) | DIMENSION | STRING | Secondary Status of the campaign |
| Campaign | Campaign created date | DIMENSION | DATE | Creation date of the campaign |
| Campaign | Campaign updated date | DIMENSION | DATE | Modification date of the campaign |
| Campaign | Campaign created datetime | DIMENSION | DATETIME | Creation date and time of the campaign |
| Campaign | Campaign updated datetime | DIMENSION | DATETIME | Modification date and time of the campaign |
| Campaign | Campaign operation status | DIMENSION | STRING | Operation Status of the campaign |
| Campaign | Campaign type | DIMENSION | STRING | Type of the campaign |
| Campaign | Campaign budget | DIMENSION | FLOAT | Budget of the campaign |
| Campaign | Campaign budget mode | DIMENSION | STRING | Budget mode of the campaign |
| Campaign | Campaign objective | DIMENSION | STRING | Objective of the campaign |
| Campaign | Campaign objective type | DIMENSION | STRING | What kind of objective for the campaign |
| Campaign | Campaign budget optimize on | DIMENSION | STRING | Whether Campaign Budget Optimization is enabled |
| Campaign | Is smart performance campaign | DIMENSION | BOOLEAN | Whether the campaign is a Smart Performance Campaign or not. |
| Campaign | Campaign bid type | DIMENSION | STRING | Bidding strategy on the campaign level |
| Campaign | Campaign deep bid type | DIMENSION | STRING | Bidding strategy for in-app events |
| Campaign | Campaign ROAS bid | DIMENSION | FLOAT | ROAS goal for Value Optimization |
| Campaign | Campaign optimization goal | DIMENSION | STRING | Optimization goal |
| Campaign | Campaign split test variables | DIMENSION | STRING | Split 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 |
| Campaign | App profile page status (campaign) | DIMENSION | STRING | Indicates the status of App Profile Page. Could be "INVALID"/"UNSET"/"ON"/"OFF" |
| Ad Group | Ad group name | DIMENSION | STRING | Name of the ad group |
| Ad Group | Ad group ID | DIMENSION | STRING | The ID of the ad group |
| Ad Group | Ad group status (secondary) | DIMENSION | STRING | Ad group Status (Secondary Status) |
| Ad Group | Ad group created date | DIMENSION | DATE | Ad group created date |
| Ad Group | Ad group created datetime | DIMENSION | DATETIME | Ad group created datetime |
| Ad Group | Ad group operation status | DIMENSION | STRING | Operation status of the ad group |
| Ad Group | Ad group placement type | DIMENSION | STRING | Placement type. Allowed values: PLACEMENT_TYPE_AUTOMATIC (automatic placement), PLACEMENT_TYPE_NORMAL (manual placement) |
| Ad Group | Ad group placements | DIMENSION | STRING | Placement location |
| Ad Group | Is ad group comment disabled | DIMENSION | BOOLEAN | Whether to allow comments on your ads on TikTok, Vigo, Helo. Enum values: 0 (allow), 1 (restrict). The default value is allow |
| Ad Group | Is ad group share disabled | DIMENSION | BOOLEAN | Whether sharing to third-party platforms is disabled for ads in this ad group |
| Ad Group | Ad group budget | DIMENSION | FLOAT | Budget of the ad group |
| Ad Group | Ad group budget mode | DIMENSION | STRING | Budget mode of the ad group |
| Ad Group | Ad group schedule type | DIMENSION | STRING | Ad schedule type values |
| Ad Group | Ad group schedule start time | DIMENSION | DATETIME | Ad delivery start time (UTC) |
| Ad Group | Ad group schedule end time | DIMENSION | DATETIME | Ad delivery end time (UTC) |
| Ad Group | Ad group optimization goal | DIMENSION | STRING | The optimization goal for the ad group |
| Ad Group | Ad group CPV video duration | DIMENSION | FLOAT | Optimized video playback duration |
| Ad Group | Ad group pacing | DIMENSION | FLOAT | Speed of ad delivery |
| Ad Group | Ad group bid method | DIMENSION | STRING | Billing event for the ad group |
| Ad Group | Ad group bidding strategy | DIMENSION | STRING | various types of bid |
| Ad Group | Ad group bid price | DIMENSION | FLOAT | The bid price for CPC, CPM bidding or oCPM learning bidding |
| Ad Group | Ad group conversion bid price | DIMENSION | FLOAT | Target cost per conversion for oCPM (optimized cost pe mille) conversion bid |
| Ad Group | Ad group deep bid type | DIMENSION | STRING | TikTok specific bid type tries to automatic optimization operation |
| Ad Group | Ad group deep CPA bid | DIMENSION | FLOAT | deep bid |
| Ad Group | Ad group frequency | DIMENSION | INTEGER | Ad 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 Group | Ad group frequency schedule | DIMENSION | INTEGER | Ad Group Frequency Schedule |
| Ad Group | Ad group statistic type | DIMENSION | STRING | Conversion bid statistic type, bid for EVERYTIME (Each Purchase)/ NONE (Unique Purchase |
| Ad Group | Is ad group video download disabled | DIMENSION | BOOLEAN | Whether users can download your video ads on TikTok. Allowed values: ALLOW_DOWNLOAD ,PREVENT_DOWNLOAD Default: ALLOW_DOWNLOAD |
| Ad Group | Billing method (RF ad groups) | DIMENSION | STRING | Billing method of Reach & Frequency ad groups. Returned when objective_type of the related campaign is RF_REACH |
| Ad Group | Ad group redirection type | DIMENSION | STRING | The types of ad redirection in the catalog. Returned when the corresponding campaign objective_type is CATALOG_SALES/PRODUCT_SALES |
| Ad Group | Ad group brand safety type | DIMENSION | STRING | Brand 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 Group | Ad group brand safety partner | DIMENSION | STRING | Brand 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 Group | Ad group promotion website type | DIMENSION | STRING | Instant 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 Group | Ad group ios quota type | DIMENSION | STRING | ROAS goal for Value Optimization |
| Ad Group | Ad group ROAS bid | DIMENSION | STRING | ROAS goal for Value Optimization |
| Ad Group | App profile page state (ad group) | DIMENSION | STRING | Indicates whether the ad group is using app profile page. Enum: INVALID, UNSET, ON, OFF |
| Ad | Ad name | DIMENSION | STRING | Name of the ad |
| Ad | Ad ID | DIMENSION | STRING | The ID of the ad |
| Ad | Ad status (secondary) | DIMENSION | STRING | The status of the ad |
| Ad | Ad operation status | DIMENSION | STRING | Operation status, values include: DISABLE, ENABLE |
| Ad | Ad created date | DIMENSION | DATE | Ad created date |
| Ad | Ad updated date | DIMENSION | DATE | Ad modified date |
| Ad | Ad created datetime | DIMENSION | DATETIME | Ad created datetime |
| Ad | Ad updated datetime | DIMENSION | DATETIME | Ad modified datetime |
| Ad | Ad identity ID | DIMENSION | STRING | The Identity ID of the ad |
| Ad | Ad identity type | DIMENSION | STRING | Identity type. Enum: CUSTOMIZED_USER, AUTH_CODE, TT_USER |
| Ad | Ad call to action | DIMENSION | STRING | The call-to-action (CTA) text |
| Ad | Ad card ID | DIMENSION | INTEGER | Image card ID, gift code card ID, or premium badge ID |
| Ad | Is automated ad | DIMENSION | BOOLEAN | Whether the ad is an automated ad |
| Ad | Ad image mode | DIMENSION | STRING | Image Mode of the Ad |
| Ad | Ad format | DIMENSION | STRING | Creative Type of the ad |
| Ad | Ad text | DIMENSION | STRING | Text of the ad |
| Ad | Ad landing page url | DIMENSION | URL | Landing page url |
| Ad | Ad display name | DIMENSION | STRING | The display name of landing page or pure exposure ad |
| Ad | Ad profile image url | DIMENSION | IMAGE_URL | Avatar url |
| Ad | Ad display monitoring url | DIMENSION | URL | Display monitoring url |
| Ad | Ad click monitoring url | DIMENSION | URL | Click monitoring url |
| Ad | Ad open url | DIMENSION | URL | The specific location where you want your audience to go if they have your app installed |
| Ad | Ad open url type | DIMENSION | STRING | The open URL type |
| Ad | Ad fallback type | DIMENSION | STRING | If 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 |
| Ad | Ad playable material url | DIMENSION | URL | Playable material url |
| Ad | Ad moat viewability verification | DIMENSION | BOOLEAN | Whether 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 |
| Ad | Is ad creative authorized | DIMENSION | BOOLEAN | Whether you grant displaying some of your ads in our TikTok For Business Creative Center. Only valid for non-US advertisers |
| Ad | Ad DPA fallback type | DIMENSION | STRING | In DPA scenario, the fallback behavior of deeplink evokes failed. Return when the corresponding campaign objective_type is CATALOG_SALES |
| Ad | Ad DPA open url type | DIMENSION | STRING | Indicates the source of the direct link used in the ad. This field is returned when the corresponding campaign objective_type is CATALOG_SALES |
| Ad | Ad DPA video template ID | DIMENSION | STRING | The Catalog video template ID. Return when the corresponding campaign objective_type is CATALOG_SALES |
| Ad | Ad promotional music status | DIMENSION | BOOLEAN | Whether 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. |
| Ad | Ad dark post status | DIMENSION | STRING | Indicates whether the ad is a Spark Ads dark post. Value can be ON or OFF |
| Ad | Ad branded content status | DIMENSION | BOOLEAN | Default is false. If branded_content_disabled is true, you cannot modify dark_post_status |
| Ad | Ad item duet status | DIMENSION | STRING | Whether 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 |
| Ad | Ad item stitch status | DIMENSION | STRING | Whether 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 |
| Ad | Ad brand safety post bid measurement partner | DIMENSION | STRING | Brand safety post bid measurement partner. Enumerations: Zefr |
| Video | Video ID | DIMENSION | STRING | The ID of the video used to create ad in ad delivery |
| Video | Video preview url | DIMENSION | URL | Video preview link, valid for an hour and needs to be re-acquired after expiration |
| Video | Video thumbnail url | DIMENSION | IMAGE_URL | Video cover, valid for an hour and needs to be re-acquired after expiration |
| Video | Video file name | DIMENSION | STRING | Video name |
| Video | Video format | DIMENSION | STRING | Video format |
| Video | Video size | DIMENSION | INTEGER | Video size, in Bytes |
| Video | Video duration | DIMENSION | FLOAT | Video duration, in Seconds |
| Video | Video bit rate | DIMENSION | INTEGER | Video Bit Rate, in bps |
| Video | Video height | DIMENSION | INTEGER | Video Height |
| Video | Video width | DIMENSION | INTEGER | Video Width |
| Video | Is video displayable | DIMENSION | BOOLEAN | Whether it can be displayed on the platform |
| Video | Is video downloadable | DIMENSION | BOOLEAN | Due to the music copyright, some materials generated by creative tools are only allowed to preview. It is prohibited to download and disseminate them |
| Video | Available video placements | DIMENSION | ARRAY | Due 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 |
| Video | Video created date | DIMENSION | DATE | Video created date |
| Video | Video modified date | DIMENSION | DATE | Video modified date |
| Video | Video modified datetime | DIMENSION | DATETIME | Video modified datetime |
| Video | Video modified datetime | DIMENSION | DATETIME | Video modified datetime |
| Audience | Gender | DIMENSION | STRING | gender of Audience |
| Audience | Age | DIMENSION | STRING | Age of Audience |
| Audience | Country code | DIMENSION | COUNTRY_CODE | Country code |
| Audience | Country | DIMENSION | COUNTRY | The country of the requested insights |
| Audience | Region | DIMENSION | REGION | Region |
| Audience | Language | DIMENSION | STRING | Language |
| Audience | Device platform | DIMENSION | STRING | Reports the OS platform that received impressions of your ads (iOS, Android, etc.) |
| Audience | Placement | DIMENSION | STRING | Reports the apps that were served impressions of your ads |
| Audience | Interest category | DIMENSION | STRING | Interest category |
| Audience | DMA ID | DIMENSION | INTEGER | Designated Market Area (DMA) ID. Only U.S. has DMAs |
| Audience | DMA name | DIMENSION | STRING | Designated Market Area (DMA) name. Only U.S. has DMAs |
| Conversion | Ad group pixel ID | DIMENSION | STRING | The ID of the conversion pixel |
| Conversion | Ad group optimization event | DIMENSION | STRING | Conversion event for the ad group |
| Conversion | Ad group secondary optimization event | DIMENSION | STRING | The secondary goal when optimization_goal is INSTALL or VALUE |
| Targeting | Audience rule | DIMENSION | STRING | Audience targeting inclusion and exclusion rules |
| Targeting | Audience type | DIMENSION | STRING | Audience 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) |
| Targeting | Ad group target age groups | DIMENSION | STRING | List of targeted age groups |
| Targeting | Ad group target gender | DIMENSION | STRING | Targeted gender |
| Targeting | Ad group target language | DIMENSION | STRING | List of targeted languages |
| Targeting | Ad group target OS | DIMENSION | STRING | List of targeted operating systems |
| Targeting | Ad group target network types | DIMENSION | STRING | List of targeted network types |
| Targeting | Ad group target device price ranges | DIMENSION | STRING | Targeted device price in USD, for example: [0,300] represents price range is from $0 to $300 |
| Targeting | Ad group target min android version | DIMENSION | STRING | Targeted audience minimum Android version |
| Targeting | Ad group target min ios version | DIMENSION | STRING | Targeted audience minimum iOS version |
| Targeting | Is ad group auto targeting enabled | DIMENSION | BOOLEAN | Whether automated targeting is turned on. Enum values: ON, OFF |