| ac | TEXT | ac | Group by network | ac |
| account_id | TEXT | Account ID | The TikTok Ads account ID | Account |
| account_name | TEXT | Account Name | The TikTok Ads account name | Account |
| ad_group_id | TEXT | Ad Group ID | Ad group ID | Ad |
| ad_group_name | TEXT | Ad Group Name | Ad group name | Ad |
| ad_id | TEXT | Ad ID | Ad ID | Ad |
| ad_name | TEXT | Ad Name | Ad Name | Ad |
| ad_text | TEXT | Ad title | Supported at Ad level. | |
| aeo_type | TEXT | App Event Optimization Type | Supported at Ad Group and Ad level. | |
| age | TEXT | Age Range | The Age Range of the Audience | Performance |
| app_install | NUMERIC | App Install | The number of times your mobile app was installed that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| average_video_play | NUMERIC | Video Average Watch Time Per Video View | The average time your video was played per single video view, including any time spent replaying the video. | Video |
| average_video_play_per_user | NUMERIC | Video Average Watch Time Per Person | The average time your video was played per person, including any time spent replaying the video. This metric is estimated. | Video |
| bid | TEXT | Bid | Supported at Ad Group and Ad level. | |
| bid_strategy | TEXT | Bid strategy | Supported at Ad Group and Ad level. | |
| billing_event | TEXT | Billing Event | Supported at Ad Group and Ad level.Example: `Clicks`, `Impression`. | |
| budget | TEXT | Ad group budget | Supported at Ad Group and Ad level. | |
| budget_optimize_switch | TEXT | Budget Optimize Switch | Whether Campaign Budget Optimization (CBO) is enabled | Campaign |
| call_to_action | TEXT | Call To Action | Call-to-action (CTA) | Ad |
| call_to_action_id | TEXT | Call To Action ID (deprecated) | Call-to-action (CTA) ID | Ad |
| campaign | TEXT | Campaign | The Campaign Name | Campaign |
| campaign_bid_type | TEXT | Campaign Bid Type | Bidding strategy on the campaign level. | Campaign |
| campaign_budget | NUMERIC | Campaign Budget | Campaign budget | Campaign |
| campaign_budget_type | TEXT | Campaign Budget Type (deprecated) | Campaign budget type | Campaign |
| campaign_creation_time | TEXT | Campaign Creation Time | Time at which campaign was created | Campaign |
| campaign_deep_bid_type | TEXT | Campaign Deep Bid Type | Bidding strategy for in-app events. | Campaign |
| campaign_id | TEXT | Campaign ID | The Campaign ID | Campaign |
| campaign_modify_time | TEXT | Campaign Modify Time (deprecated) | Time at which campaign was modified | Campaign |
| campaign_name | TEXT | Campaign | The Campaign Name | |
| campaign_optimize_goal | TEXT | Campaign Optimize Goal | Optimization goal. Returned only if Campaign Busget Optimization is enabled. | Campaign |
| campaign_roas_bid | TEXT | ROAS bid | ROAS goal for Value Optimization bid strategies (VO_*) | Campaign |
| campaign_type | TEXT | Campaign Type | Campaign objective | Campaign |
| clicks | NUMERIC | Clicks | The Number of Clicks | Performance |
| NUMERIC | Comments | The number of comments your video creative received within 1 day of a user seeing a paid ad. | Performance |
| complete_payment | NUMERIC | Total Complete Payment | Page Event Metric. The number of complete payment events. | Performance |
| conversion | NUMERIC | Conversion | The number of times your ad achieved an outcome, based on the secondary goal you selected. (Duplicate) | Performance |
| conversion_rate | PERCENT | Conversion Rate | The number of conversions and divided by the number of total ad interactions that can be tracked to a conversion. | Performance |
| conversions | NUMERIC | Conversions | The number of times your ad achieved an outcome, based on the secondary goal you selected. | Performance |
| cost_per_app_install | NUMERIC | Cost per App Install | The average cost for each app install event. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| cost_per_conversion | NUMERIC | Cost per conversion | The cost (Spend) divided by the conversions your ad generates(Conversions) | Performance |
| cost_per_create_group | NUMERIC | Cost per Unique Create Group | The average cost for each unique create group event that is attributed toyour ads. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| cost_per_registration | NUMERIC | Cost per Unique Registration | The average cost for each unique registration that is attributed to your ad. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| cost_per_total_create_group | NUMERIC | Cost per Create Group | Cost per Create Group (The total count is based on when you were billed.) | Performance |
| cost_per_total_registration | NUMERIC | Cost per Registration | Cost per Registration (The total count is based on when you were billed.) | Performance |
| country | COUNTRY | Country | The code of Country of the Audience | |
| cpc | NUMERIC | CPC | The cost (Spend) divided by the clicks your ad receives(Clicks) | Performance |
| create_group | NUMERIC | Cost per Unique Create Group | The average cost for each unique create group event that is attributed toyour ads. (The total count is calculated based on the time each adimpression occurred.) | Performance |
| create_group_rate | NUMERIC | Create Group Rate (%) | The percentage of unique create group events out of all app install events. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| ctr | PERCENT | CTR | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | Performance |
| currency | TEXT | Currency | The currency code, e.g. USD. | Account |
| date | DATE | Date | The Date | Time |
| dpa_target_audience_type | TEXT | Target audience type for DPA | The Audience that DPA products target | |
| follows | NUMERIC | Follows | The number of new followers that were gained within 1 day of a user seeing a paid ad. This metric is only for Boosted TikToks. | Performance |
| frequency | NUMERIC | Frequency | The average number of times each person saw your ad.(Conversions) | Performance |
| gender | TEXT | Gender | The Gender of the Audience | |
| image_mode | TEXT | Format | Supported at Campaign, Ad Group and Ad level. | |
| impressions | NUMERIC | Impressions | The Number of Impressions | Performance |
| initiate_checkout | NUMERIC | Total Initiate Checkout | Page Event Metric. The number of initiate checkout events. | Performance |
| is_automated_ad | TEXT | Is Automated AD | Whether the ad is automated. | Ad |
| language | TEXT | Language | The Language of the Audience | Audience |
| likes | NUMERIC | Likes | The number of likes your video creative received within 1 day of a user seeing a paid ad. | Performance |
| mobile_app_id | TEXT | Mobile App ID | Supported at Ad Group and Ad level. Returned if the promotion type of one Ad Group is App. | |
| objective | TEXT | Objective | Campaign type. Possible values: APP, LANDING_PAGE | Campaign |
| objective_type | TEXT | Objective Type | Advertising objective | Campaign |
| opt_status | TEXT | Automated creative optimization | Automated creative optimization | |
| placement | TEXT | Placement | The Placement Name | |
| placement_type | TEXT | Placement type | The Placement type | |
| platform | TEXT | Platform | The Operating System of the Audience | |
| play_duration_2s | NUMERIC | 2-Second Video Views | The number of times your video played for at least 2 seconds. Replays will not be counted. | Video |
| play_duration_6s | NUMERIC | 6-Second Video Views | The number of times your video played for at least 6 seconds, or completely played. Replays will not be counted. | Video |
| play_first_quartile | NUMERIC | Video Views at 25% | The number of times your video was played at 25% of its length. Replays will not be counted. | Video |
| play_midpoint | NUMERIC | Video Views at 50% | The number of times your video was played at 50% of its length. Replays will not be counted. | Video |
| play_over | NUMERIC | Video Views at 100% | The number of times your video was played at 100% of its length. Replays will not be counted. | Video |
| play_third_quartile | NUMERIC | Video Views at 75% | The number of times your video was played at 75% of its length. Replays will not be counted. | Video |
| promotion_type | TEXT | Promotion type | The promotion type | |
| purchase | NUMERIC | Unique Purchase | In-app event metric. The number of unique purchases event occurred in your app that were recorded by your measurement partner. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| purchase_rate | NUMERIC | Purchase Rate (%) | In-app event metric. The percentage of unique purchase event out of all the app install event. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| reach | NUMERIC | Reach | The number of unique users who saw your ads at least once | Reach |
| real_time_app_install | NUMERIC | Real-time App Install | The number of times your mobile app was installed that were recorded as app events and attributed to your ads. (The total count is based on when the conversion actually happened.) | Performance |
| real_time_app_install_cost | NUMERIC | Cost per Real-time App Install | The average cost for each app install event. (The total count is based on when the conversion actually happened.) | Performance |
| registration | NUMERIC | Unique Registration | The number of unique registrations in your mobile app that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| registration_rate | NUMERIC | Registration Rate (%) | The percentage of unique registration events out of all app install events. (The total count is calculated based on the time each ad impression occurred.) | Performance |
| shares | NUMERIC | Shares | The number of shares your video creative received within 1 day of a user seeing a paid ad. | Performance |
| smart_target | TEXT | Optimization goal | Supported at Ad Group and Ad level. | |
| spend | NUMERIC | spend | The Media Spend | Performance |
| total_checkout | NUMERIC | Total Checkout | In-app event metric. Checkout (Total No.) (The total count is based on when you were billed.) | Performance |
| total_checkout_value | NUMERIC | Total Checkout Value | In-app event metric. Total Checkout Value (The total count is based on when you were billed.) | Performance |
| total_complete_payment_rate | NUMERIC | Total Complete Payment Value | Page Event Metric. The total value returned from all Complete Payment events. | Performance |
| total_complete_tutorial | NUMERIC | Total Complete Tutorial | The number of complete tutorial events that are attributed to your ads. | Performance |
| total_complete_tutorial_value | NUMERIC | Total Complete Tutorial Value | The total value returned from all complete tutorial events. | Performance |
| total_create_group | NUMERIC | Total Create Group | The number of create group events that are attributed to your ads. | Performance |
| total_create_group_value | NUMERIC | Total Create Group Value | The total value returned from all create group events. | Performance |
| total_initiate_checkout_value | NUMERIC | Total Initiate Checkout Value | Page Event Metric. The total value returned from initiate checkout events. | Performance |
| total_play | NUMERIC | Video Views (tiktok) | The number of times your video starts to play. Replays will not be counted. | Video |
| total_registration | NUMERIC | Total Registration | Total Registration. The total count is based on when you were billed. | Performance |
| totalcost | NUMERIC | Total Cost | The Media Spend (Duplicate) | Performance |
| tt_app_id | TEXT | TikTok App ID | TikTok App ID, the App ID you used when creating an Ad Group. Supported at Ad Group and Ad level. Returned if the promotion type of one Ad Group is App. | |
| tt_app_name | TEXT | TikTok App Name | The name of your TikTok App. Supported at Ad Group and Ad level. Returned if thepromotion type of one Ad Group is App. | |
| value_per_total_create_group | NUMERIC | Value per Create Group | Value per Create Group (The total count is based on when you were billed.) | Performance |
| today | DATE | Today | Today's date | |
