TikTok Predefined Reports
  • 12 Minutes to read
  • Dark
    Light
  • PDF

TikTok Predefined Reports

  • Dark
    Light
  • PDF

Predefined Reports

The TikTok datasource in Rivery comes with the below predefined reports. Each report will have a short description of the data, a list of customizable fields (if any), and the schema mapping. Due to the standardized nature of these reports, there are a number of locked fields that will only be accessible through the custom reporting functionality.

Source-Level Selections

TikTok's one source-level selection is an Advertisers filter. Choosing distinct values will filter down each report within the river to only the selected data.

Advertisers Info

The Advertisers Info report returns details of an advertiser's account.

Field Data Type Dimension/Metric
id system schema Integer Dimension
address String Dimension
company String Dimension
contacter String Dimension
country String Dimension
create_time Integer Metric
currency String Dimension
description String Dimension
email String Dimension
balance Float Metric
industry String Dimension
language String Dimension
license_no String Dimension
license_url String Dimension
name String Dimension
phonenumber String Dimension
promotion_area String Dimension
reason String Dimension
role String Dimension
status String Dimension
telephone String Dimension
timezone String Dimension

Campaigns

The Campaigns report returns detailed information of the campaigns within the specific account. The only customization is the type of incremental load associated with this report.

Field Data Type Dimension/Metric
advertiser_id system schema Integer Dimension
campaign_id system schema Integer Dimension
budget Float Metric
budget_mode String Dimension
campaign_name String Dimension
create_time String Dimension
modify_time String Dimension
objective String Dimension
objective_type String Dimension
opt_status String Dimension
status String Dimension

Ad Groups

The Ad Groups report returns detailed information of the ad groups within the specific account. The only customization is the type of incremental load associated with this report.

Field Data Type Dimension/Metric
campaign_id system schema Integer Dimension
pixel_id system schema String Dimension
advertiser_id system schema Integer Dimension
adgroup_id system schema Integer Dimension
conversion_id system schema Integer Dimension
app_id system schema Integer Dimension
enable_inventory_filter Boolean Dimension
bid Float Metric
bid_type String Dimension
billing_event String Dimension
budget Float Metric
budget_mode String Dimension
audience Integer Metric
campaign_name String Dimension
category Integer Metric
conversion_bid Float Metric
app_download_url String Dimension
create_time String Dimension
creative_material_mode String Dimension
dayparting String Dimension
deep_bid_type String Dimension
deep_cpabid Float Metric
deep_external_action String Dimension
age String Dimension
excluded_audience Integer Metric
external_action String Dimension
external_type String Dimension
gender String Dimension
is_comment_disable Integer Metric
keywords String Dimension
location Integer Metric
modify_time String Dimension
operation_system String Dimension
opt_status String Dimension
optimize_goal String Dimension
pacing String Dimension
package String Dimension
adgroup_name String Dimension
placement String Dimension
placement_type String Dimension
schedule_end_time String Dimension
schedule_start_time String Dimension
schedule_type String Dimension
skip_learning_phase Integer Metric
statistic_type String Dimension
status String Dimension
video_download String Dimension

Ads

The Ads report returns detailed information of the regular ads and automated creative ads within the specific account. There are two customizations the user can make to this report. They can use the Primary Status filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
advertiser_id system schema Integer Dimension
ad_id system schema Integer Dimension
campaign_id system schema Integer Dimension
adgroup_id system schema Integer Dimension
video_id system schema String Dimension
adgroup_name String Dimension
app_name String Dimension
call_to_action String Dimension
ad_text String Dimension
campaign_name String Dimension
click_tracking_url String Dimension
create_time String Dimension
ad_name String Dimension
image_ids String Dimension
image_mode Integer Metric
impression_tracking_url String Dimension
landing_page_url String Dimension
modify_time String Dimension
open_url String Dimension
opt_status String Dimension
playable_url String Dimension
profile_image String Dimension
status String Dimension
display_name String Dimension

Image Files

The Image Files report returns the information of a specific image from the material library of the Tiktok auction platform.

Field Data Type Dimension/Metric
id system schema String Dimension
modify_time system schema String Dimension
image_id system schema String Dimension
create_time String Dimension
height Integer Metric
format String Dimension
file_name String Dimension
material_id String Dimension
displayable Boolean Dimension
signature String Dimension
size Integer Metric
url String Dimension
width Integer Metric

Video Files

The Video Files report returns the information of a specific video from the material library of the Tiktok auction platform.

Field Data Type Dimension/Metric
id system schema String Dimension
video_id system schema String Dimension
modify_time system schema String Dimension
allow_download Boolean Dimension
displayable Boolean Dimension
duration Float Metric
file_name String Dimension
format String Dimension
height Integer Metric
create_time String Dimension
material_id String Dimension
bit_rate Integer Metric
poster_url String Dimension
signature String Dimension
size Integer Metric
url String Dimension
allowed_placements String Dimension
width Integer Metric

Auction Ads Campaign Basic Daily

The Auction Ads Campaign Basic Daily report is a campaign-level, daily metrics report. There are two customizations the user can make to this report. They can use the Campaigns filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_campaign_id system schema Integer Dimension
dimensions_stat_time_day system schema String Dimension
metrics_real_time_conversion String Metric
metrics_average_video_play_per_user String Metric
metrics_clicks String Metric
metrics_comments String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_1000_reached String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cost_per_secondary_goal_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_ctr String Metric
metrics_impressions String Metric
metrics_likes String Metric
metrics_profile_visits String Metric
metrics_reach String Metric
metrics_average_video_play String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_secondary_goal_result String Metric
metrics_secondary_goal_result_rate String Metric
metrics_shares String Metric
metrics_spend String Metric
metrics_video_play_actions String Metric
metrics_video_views_p100 String Metric
metrics_video_views_p25 String Metric
metrics_video_views_p50 String Metric
metrics_video_views_p75 String Metric
metrics_video_watched_2s String Metric
metrics_video_watched_6s String Metric

