TikTok: Most-used fields

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

dimension

Advertiser

Advertiser

dimension

Campaign End Date

Campaign End Date

dimension

Campaign Start Date

Campaign Start Date

dimension

Country Code

Country Code

dimension

Country Name

Country Name

dimension

Currency

Currency

dimension

Day

Day

dimension

account_name

account_name

dimension

advertiserName

advertiserName

dimension

avatar_url

avatar_url

User’s profile image

dimension

bio_description

bio_description

User’s bio description if there is a valid one

dimension

comment_count

comment_count

Number of comments on the video

metric

cover_image_url

cover_image_url

A CDN link for the video’s cover image. The image is static. Due to our trust and safety policies, the link has a TTL of 6 hours.

dimension

create_time

create_time

UTC Unix epoch (in seconds) of when the TikTok video was posted.

dimension

display_name

display_name

User’s profile name

dimension

duration

duration

The duration of the TikTok video in seconds.

metric

embed_link

embed_link

Video embed link of tiktok.com

dimension

follower_count

follower_count

User’s followers count

metric

following_count

following_count

The number of accounts that the user is following

metric

height

height

The height of the TikTok video.

metric

id

id

Unique identifier for the TikTok video. Also called ‘item_id’

dimension

is_verified

is_verified

Whether TikTok has provided a verified badge to the account after confirming that it belongs to the user it represents

dimension

like_count

like_count

Number of likes for the video

metric

likes_count

likes_count

The total number of likes received by the user across all of their videos

metric

open_id

open_id

The unique identification of the user in the current application. Open ID for the client

dimension

profile_deep_link

profile_deep_link

The link to user’s TikTok profile page

dimension

share_count

share_count

Number of shares of the video

metric

share_url

share_url

A shareable link for this TikTok video. Note that the website behaves differently on Mobile and Desktop devices.

dimension

title

title

The video title. Max length: 150

dimension

union_id

union_id

The unique identification of the user across different apps for the same developer. For example, if a partner has X number of clients, it will get X number of open_id for the same TikTok user, but one persistent union_id for the particular user

dimension

video_description

video_description

The description that the creator has set for the TikTok video. Max length: 150

dimension

view_count

view_count

Number of views of the video

metric

width

width

The width of the TikTok video.

metric