Destinations
Data sources
AI insights
About us
Careers
Security
Customer reviews
Contact us
Affiliate program
Solution partners
Template gallery
Looker Studio templates
Power BI templates
Excel templates
Google Sheets templates
Tableau templates
Facebook Ads templates
Google Ads templates
Data fields & Metrics
AI prompt library & Guides
Product documentation
API documentation
Case studies
Blog
Data models
Windsor vs Supermetrics
Windsor vs Funnel.io
Windsor vs Fivetran
Windsor vs Rivery
Windsor vs Portermetrics
Windsor vs Coupler.io
Send your TikTok Ads data to
TikTok Ads Connector Reference
801 metrics149 dimensions
https://connectors.windsor.ai/tiktok?api_key=[your API key]&date_preset=last_7d&fields=campaign,clicks,spend,impressions,date,source&_renderer=csv
The TikTok Ads connector exposes 950 fields (801 metrics, 149 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.
Available options
report_timezone Report Timezone
Time zone to use for the report
Possible values (2)
LocalUTC
include_inactive Include Inactive
Also include campaigns, ad groups and ads that had no activity in the selected date range (for example paused ones) as extra rows. Only applies when the 'date' field is requested; without it inactive entities are already returned. Active entities keep their normal date-scoped metrics.
Available actions
Pause Ad Pause an active TikTok Ads ad. Reversible via enable_ad.
Pause an active TikTok Ads ad. Reversible via enable_ad.
Parameters
ad_idstringRequired
Pause Ad Group Pause an active TikTok Ads ad group. Reversible via enable_ad_group.
Pause an active TikTok Ads ad group. Reversible via enable_ad_group.
Parameters
ad_group_idstringRequired
Pause Campaign Pause an active TikTok Ads campaign. Reversible via enable_campaign.
Pause an active TikTok Ads campaign. Reversible via enable_campaign.
Parameters
campaign_idstringRequired
Enable Ad Enable a paused TikTok Ads ad. Reversible via pause_ad.
Enable a paused TikTok Ads ad. Reversible via pause_ad.
Parameters
ad_idstringRequired
Enable Ad Group Enable a paused TikTok Ads ad group. Reversible via pause_ad_group.
Enable a paused TikTok Ads ad group. Reversible via pause_ad_group.
Parameters
ad_group_idstringRequired
Enable Campaign Enable a paused TikTok Ads campaign. Reversible via pause_campaign.
Enable a paused TikTok Ads campaign. Reversible via pause_campaign.
Parameters
campaign_idstringRequired
Set Campaign Budget Set the budget of a TikTok Ads campaign. The amount is given in the account currency major unit (e.g. 100 means one hundred). The budget mode is fixed when the campaign is created and cannot be changed here: a campaign whose budget is unlimited (BUDGET_MODE_INFINITE) or managed at the ad group level has no campaign budget to update, and this action will report that the budget could not be changed. Use the ad group budget action for those campaigns.
Set the budget of a TikTok Ads campaign. The amount is given in the account currency major unit (e.g. 100 means one hundred). The budget mode is fixed when the campaign is created and cannot be changed here: a campaign whose budget is unlimited (BUDGET_MODE_INFINITE) or managed at the ad group level has no campaign budget to update, and this action will report that the budget could not be changed. Use the ad group budget action for those campaigns.
Parameters
campaign_idstringRequiredamountintegerRequired
Set Ad Group Budget Set the budget of a TikTok Ads ad group. The amount is in the account currency major unit (e.g. 100.00 means one hundred). The budget type (daily or lifetime) is fixed when the ad group is created and cannot be changed here; the existing type is detected automatically and its amount is updated. Ad groups whose budget is managed at the campaign level (Campaign Budget Optimization) have no ad group budget to set.
Set the budget of a TikTok Ads ad group. The amount is in the account currency major unit (e.g. 100.00 means one hundred). The budget type (daily or lifetime) is fixed when the ad group is created and cannot be changed here; the existing type is detected automatically and its amount is updated. Ad groups whose budget is managed at the campaign level (Campaign Budget Optimization) have no ad group budget to set.
Parameters
ad_group_idstringRequiredamountintegerRequired
TikTok Ads Fields
TikTok Ads Ad fields
The Ad report of the TikTok Ads connector includes 23 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| ad_id | TEXT | Ad ID | Ad ID. |
| ad_name | TEXT | Ad name | Ad name. |
| ad_operation_status | TEXT | Ad operation status | Ad operation status. Enum values: ENABLE, DISABLE, FROZEN. |
| ad_profile_image | TEXT | Ad Profile image | Ad profile image. |
| ad_status | TEXT | Ad Status (tiktok) | Ad status |
| ad_text | TEXT | Ad title | Ad title. |
| ad_url | TEXT | Ad URL. | Ad URL. |
| call_to_action | TEXT | Call to action | Call to action. |
| call_to_action_id | TEXT | Call to action (Duplicate) | Call to action. (Duplicate) |
| identity_id | TEXT | Identity ID | TikTok identity ID used for creating the ad. Only available at Ad level. |
| identity_type | TEXT | Identity type (Spark Ads) | Identity type. Enum values: CUSTOMIZED_USER, AUTH_CODE, TT_USER, BC_AUTH_TT. Any value except for CUSTOMIZED_USER indicatesthat the ad is a Spark Ad.Only available at Ad level. |
| image_height | NUMERIC | Image Height | The height of the image, measured in pixels. Only available at Ad level. |
| image_mode | TEXT | Format | Format. |
| image_url | IMAGE_URL | Image URL | The URL of the image. Only available at Ad level. |
| image_width | NUMERIC | Image Width | The width of the image, measured in pixels. Only available at Ad level. |
| is_automated_ad | BOOLEAN | Is Automated Ad | Whether the ad is an automated ad or a Smart Creative ad. |
| is_smart_creative | BOOLEAN | Is Smart Creative Ad | Whether the ad is a Smart Creative ad. |
| item_id | TEXT | TikTok post ID | The ID of the TikTok post that is used as Spark Ad. Only available at Ad level. |
| landing_page_url | TEXT | Landing page URL | Ad Landing page URL. |
| organic_video_views | NUMERIC | Organic Video Views | The number of times your video was played from organic traffic, excluding replays. Data from before Jan 21, 2023, or through paid ads stopped for more than 7 days won't be counted. |
| video_id | TEXT | Ad Video ID | The ad's video ID. |
| video_thumbnail_url | IMAGE_URL | Video Thumbnail URL | Thumbnail image URL for the video of ad. Only available at Ad level. |
| video_url | TEXT | Video URL | Video preview link. Only available at Ad level. |
TikTok Ads Ad Group fields
The Ad Group report of the TikTok Ads connector includes 19 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| ad_group_id | TEXT | Ad group ID | Ad group ID |
| ad_group_name | TEXT | Ad group name | Ad group name. |
| adgroup_download_url | TEXT | Download URL/Website URL | Download URL/Website URL. |
| aeo_type | TEXT | App Event Optimization Type | App Event Optimization Type. |
| bid | TEXT | Bid | Bid. |
| bid_secondary_goal | TEXT | Bid for secondary goal | Bid for secondary goal. |
| bid_strategy | TEXT | Bid strategy | Bid strategy. |
| billing_event | TEXT | Billing Event | Billing Event, e.g.: Clicks, Impression. |
| budget | NUMERIC | Ad group budget | Ad group budget. |
| dpa_target_audience_type | TEXT | Target audience type for DPA | The Audience that DPA products target. |
| mobile_app_id | TEXT | Mobile App ID | Mobile App ID. |
| opt_status | TEXT | Automated creative optimization | Automated creative optimization. |
| placement | TEXT | Placement | Placement type. |
| placement_type | TEXT | Placement type | Placement type. |
| profile_image | IMAGE_URL | Ad Group Profile image | Ad Group profile image. |
| promotion_type | TEXT | Promotion type | Promotion type. It can be app, website, or others. |
| smart_target | TEXT | Optimization goal | Optimization goal. |
| tt_app_id | TEXT | TikTok App ID | TikTok App ID, the App ID you used when creating an Ad Group. Returned if the promotion type of one Ad Group is App. |
| tt_app_name | TEXT | TikTok App Name | The name of your TikTok App. Returned if the promotion type of one Ad Group is App. |
TikTok Ads Advertiser fields
The Advertiser report of the TikTok Ads connector includes 3 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| account_id | TEXT | Account ID | Advertiser account ID. |
| account_name | TEXT | Account Name | Advertiser account name. |
| currency | TEXT | Currency | The currency code, e.g. USD. |
TikTok Ads Campaign fields
The Campaign report of the TikTok Ads connector includes 41 fields.
TikTok Ads Campaign fields (app_promotion_type to objective_type)
| ID | Type | Name | Description |
|---|---|---|---|
| app_promotion_type | TEXT | App promotion type | App promotion type. Possible values: APP_INSTALL, APP_RETARGETING. APP_INSTALL and APP_RETARGETING will be returned when objective_type is APP_PROMOTION. Otherwise, UNSET will be returned. |
| budget_optimize_switch | TEXT | Budget Optimize Switch | Whether Campaign Budget Optimization (CBO) is enabled |
| campaign | TEXT | Campaign | Campaign name. |
| campaign_advertiser_id | NUMERIC | Campaign Advertiser ID | Advertiser ID. |
| campaign_app_id | TEXT | Campaign App ID | The Application ID of the promoted app. |
| campaign_app_profile_page_state | TEXT | Campaign App Profile Page State | Indicates the status of App Profile Page. Enum values: INVALID, UNSET, ON, OFF. |
| campaign_automation_type | TEXT | Campaign Automation Type | The automation type of the campaign, distinguishing Smart+ campaigns from manual ones. Values include MANUAL and UPGRADED_SMART_PLUS. |
| campaign_bid_align_type | TEXT | Campaign Bid Align Type | The attribution type for the Dedicated Campaign. The type determines which attribution network the target CPA (conversion_bid_price) or ROAS (roas_bid) at the ad group level is based on. Values: SAN, SKAN. |
| campaign_bid_type | TEXT | Campaign Bid Type | Bidding strategy on the campaign level. |
| campaign_budget | NUMERIC | Campaign budget | Campaign budget. |
| campaign_budget_mode | TEXT | Campaign Budget Mode | Budget mode. Values: BUDGET_MODE_INFINITE: Unlimited budget. BUDGET_MODE_TOTAL: Lifetime budget. BUDGET_MODE_DAY : Daily budget. BUDGET_MODE_DYNAMIC_DAILY_BUDGET: Dynamic daily budget. It is the average daily budget over a week. Daily costs will not exceed 125% of the average daily budget. Weekly costs will not exceed the average daily budget * 7. |
| campaign_budget_type | TEXT | Campaign Budget Type (deprecated) | Campaign budget type |
| campaign_campaign_type | TEXT | Campaign Type | Campaign Type, indicates the campaign is a regular campaign or iOS 14 campaign. Values: REGULAR_CAMPAIGN, IOS14_CAMPAIGN. |
| campaign_catalog_enabled | BOOLEAN | Campaign Catalog Enabled | Whether to use your catalog to promote car inventory or models.This field will be true for Automotive Ads for Inventory or Automotive Ads for Models. |
| campaign_creation_time | Campaign Creation Time | Time at which campaign was created | |
| campaign_deep_bid_type | TEXT | Campaign Deep Bid Type | Bidding strategy for in-app events. |
| campaign_disable_skan_campaign | BOOLEAN | Campaign Disable SKAN | Whether to disable SKAN (SKAdNetwork) attribution, Apple's conversion attribution solution for iOS campaigns. |
| campaign_id | TEXT | Campaign ID | Campaign ID. |
| campaign_is_advanced_dedicated_campaign | BOOLEAN | Campaign Is Advanced Dedicated Campaign | Whether the campaign is an Advanced Dedicated Campaign. Advanced Dedicated Campaigns leverage advanced delivery models that benefit from real-time signals. |
| campaign_is_new_structure | BOOLEAN | Campaign Is New Structure | Whether the campaign is a new structure (for the same campaign, the structure of campaign, ad groups and ads are the same). |
| campaign_is_search_campaign | BOOLEAN | Campaign Is Search | Whether the campaign is a Search Campaign. |
| campaign_is_smart_performance_campaign | BOOLEAN | Campaign Is Smart Performance | Whether the campaign is an automated campaign type. |
| campaign_modify_time | Campaign Modify Time (deprecated) | Time at which campaign was modified | |
| campaign_name | TEXT | Campaign | Campaign name. (Duplicate) |
| campaign_operation_status | TEXT | Campaign Operation Status | Operation status of the campaign. Enum values: ENABLE : The campaign is enabled (in 'ON' status). DISABLE: The campaign is disabled (in 'OFF' status). |
| campaign_optimization_goal | TEXT | Campaign Optimization Goal | Optimization goal. |
| campaign_optimize_goal | TEXT | Campaign Optimize Goal (Deprecated) | Campaign Optimization goal. Returned only if Campaign Budget Optimization is enabled. This field isn't supported anymore, use optimization_goal (Adgroup Optimization goal) instead. |
| campaign_postback_window_mode | TEXT | Campaign Postback Window Mode | The mode that determines which SKAN 4.0 postback you want to secure. Values: POSTBACK_WINDOW_MODE1: This option secures the first postback, which corresponds to the 0-2 day attribution window. The data can take up to 4 days to return, and the campaign will wait for 4 days to release the campaign quota. POSTBACK_WINDOW_MODE2: This mode secures the first two postbacks, which correspond to the 3-7 day attribution window. The data can take up to 13 days to return, and the campaign will wait for 13 days to release the campaign quota. POSTBACK_WINDOW_MODE3: This mode secures all three postbacks, which correspond to the 8-35 day attribution window. The data can take up to 41 days to return, and the campaign will wait for 41 days to release the campaign quota. |
| campaign_product_source | TEXT | Campaign Product Source | Returned only when objective_type for the campaign is PRODUCT_SALES and the product source is configured for the campaign. Product source of the campaign. Values: CATALOG : Catalog. STORE: TikTok Shop, or TikTok Showcase. |
| campaign_rf_campaign_type | TEXT | Campaign RF Type | When objective_type is specified as RF_REACH, this field specifies the specific Reservation campaign type. Values: STANDARD: Reach & Frequency campaign. PULSE: TikTok Pulse campaign. TOPVIEW: TopView campaign. |
| campaign_roas_bid | TEXT | ROAS bid | ROAS goal for Value Optimization bid strategies (VO_*) |
| campaign_rta_bid_enabled | BOOLEAN | Campaign RTA Bid Enabled | Whether to use RTA bid. |
| campaign_rta_id | TEXT | Campaign RTA ID | Realtime API (RTA) ID, the RTA strategy identifier. |
| campaign_rta_product_selection_enabled | BOOLEAN | Campaign RTA Product Selection Enabled | Whether to use RTA to automatically select products. |
| campaign_special_industries | TEXT | Campaign Special Industries | Special ad categories. Values: HOUSING: Ads for real estate listings, homeowners insurance, mortgage loans or other related opportunities. EMPLOYMENT: Ads for job offers, internship, professional certification programs or other related opportunities. CREDIT: Ads for credit card offers, auto loans, long-term financing or other related opportunities. Note: Using special ad categories in Shopping Ads with campaign product source as Catalog and in Shopping Ads with campaign product source as non-Catalog are currently separate allowlist-only features. If you would like to access them, please contact your TikTok representative. This field is generally available to advertisers registered in America or Canada. Advertisers who are not registered in America or Canada but want to target these countries with special ad categories need to apply for an additional allowlist. |
| campaign_status | TEXT | Campaign Status | Campaign status |
| campaign_system_origin | TEXT | Campaign System Origin | Returned for Promote campaigns only. Not returned for non-Promote campaigns. The origin (source) of the campaign. PROMOTE: The campaign is a Promote campaign created through the TikTok mobile App. |
| campaign_type | TEXT | Campaign type | iOS14 Dedicated Campaign or regular campaign. |
| objective | TEXT | Objective | Campaign type (application or landing page). |
| objective_type | TEXT | Advertising objective | Campaign advertising objective. Possible values: CONVERSIONS, TRAFFIC, REACH, APP_PROMOTION, WEB_CONVERSIONS, TOPVIEW_REACH, RF_REACH, LEAD_GENERATION, ENGAGEMENT, PRODUCT_SALES, VIDEO_VIEWS, SHOP_PURCHASES. |
TikTok Ads Campaign fields (split_test to split_test)
| ID | Type | Name | Description |
|---|---|---|---|
| split_test | TEXT | Split test status | Split test status. |
TikTok Ads Conversions (App) fields
The Conversions (App) report of the TikTok Ads connector includes 208 fields.
TikTok Ads Conversions (App) fields (achieve_level to cost_per_next_day_open)
| ID | Type | Name | Description |
|---|---|---|---|
| achieve_level | NUMERIC | Unique levels achieved (app) | The number of unique app achieve level actions attributed to your ads. |
| achieve_level_rate | PERCENT | Unique level achievement rate (app) | The percentage of app achieve level actions from all app installs attributed to your ads. |
| ad_impression_ad_revenue_day0 | NUMERIC | Day 0 ad revenue | Total ad revenue within 24 hours of app install. |
| ad_impression_ad_revenue_day2 | NUMERIC | Day 2 ad revenue | Total ad revenue within 72 hours of app install. |
| ad_impression_ad_revenue_day6 | NUMERIC | Day 6 ad revenue | Total ad revenue within 168 hours of app install. |
| ad_impression_ad_revenue_roas_day0 | NUMERIC | Day 0 ad revenue ROAS | Total return on ad spend (ROAS) from ad revenue within 24 hours of app install. |
| ad_impression_ad_revenue_roas_day2 | NUMERIC | Day 2 ad revenue ROAS | Total return on ad spend (ROAS) from ad revenue within 72 hours of app install. |
| ad_impression_ad_revenue_roas_day6 | NUMERIC | Day 6 ad revenue ROAS | Total return on ad spend (ROAS) from ad revenue within 168 hours of app install. |
| add_payment_info | NUMERIC | Unique payment info adds (app) | The number of unique app add payment info actions attributed to your ads. |
| add_payment_info_rate | PERCENT | Unique payment info add rate (app) | The percentage of app add payment info actions from all app installs attributed to your ads. |
| add_to_wishlist | NUMERIC | Unique adds to wishlist (app) | The number of unique app add to wishlist actions attributed to your ads. |
| add_to_wishlist_rate | PERCENT | Unique add to wishlist rate (app) | The percentage of app add to wishlist actions from all app installs attributed to your ads. |
| ads_impression_events | NUMERIC | Ads impressions events | The total number of ad impression events from your mobile app counted as app events and attributed to your ads. |
| app_event_add_to_cart | NUMERIC | Unique adds to cart (app) | The number of unique app add to cart actions attributed to your ads. |
| app_event_add_to_cart_rate | PERCENT | Unique add to cart rate (app) | The percentage of app add to cart actions from all app installs attributed to your ads. |
| app_install | NUMERIC | App install | The number of times your mobile app was installed that were recorded as app events and attributed to your ads. (The total count is calculated based on the time each ad impression occurred.) |
| checkout | NUMERIC | Unique checkouts (app) | The number of unique app checkout actions attributed to your ads. |
| checkout_rate | PERCENT | Unique checkout rate (app) | The percentage of app checkout actions from all app installs attributed to your ads. |
| complete_tutorial | NUMERIC | Unique tutorials completed (app) | The number of unique app complete tutorial actions attributed to your ads. |
| complete_tutorial_rate | PERCENT | Unique tutorial completion rate (app) | The percentage of app complete tutorial actions from all app installs attributed to your ads. |
| cost_per_achieve_level | NUMERIC | Unique cost per unique level achieved (app) | The average cost per unique app achieve level action attributed to your ads. |
| cost_per_add_payment_info | NUMERIC | Unique cost per payment info add (app) | The average cost per unique app add payment info action attributed to your ads. |
| cost_per_add_to_wishlist | NUMERIC | Unique cost per add to wishlist (app) | The average cost per unique app add to wishlist action attributed to your ads. |
| cost_per_app_event_add_to_cart | NUMERIC | Unique cost per add to cart (app) | The average cost per unique app add to cart action attributed to your ads. |
| cost_per_app_install | NUMERIC | Cost per app install | The average cost for each app install event. (The total count is calculated based on the time each ad impression occurred.) |
| cost_per_checkout | NUMERIC | Unique cost per checkout (app) | The average cost per unique app checkout action attributed to your ads. |
| cost_per_complete_tutorial | NUMERIC | Unique cost per complete tutorial (app) | The average cost per unique app complete tutorial action attributed to your ads. |
| cost_per_create_gamerole | NUMERIC | Unique cost per role created (app) | The average cost per unique app create role action attributed to your ads. |
| cost_per_create_group | NUMERIC | Unique cost per group created (app) | The average cost per unique app create group action attributed to your ads. |
| cost_per_custom_app_event | NUMERIC | Cost per custom event (app) | The average cost per custom app event attributed to your ads. |
| cost_per_day7_retention | NUMERIC | Cost per unique Day 7 retention | Average cost per unique Day 7 retention attributed to your ad. |
| cost_per_in_app_ad_click | NUMERIC | Unique cost per in-app ad click (app) | The average cost per unique in-app ad click attributed to your ads. |
| cost_per_in_app_ad_impr | NUMERIC | Unique cost per in-app ad impression (app) | The average cost per unique in-app ad impression attributed to your ads. |
| cost_per_join_group | NUMERIC | Unique cost per group join (app) | The average cost per unique app join group action attributed to your ads. |
| cost_per_launch_app | NUMERIC | Unique cost per app launch (app) | The average cost per unique launch app action attributed to your ads. |
| cost_per_loan_apply | NUMERIC | Unique cost per loan application (app) | The average cost per unique app loan application action attributed to your ads. |
| cost_per_loan_credit | NUMERIC | Unique cost per loan approval (app) | The average cost per unique app loan approval action attributed to your ads. |
| cost_per_loan_disbursement | NUMERIC | Unique cost per loan disbursal (app) | The average cost per unique app loan disbursal action attributed to your ads. |
| cost_per_login | NUMERIC | Unique cost per login (app) | The average cost per unique app login action attributed to your ads. |
| cost_per_next_day_open | NUMERIC | Cost per unique Day 1 retention | Average cost per unique Day 1 retention. |
TikTok Ads Conversions (App) fields (cost_per_purchase to cost_pre_ad_impression_event)
| ID | Type | Name | Description |
|---|---|---|---|
| cost_per_purchase | NUMERIC | Unique cost per purchase (app) | The average cost per unique app purchase action attributed to your ads. |
| cost_per_ratings | NUMERIC | Unique cost per rating (app) | The average cost per unique app rate action attributed to your ads. |
| cost_per_registration | NUMERIC | Unique cost per registration (app) | The average cost per unique app registration action attributed to your ads. |
| cost_per_sales_lead | NUMERIC | Unique cost per lead generated (app) | The average cost per unique app generate lead action attributed to your ads. |
| cost_per_search | NUMERIC | Unique cost per search (app) | The average cost per unique app search action attributed to your ads. |
| cost_per_spend_credits | NUMERIC | Unique cost per credit spend (app) | The average cost per unique app spend credit action attributed to your ads. |
| cost_per_start_trial | NUMERIC | Unique cost per trial started (app) | The average cost per unique app start trial action attributed to your ads. |
| cost_per_subscribe | NUMERIC | Unique cost per subscription (app) | The average cost per unique app subscribe action attributed to your ads. |
| cost_per_total_achieve_level | NUMERIC | Cost per level achieved (app) | The average cost per app achieve level action attributed to your ads. |
| cost_per_total_add_to_wishlist | NUMERIC | Cost per add to wishlist (app) | The average cost per app add to wishlist action attributed to your ads. |
| cost_per_total_app_event_add_to_cart | NUMERIC | Cost per add to cart (app) | The average cost per app add to cart action attributed to your ads. |
| cost_per_total_checkout | NUMERIC | Cost per checkout (app) | The average cost per app checkout action attributed to your ads. |
| cost_per_total_complete_tutorial | NUMERIC | Cost per complete tutorial (app) | The average cost per app complete tutorial action attributed to your ads. |
| cost_per_total_create_gamerole | NUMERIC | Cost per role created (app) | The average cost per app create role action attributed to your ads. |
| cost_per_total_create_group | NUMERIC | Cost per group created (app) | The average cost per app create group action attributed to your ads. |
| cost_per_total_day7_retention | NUMERIC | Cost per Day 7 retention | Average cost per Day 7 retention attributed to your ad. |
| cost_per_total_in_app_ad_click | NUMERIC | Cost per in-app ad click (app) | The average cost per in-app ad click attributed to your ads. |
| cost_per_total_in_app_ad_impr | NUMERIC | Cost per in-app ad impression (app) | The average cost per in-app ad impression attributed to your ads. |
| cost_per_total_join_group | NUMERIC | Cost per group join (app) | The average cost per app join group action attributed to your ads. |
| cost_per_total_launch_app | NUMERIC | Cost per app launch (app) | The average cost per launch app action attributed to your ads. |
| cost_per_total_loan_apply | NUMERIC | Cost per loan application (app) | The average cost per app loan application action attributed to your ads. |
| cost_per_total_loan_credit | NUMERIC | Cost per loan approval (app) | The average cost per app loan approval action attributed to your ads. |
| cost_per_total_loan_disbursement | NUMERIC | Cost per loan disbursal (app) | The average cost per app loan disbursal action attributed to your ads. |
| cost_per_total_login | NUMERIC | Cost per login (app) | The average cost per app login action attributed to your ads. |
| cost_per_total_next_day_open | NUMERIC | Cost per Day 1 retention | Average cost per Day 1 retention. |
| cost_per_total_purchase | NUMERIC | Cost per purchase (app) | The average cost per app purchase action attributed to your ads. |
| cost_per_total_ratings | NUMERIC | Cost per rating (app) | The average cost per app rate action attributed to your ads. |
| cost_per_total_registration | NUMERIC | Cost per registration (app) | The average cost per app registration action attributed to your ads. |
| cost_per_total_sales_lead | NUMERIC | Cost per lead generated (app) | The average cost per app generate lead action attributed to your ads. |
| cost_per_total_search | NUMERIC | Cost per search (app) | The average cost per app search action attributed to your ads. |
| cost_per_total_spend_credits | NUMERIC | Cost per credit spend (app) | The average cost per app spend credit action attributed to your ads. |
| cost_per_total_start_trial | NUMERIC | Cost per trial started (app) | The average cost per app start trial action attributed to your ads. |
| cost_per_total_subscribe | NUMERIC | Cost per subscription (app) | The average cost per app subscribe action attributed to your ads. |
| cost_per_total_unlock_achievement | NUMERIC | Cost per achievement unlocked (app) | The average cost per app unlock achievement action attributed to your ads. |
| cost_per_total_view_content | NUMERIC | Cost per content view (app) | The average cost per app view content action attributed to your ads. |
| cost_per_unique_ad_impression_event | NUMERIC | Cost per unique ads impression | The average cost of each unique ad impression event attributed to your ad. |
| cost_per_unique_custom_app_event | NUMERIC | Cost per unique custom event (app) | The average cost per unique custom app event attributed to your ads. |
| cost_per_unlock_achievement | NUMERIC | Unique cost per achievement unlocked (app) | The average cost per unique app unlock achievement action attributed to your ads. |
| cost_per_view_content | NUMERIC | Unique cost per content view (app) | The average cost per unique app view content action attributed to your ads. |
| cost_pre_ad_impression_event | NUMERIC | Cost per ads impression | The average cost of each ad impression event attributed to your ad. |
TikTok Ads Conversions (App) fields (cost_total_add_payment_info to search)
| ID | Type | Name | Description |
|---|---|---|---|
| cost_total_add_payment_info | NUMERIC | Cost per payment info add (app) | The average cost per app add payment info action attributed to your ads. |
| create_gamerole | NUMERIC | Unique roles created (app) | The number of unique app create role actions attributed to your ads. |
| create_gamerole_rate | PERCENT | Unique role creation rate (app) | The percentage of app create role actions from all app installs attributed to your ads. |
| create_group | NUMERIC | Unique groups created (app) | The number of unique app create group actions attributed to your ads. |
| create_group_rate | PERCENT | Unique group creation rate (app) | The percentage of app create group actions from all app installs attributed to your ads. |
| custom_app_event_rate | PERCENT | Custom event rate (app) (%) | The percentage of custom app events from all app installs attributed to your ads. |
| custom_app_events | NUMERIC | Custom events (app) | The number of custom app events attributed to your ads. |
| custom_app_events_value | NUMERIC | Custom event value (app) | The total value of custom app events attributed to your ads. |
| customized_ad_impression_event_rate | PERCENT | Unique ad impression rate (%) | The percentage of unique ad impression events out of all app install events. |
| day7_retention | NUMERIC | Unique Day 7 retentions | Number of unique Day 7 retentions from your mobile app counted as app events and attributed to your ads. |
| day7_retention_rate | PERCENT | Day 7 retention rate (%) | Percentage of Day 7 retentions out of all app install events. |
| in_app_ad_click | NUMERIC | Unique in-app ad clicks (app) | The number of unique in-app ad clicks attributed to your ads. |
| in_app_ad_click_rate | PERCENT | In-app ad click rate (app) | The percentage of in-app ad clicks from all app installs attributed to your ads. |
| in_app_ad_impr | NUMERIC | Unique in-app ad impressions (app) | The number of unique in-app ad impressions attributed to your ads. |
| in_app_ad_impr_rate | PERCENT | In-app ad impression rate (app) | The percentage of in-app ad impressions from all app installs attributed to your ads. |
| join_group | NUMERIC | Unique group joins (app) | The number of unique app join group actions attributed to your ads. |
| join_group_rate | PERCENT | Unique group joining rate (app) | The percentage of app join group actions from all app installs attributed to your ads. |
| launch_app | NUMERIC | Unique app launches (app) | The number of unique launch app actions attributed to your ads. |
| launch_app_rate | PERCENT | Unique app launch rate (app) | The percentage of launch app actions from all app installs attributed to your ads. |
| loan_apply | NUMERIC | Unique loan applications (app) | The number of unique app loan application actions attributed to your ads. |
| loan_apply_rate | PERCENT | Unique loan application rate (app) | The percentage of app loan application actions from all app installs attributed to your ads. |
| loan_credit | NUMERIC | Unique loan approvals (app) | The number of unique app loan approval actions attributed to your ads. |
| loan_credit_rate | PERCENT | Unique loan approval rate (app) | The percentage of app loan approval actions from all app installs attributed to your ads. |
| loan_disbursement | NUMERIC | Unique loan disbursals (app) | The number of unique app loan disbursal actions attributed to your ads. |
| loan_disbursement_rate | PERCENT | Unique loan disbursal rate (app) | The percentage of app loan disbursal actions from all app installs attributed to your ads. |
| login | NUMERIC | Unique logins (app) | The number of unique app login actions attributed to your ads. |
| login_rate | PERCENT | Unique login rate (app) | The percentage of app login actions from all app installs attributed to your ads. |
| next_day_open | NUMERIC | Unique Day 1 retentions | Number of unique Day 1 retentions attributed to your ads. |
| next_day_open_rate | PERCENT | Day 1 retention rate (%) | Percentage of unique Day 1 retentions out of all app install events. |
| purchase | NUMERIC | Unique purchases (app) | The number of unique app purchase actions attributed to your ads. |
| purchase_rate | PERCENT | Unique purchase rate (app) | The percentage of app purchase actions from all app installs attributed to your ads. |
| ratings | NUMERIC | Unique ratings (app) | The number of unique app rate actions attributed to your ads. |
| ratings_rate | PERCENT | Unique rate rate (%) | The percentage of unique rate events out of all app install events. |
| real_time_app_install | NUMERIC | App installs by conversion time | The number of times your mobile app was installed that were recorded as app events and attributed to your ads. (The total count is based on when the conversion actually happened.) |
| real_time_app_install_cost | NUMERIC | Cost per app install by conversion time | The average cost for each app install event. (The total count is based on when the conversion actually happened.) |
| registration | NUMERIC | Unique registrations (app) | The number of unique app registration actions attributed to your ads. |
| registration_rate | PERCENT | Unique registration rate (app) | The percentage of app registration actions from all app installs attributed to your ads. |
| sales_lead | NUMERIC | Unique leads generated (app) | The number of unique app generate lead actions attributed to your ads. |
| sales_lead_rate | PERCENT | Unique lead generation rate (app) | The percentage of app generate lead actions from all app installs attributed to your ads. |
| search | NUMERIC | Unique searches (app) | The number of unique app search actions attributed to your ads. |
TikTok Ads Conversions (App) fields (search_rate to total_purchase)
| ID | Type | Name | Description |
|---|---|---|---|
| search_rate | PERCENT | Unique search rate (app) | The percentage of app search actions from all app installs attributed to your ads. |
| spend_credits | NUMERIC | Unique credit spends (app) | The number of unique app spend credit actions attributed to your ads. |
| spend_credits_rate | PERCENT | Unique credit spend rate (app) | The percentage of app spend credit actions from all app installs attributed to your ads. |
| start_trial | NUMERIC | Unique trial started (app) | The number of unique app start trial actions attributed to your ads. |
| start_trial_rate | PERCENT | Unique trial start rate (app) | The percentage of app start trial actions from all app installs attributed to your ads. |
| subscribe | NUMERIC | Unique subscriptions (app) | The number of unique app subscribe actions attributed to your ads. |
| subscribe_rate | PERCENT | Unique subscription rate (app) | The percentage of app subscribe actions from all app installs attributed to your ads. |
| total_achieve_level | NUMERIC | Levels achieved (app) | The number of app achieve level actions attributed to your ads. |
| total_achieve_level_value | NUMERIC | Level achievement value (app) | The total value of app achieve level actions attributed to your ads. |
| total_active_pay_roas | NUMERIC | Purchase ROAS (app) | The return on ad spend (ROAS) from app purchase actions. |
| total_ad_impression_events_value | NUMERIC | Ads impression value | The total value returned from all ad impression events. |
| total_ad_impression_roas | NUMERIC | Ads impression ROAS | The total return on ad spend (ROAS) from ad impression events. |
| total_add_payment_info | NUMERIC | Payment info adds (app) | The number of app add payment info actions attributed to your ads. |
| total_add_to_wishlist | NUMERIC | Adds to wishlist (app) | The number of app add to wishlist actions attributed to your ads. |
| total_add_to_wishlist_value | NUMERIC | Add to wishlist value (app) | The total value of app add to wishlist actions attributed to your ads. |
| total_app_event_add_to_cart | NUMERIC | Adds to cart (app) | The number of app add to cart actions attributed to your ads. |
| total_app_event_add_to_cart_value | NUMERIC | Add to cart value (app) | The total value of app add to cart actions attributed to your ads. |
| total_checkout | NUMERIC | Checkouts (app) | The number of app checkout actions attributed to your ads. |
| total_checkout_value | NUMERIC | Checkout value (app) | The total value of app checkout actions attributed to your ads. |
| total_complete_tutorial | NUMERIC | Tutorials completed (app) | The number of app complete tutorial actions attributed to your ads. |
| total_complete_tutorial_value | NUMERIC | Tutorial completion value (app) | The total value of app complete tutorial actions attributed to your ads. |
| total_create_gamerole | NUMERIC | Roles created (app) | The number of app create role actions attributed to your ads. |
| total_create_gamerole_value | NUMERIC | Role creation value (app) | The total value of app create role actions attributed to your ads. |
| total_create_group | NUMERIC | Groups created (app) | The number of app create group actions attributed to your ads. |
| total_create_group_value | NUMERIC | Group creation value (app) | The total value of app create group actions attributed to your ads. |
| total_day7_retention | NUMERIC | Day 7 retentions | Total number of Day 7 retentions from your mobile app counted as app events and attributed to your ads. |
| total_day7_retention_value | NUMERIC | Day 7 retention value | Total value returned from all Day 7 retentions. |
| total_in_app_ad_click | NUMERIC | In-app ad clicks (app) | The number of in-app ad clicks attributed to your ads. |
| total_in_app_ad_click_value | NUMERIC | In-app ad click value (app) | The total value of in-app ad clicks attributed to your ads. |
| total_in_app_ad_impr | NUMERIC | In-app ad impressions (app) | The number of in-app ad impressions attributed to your ads. |
| total_in_app_ad_impr_value | NUMERIC | In-app ad impression value (app) | The total value of in-app ad impressions attributed to your ads. |
| total_join_group | NUMERIC | Group joins (app) | The number of app join group actions attributed to your ads. |
| total_join_group_value | NUMERIC | Group joining value (app) | The total value of app join group actions attributed to your ads. |
| total_launch_app | NUMERIC | App launches (app) | The number of launch app actions attributed to your ads. |
| total_loan_apply | NUMERIC | Loan applications (app) | The number of app loan application actions attributed to your ads. |
| total_loan_credit | NUMERIC | Loan approvals (app) | The number of app loan approval actions attributed to your ads. |
| total_loan_disbursement | NUMERIC | Loan disbursals (app) | The number of app loan disbursal actions attributed to your ads. |
| total_login | NUMERIC | Logins (app) | The number of app login actions attributed to your ads. |
| total_next_day_open | NUMERIC | Day 1 retentions | Number of Day 1 retentions attributed to your ads. |
| total_purchase | NUMERIC | Purchases (app) | The number of app purchase actions attributed to your ads. |
TikTok Ads Conversions (App) fields (total_purchase_roas_day0 to value_per_total_purchase)
| ID | Type | Name | Description |
|---|---|---|---|
| total_purchase_roas_day0 | NUMERIC | Day 0 purchase ROAS | Total return on ad spend (ROAS) from purchase actions within 24 hours of app install. |
| total_purchase_roas_day2 | NUMERIC | Day 2 purchase ROAS | Total return on ad spend (ROAS) from purchase actions within 72 hours of app install. |
| total_purchase_roas_day6 | NUMERIC | Day 6 purchase ROAS | Total return on ad spend (ROAS) from purchase actions within 168 hours of app install. |
| total_purchase_value | NUMERIC | Purchase value (app) | The total value of app purchase actions attributed to your ads. |
| total_purchase_value_day0 | NUMERIC | Day 0 purchase value | Total value of all purchase actions within 24 hours of app install. |
| total_purchase_value_day2 | NUMERIC | Day 2 purchase value | Total value of all purchase actions within 72 hours of app install. |
| total_purchase_value_day6 | NUMERIC | Day 6 purchase value | Total value of all purchase actions within 168 hours of app install. |
| total_ratings | NUMERIC | Ratings (app) | The number of app rate actions attributed to your ads. |
| total_ratings_value | NUMERIC | Rating value (app) | The total value of app rate actions attributed to your ads. |
| total_registration | NUMERIC | Registrations (app) | The number of app registration actions attributed to your ads. |
| total_sales_lead | NUMERIC | Leads generated (app) | The number of app generate lead actions attributed to your ads. |
| total_sales_lead_value | NUMERIC | Lead generation value (app) | The total value of app generate lead actions attributed to your ads. |
| total_search | NUMERIC | Searches (app) | The number of app search actions attributed to your ads. |
| total_spend_credits | NUMERIC | Credit spends (app) | The number of app spend credit actions attributed to your ads. |
| total_spend_credits_value | NUMERIC | Credit spend value (app) | The total value of app spend credit actions attributed to your ads. |
| total_start_trial | NUMERIC | Trials started (app) | The number of app start trial actions attributed to your ads. |
| total_subscribe | NUMERIC | Subscriptions (app) | The number of app subscribe actions attributed to your ads. |
| total_subscribe_value | NUMERIC | Subscription value (app) | The total value of app subscribe actions attributed to your ads. |
| total_unlock_achievement | NUMERIC | Achievements unlocked (app) | The number of app unlock achievement actions attributed to your ads. |
| total_unlock_achievement_value | NUMERIC | Unlocked achievement value (app) | The total value of app unlock achievement actions attributed to your ads. |
| total_view_content | NUMERIC | Content views (app) | The number of app view content actions attributed to your ads. |
| total_view_content_value | NUMERIC | Content view value (app) | The total value of app view content actions attributed to your ads. |
| unique_ad_impression_events | NUMERIC | Unique ad impressions | The number of unique ad impression events from your mobile app counted as app events and attributed to your ads. |
| unique_custom_app_events | NUMERIC | Unique custom events (app) | The number of unique custom app events attributed to your ads. |
| unlock_achievement | NUMERIC | Unique achievements unlocked (app) | The number of unique app unlock achievement actions attributed to your ads. |
| unlock_achievement_rate | PERCENT | Unique unlocked achievement rate (app) | The percentage of app unlock achievement actions from all app installs attributed to your ads. |
| value_per_ad_impression_event | NUMERIC | Value per ads impression | The average value of each ad impression event attributed to your ad. |
| value_per_checkout | NUMERIC | Value per checkout (app) | The average value per app checkout action attributed to your ads. |
| value_per_custom_app_event | NUMERIC | Value per custom event (app) | The average value per custom app event attributed to your ads. |
| value_per_total_achieve_level | NUMERIC | Value per level achieved (app) | The average value per app achieve level action attributed to your ads. |
| value_per_total_add_to_wishlist | NUMERIC | Value per add to wishlist (app) | The average value per app add to wishlist action attributed to your ads. |
| value_per_total_app_event_add_to_cart | NUMERIC | Value per add to cart (app) | The average value per app add to cart action attributed to your ads. |
| value_per_total_complete_tutorial | NUMERIC | Value per complete tutorial (app) | The average value per app complete tutorial action attributed to your ads. |
| value_per_total_create_gamerole | NUMERIC | Value per role created (app) | The average value per app create role action attributed to your ads. |
| value_per_total_create_group | NUMERIC | Value per group created (app) | The average value per app create group action attributed to your ads. |
| value_per_total_day7_retention | NUMERIC | Value per Day 7 retention | Average value per Day 7 retention attributed to your ad. |
| value_per_total_in_app_ad_click | NUMERIC | Value per in-app ad click (app) | The average value per in-app ad click attributed to your ads. |
| value_per_total_in_app_ad_impr | NUMERIC | Value per in-app ad impression (app) | The average value per in-app ad impression attributed to your ads. |
| value_per_total_join_group | NUMERIC | Value per group join (app) | The average value per app join group action attributed to your ads. |
| value_per_total_purchase | NUMERIC | Value per purchase (app) | The average value per app purchase action attributed to your ads. |
TikTok Ads Conversions (App) fields (value_per_total_ratings to view_content_rate)
| ID | Type | Name | Description |
|---|---|---|---|
| value_per_total_ratings | NUMERIC | Value per rating (app) | The average value per app rate action attributed to your ads. |
| value_per_total_sales_lead | NUMERIC | Value per lead generated (app) | The average value per app generate lead action attributed to your ads. |
| value_per_total_spend_credits | NUMERIC | Value per credit spend (app) | The average value per app spend credit action attributed to your ads. |
| value_per_total_subscribe | NUMERIC | Value per subscription (app) | The average value per app subscribe action attributed to your ads. |
| value_per_total_unlock_achievement | NUMERIC | Value per achievement unlocked (app) | The average value per app unlock achievement action attributed to your ads. |
| value_per_total_view_content | NUMERIC | Value per content view (app) | The average value per app view content action attributed to your ads. |
| view_content | NUMERIC | Unique content views (app) | The number of unique app view content actions attributed to your ads. |
| view_content_rate | PERCENT | Unique content view rate (app) | The percentage of app view content actions from all app installs attributed to your ads. |
TikTok Ads Conversions (Attribution) fields
The Conversions (Attribution) report of the TikTok Ads connector includes 30 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| cost_per_cta_app_install | NUMERIC | Cost per CTA app install | The average cost per each app install event attributed to a click on your ad. |
| cost_per_cta_conversion | NUMERIC | Cost per CTA conversion | The average cost per each conversion event attributed to a click on your ad. |
| cost_per_cta_purchase | NUMERIC | Cost per CTA purchase (app) | Average cost per in-app purchase event attributed to a click on your ad. |
| cost_per_cta_registration | NUMERIC | Cost per CTA registration | Average cost for an in-app registration event attributed to a click on your ad. |
| cost_per_engaged_view_through_conversion | NUMERIC | Cost per EVTA conversion | Average cost per conversion attributed to an engaged view.The average cost of each conversion that is attributed to an engaged view. |
| cost_per_evta_app_install | NUMERIC | Cost per EVTA app install | The average cost per app install action attributed to engaged views of your ad. |
| cost_per_evta_payments_completed | NUMERIC | Cost per EVTA purchase (website) | The average cost per website purchase action attributed to engaged views of your ad. |
| cost_per_evta_purchase | NUMERIC | Cost per EVTA purchase (app) | The average cost per in-app purchase action attributed to engaged views of your ad. |
| cost_per_evta_registration | NUMERIC | Cost per EVTA registration | The average cost per registration action attributed to engaged views of your ad. |
| cost_per_vta_app_install | NUMERIC | Cost per VTA app install | The average cost per each app install event attributed to an ad impression. |
| cost_per_vta_conversion | NUMERIC | Cost per VTA conversion | The average cost per each conversion event attributed to an ad impression. |
| cost_per_vta_payments_completed | NUMERIC | Cost per VTA purchase (website) | Average cost of each website purchase event attributed to someone only viewing your ad. |
| cost_per_vta_purchase | NUMERIC | Cost per VTA purchase (app) | Average cost per in-app purchase event attributed to an ad impression. |
| cost_per_vta_registration | NUMERIC | Cost per VTA registration | Average cost per registration event attributed to an ad impression. |
| cta_app_install | NUMERIC | CTA app installs | The number of app install events attributed to a click on your ad. |
| cta_conversion | NUMERIC | CTA conversions | The number of conversion events attributed to a click on your ad. |
| cta_purchase | NUMERIC | CTA purchases (app) | Number of in-app purchase events attributed to clicks on your ad based on information received from your measurement partner. |
| cta_registration | NUMERIC | CTA registrations | Number of in-app registration events attributed to a click on your ad based on information received from your measurement partner. |
| engaged_view_through_conversions | NUMERIC | EVTA conversions | Number of conversions attributed to engaged views. |
| evta_app_install | NUMERIC | EVTA app installs | The number of app install actions attributed to engaged views of your ad. |
| evta_payments_completed | NUMERIC | EVTA purchases (website) | The number of website purchase actions attributed to engaged views of your ad. |
| evta_purchase | NUMERIC | EVTA purchases (app) | The number of in-app purchase actions attributed to engaged views of your ad. |
| evta_registration | NUMERIC | EVTA registrations | The number of registration actions attributed to engaged views of your ad. |
| vta_app_install | NUMERIC | VTA app installs | The number of app install events attributed to an ad impression. |
| vta_complete_payment | NUMERIC | VTA purchases (website) | Website purchase events attributed to someone only viewing your ad. |
| vta_complete_payment_roas | NUMERIC | VTA purchase ROAS | Return on ad spend (ROAS) from purchase events attributed to someone only viewing your ad. |
| vta_complete_payment_value | NUMERIC | VTA purchase value | Total value of purchase events attributed to someone only viewing your ad. |
| vta_conversion | NUMERIC | VTA conversions | The number of conversion events attributed to an ad impression. |
| vta_purchase | NUMERIC | VTA purchases (app) | Number of in-app purchase events attributed to an ad impression based on information received from your measurement partner. |
| vta_registration | NUMERIC | VTA registrations | Number of registration events attributed to an ad impression based on information received from your measurement partner. |
TikTok Ads Conversions (Messaging) fields
The Conversions (Messaging) report of the TikTok Ads connector includes 6 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| messaging_conversation_rate_instant_messaging_app | PERCENT | Conversation rate (Instant messaging app) (%) | Percentage of instant messaging app conversation started out of all click events attributed to your TikTok ads. |
| messaging_conversation_rate_tiktok_direct_message | PERCENT | Conversation rate (TikTok direct message) (%) | Percentage of TikTok direct message conversations that occurred within a TikTok-owned property (out of all click events). |
| messaging_cost_per_conversation_instant_messaging_app | NUMERIC | Cost per conversation (Instant messaging app) | Average cost per instant messaging app conversation started event attributed to your TikTok ads. |
| messaging_cost_per_conversation_tiktok_direct_message | NUMERIC | Cost per conversation (TikTok direct message) | Average cost of each TikTok direct message conversation event attributed to ads running on a TikTok-owned property. |
| messaging_total_conversation_instant_messaging_app | NUMERIC | Conversations (Instant messaging app) | Number of instant messaging app conversation started events attributed to your TikTok ads. |
| messaging_total_conversation_tiktok_direct_message | NUMERIC | Conversations (TikTok direct message) | Number of TikTok direct message conversations attributed to ads running on a TikTok-owned property. |
TikTok Ads Conversions (Offline) fields
The Conversions (Offline) report of the TikTok Ads connector includes 99 fields.
TikTok Ads Conversions (Offline) fields (cost_per_offline_add_payment_info_event to offline_crm_event_value)
| ID | Type | Name | Description |
|---|---|---|---|
| cost_per_offline_add_payment_info_event | NUMERIC | Cost per payment info add (offline) | The average cost per offline add payment info action attributed to your ads. |
| cost_per_offline_add_to_cart_event | NUMERIC | Cost per add to cart (offline) | The average cost per offline add to cart action attributed to your ads. |
| cost_per_offline_add_to_wishlist_event | NUMERIC | Cost per add to wishlist (offline) | The average cost per offline add to wishlist action attributed to your ads. |
| cost_per_offline_click_button_event | NUMERIC | Cost per button click (offline) | The average cost per offline click button action attributed to your ads. |
| cost_per_offline_complete_registration_event | NUMERIC | Cost per registration (offline) | The average cost per offline complete registration action attributed to your ads. |
| cost_per_offline_contact_event | NUMERIC | Cost per contact (offline) | The average cost per offline contact action attributed to your ads. |
| cost_per_offline_download_event | NUMERIC | Cost per download (offline) | The average cost per offline download action attributed to your ads. |
| cost_per_offline_form_event | NUMERIC | Cost per form submitted (offline) | The average cost per offline lead action attributed to your ads. |
| cost_per_offline_initiate_checkout_event | NUMERIC | Cost per checkout initiated (offline) | The average cost per offline initiate checkout action attributed to your ads. |
| cost_per_offline_place_order_event | NUMERIC | Cost per order placed (offline) | The average cost per offline place order action attributed to your ads. |
| cost_per_offline_search_event | NUMERIC | Cost per search (offline) | The average cost per offline search action attributed to your ads. |
| cost_per_offline_shopping_event | NUMERIC | Cost per purchase (offline) | The average cost per offline purchase action attributed to your ads. |
| cost_per_offline_subscribe_event | NUMERIC | Cost per subscription (offline) | The average cost per offline subscribe action attributed to your ads. |
| cost_per_offline_view_content_event | NUMERIC | Cost per content view (offline) | The average cost per offline view content action attributed to your ads. |
| offline_add_payment_info_event_rate | PERCENT | Unique payment info add rate (offline) (%) | The percentage of offline add payment info actions from all clicks attributed to your ads. |
| offline_add_payment_info_events | NUMERIC | Payment info adds (offline) | The number of offline add payment info actions attributed to your ads. |
| offline_add_payment_info_events_value | NUMERIC | Payment info add value (offline) | The total value of offline add payment info actions attributed to your ads. |
| offline_add_to_cart_event_rate | PERCENT | Unique add to cart rate (offline) (%) | The percentage of offline add to cart actions from all clicks attributed to your ads. |
| offline_add_to_cart_events | NUMERIC | Adds to cart (offline) | The number of offline add to cart actions attributed to your ads. |
| offline_add_to_cart_events_value | NUMERIC | Add to cart value (offline) | The total value of offline add to cart actions attributed to your ads. |
| offline_add_to_wishlist_event_rate | PERCENT | Unique add to wishlist rate (offline) (%) | The percentage of offline add to wishlist actions from all clicks attributed to your ads. |
| offline_add_to_wishlist_events | NUMERIC | Adds to wishlist (offline) | The number of offline add to wishlist actions attributed to your ads. |
| offline_add_to_wishlist_events_value | NUMERIC | Add to wishlist value (offline) | The total value of offline add to wishlist actions attributed to your ads. |
| offline_click_button_event_rate | PERCENT | Unique button click rate (offline) (%) | The percentage of offline click button actions from all clicks attributed to your ads. |
| offline_click_button_events | NUMERIC | Button clicks (offline) | The number of offline click button actions attributed to your ads. |
| offline_click_button_events_value | NUMERIC | Button click value (offline) | The total value of offline click button actions attributed to your ads. |
| offline_complete_registration_event_rate | PERCENT | Unique registration rate (offline) (%) | The percentage of offline complete registration actions from all clicks attributed to your ads. |
| offline_complete_registration_events | NUMERIC | Registrations (offline) | The number of offline complete registration actions attributed to your ads. |
| offline_complete_registration_events_value | NUMERIC | Registration value (offline) | The total value of offline complete registration actions attributed to your ads. |
| offline_contact_event_rate | PERCENT | Unique contact rate (offline) (%) | The percentage of offline contact actions from all clicks attributed to your ads. |
| offline_contact_events | NUMERIC | Contacts (offline) | The number of offline contact actions attributed to your ads. |
| offline_contact_events_value | NUMERIC | Contact value (offline) | The total value of offline contact actions attributed to your ads. |
| offline_cost_per_crm_event | NUMERIC | Cost per CRM Event | Average cost per CRM event. |
| offline_cost_per_custom_event | NUMERIC | Cost per custom event (offline) | Average cost per custom offline event attributed to your ads. |
| offline_cost_per_customize_product | NUMERIC | Cost per customize product (offline) | The average cost of each offline customize product event attributed to your TikTok ads. |
| offline_cost_per_find_location | NUMERIC | Cost per find location (offline) | The average cost of each offline find location event attributed to your TikTok ads. |
| offline_cost_per_preferred_lead | NUMERIC | Cost per preferred leads (offline) | Average cost per preferred lead event attributed to your TikTok ads. |
| offline_cost_per_schedule | NUMERIC | Cost per schedule (offline) | The average cost of each offline schedule event attributed to your TikTok ads. |
| offline_crm_event_rate | PERCENT | CRM Event Rate (%) | Percentage of CRM events out of all click events. |
| offline_crm_event_value | NUMERIC | CRM event value | Total value returned from all CRM events. |
TikTok Ads Conversions (Offline) fields (offline_custom_event_rate to offline_value_per_customize_product)
| ID | Type | Name | Description |
|---|---|---|---|
| offline_custom_event_rate | PERCENT | Custom event rate (offline) (%) | Percentage of custom offline events from all clicks attributed to your ads. |
| offline_customize_product_rate | PERCENT | Customize product rate (offline) | The percentage of offline customize product events out of all click events attributed to your TikTok ads. |
| offline_download_event_rate | PERCENT | Unique download rate (offline) (%) | The percentage of offline download actions from all clicks attributed to your ads. |
| offline_download_events | NUMERIC | Downloads (offline) | The number of offline download actions attributed to your ads. |
| offline_download_events_value | NUMERIC | Download value (offline) | The total value of offline download actions attributed to your ads. |
| offline_find_location_rate | PERCENT | Find location rate (offline) | The percentage of offline find location events out of all click events attributed to your TikTok ads. |
| offline_form_event_rate | PERCENT | Unique form submission rate (offline) (%) | The percentage of offline lead actions from all clicks attributed to your ads. |
| offline_form_events | NUMERIC | Form submissions (offline) | The number of offline lead actions attributed to your ads. |
| offline_form_events_value | NUMERIC | Form submission value (offline) | The total value of offline lead actions attributed to your ads. |
| offline_initiate_checkout_event_rate | PERCENT | Unique checkout initiation rate (offline) (%) | The percentage of offline initiate checkout actions from all clicks attributed to your ads. |
| offline_initiate_checkout_events | NUMERIC | Checkouts initiated (offline) | The number of offline initiate checkout actions attributed to your ads. |
| offline_initiate_checkout_events_value | NUMERIC | Checkout initiation value (offline) | The total value of offline initiate checkout actions attributed to your ads. |
| offline_place_order_event_rate | PERCENT | Unique orders placed rate (offline) (%) | The percentage of offline place order actions from all clicks attributed to your ads. |
| offline_place_order_events | NUMERIC | Orders placed (offline) | The number of offline place order actions attributed to your ads. |
| offline_place_order_events_value | NUMERIC | Orders placed value (offline) | The total value of offline place order actions attributed to your ads. |
| offline_preferred_lead_rate | PERCENT | Preferred leads rate (offline) (%) | Percentage of preferred leads events out of all click events attributed to your TikTok ads. |
| offline_preferred_leads | NUMERIC | Preferred leads (offline) | Number of preferred leads events attributed to your TikTok ads. |
| offline_schedule_rate | PERCENT | Schedule rate (offline) | The percentage of offline schedule events out of all click events attributed to your TikTok ads. |
| offline_search_event_rate | PERCENT | Unique search rate (offline) (%) | The percentage of offline search actions from all clicks attributed to your ads. |
| offline_search_events | NUMERIC | Searches (offline) | The number of offline search actions attributed to your ads. |
| offline_search_events_value | NUMERIC | Search value (offline) | The total value of offline search actions attributed to your ads. |
| offline_shopping_event_rate | PERCENT | Unique purchase rate (offline) (%) | The percentage of offline purchase actions from all clicks attributed to your ads. |
| offline_shopping_events | NUMERIC | Purchases (offline) | The number of offline purchase actions attributed to your ads. |
| offline_shopping_events_roas | NUMERIC | Purchase ROAS (offline) | The return on ad spend (ROAS) from offline purchase actions. |
| offline_shopping_events_value | NUMERIC | Purchase value (offline) | The total value of offline purchaseactions attributed to your ads. |
| offline_subscribe_event_rate | PERCENT | Unique subscription rate (offline) (%) | The percentage of offline subscribe actions from all clicks attributed to your ads. |
| offline_subscribe_events | NUMERIC | Subscriptions (offline) | The number of offline subscribe actions attributed to your ads. |
| offline_subscribe_events_value | NUMERIC | Subscription value (offline) | The total value of offline subscribe actions attributed to your ads. |
| offline_total_crm_events | NUMERIC | CRM events | Number of CRM events attributed to your ads. |
| offline_total_custom_event_value | NUMERIC | Custom event value (offline) | Total value of custom offline events attributed to your ads. |
| offline_total_custom_events | NUMERIC | Custom events (offline) | Number of custom offline events attributed to your ads. |
| offline_total_customize_product | NUMERIC | Total customize product (offline) | The number of offline customize product events attributed to your TikTok ads. |
| offline_total_customize_product_value | NUMERIC | Total customize product value (offline) | The total value returned from all offline customize product events attributed to your TikTok ads. |
| offline_total_find_location | NUMERIC | Total find location (offline) | The number of offline find location events attributed to your TikTok ads. |
| offline_total_find_location_value | NUMERIC | Total find location value (offline) | The total value returned from all offline find location events attributed to your TikTok ads. |
| offline_total_schedule | NUMERIC | Total schedule (offline) | The number of offline schedule events attributed to your TikTok ads. |
| offline_total_schedule_value | NUMERIC | Total schedule value (offline) | The total value returned from all offline schedule events attributed to your TikTok ads. |
| offline_value_per_crm_event | NUMERIC | Value per CRM Event | Average value returned from each CRM event. |
| offline_value_per_custom_event | NUMERIC | Value per custom event (offline) | Average value per custom offline event attributed to your ads. |
| offline_value_per_customize_product | NUMERIC | Value per customize product (offline) | The average value returned from each offline customize product event attributed to your TikTok ads. |
TikTok Ads Conversions (Offline) fields (offline_value_per_find_location to value_per_offline_view_content_event)
| ID | Type | Name | Description |
|---|---|---|---|
| offline_value_per_find_location | NUMERIC | Value per find location (offline) | The average value returned offline from each find location event attributed to your TikTok ads. |
| offline_value_per_schedule | NUMERIC | Value per schedule (offline) | The average value returned from each offline schedule event attributed to your TikTok ads. |
| offline_view_content_event_rate | PERCENT | Unique content view rate (offline) (%) | The percentage of offline view content actions from all clicks attributed to your ads. |
| offline_view_content_events | NUMERIC | Content views (offline) | The number of offline view content actions attributed to your ads. |
| offline_view_content_events_value | NUMERIC | Content view value (offline) | The total value of offline view content actions attributed to your ads. |
| value_per_offline_add_payment_info_event | NUMERIC | Value per payment info add (offline) | The average value per offline add payment info action attributed to your ads. |
| value_per_offline_add_to_cart_event | NUMERIC | Value per add to cart (offline) | The average value per offline add to cart action attributed to your ads. |
| value_per_offline_add_to_wishlist_event | NUMERIC | Value per add to wishlist (offline) | The average value per offline add to wishlist action attributed to your ads. |
| value_per_offline_click_button_event | NUMERIC | Value per button click (offline) | The average value per offline click button action attributed to your ads. |
| value_per_offline_complete_registration_event | NUMERIC | Value per registration (offline) | The average value per offline complete registration action attributed to your ads. |
| value_per_offline_contact_event | NUMERIC | Value per contact (offline) | The average value per offline contact action attributed to your ads. |
| value_per_offline_download_event | NUMERIC | Value per download (offline) | The average value per offline download action attributed to your ads. |
| value_per_offline_form_event | NUMERIC | Value per form submitted (offline) | The average value per offline lead attributed to your ads. |
| value_per_offline_initiate_checkout_event | NUMERIC | Value per checkout initiated (offline) | The average value per offline initiate checkout action attributed to your ads. |
| value_per_offline_place_order_event | NUMERIC | Value per order placed (offline) | The average value per offline place order action attributed to your ads. |
| value_per_offline_search_event | NUMERIC | Value per search (offline) | The average value per offline search action attributed to your ads. |
| value_per_offline_shopping_event | NUMERIC | Value per purchase (offline) | The average value per offline purchase action attributed to your ads. |
| value_per_offline_subscribe_event | NUMERIC | Value per subscription (offline) | The average value per offline subscribe action attributed to your ads. |
| value_per_offline_view_content_event | NUMERIC | Value per content view (offline) | The average value per offline view content action attributed to your ads. |
TikTok Ads Conversions (Shop) fields
The Conversions (Shop) report of the TikTok Ads connector includes 24 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| cost_per_onsite_initiate_checkout_count | NUMERIC | Cost per checkout initiated (Shop) | Average cost per Shop initiated checkout action attributed to your ads. |
| cost_per_onsite_on_web_cart | NUMERIC | Cost per add to cart (Shop) | Average cost per Shop add to cart action attributed to your ads. |
| cost_per_onsite_on_web_detail | NUMERIC | Cost per product page view (Shop) | Average cost per Shop product detail page view attributed to your ads. |
| cost_per_onsite_shopping | NUMERIC | Cost per purchase (Shop) | Average cost per Shop purchase attributed to your ads. |
| onsite_initiate_checkout_count | NUMERIC | Checkouts initiated (Shop) | Number of initiated checkout actions in Shop attributed to your ads, such as clicks on Buy now and Buy with coupon buttons on your product pages. |
| onsite_initiate_checkout_count_rate | PERCENT | Checkout initiation rate (Shop) | Percentage of Shop initiated checkout actions from clicks on your ads. |
| onsite_on_web_cart | NUMERIC | Add to cart (Shop) | Number of Shop add to cart actions attributed to your ads. |
| onsite_on_web_cart_rate | PERCENT | Add to cart rate (Shop) (%) | Percentage of Shop add to cart actions from clicks on your ads. |
| onsite_on_web_detail | NUMERIC | Product page views (Shop) | Number of Shop product detail page views attributed to your ads. |
| onsite_on_web_detail_rate | PERCENT | Product page view rate (Shop) (%) | Percentage of Shop product detail page views from clicks on your ads. |
| onsite_shopping | NUMERIC | Purchases (Shop) | Number of Shop order submission actions attributed to your ads. |
| onsite_shopping_rate | PERCENT | Purchase rate (Shop) | Percentage of Shop purchases from clicks on your ads. |
| onsite_shopping_roas | NUMERIC | ROAS (Shop) | The return on ad spend (ROAS) from TikTok Shop gross revenue attributed to your ads. |
| shop_gross_revenue_by_order_submission | NUMERIC | Gross revenue (Shop) by order submission time | The gross revenue of Shop orders attributed to your ads. It's the amount people pay, less any sales taxes, plus any product discounts provided to them by Shop platform. |
| shop_total_items_purchased | NUMERIC | Items purchased (Shop) | The number of Shop items sold attributed to your ads. |
| shop_total_purchase_by_order_submission | NUMERIC | Purchases (Shop) by order submission time | The number of Shop order submission actions attributed to your ads. |
| total_onsite_initiate_checkout_count_value | NUMERIC | Checkout initiation value (Shop) | Total value of Shop initiated checkout actions attributed to your ads. |
| total_onsite_on_web_cart_value | NUMERIC | Add to cart value (Shop) | Total value of Shop add to cart actions attributed to your ads. |
| total_onsite_on_web_detail_value | NUMERIC | Product page view value (Shop) | Total value of Shop product detail page views attributed to your ads. |
| total_onsite_shopping_value | NUMERIC | Gross revenue (Shop) | Gross revenue of Shop orders attributed to your ads. It's the amount people pay, less any sales taxes, plus any product discounts provided to them by Shop platform. |
| value_per_onsite_initiate_checkout_count | NUMERIC | Value per checkout initiated (Shop) | Average value per Shop initiated checkout action attributed to your ads. |
| value_per_onsite_on_web_cart | NUMERIC | Value per add to cart (Shop) | Average value per Shop add to cart action attributed to your ads. |
| value_per_onsite_on_web_detail | NUMERIC | Value per product page view (Shop) | Average value per Shop product detail page view attributed to your ads. |
| value_per_onsite_shopping | NUMERIC | Average order value (Shop) | Average order value per Shop purchase attributed to your ads. |
TikTok Ads Conversions (TikTok) fields
The Conversions (TikTok) report of the TikTok Ads connector includes 52 fields.
TikTok Ads Conversions (TikTok) fields (cost_per_ix_button_click_count to onsite_total_product_details_page_view_value)
| ID | Type | Name | Description |
|---|---|---|---|
| cost_per_ix_button_click_count | NUMERIC | Cost per outbound click (TikTok) | Average cost per call-to-action button click event within a TikTok-owned property. |
| cost_per_ix_page_view_count | NUMERIC | Cost per page view (TikTok) | Average cost per page view event within a TikTok-owned property. |
| cost_per_ix_product_click_count | NUMERIC | Cost per product clicks (TikTok) | Average cost per product click event within a TikTok-owned property. |
| cost_per_onsite_add_billing | NUMERIC | Cost per billing add (TikTok) | Average cost per add billing event within a TikTok-owned property. |
| cost_per_onsite_add_to_wishlist | NUMERIC | Cost per add to wishlist (TikTok) | The average cost per add to wishlist action attributed to your ads. |
| cost_per_onsite_destination_visit | NUMERIC | Cost per destination visit (TikTok) | The average cost of each destination visit event within a TikTok-owned property. |
| cost_per_onsite_download_start | NUMERIC | Cost per app store click (TikTok) | Average cost per app store click event within a TikTok-owned property. |
| cost_per_onsite_form | NUMERIC | Cost per form submitted (TikTok) | The average cost per lead action attributed to your ads. |
| ix_button_click_count | NUMERIC | Outbound clicks (TikTok) | Number of call-to-action button click events within a TikTok-owned property. |
| ix_button_click_count_rate | PERCENT | Outbound click rate (TikTok) (%) | Percentage of call-to-action button click events out of all click events within a TikTok-owned property. |
| ix_page_view_count | NUMERIC | Page views (TikTok) | Number of page views on the instant page. |
| ix_page_view_count_rate | PERCENT | Page view rate (TikTok) (%) | Percentage of page view events out of all click events within a TikTok-owned property. |
| ix_product_click_count | NUMERIC | Product clicks (TikTok) | Number of product clicks on the instant page that leads to detail page views. |
| ix_product_click_count_rate | PERCENT | Product clicks rate (TikTok) (%) | Percentage of product click events out of all click events within a TikTok-owned property. |
| onsite_add_billing | NUMERIC | Billing adds (TikTok) | Number of add billing events attributed to your ads within a TikTok-owned property. |
| onsite_add_billing_rate | PERCENT | Billing add rate (TikTok) (%) | Percentage of add billing events out of all click events within a TikTok-owned property. |
| onsite_add_to_cart_rate | PERCENT | Add to cart rate (TikTok) (%) | The percentage of TikTok add to cart actions from all clicks attributed to your ads. |
| onsite_add_to_wishlist | NUMERIC | Adds to wishlist (TikTok) | The number of add to wishlist actions attributed to your ads. |
| onsite_add_to_wishlist_rate | PERCENT | Unique add to wishlist rate (TikTok) | The percentage of add to wishlist actions from all clicks attributed to your ads. |
| onsite_checkout_initiation_rate | PERCENT | Checkout initiation rate (TikTok) (%) | The percentage of TikTok checkout initiation actions from all clicks attributed to your ads. |
| onsite_cost_per_add_to_cart | NUMERIC | Cost per add to cart (TikTok) | The average cost per TikTok add to cart action attributed to your ads. |
| onsite_cost_per_checkout_initiation | NUMERIC | Cost per checkout initiation (TikTok) | The average cost per TikTok checkout initiation action attributed to your ads. |
| onsite_cost_per_product_details_page_view | NUMERIC | Cost per product details page view (TikTok) | The average cost per TikTok product details page view action attributed to your ads. |
| onsite_cost_per_purchase | NUMERIC | Cost per purchase (TikTok) | The average cost per TikTok purchase action attributed to your ads. |
| onsite_destination_visit_rate | PERCENT | Destination visit rate (TikTok) (%) | The percentage of destination visit events out of all click events within a TikTok-owned property. |
| onsite_destination_visits | NUMERIC | Destination visits (TikTok) | The number of destination visit events that are attributed to your ads within a TikTok-owned property. |
| onsite_download_start | NUMERIC | App store clicks (TikTok) | Number of app store click events attributed to your ads within a TikTok-owned property. |
| onsite_download_start_rate | PERCENT | App store click rate (TikTok) (%) | Percentage of app store click events out of all click events within a TikTok-owned property. |
| onsite_form | NUMERIC | Form submissions (TikTok) | The number of lead actions attributed to your ads. |
| onsite_form_rate | PERCENT | Unique form submission rate (TikTok) | The percentage of lead actions from all clicks attributed to your ads. |
| onsite_product_details_page_view_rate | PERCENT | Product details page view rate (TikTok) (%) | The percentage of TikTok product details page view actions from all clicks attributed to your ads. |
| onsite_purchase_rate | PERCENT | Purchase rate (TikTok) (%) | The percentage of TikTok purchase actions from all clicks attributed to your ads. |
| onsite_purchases_roas | NUMERIC | Purchases ROAS (TikTok) | The return on ad spend (ROAS) from TikTok purchase actions. |
| onsite_total_add_to_cart | NUMERIC | Add to cart (TikTok) | The number of TikTok add to cart actions attributed to your ads. |
| onsite_total_add_to_cart_value | NUMERIC | Add to cart value (TikTok) | The total value of TikTok add to cart actions attributed to your ads. |
| onsite_total_checkout_initiation | NUMERIC | Checkouts initiated (TikTok) | The number of TikTok checkouts initiated actions attributed to your ads. |
| onsite_total_checkout_initiation_value | NUMERIC | Checkout initiation value (TikTok) | The total value of TikTok checkout initiation actions attributed to your ads. |
| onsite_total_filtered_out_form_submission | NUMERIC | Filtered out form submissions (TikTok) | This is the number of users that were disqualified and not counted as submissions due to the logic you set. |
| onsite_total_product_details_page_view | NUMERIC | Product details page view (TikTok) | The number of TikTok product details page view actions attributed to your ads. |
| onsite_total_product_details_page_view_value | NUMERIC | Product details page view value (TikTok) | The total value of TikTok product details page view actions attributed to your ads. |
TikTok Ads Conversions (TikTok) fields (onsite_total_purchase to value_per_onsite_form)
| ID | Type | Name | Description |
|---|---|---|---|
| onsite_total_purchase | NUMERIC | Purchases (TikTok) | The number of TikTok purchase actions attributed to your ads. |
| onsite_total_purchase_value | NUMERIC | Purchase value (TikTok) | The total value of TikTok purchase actions attributed to your ads. |
| onsite_value_per_add_to_cart | NUMERIC | Value per add to cart (TikTok) | The average value per TikTok add to cart action attributed to your ads. |
| onsite_value_per_checkout_initiation | NUMERIC | Value per checkout initiation (TikTok) | The average value per TikTok checkout initiation action attributed to your ads. |
| onsite_value_per_product_details_page_view | NUMERIC | Value per product details page view (TikTok) | The average value per TikTok product details page view action attributed to your ads. |
| onsite_value_per_purchase | NUMERIC | Value per purchase (TikTok) | The average value per TikTok purchase action attributed to your ads. |
| total_onsite_add_billing_value | NUMERIC | Billing add value (TikTok) | Total value returned from all add billing events within a TikTok-owned property. |
| total_onsite_add_to_wishlist_value | NUMERIC | Add to wishlist value (TikTok) | The total value of add to wishlist actions attributed to your ads. |
| total_onsite_form_value | NUMERIC | Form submission value (TikTok) | The total value of lead actions attributed to your ads. |
| value_per_onsite_add_billing | NUMERIC | Value per billing add (TikTok) | Average value returned from each add billing event within a TikTok-owned property. |
| value_per_onsite_add_to_wishlist | NUMERIC | Value per add to wishlist (TikTok) | The average value per add to wishlist action attributed to your ads. |
| value_per_onsite_form | NUMERIC | Value per form submitted (TikTok) | The average value per lead attributed to your ads. |
TikTok Ads Conversions (Website) fields
The Conversions (Website) report of the TikTok Ads connector includes 99 fields.
TikTok Ads Conversions (Website) fields (add_billing to on_web_subscribe)
| ID | Type | Name | Description |
|---|---|---|---|
| add_billing | NUMERIC | Payment info added (website) | Number of add payment info actions on your website. |
| add_billing_rate | PERCENT | Unique payment info added rate (%) (website) | Percentage of add payment info actions on your website from all clicks attributed to your ads. |
| avg_value_per_pageview | NUMERIC | Value per page view (website) | Average value returned from each page view event. |
| button_click | NUMERIC | Button clicks (website) | The number of website click button actions attributed to your ads. |
| button_click_rate | PERCENT | Unique button click rate (website) | The percentage of website click button actions from all clicks attributed to your ads. |
| complete_payment | NUMERIC | Purchases (website) | Number of website purchase actions attributed to your ads. |
| complete_payment_rate | PERCENT | Unique purchase rate (website) (%) | Percentage of website purchase actions from all clicks attributed to your ads. |
| complete_payment_roas | NUMERIC | Purchase ROAS (website) | Return on ad spend (ROAS) from website purchase actions. |
| cost_per_add_billing | NUMERIC | Cost per payment info added (website) | Average cost per add payment info action on your website attributed to your ads. |
| cost_per_button_click | NUMERIC | Cost per button click (website) | The average cost per website click button action attributed to your ads. |
| cost_per_complete_payment | NUMERIC | Cost per purchase (website) | Average cost per website purchase action attributed to your ads. |
| cost_per_custom_page_event | NUMERIC | Cost per custom event (website) | The average cost per custom web event attributed to your ads. |
| cost_per_download_start | NUMERIC | Cost per download (website) | The average cost per website download action attributed to your ads. |
| cost_per_form | NUMERIC | Cost per form submitted (website) | The average cost per website lead action attributed to your ads. |
| cost_per_initiate_checkout | NUMERIC | Cost per checkout initiated (website) | The average cost per website initiate checkout action attributed to your ads. |
| cost_per_landing_page_view | NUMERIC | Cost per landing page view (website) | Average cost per landing page view event on your website. |
| cost_per_on_web_add_to_wishlist | NUMERIC | Cost per add to wishlist (website) | The average cost per website add to wishlist action attributed to your ads. |
| cost_per_on_web_order | NUMERIC | Cost per order placed (website) | The average cost per website place order action attributed to your ads. |
| cost_per_on_web_subscribe | NUMERIC | Cost per subscription (website) | The average cost per website subscribe action attributed to your ads. |
| cost_per_online_consult | NUMERIC | Cost per contact (website) | The average cost per website contact action attributed to your ads. |
| cost_per_page_content_view_event | NUMERIC | Cost per content view (website) | The average cost per website view content action attributed to your ads. |
| cost_per_page_event_search | NUMERIC | Cost per search (website) | The average cost per website search action attributed to your ads. |
| cost_per_pageview | NUMERIC | Cost per page view (website) | Average cost per page view event. |
| cost_per_user_registration | NUMERIC | Cost per registration (website) | The average cost per website complete registration action attributed to your ads. |
| cost_per_web_event_add_to_cart | NUMERIC | Cost per add to cart (website) | The average cost per website add to cart action attributed to your ads. |
| custom_page_event_rate | PERCENT | Custom event rate (website) (%) | The percentage of custom web events from all clicks attributed to your ads. |
| custom_page_events | NUMERIC | Custom events (website) | The number of custom web events attributed to your ads. |
| custom_page_events_value | NUMERIC | Custom event value (website) | The total value of custom web events attributed to your ads. |
| download_start | NUMERIC | Downloads (website) | The number of website download actions attributed to your ads. |
| download_start_rate | PERCENT | Unique download rate (website) (%) | The percentage of website download actions from all clicks attributed to your ads. |
| form | NUMERIC | Form submissions (website) | The number of website lead actions attributed to your ads. |
| form_rate | PERCENT | Unique form submission rate (website) (%) | The percentage of website lead actions from all clicks attributed to your ads. |
| initiate_checkout | NUMERIC | Checkouts initiated (website) | The number of website initiate checkout actions attributed to your ads. |
| initiate_checkout_rate | PERCENT | Unique checkout initiation rate (website) (%) | The percentage of website initiate checkout actions from all clicks attributed to your ads. |
| landing_page_view_rate | PERCENT | Landing page view rate (website) | Percentage of click events that are landing page view events. |
| on_web_add_to_wishlist | NUMERIC | Adds to wishlist (website) | The number of website add to wishlist actions attributed to your ads. |
| on_web_add_to_wishlist_per_click | PERCENT | Unique add to wishlist rate (website) (%) | The percentage of website add to wishlist actions from all clicks attributed to your ads. |
| on_web_order | NUMERIC | Orders placed (website) | The number of website place order actions attributed to your ads. |
| on_web_order_rate | PERCENT | Unique orders placed rate (website) (%) | The percentage of website place order actions from all clicks attributed to your ads. |
| on_web_subscribe | NUMERIC | Subscriptions (website) | The number of website subscribe actions attributed to your ads. |
TikTok Ads Conversions (Website) fields (on_web_subscribe_per_click to value_per_page_event_search)
| ID | Type | Name | Description |
|---|---|---|---|
| on_web_subscribe_per_click | PERCENT | Unique subscription rate (website) (%) | The percentage of website subscribe actions from all clicks attributed to your ads. |
| online_consult | NUMERIC | Contacts (website) | The number of website contact actions attributed to your ads. |
| online_consult_rate | PERCENT | Unique contact rate (website) | The percentage of website contact actions from all clicks attributed to your ads. |
| page_content_view_event_rate | PERCENT | Unique content view rate (website) (%) | The percentage of website view content actions from all clicks attributed to your ads. |
| page_content_view_events | NUMERIC | Content views (website) | The number of website view content actions attributed to your ads. |
| page_event_search | NUMERIC | Searches (website) | The number of website search actions attributed to your ads. |
| page_event_search_rate | PERCENT | Unique search rate (website) (%) | The percentage of website search actions from all clicks attributed to your ads. |
| pageview_rate | PERCENT | Page view rate (website) (%) | Percentage of page view events out of all click events. |
| total_add_billing_value | NUMERIC | Add payment info value (website) | Total value of add payment info actions on your website attributed to your ads. |
| total_button_click_value | NUMERIC | Button click value (website) | The total value of website click button actions attributed to your ads. |
| total_complete_payment_rate | NUMERIC | Purchase value (website) | Total value of website purchase actions attributed to your ads. |
| total_download_start_value | NUMERIC | Download value (website) | The total value of website download actions attributed to your ads. |
| total_form_value | NUMERIC | Form submission value (website) | The total value of website lead actions attributed to your ads. |
| total_initiate_checkout_value | NUMERIC | Checkout initiation value (website) | The total value of website initiate checkout actions attributed to your ads. |
| total_landing_page_view | NUMERIC | Landing page views (website) | Number of landing page view events from your ads. |
| total_on_web_add_to_wishlist_value | NUMERIC | Add to wishlist value (website) | The total value of website add to wishlist actions attributed to your ads. |
| total_on_web_order_value | NUMERIC | Orders placed value (website) | The total value of website place order actions attributed to your ads. |
| total_on_web_subscribe_value | NUMERIC | Subscription value (website) | The total value of website subscribe actions attributed to your ads. |
| total_online_consult_value | NUMERIC | Contact value (website) | The total value of website contact actions attributed to your ads. |
| total_page_event_search_value | NUMERIC | Search value (website) | The total value of website search actions attributed to your ads. |
| total_page_view_content_events_value | NUMERIC | Content view value (website) | The total value of website view content actions attributed to your ads. |
| total_pageview | NUMERIC | Page views (website) | Number of page view events. |
| total_user_registration_value | NUMERIC | Registration value (website) | The total value of website complete registration actions attributed to your ads. |
| total_value_per_pageview | NUMERIC | Total page view value (website) | Total value returned from all page view events. |
| total_web_event_add_to_cart_value | NUMERIC | Add to cart value (website) | The total value of website add to cart actions attributed to your ads. |
| user_registration | NUMERIC | Registrations (website) | The number of website complete registration actions attributed to your ads. |
| user_registration_rate | PERCENT | Unique registration rate (website) (%) | The percentage of website complete registration actions from all clicks attributed to your ads. |
| value_per_add_billing | NUMERIC | Value per payment info added (website) | Average value per add payment info action on your website attributed to your ads. |
| value_per_button_click | NUMERIC | Value per button click (website) | The average value per website click button action attributed to your ads. |
| value_per_complete_payment | NUMERIC | Value per purchase (website) | Average value per website purchase action attributed to your ads. |
| value_per_custom_page_event | NUMERIC | Value per custom event (website) | The average value per custom web event attributed to your ads. |
| value_per_download_start | NUMERIC | Value per download (website) | The average value per website download action attributed to your ads. |
| value_per_form | NUMERIC | Value per form submitted (website) | The average value per website lead attributed to your ads. |
| value_per_initiate_checkout | NUMERIC | Value per checkout initiated (website) | The average value per website initiate checkout action attributed to your ads. |
| value_per_on_web_add_to_wishlist | NUMERIC | Value per add to wishlist (website) | The average value per website add to wishlist action attributed to your ads. |
| value_per_on_web_order | NUMERIC | Value per order placed (website) | The average value per website place order action attributed to your ads. |
| value_per_on_web_subscribe | NUMERIC | Value per subscription (website) | The average value per website subscribe action attributed to your ads. |
| value_per_online_consult | NUMERIC | Value per contact (website) | The average value per website contact action attributed to your ads. |
| value_per_page_content_view_event | NUMERIC | Value per content view (website) | The average value per website view content action attributed to your ads. |
| value_per_page_event_search | NUMERIC | Value per search (website) | The average value per website search action attributed to your ads. |
TikTok Ads Conversions (Website) fields (value_per_user_registration to website_value_per_schedule)
| ID | Type | Name | Description |
|---|---|---|---|
| value_per_user_registration | NUMERIC | Value per registration (website) | The average value per website complete registration action attributed to your ads. |
| value_per_web_event_add_to_cart | NUMERIC | Value per add to cart (website) | The average value per website add to cart action attributed to your ads. |
| web_event_add_to_cart | NUMERIC | Adds to cart (website) | The number of website add to cart actions attributed to your ads. |
| web_event_add_to_cart_rate | PERCENT | Unique add to cart rate (website) (%) | The percentage of website add to cart actions from all clicks attributed to your ads. |
| website_cost_per_customize_product | NUMERIC | Cost per customize product | The average cost of each customize product event. |
| website_cost_per_find_location | NUMERIC | Cost per find location | The average cost of each find location event. |
| website_cost_per_schedule | NUMERIC | Cost per schedule | The average cost of each schedule event. |
| website_customize_product_rate | PERCENT | Customize product rate | The percentage of customize product events out of all click events. |
| website_find_location_rate | PERCENT | Find location rate | The percentage of find location events out of all click events. |
| website_schedule_rate | PERCENT | Schedule rate | The percentage of schedule events out of all click events. |
| website_total_customize_product | NUMERIC | Total customize product | The number of customize product events. |
| website_total_customize_product_value | NUMERIC | Total customize product value | The total value returned from all customize product events. |
| website_total_find_location | NUMERIC | Total find location | The number of find location events. |
| website_total_find_location_value | NUMERIC | Total find location value | The total value returned from all find location events. |
| website_total_schedule | NUMERIC | Total schedule | The number of schedule events. |
| website_total_schedule_value | NUMERIC | Total schedule value | The total value returned from all schedule events. |
| website_value_per_customize_product | NUMERIC | Value per customize product | The average value returned from each customize product event. |
| website_value_per_find_location | NUMERIC | Value per find location | The average value returned from each find location event. |
| website_value_per_schedule | NUMERIC | Value per schedule | The average value returned from each schedule event. |
TikTok Ads GMV Max Report fields
The GMV Max Report report of the TikTok Ads connector includes 10 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| gmv_max_cost | NUMERIC | GMV Max Cost | Total amount spent on your GMV Max campaigns. |
| gmv_max_cost_per_order | NUMERIC | GMV Max Cost per Order | Average cost per order of your GMV Max campaigns. |
| gmv_max_gross_revenue | NUMERIC | GMV Max Gross Revenue | Total gross revenue of TikTok Shop orders, paid and organic, attributed to your GMV Max campaigns. |
| gmv_max_live_room_id | TEXT | GMV Max LIVE Room ID | LIVE room ID of a GMV Max LIVE campaign. Breaks GMV Max metrics down by LIVE. A value of -1 means the metrics are not attributed to a room. |
| gmv_max_max_delivery_budget | NUMERIC | GMV Max Max Delivery Budget | The maximum delivery budget configured for the GMV Max campaign. A campaign setting, so it is not summed when aggregated. |
| gmv_max_net_cost | NUMERIC | GMV Max Net Cost | Amount spent on your GMV Max campaigns, excluding ad credit/coupons used. |
| gmv_max_orders | NUMERIC | GMV Max Orders | Number of SKU orders generated by the products in your GMV Max campaigns. |
| gmv_max_product_id | TEXT | GMV Max Product ID | Product (item group) ID of a GMV Max product campaign. Breaks GMV Max metrics down by product. |
| gmv_max_roi | NUMERIC | GMV Max ROI | Return on investment of your GMV Max campaigns: gross revenue divided by cost. |
| gmv_max_target_roi_budget | NUMERIC | GMV Max Target ROI Budget | The target ROI budget configured for the GMV Max campaign. A campaign setting, so it is not summed when aggregated. |
TikTok Ads Interactions (Clicks) fields
The Interactions (Clicks) report of the TikTok Ads connector includes 9 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| anchor_click_rate | PERCENT | Anchor click rate | Percentage of anchor clicks out of all impressions on your ads. |
| anchor_clicks | NUMERIC | Anchor clicks | Number of clicks on ad anchors. |
| clicks_on_hashtag_challenge | NUMERIC | Hashtag clicks | Number of clicks on the hashtag challenge associated with your ad during the ad impression. |
| clicks_on_music_disc | NUMERIC | Sound clicks | Number of clicks on the sound associated with your ad during the ad impression. |
| duet_clicks | NUMERIC | Duet button clicks | Number of clicks on the "Duet" button. |
| engagement_rate | PERCENT | CTR (all) | Percentage of impressions that resulted in a click out of all impressions. |
| engagements | NUMERIC | Clicks (all) | Number of clicks from your ads. This includes clicks that lead to destination as well as those for social and interaction purposes. |
| sound_usage_clicks | NUMERIC | Use sound button clicks | Number of clicks on the "Use sound" button. |
| stitch_clicks | NUMERIC | Stitch button clicks | Number of clicks on the "Stitch" button. |
TikTok Ads Interactions (Images) fields
The Interactions (Images) report of the TikTok Ads connector includes 3 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| single_image_ctr | PERCENT | Single image CTR | The percentage of clicks people performed on the image out of all impressions of the image. |
| single_image_impression_rate | PERCENT | Single image showrate | The percentage of times the image appeared on screen out of all impressions of the ad. |
| single_image_impressions | NUMERIC | Single image impression | The number of times an image of the carousel ad appeared on screen. |
TikTok Ads Interactions (Instant Experiences) fields
The Interactions (Instant Experiences) report of the TikTok Ads connector includes 11 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| ix_average_video_play | NUMERIC | Average Instant experience video view time | Average time your instant experience video was played in a single video view, including any time spent replaying the video. |
| ix_average_video_play_non_aggregated | NUMERIC | (Internal) Average Instant experience video view time (Non-Aggregated) | (Internal) Average time your instant experience video was played in a single video view, including any time spent replaying the video. |
| ix_page_duration_avg | NUMERIC | Instant experience average view time | Average time your Instant Experience was shown. |
| ix_page_duration_avg_non_aggregated | NUMERIC | (Internal) Instant experience average view time (Non-Aggregated) | (Internal) Average time your Instant Experience was shown. |
| ix_page_viewrate_avg | PERCENT | Instant experience average view percentage | Average percentage of content on your Instant Experience that was viewed. |
| ix_page_viewrate_avg_non_aggregated | PERCENT | (Internal) Instant experience average view percentage (Non-Aggregated) | (Internal) Average percentage of content on your Instant Experience that was viewed. |
| ix_video_views | NUMERIC | Instant experience video views | Number of times your Instant Experience video was played. Replays are excluded. |
| ix_video_views_p100 | NUMERIC | Instant experience video views at 100% | Number of times your Instant Experience video was played 100% of its length. Replays are excluded. |
| ix_video_views_p25 | NUMERIC | Instant experience video views at 25% | Number of times your Instant Experience video was played at least 25% of its length. Replays are excluded. |
| ix_video_views_p50 | NUMERIC | Instant experience video views at 50% | Number of times your Instant Experience video was played at least 50% of its length. Replays are excluded. |
| ix_video_views_p75 | NUMERIC | Instant experience video views at 75% | Number of times your Instant Experience video was played at least 75% of its length. Replays are excluded. |
TikTok Ads Interactions (Interactive Add-ons) fields
The Interactions (Interactive Add-ons) report of the TikTok Ads connector includes 6 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| countdown_sticker_recall_clicks | NUMERIC | Countdown sticker recall clicks | Number of clicks on a reminder from the countdown sticker to a specified destination. |
| interactive_add_on_activity_clicks | NUMERIC | Interactive Add-on activity clicks | Number of interactive activity clicks in an Interactive Add-on. |
| interactive_add_on_destination_clicks | NUMERIC | Interactive Add-on destination clicks | Number of clicks from an Interactive Add-on to a specified destination. |
| interactive_add_on_impressions | NUMERIC | Interactive Add-on impressions | Number of times your Interactive Add-on was shown. |
| interactive_add_on_option_a_clicks | NUMERIC | Interactive Add-on option A clicks | Number of clicks on option A in an Interactive Add-on. |
| interactive_add_on_option_b_clicks | NUMERIC | Interactive Add-on option B clicks | Number of clicks on option B in an Interactive Add-on. |
TikTok Ads Interactions (LIVE) fields
The Interactions (LIVE) report of the TikTok Ads connector includes 4 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| live_effective_views | NUMERIC | 10-second LIVE views | Number of times your LIVE was viewed for at least 10 seconds from an ad. Revisits are counted. |
| live_product_clicks | NUMERIC | LIVE Product Clicks | Number of time viewers clicked a product and viewed its details page during your LIVE. |
| live_unique_views | NUMERIC | LIVE unique views | Number of unique users who saw your LIVE at least once from an ad. |
| live_views | NUMERIC | LIVE views | Number of times your LIVE was viewed from an ad. Revisits are counted. |
TikTok Ads Interactions (Social) fields
The Interactions (Social) report of the TikTok Ads connector includes 8 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| comments | NUMERIC | Paid comments | Number of comments sent on your ad during the ad impression. |
| follows | NUMERIC | Paid follows | Number of follows to the associated profile during the ad impression. |
| likes | NUMERIC | Paid likes | Number of times your ad was liked during the ad impression. |
| profile_visits | NUMERIC | Paid profile visits | Number of visits to the associated profile during the ad impression. |
| profile_visits_rate | PERCENT | Paid profile visit rate | Percentage of profile visits from ads out of all impressions on your ads. |
| shares | NUMERIC | Paid shares | Number of shares of your ad during the ad impression. |
| tt_playlist_visit | NUMERIC | Playlist page visit | The number of playlist page visits the paid ad drove during the campaign. |
| tt_playlist_visit_rate | PERCENT | Playlist page visit rate | The rate of playlist page visits per impression the paid ad drove during the campaign. |
TikTok Ads Interactions (Videos) fields
The Interactions (Videos) report of the TikTok Ads connector includes 17 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| average_video_play | NUMERIC | Average play time per video view | Average time your video was played per single video view, including any time spent replaying the video. |
| average_video_play_non_aggregated | NUMERIC | (Internal) Average play time per video view (Non-Aggregated) | (Internal) Average time your video was played per single video view, including any time spent replaying the video. |
| average_video_play_per_user | NUMERIC | Average play time per user | Average time your video was played per user, including any time spent replaying the video. |
| average_video_play_per_user_non_aggregated | NUMERIC | (Internal) Average play time per user (Non-Aggregated) | (Internal) Average time your video was played per user, including any time spent replaying the video. |
| focused_view_15s | NUMERIC | 15-second focused views | Number of times your video was played for at least 15 seconds, played in full if it is less than 15 seconds, or received at least 1 engagement within the first 15 seconds. |
| focused_view_6s | NUMERIC | 6-second focused views | Number of times your video was played for at least 6 seconds, played in full if it is less than 6 seconds, or received at least 1 engagement within the first 6 seconds. |
| paid_engaged_view | NUMERIC | 6-second focused views (paid views) | Number of times your video was played for at least 6 seconds, or played in full if it is less than 6 seconds. For each video impression, plays are counted separately and replays are excluded. |
| paid_engaged_view_15s | NUMERIC | 15-second focused views (paid views) | The number of times your video was viewed for at least 15 seconds, or viewed in full if it is less than 15 seconds long. For each video impression, plays are counted separately and replays are excluded. This metric is only available for advertisers using focused view products. |
| paid_engagement_engaged_view | NUMERIC | 6-second focused views (paid interactions) | The number of times your video received at least one positive interaction (likes, shares, follows, or clicks) without being viewed for 6 seconds. This metric is only available for advertisers using focused view products. For each video impression, paid interactions are counted separately and replays are excluded. |
| paid_engagement_engaged_view_15s | NUMERIC | 15-second focused views (paid interactions) | The number of times your video received at least one positive interaction (likes, shares, follows, or clicks) without being viewed for 15 seconds. This metric is only available for advertisers using focused view products. For each video impression, paid interactions are counted separately and replays are excluded. |
| play_duration_2s | NUMERIC | 2-second video views | Number of times your video was played for at least 2 seconds. For each video impression, plays are counted separately and replays are excluded. |
| play_duration_6s | NUMERIC | 6-second video views | Number of times your video was played for at least 6 seconds. For each video impression, plays are counted separately and replays are excluded. |
| play_first_quartile | NUMERIC | Video views at 25% | Number of times your video was played at least 25% of its length. For each impression, views are counted separately and replays are excluded. |
| play_midpoint | NUMERIC | Video views at 50% | Number of times your video was played at least 50% of its length. For each impression, views are counted separately and replays are excluded. |
| play_over | NUMERIC | Video views at 100% | Number of times your video was played 100% of its length. For each impression, views are counted separately and replays are excluded. |
| play_third_quartile | NUMERIC | Video views at 75% | Number of times your video was played at least 75% of its length. For each impression, views are counted separately and replays are excluded. |
| total_play | NUMERIC | Video views | Number of times your video started to play. For each video impression, plays are counted separately and replays are excluded. |
TikTok Ads Performance fields
The Performance report of the TikTok Ads connector includes 31 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| billed_cost | NUMERIC | Net cost | Sum of your total ad spend, excluding ad credit or coupons used. |
| cash_spend | NUMERIC | Cost Charged by Cash | The estimated amount of money you've spent on your campaign, ad group, or ad during its schedule charged by cash. (This metric can be required at the advertiser level only and lifetime, hourly breakdown is not supported.) Please note that there may be a delay from 24h to 48h between when you were charged and when you can see it through the API. |
| clicks | NUMERIC | Clicks (destination) | Number of clicks from your ads to a specified destination. |
| conversion | NUMERIC | Conversions (Duplicate) | Number of times your ad resulted in the optimization event you selected. (Duplicate) |
| conversion_rate | PERCENT | Conversion rate (CVR, clicks) | Percentage of results you received out of all destination clicks on your ads. |
| conversion_rate_v2 | PERCENT | Conversion rate (CVR) | Percentage of results you received out of all impressions on your ads. |
| conversions | NUMERIC | Conversions | Number of times your ad resulted in the optimization event you selected. |
| cost_per_1000_reached | NUMERIC | Cost per 1,000 people reached | Average cost to reach 1,000 unique users. |
| cost_per_conversion | NUMERIC | Cost per conversion | Average amount spent on a conversion. |
| cost_per_result | NUMERIC | Cost per result | Average cost per each result from your ads. |
| cost_per_secondary_goal_result | NUMERIC | Cost per deep funnel result | Average cost per each deep funnel result from your ads. |
| cpc | NUMERIC | CPC (destination) | Average cost of each click to a specified destination. |
| cpm | NUMERIC | CPM | Average amount you spent per 1,000 impressions. |
| ctr | PERCENT | CTR (destination) | Percentage of impressions that resulted in a destination click out of all impressions. |
| frequency | NUMERIC | Frequency | The average number of times each user saw your ad over a given time period. |
| gross_impressions | NUMERIC | Gross Impressions (Includes Invalid Impressions) | Number of times your ads were shown, including invalid impressions. |
| impressions | NUMERIC | Impressions | Number of times your ads were shown. |
| reach | NUMERIC | Reach | Number of unique users who saw your ads at least once. |
| real_time_conversion | NUMERIC | Conversions by conversion time | Number of times your ad resulted in the optimization event you selected. |
| real_time_conversion_rate | PERCENT | Real-time conversion rate (CVR, clicks) | Percentage of conversions you received out of all impressions on your ads. |
| real_time_cost_per_conversion | NUMERIC | Cost per conversion by conversion time | Average amount spent on a conversion. |
| real_time_cost_per_result | NUMERIC | Real-time cost per result | Average cost per each result from your ads. |
| real_time_result | NUMERIC | Real-time results | Number of times your ad resulted in an intended outcome based on your campaign objective and optimization goal. |
| real_time_result_rate | PERCENT | Real-time result rate | Percentage of results that happened out of all impressions on your ads. |
| result_rate | PERCENT | Result rate | Percentage of results that happened out of all impressions on your ads. |
| results | NUMERIC | Results | Number of times your ad resulted in an intended outcome based on your campaign objective and optimization goal. |
| secondary_goal_result | NUMERIC | Deep funnel result | Number of times your ad resulted in an intended outcome based on the deep funnel event you selected. |
| secondary_goal_result_rate | PERCENT | Deep funnel result rate | Percentage of deep funnel results out of total impressions on your ads. |
| spend | NUMERIC | Cost | Sum of your total ad spend. |
| totalcost | NUMERIC | Cost (Duplicate) | Sum of your total ad spend. (Duplicate) |
| voucher_spend | NUMERIC | Cost Charged by Voucher | The estimated amount of money you've spent on your campaign, ad group, or ad during its schedule charged by voucher. (This metric can be required at the advertiser level only and lifetime, hourly breakdown is not supported.) Please note that there may be a delay from 24h to 48h between when you were charged and when you can see it through the API. |
TikTok Ads SKAN Conversions fields
The SKAN Conversions report of the TikTok Ads connector includes 151 fields.
TikTok Ads SKAN Conversions fields (skan_achieve_level to skan_cost_per_total_achieve_level)
| ID | Type | Name | Description |
|---|---|---|---|
| skan_achieve_level | NUMERIC | Unique levels achieved (SKAN) | Number of unique achieve level events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_achieve_level_rate | PERCENT | Unique level achievement rate (SKAN) | Percentage of unique achieve level events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_add_payment_info | NUMERIC | Unique payment info adds (SKAN) | Number of unique add payment info events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_add_payment_info_rate | PERCENT | Unique payment info add rate (SKAN) | Percentage of unique add payment info events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_add_to_cart | NUMERIC | Unique adds to cart (SKAN) | Number of unique add to cart events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_add_to_cart_rate | PERCENT | Unique add to cart rate (SKAN) | Percentage of unique add to cart events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_add_to_wishlist | NUMERIC | Unique adds to wishlist (SKAN) | Number of unique add to wishlist events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_add_to_wishlist_rate | PERCENT | Unique add to wishlist rate (SKAN) | Percentage of unique add to wishlist events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_app_install | NUMERIC | App install (SKAN) | Number of unique app install events attributed to your ads. |
| skan_app_install_withheld | NUMERIC | App Installs (SKAN Privacy Withheld) | Number of unique app install events attributed to your ads, with withheld values due to Apple's privacy threshold. |
| skan_checkout | NUMERIC | Unique checkouts (SKAN) | Number of unique checkout events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_checkout_rate | PERCENT | Unique checkout rate (SKAN) | Percentage of unique checkout events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_complete_tutorial | NUMERIC | Unique tutorials completed (SKAN) | Number of unique complete tutorial events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_complete_tutorial_rate | PERCENT | Unique tutorial completion rate (SKAN) | Percentage of unique complete tutorial events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_achieve_level | NUMERIC | Cost per unique level achieved (SKAN) | Average cost per unique achieve level event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_add_payment_info | NUMERIC | Cost per unique payment info add (SKAN) | Average cost per unique add payment info event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_add_to_cart | NUMERIC | Cost per unique add to cart (SKAN) | Average cost per unique add to cart event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_add_to_wishlist | NUMERIC | Cost per unique add to wishlist (SKAN) | Average cost per unique add to wishlist event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_app_install | NUMERIC | Cost per app install (SKAN) | Average cost per unique app install event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_checkout | NUMERIC | Cost per unique checkout (SKAN) | Average cost per unique checkout event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_complete_tutorial | NUMERIC | Cost per unique tutorial completed (SKAN) | Average cost per unique complete tutorial event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_create_gamerole | NUMERIC | Cost per unique role created (SKAN) | Average cost per unique create role event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_create_group | NUMERIC | Cost per unique group created (SKAN) | Average cost per unique create group event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_in_app_ad_click | NUMERIC | Cost per unique in-app ad click (SKAN) | Average cost per unique in-app ad click event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_in_app_ad_impr | NUMERIC | Cost per unique in-app ad impression (SKAN) | Average cost per unique in-app ad impression event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_join_group | NUMERIC | Cost per unique group join (SKAN) | Average cost per unique join group event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_launch_app | NUMERIC | Cost per unique app launch (SKAN) | Average cost per unique launch app event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_loan_apply | NUMERIC | Cost per unique loan application (SKAN) | Average cost per unique loan application event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_loan_credit | NUMERIC | Cost per unique loan approval (SKAN) | Average cost per unique loan approval event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_loan_disbursement | NUMERIC | Cost per unique loan disbursal (SKAN) | Average cost per unique loan disbursal event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_login | NUMERIC | Cost per unique login (SKAN) | Average cost per unique login event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_purchase | NUMERIC | Cost per unique purchase (SKAN) | Average cost per unique purchase event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_ratings | NUMERIC | Cost per unique rating (SKAN) | Average cost per unique rate event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_registration | NUMERIC | Cost per unique registration (SKAN) | Average cost per unique registration event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_sales_lead | NUMERIC | Cost per unique lead generated (SKAN) | Average cost per unique generate lead event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_search | NUMERIC | Cost per unique search (SKAN) | Average cost per unique search event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_spend_credits | NUMERIC | Cost per unique credit spend (SKAN) | Average cost per unique spend credit event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_start_trial | NUMERIC | Cost per unique trial started (SKAN) | Average cost per unique start trial event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_subscribe | NUMERIC | Cost per unique subscription (SKAN) | Average cost per unique subscribe event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_achieve_level | NUMERIC | Cost per level achieved (SKAN) | Average cost per achieve level event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
TikTok Ads SKAN Conversions fields (skan_cost_per_total_add_to_cart to skan_loan_apply)
| ID | Type | Name | Description |
|---|---|---|---|
| skan_cost_per_total_add_to_cart | NUMERIC | Cost per add to cart (SKAN) | Average cost per add to cart event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_add_to_wishlist | NUMERIC | Cost per add to wishlist (SKAN) | Average cost per add to wishlist event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_checkout | NUMERIC | Cost per checkout (SKAN) | Average cost per checkout event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_complete_tutorial | NUMERIC | Cost per tutorial completed (SKAN) | Average cost per complete tutorial event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_create_gamerole | NUMERIC | Cost per role created (SKAN) | Average cost per create role event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_create_group | NUMERIC | Cost per group created (SKAN) | Average cost per create group event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_in_app_ad_click | NUMERIC | Cost per in-app ad click (SKAN) | Average cost per in-app ad click event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_in_app_ad_impr | NUMERIC | Cost per in-app ad impression (SKAN) | Average cost per in-app ad impression event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_join_group | NUMERIC | Cost per group join (SKAN) | Average cost per join group event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_launch_app | NUMERIC | Cost per app launch (SKAN) | Average cost per launch app event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_loan_apply | NUMERIC | Cost per loan application (SKAN) | Average cost per loan application event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_loan_credit | NUMERIC | Cost per loan approval (SKAN) | Average cost per loan approval event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_loan_disbursement | NUMERIC | Cost per loan disbursal (SKAN) | Average cost per loan disbursal event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_login | NUMERIC | Cost per login (SKAN) | Average cost per login event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_purchase | NUMERIC | Cost per purchase (SKAN) | Average cost per purchase event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_ratings | NUMERIC | Cost per rating (SKAN) | Average cost per rate event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_registration | NUMERIC | Cost per registration (SKAN) | Average cost per registration event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_sales_lead | NUMERIC | Cost per lead generated (SKAN) | Average cost per generate lead event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_search | NUMERIC | Cost per search (SKAN) | Average cost per search event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_spend_credits | NUMERIC | Cost per credit spend (SKAN) | Average cost per spend credit event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_start_trial | NUMERIC | Cost per trial started (SKAN) | Average cost per start trial event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_subscribe | NUMERIC | Cost per subscription (SKAN) | Average cost per subscribe event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_unlock_achievement | NUMERIC | Cost per achievement unlocked (SKAN) | Average cost per unlock achievement event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_total_view_content | NUMERIC | Cost per content view (SKAN) | Average cost per view content event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_unlock_achievement | NUMERIC | Cost per unique achievement unlocked (SKAN) | Average cost per unique unlock achievement event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_view_content | NUMERIC | Cost per unique content view (SKAN) | Average cost per unique view content event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_total_add_payment_info | NUMERIC | Cost per payment info add (SKAN) | Average cost per add payment info event. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_create_gamerole | NUMERIC | Unique roles created (SKAN) | Number of unique create role events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_create_gamerole_rate | PERCENT | Unique role creation rate (SKAN) | Percentage of unique create role events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_create_group | NUMERIC | Unique groups created (SKAN) | Number of unique create group events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_create_group_rate | PERCENT | Unique group creation rate (SKAN) | Percentage of unique create group events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_in_app_ad_click | NUMERIC | Unique in-app ad clicks (SKAN) | Number of unique in-app ad click events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_in_app_ad_click_rate | PERCENT | Unique in-app ad click rate (SKAN) | Percentage of unique in-app ad click events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_in_app_ad_impr | NUMERIC | Unique in-app ad impressions (SKAN) | Number of unique in-app ad impression events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_in_app_ad_impr_rate | PERCENT | Unique in-app ad impression rate (SKAN) | Percentage of unique in-app ad impression events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_join_group | NUMERIC | Unique group joins (SKAN) | Number of unique join group events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_join_group_rate | PERCENT | Unique group joining rate (SKAN) | Percentage of unique join group events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_launch_app | NUMERIC | Unique app launches (SKAN) | Number of unique launch app events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_launch_app_rate | PERCENT | Unique app launch rate (SKAN) | Percentage of unique launch app events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_loan_apply | NUMERIC | Unique loan applications (SKAN) | Number of unique loan application events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
TikTok Ads SKAN Conversions fields (skan_loan_apply_rate to skan_total_in_app_ad_click_value)
| ID | Type | Name | Description |
|---|---|---|---|
| skan_loan_apply_rate | PERCENT | Unique loan application rate (SKAN) | Percentage of unique loan application events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_loan_credit | NUMERIC | Unique loan approvals (SKAN) | Number of unique loan approval events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_loan_credit_rate | PERCENT | Unique loan approval rate (SKAN) | Percentage of unique loan approval events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_loan_disbursement | NUMERIC | Unique loan disbursals (SKAN) | Number of unique loan disbursal events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_loan_disbursement_rate | PERCENT | Unique loan disbursal rate (SKAN) | Percentage of unique loan disbursal events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_login | NUMERIC | Unique logins (SKAN) | Number of unique login events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_login_rate | PERCENT | Unique login rate (SKAN) | Percentage of unique login events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_purchase | NUMERIC | Unique purchases (SKAN) | Number of unique purchase events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_purchase_rate | PERCENT | Unique purchase rate (%) (SKAN) | Percentage of unique purchase events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_ratings | NUMERIC | Unique ratings (SKAN) | Number of unique rate events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_ratings_rate | PERCENT | Unique rate rate (SKAN) | Percentage of unique rate events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_registration | NUMERIC | Unique registrations (SKAN) | Number of unique registration events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_registration_rate | PERCENT | Unique registration rate (SKAN) | Percentage of unique registration events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_sales_lead | NUMERIC | Unique leads generated (SKAN) | Number of unique generate lead events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_sales_lead_rate | PERCENT | Unique lead generation rate (SKAN) | Percentage of unique generate lead events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_search | NUMERIC | Unique searches (SKAN) | Number of unique search events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_search_rate | PERCENT | Unique search rate (SKAN) | Percentage of unique search events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_spend_credits | NUMERIC | Unique credit spends (SKAN) | Number of unique spend credit events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_spend_credits_rate | PERCENT | Unique credit spend rate (SKAN) | Percentage of unique spend credit events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_start_trial | NUMERIC | Unique trial started (SKAN) | Number of unique start trial events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_start_trial_rate | PERCENT | Unique trial start rate (SKAN) | Percentage of unique start trial events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_subscribe | NUMERIC | Unique subscriptions (SKAN) | Number of unique subscribe events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_subscribe_rate | PERCENT | Unique subscription rate (SKAN) | Percentage of unique subscribe events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_achieve_level | NUMERIC | Levels achieved (SKAN) | Number of achieve level events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_achieve_level_value | NUMERIC | Level achievement value (SKAN) | Total value returned from all achieve level events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_add_payment_info | NUMERIC | Payment info adds (SKAN) | Number of add payment info events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_add_to_cart | NUMERIC | Adds to cart (SKAN) | Number of add to cart events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_add_to_cart_value | NUMERIC | Add to cart value (SKAN) | Total value returned from all add to cart events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_add_to_wishlist | NUMERIC | Adds to wishlist (SKAN) | Number of add to wishlist events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_add_to_wishlist_value | NUMERIC | Add to wishlist value (SKAN) | Total value returned from all add to wishlist events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_checkout | NUMERIC | Checkouts (SKAN) | Number of checkout events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_checkout_value | NUMERIC | Checkout value (SKAN) | Total value returned from all checkout events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_complete_tutorial | NUMERIC | Tutorials completed (SKAN) | Number of complete tutorial events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_complete_tutorial_value | NUMERIC | Tutorial completion value (SKAN) | Total value returned from all complete tutorial events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_create_gamerole | NUMERIC | Roles created (SKAN) | Number of create role events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_create_gamerole_value | NUMERIC | Role creation value (SKAN) | Total value returned from all create role events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_create_group | NUMERIC | Groups created (SKAN) | Number of create group events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_create_group_value | NUMERIC | Group creation value (SKAN) | Total value returned from all create group events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_in_app_ad_click | NUMERIC | In-app ad clicks (SKAN) | Number of in-app ad click events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_in_app_ad_click_value | NUMERIC | In-app ad click value (SKAN) | Total value returned from all in-app ad click events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
TikTok Ads SKAN Conversions fields (skan_total_in_app_ad_impr to skan_view_content_rate)
| ID | Type | Name | Description |
|---|---|---|---|
| skan_total_in_app_ad_impr | NUMERIC | In-app ad impressions (SKAN) | Number of in-app ad impression events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_in_app_ad_impr_value | NUMERIC | In-app ad impression value (SKAN) | Total value returned from all in-app ad impression events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_join_group | NUMERIC | Group joins (SKAN) | Number of join group events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_join_group_value | NUMERIC | Group joining value (SKAN) | Total value returned from all join group events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_launch_app | NUMERIC | App launches (SKAN) | Number of launch app events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_loan_apply | NUMERIC | Loan applications (SKAN) | Number of loan application events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_loan_credit | NUMERIC | Loan approvals (SKAN) | Number of loan approval events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_loan_disbursement | NUMERIC | Loan disbursals (SKAN) | Number of loan disbursal events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_login | NUMERIC | Logins (SKAN) | Number of login events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_purchase | NUMERIC | Purchases (SKAN) | Number of purchase events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_purchase_value | NUMERIC | Purchase value (SKAN) | Total value returned from all purchase events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_ratings | NUMERIC | Ratings (SKAN) | Number of rate events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_ratings_value | NUMERIC | Rating value (SKAN) | Total value returned from all rate events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_registration | NUMERIC | Registrations (SKAN) | Number of in-app registration events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_repetitive_active_pay_roas | NUMERIC | Purchase ROAS (SKAN) | Total return on ad spend (ROAS) from purchase events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_sales_lead | NUMERIC | Leads generated (SKAN) | Number of generate lead events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_sales_lead_value | NUMERIC | Lead generation value (SKAN) | Total value returned from all generate lead events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_search | NUMERIC | Searches (SKAN) | Number of search events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_spend_credits | NUMERIC | Credit spends (SKAN) | Number of spend credit events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_spend_credits_value | NUMERIC | Credit spend value (SKAN) | Total value returned from all spend credit events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_start_trial | NUMERIC | Trials started (SKAN) | Number of start trial events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_subscribe | NUMERIC | Subscriptions (SKAN) | Number of subscribe events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_subscribe_value | NUMERIC | Subscription value (SKAN) | Total value returned from all subscribe events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_unlock_achievement | NUMERIC | Achievements unlocked (SKAN) | Number of unlock achievement events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_unlock_achievement_value | NUMERIC | Unlocked achievement value (SKAN) | Total value returned from all unlock achievement events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_view_content | NUMERIC | Content views (SKAN) | Number of view content events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_total_view_content_value | NUMERIC | Content view value (SKAN) | Total value returned from all view content events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_unlock_achievement | NUMERIC | Unique achievements unlocked (SKAN) | Number of unique unlock achievement events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_unlock_achievement_rate | PERCENT | Unique achievement unlocked rate (SKAN) | Percentage of unique unlock achievement events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_view_content | NUMERIC | Unique content views (SKAN) | Number of unique view content events attributed to your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_view_content_rate | PERCENT | Unique content view rate (SKAN) | Percentage of unique view content events out of all app install events. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
TikTok Ads SKAN Conversions (Attribution) fields
The SKAN Conversions (Attribution) report of the TikTok Ads connector includes 16 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| skan_cost_per_cta_app_install | NUMERIC | Cost per CTA app install (SKAN) | Average cost per app install event attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_cta_conversion | NUMERIC | Cost per CTA conversion (SKAN) | Average cost per in-app conversion event attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_cta_purchase | NUMERIC | Cost per CTA purchase (SKAN) | Average cost per in-app purchase event attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_cta_registration | NUMERIC | Cost per CTA registration (SKAN) | Average cost per in-app registration event attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_vta_app_install | NUMERIC | Cost per VTA app install (SKAN) | Average cost per app install event attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_vta_conversion | NUMERIC | Cost per VTA conversion (SKAN) | Average cost per conversion event attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_vta_purchase | NUMERIC | Cost per VTA purchase (SKAN) | Average cost per in-app purchase event attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cost_per_vta_registration | NUMERIC | Cost per VTA registration (SKAN) | Average cost per in-app registration event attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cta_app_install | NUMERIC | CTA app installs (SKAN) | Number of app install events attributed to clicks on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cta_conversion | NUMERIC | CTA conversions (SKAN) | Number of in-app conversion events attributed to ad impressions. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cta_purchase | NUMERIC | CTA purchases (SKAN) | Number of in-app purchase events attributed to clicks on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_cta_registration | NUMERIC | CTA registrations (SKAN) | Number of in-app registration events attributed to a click on your ad. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_vta_app_install | NUMERIC | VTA app installs (SKAN) | Number of app install events attributed to ad impressions. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_vta_conversion | NUMERIC | VTA conversions (SKAN) | Number of conversion events attributed to ad impressions. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_vta_purchase | NUMERIC | VTA purchases (SKAN) | Number of in-app purchase events attributed to ad impressions. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
| skan_vta_registration | NUMERIC | VTA registrations (SKAN) | Number of in-app registration events attributed to an ad impression. Data may be incomplete due to SKAdNetwork (SKAN) limitations. |
TikTok Ads SKAN Performance fields
The SKAN Performance report of the TikTok Ads connector includes 10 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| skan_click_time_conversion | NUMERIC | Conversions (SKAN click time) | The number of times your ad achieved an outcome based on the objective and settings you selected. Data may be partial due to SKAdNetwork(SKAN) limitations. |
| skan_click_time_conversion_rate | PERCENT | CVR (SKAN click time, clicks) | The percentage of conversions from all clicks of your ads. Data may be incomplete due to SKAdNetwork (SKAN) limitations. (Time of events reported is based on modeled results. This metric is not available at the ad level.) |
| skan_click_time_cost_per_conversion | NUMERIC | CPA (SKAN click time) | The average amount of money you've spent on a conversion. Data may be partial due to SKAdNetwork(SKAN) limitations. |
| skan_conversion | NUMERIC | Conversions (SKAN) | Number of times your ad resulted in an intended outcome based on your optimization event. |
| skan_conversion_rate | PERCENT | Conversion rate (SKAN, clicks) | Percentage of conversions you received out of all destination clicks on your ads. |
| skan_conversion_rate_v2 | PERCENT | Conversion rate (SKAN) | Percentage of conversions you received out of all impressions on your ads. |
| skan_cost_per_conversion | NUMERIC | Cost per conversion (SKAN) | Average amount you spent on a conversion. |
| skan_cost_per_result | NUMERIC | Cost per result (SKAN) | Average cost per each result from your ads. |
| skan_result_rate | PERCENT | Result rate (SKAN) | Percentage of results that happened out of all impressions on your ads. |
| skan_results | NUMERIC | Results (SKAN) | Number of times your ad resulted in an intended outcome based on your campaign objective and optimization goal. |
TikTok Ads other fields
The TikTok Ads connector has 70 fields that do not belong to a named report, or belong to a report with only one or two fields.
TikTok Ads other fields (ac to match_type)
| ID | Type | Name | Description | Report |
|---|---|---|---|---|
| ac | TEXT | Audience Network | Audience network. | Audience (Audience Network) |
| ad_format | TEXT | Ad Format | The ad format. Enum values: SINGLE_IMAGE, SINGLE_VIDEO, LIVE_CONTENT, CAROUSEL_ADS, CATALOG_CAROUSEL. | |
| ad_group_budget | NUMERIC | Ad Group Budget mode | Ad Group budget. | |
| ad_group_budget_mode | TEXT | Ad Group Budget mode | Ad Group budget mode. If Campaign Budget Optimization is enabled, BUDGET_MODE_INFINITE will be returned. | |
| ad_group_operation_status | TEXT | Ad group operation status | Ad Group operation status. Enum values: ENABLE, DISABLE, FROZEN. | |
| ad_group_placement_type | TEXT | Ad Group Placement type | The placement strategy that decides where your ads will be shown. Enum values: PLACEMENT_TYPE_AUTOMATIC (Automatic placement), PLACEMENT_TYPE_NORMAL (Select placement). | |
| ad_group_product_source | TEXT | Ad Group Product Source | Product source where you want to get products for promotion. Possible values: UNSET, CATALOG (Catalog), STORE (TikTok Shop), SHOWCASE (TikTok Showcase). | |
| ad_group_shopping_ads_type | TEXT | Ad Group Shopping Ads Type | Shopping ads type of the ad group, e.g. VIDEO (Video Shopping Ads) or UNSET. Only returned for TikTok Shop ad groups. | |
| ad_playable_url | TEXT | Ad Playable URL | Playable material URL. Only supported by the interactive Playable Ad type. | |
| ad_type | TEXT | Ad Type | Ad type. | Audience (Ad Type) |
| additional_interests | TEXT | Additional Interests | Additional interests. | Audience (Additional Interests) |
| adgroup_status | TEXT | Adgroup Status | Adgroup status | |
| age | TEXT | Age | Age. | Audience (Age) |
| audience_placement | TEXT | Audience Placement | Audience placement. | Audience (Placement) |
| audience_tags | TEXT | Audience Tags | Audience tags. | Audience (Audience Tags) |
| behavior_id | TEXT | Behavior ID | Behavior ID. | Audience (Behavior) |
| component_name | TEXT | Component Name | Component name on the TikTok Instant Form. | Assets (TikTok Instant Form Component) |
| contextual_tag | TEXT | Contextual Tag | Contextual tag. | Audience (Contextual Tag) |
| country | COUNTRY | Country | Country code. | Audience (Country) |
| country_code | COUNTRY | Country code | Country code. (Duplicate) | Audience (Country) |
| custom_event_type | TEXT | Custom Event Type | Custom event type. | Assets (Custom Event) |
| data_fetched_at | Data fetched at | UTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed. | ||
| datasource | TEXT | Data Source | The name of the Windsor connector returning the row | |
| date | DATE | Date | Date. | Time (Date) |
| day_of_month | TEXT | Day of month | Day of the month | |
| device_brand_id | TEXT | Device Brand ID | Device brand ID. | Audience (Device Brand) |
| dma_id | TEXT | DMA ID | Designated Market Area ID. | Audience (DMA) |
| event_source_id | TEXT | Event Source ID | Event source ID. | Assets (Event Source) |
| gender | TEXT | Gender | Gender. | Audience (Gender) |
| gmv_max_ads_billed_cost | NUMERIC | GMV Max Ads Net Cost | The amount spent, excluding ad credit/coupons used. | GMV Max Ads |
| gmv_max_ads_spend | NUMERIC | GMV Max Ads Total Cost | The estimated total amount you've spent on your ads during its schedule. | GMV Max Ads |
| hashtag | TEXT | Hashtag | Hashtag. | Audience (Hashtag) |
| hour | TEXT | Hour | Hour. | Time (Hour) |
| image_id | TEXT | Image ID | Image ID. | Assets (Image) |
| interest_category | TEXT | First Level Interest Category | First level interest category. | Audience (First Level Interest Category) |
| interest_category_tier2 | TEXT | Second Level Interest Category | Second level interest category. | Audience (Second Level Interest Category) |
| interest_category_tier3 | TEXT | Third Level Interest Category | Third level interest category. | Audience (Third Level Interest Category) |
| interest_category_tier4 | TEXT | Fourth Level Interest Category | Fourth level interest category. | Audience (Fourth Level Interest Category) |
| language | TEXT | Language | Language. | Audience (Language) |
| match_type | TEXT | Match Type | Match type. | Search (Match Type) |
TikTok Ads other fields (month to year_week_iso)
| ID | Type | Name | Description | Report |
|---|---|---|---|---|
| month | TEXT | Month | Number of the month | |
| now | Now | Current timestamp | ||
| optimization_goal | TEXT | Adgroup Optimization goal | Optimization goal. Only available at Adgroup level and when Campaign Budget Optimization is enabled. | |
| page_id | TEXT | Page ID | Page ID. | Assets (Page) |
| platform | TEXT | Platform | Operating system. | Audience (Platform) |
| post_id | TEXT | Post ID | Post ID. | Assets (Post) |
| profile_image_url | IMAGE_URL | Profile Image URL | Profile Image URL used for ad. | |
| province_id | TEXT | Province ID | Province ID | Audience (Province) |
| province_name | TEXT | Province Name | Province name. | Audience (Province) |
| purchase_intention | TEXT | Purchase Intention | Purchase intention. | Audience (Purchase Intention) |
| room_id | TEXT | Room ID | Live room ID. | Assets (Live Room) |
| schedule_end_time | TEXT | Schedule end time | Ad delivery end time (UTC+0). | |
| schedule_start_time | TEXT | Schedule start time | Ad delivery start time (UTC+0). | |
| search_keyword | TEXT | Search Keyword | Search keyword. | Search (Search Keyword) |
| search_terms | TEXT | Search Terms | Search terms. | Search (Search Terms) |
| skan_postback_sequence | TEXT | SKAN Postback Sequence | Order in which postbacks occurred in the SKAN 4.0 framework. The SKAN 4.0 framework is a mobile attribution framework developed by Apple that helps advertisers measure the effectiveness of their ad campaigns. Possible values: 0 (The campaign is not an iOS 14 Dedicated Campaign, so the SKAN Postback Sequence doesn't apply), 1 (The first postback in the SKAN 4.0 framework, which allows you to measure in-app activity from day 0 through to day 2), 2 (The second postback in the SKAN 4.0 framework, which allows you to measure in-app activity from day 3 through to day 7), 3 (The third postback in the SKAN 4.0 framework, which allows you to measure in-app activity from day 8 through to day 35). | SKAN Postback Sequence |
| source | TEXT | Source | The name of the Windsor connector returning the row | |
| today | DATE | Today | Today's date | |
| video_material_id | TEXT | Video Material ID | Video Material ID. | Assets (Video) |
| week | TEXT | Week | Week (Sun-Sat). | |
| week_day | TEXT | Day of week and day number | Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday. | |
| week_day_iso | TEXT | Day of week and day number, ISO | Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7 | |
| week_iso | TEXT | Week ISO | Week, ISO format (Mon-Sun). | |
| year | TEXT | Year | Year | |
| year_month | TEXT | Yearmonth | Year and month, e.g. 2024|3 | |
| year_month_name | TEXT | Year month name | Year and month with the month name written out, e.g. "Jan 2025". | |
| year_of_week | TEXT | Year of week | The year that contains first day of the week (Sun-Sat). | |
| year_of_week_iso | TEXT | Year of week, ISO | The year that contains first day of the ISO week (Mon-Sun). | |
| year_week | TEXT | Year week | Year and week for US weeks (Sun-Sat), e.g. 2024|15 | |
| year_week_iso | TEXT | Year week ISO | Year and week for ISO weeks (Mon-Sun), e.g. 2024|20 |