TikTok Business: Most-used fields

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