TikTok Ads Field Mapping

Media Delivery

note: 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

Media Conversion

note: 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