TikTok Business: Most-used fields#
The table below gives information about most-used fields that you can import from TikTok Business. 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 |
|---|---|---|---|
audience_activity |
audience_activity |
metric |
|
audience_activity_hour |
audience_activity_hour |
dimension |
|
audience_countries |
audience_countries |
A list or aggregated data representing the countries where the audience of the TikTok business profile is located. This information is available for both profile and video-specific analytics and reflects follower distribution over the past 60 days. |
dimension |
audience_country |
audience_country |
Represents a specific country where the audience of the TikTok business profile is located. This data is part of the country distribution of followers. |
dimension |
audience_country_percentage |
audience_country_percentage |
The percentage of the audience for the TikTok business profile residing in a specific country. This metric is derived from the country distribution of followers. |
dimension |
audience_genders |
audience_genders |
The gender distribution of the audience following the TikTok business profile. This metric provides insights into the demographic makeup of the follower base. |
dimension |
average_time_watched |
average_time_watched |
The average time, in seconds, users spent watching the video. |
metric |
business_id |
business_id |
The unique identifier for the TikTok business account. |
dimension |
caption |
caption |
The text caption of the video. |
dimension |
comments |
comments |
The total number of comments received on the video. |
metric |
create_time |
create_time |
The Unix timestamp (in seconds) indicating when the video was created and posted. |
dimension |
daily_new_followers |
daily_new_followers |
The number of new followers gained by the TikTok business profile on a daily basis. This is typically represented as ‘Net Followers’ and is part of daily profile data, which has a 60-day historical limit. |
metric |
date |
date |
The date for which the data is reported. |
dimension |
display_name |
display_name |
The public profile name of the TikTok account. |
metric |
followers_count |
followers_count |
The total number of followers for the business profile. |
metric |
full_video_watched_rate |
full_video_watched_rate |
The percentage of viewers who watched the video from start to finish. |
metric |
impression_percentage |
impression_percentage |
The percentage of impressions for the content or profile. |
metric |
impressions_source |
impressions_source |
The source categories from which video impressions originated, providing insights into discovery channels. |
dimension |
is_business_account |
is_business_account |
Indicates whether the TikTok account is a business account. |
metric |
item_id |
item_id |
The unique identifier for the video. |
dimension |
likes |
likes |
The total number of likes received on the video. |
metric |
profile_image |
profile_image |
dimension |
|
profile_views |
profile_views |
The total number of times the business profile has been viewed. |
metric |
reach |
reach |
The number of unique users who have seen the video. |
metric |
share_url |
share_url |
The URL that can be used to share the TikTok video or profile. |
dimension |
shares |
shares |
The total number of times the video has been shared. |
metric |
thumbnail_url |
thumbnail_url |
The URL of the video’s thumbnail image. |
dimension |
total_time_watched |
total_time_watched |
The total accumulated time, in seconds, all users spent watching the video. |
metric |
username |
username |
The unique identifier or handle of the TikTok account. |
dimension |
video_duration |
video_duration |
The length of the video in seconds. |
metric |
video_views |
video_views |
The total number of times the video has been viewed (for video data) or total views across all profile videos (for profile data). |
metric |