Auction Ads Adgroups Basic Daily

The Auction Ads Adgroups Basic Daily report is an ad group-level, daily metrics report. The only customization is the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_adgroup_id system schema Integer Dimension
dimensions_stat_time_day system schema String Dimension
metrics_real_time_conversion String Metric
metrics_average_video_play_per_user String Metric
metrics_clicks String Metric
metrics_comments String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_1000_reached String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cost_per_secondary_goal_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_ctr String Metric
metrics_impressions String Metric
metrics_likes String Metric
metrics_profile_visits String Metric
metrics_reach String Metric
metrics_average_video_play String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_secondary_goal_result String Metric
metrics_secondary_goal_result_rate String Metric
metrics_shares String Metric
metrics_spend String Metric
metrics_video_play_actions String Metric
metrics_video_views_p100 String Metric
metrics_video_views_p25 String Metric
metrics_video_views_p50 String Metric
metrics_video_views_p75 String Metric
metrics_video_watched_2s String Metric
metrics_video_watched_6s String Metric

Auction Ads Basic Daily

The Auction Ads Basic Daily report is an ad-level, daily metrics report. There are two customizations the user can make to this report. They can use the Ads filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_ad_id system schema Integer Dimension
dimensions_stat_time_day system schema String Dimension
metrics_real_time_conversion String Metric
metrics_average_video_play_per_user String Metric
metrics_clicks String Metric
metrics_comments String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_1000_reached String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cost_per_secondary_goal_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_ctr String Metric
metrics_impressions String Metric
metrics_likes String Metric
metrics_profile_visits String Metric
metrics_reach String Metric
metrics_average_video_play String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_secondary_goal_result String Metric
metrics_secondary_goal_result_rate String Metric
metrics_shares String Metric
metrics_spend String Metric
metrics_video_play_actions String Metric
metrics_video_views_p100 String Metric
metrics_video_views_p25 String Metric
metrics_video_views_p50 String Metric
metrics_video_views_p75 String Metric
metrics_video_watched_2s String Metric
metrics_video_watched_6s String Metric

Auction Ads Audience Age

The Auction Ads Audience Age report is an ad-level, daily metrics report that is aggregated to the age segemntation. There are two customizations the user can make to this report. They can use the Ads filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_ad_id system schema Integer Dimension
dimensions_age system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Gender

The Auction Ads Audience Gender report is an ad-level, daily metrics report that is aggregated to the gender segemntation. There are two customizations the user can make to this report. They can use the Ads filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_ad_id system schema Integer Dimension
dimensions_gender system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Language

The Auction Ads Audience Language report is an ad-level, daily metrics report that is aggregated to the language segemntation. There are two customizations the user can make to this report. They can use the Ads filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_ad_id system schema Integer Dimension
dimensions_language system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Country

The Auction Ads Audience Country report is an ad-level, daily metrics report that is aggregated to the country segemntation. There are two customizations the user can make to this report. They can use the Ads filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_ad_id system schema Integer Dimension
dimensions_country_code system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Platform

The Auction Ads Audience Platform report is an ad-level, daily metrics report that is aggregated to the platform segemntation. There are two customizations the user can make to this report. They can use the Ads filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_ad_id system schema Integer Dimension
dimensions_platform system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Campaign Age

The Auction Ads Audience Campaign Age report is a campaign-level, daily metrics report that is aggregated to the age segemntation. There are two customizations the user can make to this report. They can use the Campaigns filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_age system schema String Dimension
dimensions_campaign_id system schema Integer Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Campaign Country

The Auction Ads Audience Campaign Country report is a campaign-level, daily metrics report that is aggregated to the country segemntation. There are two customizations the user can make to this report. They can use the Campaigns filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_campaign_id system schema Integer Dimension
dimensions_country_code system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Campaign Language

The Auction Ads Audience Campaign Language report is a campaign-level, daily metrics report that is aggregated to the language segemntation. There are two customizations the user can make to this report. They can use the Campaigns filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_campaign_id system schema Integer Dimension
dimensions_language system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Campaign Platform

The Auction Ads Audience Campaign Platform report is a campaign-level, daily metrics report that is aggregated to the platform segemntation. There are two customizations the user can make to this report. They can use the Campaigns filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_campaign_id system schema Integer Dimension
dimensions_platform system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Auction Ads Audience Campaign Gender

The Auction Ads Audience Campaign Gender report is a campaign-level, daily metrics report that is aggregated to the gender segemntation. There are two customizations the user can make to this report. They can use the Campaigns filter option to cut down the output and can customize the type of incremental load associated with this report.

Field Data Type Dimension/Metric
dimensions_campaign_id system schema Integer Dimension
dimensions_gender system schema String Dimension
dimensions_stat_time_day system schema String Dimension
metrics_ctr String Metric
metrics_conversion String Metric
metrics_conversion_rate String Metric
metrics_cost_per_conversion String Metric
metrics_cost_per_result String Metric
metrics_cpc String Metric
metrics_cpm String Metric
metrics_clicks String Metric
metrics_impressions String Metric
metrics_real_time_conversion String Metric
metrics_real_time_conversion_rate String Metric
metrics_real_time_cost_per_conversion String Metric
metrics_real_time_cost_per_result String Metric
metrics_real_time_result String Metric
metrics_real_time_result_rate String Metric
metrics_result String Metric
metrics_result_rate String Metric
metrics_spend String Metric

Was this article helpful?