TikTok Ads Field Mapping
Unmapped fields can be manually assigned by selecting Custom in the Mapping section. Learn more
| API Source Field Name | Displayed Field Name | Type |
|---|---|---|
| Age | Engaged Audience Age | Text |
| Gender | Engaged Audience Gender | Text |
| ad_id | Ad Id | Text |
| ad_name | Ad Name | Text |
| ad_text | Ad Creative Text | Text |
| ad_url | Ad Creative Url | Text |
| adgroup_id | Media Buy Id | Text |
| adgroup_name | Media Buy Name | Text |
| advertiser_id | Advertiser ID | Text |
| advertiser_name | Advertiser Name | Text |
| objective_type | Campaign Method | Text |
| age_groups | Targeted Segment Age | Text |
| budget | Campaign Budget | Number |
| campaign_id | Campaign Id | Text |
| campaign_name | Campaign Name | Text |
| create_time | Campaign Start Date | Date |
| currency | Currency | Currency |
| country_code | Engaged Audience Country | Text |
| gender | Targeted Segment Gender | Text |
| landing_page_url | Ad Creative Click Url | Text |
| province_id | Engaged Audience Region | Text |
| statTimeDay | Date Time | DateTime |
| frequency | Frequency | Number |
| comments | Paid Comment | Number |
| follows | Social Follows | Number |
| likes | Paid Likes | Number |
| shares | Paid Shares | Number |
| profile_visits | Unmapped | Number |
| profile_visits_rate | Unmapped | Number |
| reach | Reach | Number |
| clicks | Clicks | Number |
| video_watched_2s | Video Views 2S | Number |
| video_watched_6s | Video Views 6S | Number |
| video_views_p25 | Video Completions 25 | Number |
| video_views_p50 | Video Completions 50 | Number |
| video_views_p75 | Video Completions 75 | Number |
| video_views_p100 | Video Fully Played | Number |
| impressions | Impressions | Number |
| spend | Spend | Number |
| video_play_actions | Video Views | Number |
| engaged_view | Unmapped | Number |
| engaged_view_15s | Unmapped | Number |
Unmapped fields can be manually assigned by selecting Custom in the Mapping section. Learn more
| API Source Field Name | Displayed Field Name | Type |
|---|---|---|
| ad_id | Ad Id | Text |
| ad_name | Ad Name | Text |
| ad_text | Creative Text | Text |
| ad_url | Ad Creative Url | Text |
| adgroup_id | Media Buy Id | Text |
| adgroup_name | Media Buy Name | Text |
| advertiser_id | Advertiser ID | Text |
| advertiser_name | Advertiser Name | Text |
| objective_type | Campaign Method | Text |
| age (age_groups) | Targeted Segment Age | Text |
| budget | Campaign Budget | Number |
| campaign_id | Campaign Id | Text |
| campaign_name | Campaign Name | Text |
| create_time | Campaign Start Date | Date |
| currency | Currency | Currency |
| gender | Targeted Segment Gender | Text |
| stat_datetime | Date Time | DateTime |
| conversion_tag_category | Conversion Tag Category | Text |
| conversion_tag_name | Conversion Tag Name | Text |
| totalEventsCount | Conversions | Number |
| totalEventsValue | Revenue | Number |
| uniqueEvents | Post Click Conversions | Number |