TikTok: Most-used fields

The table below gives information about most-used fields that you can import from TikTok. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
Account_ID	Account_ID	The unique identifier for the advertiser account.	dimension
Advertiser	Advertiser	The name of the advertiser account.	dimension
Campaign End Date	Campaign End Date	The end date of the advertising campaign.	dimension
Campaign Start Date	Campaign Start Date	The start date of the advertising campaign.	dimension
Country Code	Country Code	The two-letter ISO 3166-1 country code representing the country associated with the ad or advertiser.	dimension
Country Name	Country Name	The geographical country associated with the video or user, typically represented by a standardized country or region code.	dimension
Currency	Currency	The currency used for reporting ad spend and costs within the advertiser account.	dimension
Day	Day	Represents a specific calendar day for which data is reported or aggregated. This is often derived from video creation time or used in daily reports.	dimension
account_name	account_name	The name of the advertiser account.	dimension
advertiserName	advertiserName	The name of the advertiser account.	dimension
avatar_url	avatar_url	The URL of the user’s profile avatar image.	dimension
bio_description	bio_description	The biography description of the TikTok account associated with the advertiser.	dimension
comment_count	comment_count	The total number of comments received on the ad creative.	metric
cover_image_url	cover_image_url	The URL of the video’s cover image.	dimension
create_time	create_time	The timestamp indicating when the video was created.	dimension
display_name	display_name	The public display name of the user’s TikTok profile.	dimension
duration	duration	The duration of the video in seconds.	metric
embed_link	embed_link	The URL provided for embedding the video content on other platforms.	dimension
follower_count	follower_count	The total number of followers the user’s account has. This field is available via the /user/info/ endpoint.	metric
following_count	following_count	The total number of users the account is following. This field is available via the /user/info/ endpoint.	metric
height	height	The height of the TikTok video in pixels.	metric
id	id	The unique identifier for the video.	dimension
is_verified	is_verified	Indicates whether the user’s account is verified.	dimension
like_count	like_count	The total number of likes received on the ad creative.	metric
likes_count	likes_count	The total number of likes received across all of the user’s videos. This field is available via the /user/info/ endpoint.	metric
open_id	open_id	The unique identifier for the user within the specific application.	dimension
profile_deep_link	profile_deep_link	The deep link or URL to the TikTok profile associated with the advertiser’s account.	dimension
share_count	share_count	The total number of times the ad creative has been shared.	metric
share_url	share_url	The URL to share the video directly on TikTok.	dimension
title	title	The title of the video.	dimension
union_id	union_id	A unique identifier for the user across multiple applications owned by the same developer.	dimension
video_description	video_description	The detailed textual description of the video content.	dimension
view_count	view_count	The total number of times the ad creative, especially video, has been viewed or played.	metric
width	width	The width of the TikTok video in pixels.	metric