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.

FieldAdverity UI nameType
audience_activity Metric

Represents the overall activity or engagement of the audience for the business profile. This metric provides a general overview of audience interaction.

audience_activity_hour Dimension

Provides data on audience activity broken down by hour, indicating the times when the profile's audience is most active.

audience_countries Dimension

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.

audience_country Dimension

Represents a specific country where the audience of the TikTok business profile is located. This data is part of the country distribution of followers.

audience_country_percentage Dimension

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.

audience_genders Dimension

The gender distribution of the audience following the TikTok business profile. This metric provides insights into the demographic makeup of the follower base.

average_time_watched Metric

The average time, in seconds, users spent watching the video.

business_id Dimension

The unique identifier for the TikTok business account.

caption Dimension

The text caption of the video.

comments Metric

The total number of comments received on the video.

create_time Dimension

The Unix timestamp (in seconds) indicating when the video was created and posted.

daily_new_followers Metric

The number of new followers gained by the TikTok Business profile on a specific day.

daily_total_followers Metric

The total number of followers a TikTok business profile has on a specific day. This metric corresponds to the 'followers_count' available through the API.

date Dimension

The date for which the data is reported.

display_name Dimension

The public profile name of the TikTok account.

followers_count Metric

The total number of followers for the business profile.

full_video_watched_rate Metric

The percentage of viewers who watched the video from start to finish.

gender Dimension

The gender distribution of the audience following the TikTok business profile. This metric provides insights into the demographic makeup of the follower base.

gender_percentage Dimension

The percentage of the audience for the TikTok business profile belonging to a specific gender. This metric is derived from the audience's gender distribution.

hour Metric

Represents the hour of the day when collecting data, used to analyze audience activity and engagement patterns on an hourly basis.

impression_percentage Metric

The percentage of impressions for the content or profile.

impressions_source Dimension

The source categories from which video impressions originated, providing insights into discovery channels.

is_business_account Dimension

Indicates whether the TikTok account is a business account.

item_id Dimension

The unique identifier for the video.

likes Metric

The total number of likes received on the video.

profile_image Dimension

The URL of the profile image associated with the TikTok Business profile.

profile_views Metric

The total number of times the business profile has been viewed.

reach Metric

The number of unique users who have seen the video.

share_url Dimension

The URL that can be used to share the TikTok video or profile.

shares Metric

The total number of times the video has been shared.

thumbnail_url Dimension

The URL of the video's thumbnail image.

total_time_watched Metric

The total accumulated time, in seconds, all users spent watching the video.

username Dimension

The unique identifier or handle of the TikTok account.

video_duration Dimension

The length of the video in seconds.

video_views Metric

The total number of times the video has been viewed (for video data) or total views across all profile videos (for profile data).