TIKTOK ADS FIELDS

Every TikTok Ads field, documented

All 336 metrics and dimensions you can pull into Data Studio and into Claude, ChatGPT or Gemini with the Data Bloo connector, grouped, searchable, and free to use.

Available inData Studio Claude ChatGPT Gemini

301Metrics

35Dimensions

15Categories

336 fields

All fields336Metrics301Dimensions35

Cost & spend

23 fields

FieldDescriptionType

CostcostTotal amount spent on your TikTok Ads campaigns.Metric

Cost (cash)cost_cashSpend paid from your cash balance.Metric

Cost (voucher)cost_voucherSpend covered by ad vouchers or credits.Metric

CPCcpcAverage cost per click.Metric

CPMcpmAverage cost per 1,000 impressions.Metric

BidbidThe bid amount set for the ad group.Metric

Ad group budgetad_group_budgetBudget assigned at ad group level.Metric

Campaign budgetcampaign_budgetBudget assigned at campaign level.Metric

Cost per 1,000 people reachedcost_per_1000_reachedSpend divided by every thousand unique people reached.Metric

Cost per conversioncost_per_conversionSpend divided by conversions.Metric

Cost per resultcost_per_resultSpend divided by your optimisation goal results.Metric

Cost per secondary goal resultcost_per_secondary_goal_resultSpend divided by secondary goal results.Metric

Cost per landing page viewcost_per_landing_page_viewSpend divided by landing page views.Metric

Cost per page view (website)cost_per_pageviewSpend divided by website page views.Metric

Cost per page view contentcost_per_page_content_view_eventSpend divided by page view content events.Metric

Cost per add to cartcost_per_web_event_add_to_cartSpend divided by website adds to cart.Metric

Cost per add to cart (in app)cost_per_total_app_event_add_to_cartSpend divided by in-app adds to cart.Metric

Cost per add to cart (onsite)cost_per_onsite_on_web_cartSpend divided by onsite adds to cart.Metric

Cost per add to wishlist (website)cost_per_on_web_add_to_wishlistSpend divided by website wishlist adds.Metric

Cost per subscribecost_per_on_web_subscribeSpend divided by subscribe events.Metric

Cost per complete payment (onsite)cost_per_onsite_shoppingSpend divided by onsite completed payments.Metric

Cost per real-time conversioncost_per_real_time_conversionSpend divided by real-time conversions.Metric

Cost per real-time resultreal_time_cost_per_resultSpend divided by real-time results.Metric

Reach & clicks

6 fields

FieldDescriptionType

ImpressionsimpressionsThe number of times your ads were shown.Metric

ReachreachThe number of unique people who saw your ads.Metric

FrequencyfrequencyAverage impressions per person reached.Metric

ClicksclicksThe number of clicks on your ads.Metric

Clicks (All)engagementsAll clicks counted across ad elements.Metric

CTRctrClicks divided by impressions.Metric

Video performance

11 fields

FieldDescriptionType

Video viewsvideo_play_actionsThe number of times your video started playing.Metric

2-second video viewsvideo_watched_2sViews where the video played at least two seconds.Metric

6-second video viewsvideo_watched_6sViews where the video played at least six seconds.Metric

6-second video views (focused view)engaged_viewSix-second views with the video in focus on screen.Metric

15-second video views (focused view)engaged_view_15sFifteen-second views with the video in focus.Metric

Video views at 25%video_views_p25Views that reached a quarter of the video.Metric

Video views at 50%video_views_p50Views that reached halfway.Metric

Video views at 75%video_views_p75Views that reached three quarters.Metric

Video views at 100%video_views_p100Views that watched the video to the end.Metric

Avg watch time per video viewaverage_video_playAverage seconds watched per view.Metric

Avg watch time per personaverage_video_play_per_userAverage seconds watched per unique person.Metric

Paid engagement

11 fields

FieldDescriptionType

Paid likeslikesLikes earned from your paid ads.Metric

Paid commentscommentsComments earned from your paid ads.Metric

Paid sharessharesShares earned from your paid ads.Metric

Paid followsfollowsNew followers earned from your paid ads.Metric

Profile visitsprofile_visitsVisits to your profile driven by ads.Metric

Sound clicksclicks_on_music_discClicks on the sound attached to your ad.Metric

Use sound button clickssound_usage_clicksClicks on the use-this-sound button.Metric

Duet clicksduet_clicksClicks on the duet option.Metric

Stitch clicksstitch_clicksClicks on the stitch option.Metric

Button click eventsbutton_clickClicks on the ad call-to-action button.Metric

Total button click valuetotal_button_click_valueTotal value attributed to button clicks.Metric

Conversions & results

16 fields

FieldDescriptionType

ConversionsconversionsConversions attributed to your ads.Metric

Conversion rateconversion_rateConversions divided by clicks.Metric

ResultsresultsResults against your chosen optimisation goal.Metric

Result rateresult_rateResults divided by impressions or clicks.Metric

Secondary goal resultsecondary_goal_resultResults against your secondary goal.Metric

Real-time conversionsreal_time_conversionsConversions reported without attribution delay.Metric

Real-time conversion ratereal_time_conversion_rateReal-time conversions divided by clicks.Metric

Real-time resultsreal_time_resultsResults reported without attribution delay.Metric

Real-time result ratereal_time_result_rateReal-time results divided by impressions or clicks.Metric

Real-time app installsreal_time_app_installApp installs reported in real time.Metric

CTA conversionscta_conversionConversions attributed to a click.Metric

CTA purchasescta_purchasePurchases attributed to a click.Metric

CTA registrationscta_registrationRegistrations attributed to a click.Metric

VTA conversionsvta_conversionConversions attributed to a view.Metric

VTA purchasesvta_purchasePurchases attributed to a view.Metric

VTA registrationsvta_registrationRegistrations attributed to a view.Metric

Website events

40 fields

FieldDescriptionType

Page views (website)total_pageviewPage views on your site after an ad interaction.Metric

Page view rate (website)pageview_ratePage views divided by clicks.Metric

Value per page view (website)avg_value_per_pageviewAverage value of a website page view.Metric

Total page view value (website)total_value_per_pageviewCombined value of website page views.Metric

Total landing page viewtotal_landing_page_viewLanding page views after an ad click.Metric

Landing page view ratelanding_page_view_rateLanding page views divided by clicks.Metric

Total page view contentpage_content_view_eventsContent view events on your site.Metric

Total page view content valuetotal_page_view_content_events_valueCombined value of content view events.Metric

Page browse eventspage_browse_viewBrowsing events recorded on your site.Metric

Product details page browse eventsproduct_details_page_browseViews of a product detail page.Metric

Total product details page browse valuetotal_product_details_page_browse_valueCombined value of product detail views.Metric

Search eventspage_event_searchSearches performed on your site.Metric

Total search valuetotal_page_event_search_valueCombined value of site searches.Metric

Add to cart eventsweb_event_add_to_cartAdds to cart on your website.Metric

Total add to cart valuetotal_web_event_add_to_cart_valueCombined value of website adds to cart.Metric

Adds to wishlist (website)on_web_add_to_wishlistWishlist adds on your website.Metric

Unique add to wishlist rate (website)on_web_add_to_wishlist_per_clickUnique wishlist adds divided by clicks.Metric

Add to wishlist value (website)total_on_web_add_to_wishlist_valueCombined value of website wishlist adds.Metric

Value per add to wishlist (website)value_per_on_web_add_to_wishlistAverage value of a website wishlist add.Metric

Place an order eventson_web_orderOrders placed on your website.Metric

Total place an order valuetotal_on_web_order_valueCombined value of website orders.Metric

Total subscribeon_web_subscribeSubscriptions recorded on your website.Metric

Subscribe rate (%)on_web_subscribe_per_clickSubscriptions divided by clicks.Metric

Total subscribe valuetotal_on_web_subscribe_valueCombined value of website subscriptions.Metric

Value per subscribevalue_per_on_web_subscribeAverage value of a subscription.Metric

Complete payment eventscomplete_paymentCompleted payments on your website.Metric

Complete payment ROAScomplete_payment_roasReturn on ad spend from completed payments.Metric

Total complete payment valuetotal_complete_payment_rateCombined value of completed payments.Metric

Checkout initiationsinitiate_checkoutCheckouts started on your website.Metric

Total initiate checkout valuetotal_initiate_checkout_valueCombined value of started checkouts.Metric

Form submissionsformLead forms submitted.Metric

Total form submission valuetotal_form_valueCombined value of form submissions.Metric

Online consultation eventsonline_consultConsultation requests recorded.Metric

Total online consultation valuetotal_online_consult_valueCombined value of consultation requests.Metric

Download button clicksdownload_startClicks on a download button.Metric

Total download button click valuetotal_download_start_valueCombined value of download clicks.Metric

User registrationsuser_registrationRegistrations completed on your site.Metric

Total user registration valuetotal_user_registration_valueCombined value of registrations.Metric

Add billingadd_billingBilling information added.Metric

Total add billing valuetotal_add_billing_valueCombined value of billing additions.Metric

TikTok Shop (onsite)

12 fields

FieldDescriptionType

Add to cart (onsite)onsite_on_web_cartAdds to cart inside TikTok.Metric

Total add to cart value (onsite)total_onsite_on_web_cart_valueCombined value of onsite adds to cart.Metric

Product details page view (onsite)onsite_on_web_detailProduct page views inside TikTok.Metric

Complete payment (onsite)onsite_shoppingPayments completed inside TikTok.Metric

Total complete payment value (onsite)total_onsite_shopping_valueCombined value of onsite payments.Metric

Complete payment ROAS (onsite)onsite_shopping_roasReturn on ad spend from onsite payments.Metric

Purchase rate (Shop)onsite_shopping_rateOnsite purchases divided by clicks.Metric

Average order value (Shop)value_per_onsite_shoppingAverage value of an onsite order.Metric

Add to wishlist (onsite)onsite_add_to_wishlistWishlist adds inside TikTok.Metric

Add billing (onsite)onsite_add_billingBilling details added inside TikTok.Metric

App store click (onsite)onsite_download_startApp store clicks inside TikTok.Metric

Form submission (onsite)onsite_formForms submitted inside TikTok.Metric

App events

45 fields

FieldDescriptionType

App installsapp_installInstalls attributed to your ads.Metric

Unique app launcheslaunch_appPeople who opened your app.Metric

Launch app eventstotal_launch_appTotal app launch events.Metric

Unique day 2 retentionsnext_day_openPeople who returned the day after installing.Metric

Day 2 retention eventstotal_next_day_openTotal day-two retention events.Metric

Unique adds to cartapp_event_add_to_cartPeople who added to cart in your app.Metric

Add to cart eventstotal_app_event_add_to_cartTotal in-app adds to cart.Metric

Total add to cart valuetotal_app_event_add_to_cart_valueCombined value of in-app adds to cart.Metric

Unique payment info additionsadd_payment_infoPeople who added payment details.Metric

Add payment info eventstotal_add_payment_infoTotal payment info events.Metric

Unique checkoutscheckoutPeople who started checkout in your app.Metric

Checkout eventstotal_checkoutTotal in-app checkout events.Metric

Total checkout valuetotal_checkout_valueCombined value of in-app checkouts.Metric

Unique purchasespurchasePeople who purchased in your app.Metric

Purchase eventstotal_purchaseTotal in-app purchase events.Metric

Total purchase valuetotal_purchase_valueCombined value of in-app purchases.Metric

Unique adds to wishlistadd_to_wishlistPeople who added to wishlist in your app.Metric

Add to wishlist eventstotal_add_to_wishlistTotal in-app wishlist adds.Metric

Total add to wishlist valuetotal_add_to_wishlist_valueCombined value of in-app wishlist adds.Metric

Unique content viewsview_contentPeople who viewed content in your app.Metric

View content eventstotal_view_contentTotal in-app content views.Metric

Total view content valuetotal_view_content_valueCombined value of in-app content views.Metric

Unique searchessearchPeople who searched in your app.Metric

Search eventstotal_searchTotal in-app searches.Metric

Unique registrationsregistrationPeople who registered in your app.Metric

Registrations eventstotal_registrationTotal in-app registrations.Metric

Unique loginsloginPeople who logged into your app.Metric

Login eventstotal_loginTotal in-app logins.Metric

Unique subscribessubscribePeople who subscribed in your app.Metric

Subscribe eventstotal_subscribeTotal in-app subscriptions.Metric

Total subscribe valuetotal_subscribe_valueCombined value of in-app subscriptions.Metric

Unique trial statsstart_trialPeople who started a trial.Metric

Start trial eventstotal_start_trialTotal trial starts.Metric

Unique rateratingsPeople who rated your app.Metric

Total ratetotal_ratingsTotal rating events.Metric

Total rate valuetotal_ratings_valueCombined value of rating events.Metric

Unique generate leadsales_leadPeople who became a lead in your app.Metric

Total generate leadtotal_sales_leadTotal lead events.Metric

Total generate lead valuetotal_sales_lead_valueCombined value of lead events.Metric

Unique in-app ad clicksin_app_ad_clickPeople who clicked an ad inside your app.Metric

In-app ad clickstotal_in_app_ad_clickTotal in-app ad clicks.Metric

Total in app ad click valuetotal_in_app_ad_click_valueCombined value of in-app ad clicks.Metric

Unique in-app ad impressionsin_app_ad_imprPeople who saw an ad inside your app.Metric

In-app ad impressionstotal_in_app_ad_imprTotal in-app ad impressions.Metric

Total in-app ad impression valuetotal_in_app_ad_impr_valueCombined value of in-app ad impressions.Metric

Gaming & app milestones

21 fields

FieldDescriptionType

Unique level achievementsachieve_levelPeople who reached a level in your app.Metric

Achieve level eventstotal_achieve_levelTotal level achievement events.Metric

Total achieve level valuetotal_achieve_level_valueCombined value of level achievements.Metric

Unique achievement unlocksunlock_achievementPeople who unlocked an achievement.Metric

Unlock achievement eventstotal_unlock_achievementTotal achievement unlocks.Metric

Total unlock achievement valuetotal_unlock_achievement_valueCombined value of achievement unlocks.Metric

Unique role creationscreate_gamerolePeople who created a game character.Metric

Create role eventstotal_create_gameroleTotal role creation events.Metric

Total create role valuetotal_create_gamerole_valueCombined value of role creations.Metric

Unique credit spendsspend_creditsPeople who spent in-app credits.Metric

Spend credit eventstotal_spend_creditsTotal credit spend events.Metric

Total spend credit valuetotal_spend_credits_valueCombined value of credit spends.Metric

Unique tutorial completionscomplete_tutorialPeople who finished the tutorial.Metric

Complete tutorial eventstotal_complete_tutorialTotal tutorial completions.Metric

Total complete tutorial valuetotal_complete_tutorial_valueCombined value of tutorial completions.Metric

Unique group creationscreate_groupPeople who created a group.Metric

Create group eventstotal_create_groupTotal group creation events.Metric

Total create group valuetotal_create_group_valueCombined value of group creations.Metric

Unique group joinsjoin_groupPeople who joined a group.Metric

Join group eventstotal_join_groupTotal group join events.Metric

Total join group valuetotal_join_group_valueCombined value of group joins.Metric

SKAN (iOS attribution)

77 fields

FieldDescriptionType

App Installs (SKAN)skan_app_installInstalls measured through SKAdNetwork.Metric

Conversions (SKAN)skan_conversionsSKAN-attributed conversions.Metric

Conversion rate (SKAN)skan_conversion_rateSKAN conversions divided by clicks.Metric

Cost per conversion (SKAN)skan_cost_per_conversionSpend divided by SKAN conversions.Metric

Results (SKAN)skan_resultsSKAN-attributed results.Metric

Result rate (SKAN)skan_result_rateSKAN results divided by impressions or clicks.Metric

Cost per result (SKAN)skan_cost_per_resultSpend divided by SKAN results.Metric

Unique adds to cart (SKAN)skan_add_to_cartSKAN-attributed people adding to cart.Metric

Add to cart events (SKAN)skan_total_add_to_cartTotal SKAN adds to cart.Metric

Total add to cart value (SKAN)skan_total_add_to_cart_valueCombined SKAN add-to-cart value.Metric

Cost per add to cart (SKAN)skan_cost_per_total_add_to_cartSpend divided by SKAN adds to cart.Metric

Unique purchases (SKAN)skan_purchaseSKAN-attributed purchasers.Metric

Purchase events (SKAN)skan_total_purchaseTotal SKAN purchases.Metric

Total purchase value (SKAN)skan_total_purchase_valueCombined SKAN purchase value.Metric

Unique checkouts (SKAN)skan_checkoutSKAN-attributed checkouts started.Metric

Checkout events (SKAN)skan_total_checkoutTotal SKAN checkouts.Metric

Total checkout value (SKAN)skan_total_checkout_valueCombined SKAN checkout value.Metric

Unique add payment info (SKAN)skan_add_payment_infoSKAN-attributed payment info adds.Metric

Add payment info events (SKAN)skan_total_add_payment_infoTotal SKAN payment info events.Metric

Unique add to wishlist (SKAN)skan_add_to_wishlistSKAN-attributed wishlist adds.Metric

Add to wishlist events (SKAN)skan_total_add_to_wishlistTotal SKAN wishlist adds.Metric

Total add to wishlist value (SKAN)skan_total_add_to_wishlist_valueCombined SKAN wishlist value.Metric

Unique view content (SKAN)skan_view_contentSKAN-attributed content views.Metric

View content events (SKAN)skan_total_view_contentTotal SKAN content views.Metric

Total view content value (SKAN)skan_total_view_content_valueCombined SKAN content view value.Metric

Unique search (SKAN)skan_searchSKAN-attributed searches.Metric

Search events (SKAN)skan_total_searchTotal SKAN searches.Metric

Unique registrations (SKAN)skan_registrationSKAN-attributed registrations.Metric

Registration events (SKAN)skan_total_registrationTotal SKAN registrations.Metric

Unique logins (SKAN)skan_loginSKAN-attributed logins.Metric

Login events (SKAN)skan_total_loginTotal SKAN logins.Metric

Unique subscribe (SKAN)skan_subscribeSKAN-attributed subscriptions.Metric

Subscribe events (SKAN)skan_total_subscribeTotal SKAN subscriptions.Metric

Total subscribe value (SKAN)skan_total_subscribe_valueCombined SKAN subscription value.Metric

Unique start trial (SKAN)skan_start_trialSKAN-attributed trial starts.Metric

Start trial events (SKAN)skan_total_start_trialTotal SKAN trial starts.Metric

Unique ratings (SKAN)skan_ratingsSKAN-attributed ratings.Metric

Rate events (SKAN)skan_total_ratingsTotal SKAN rating events.Metric

Total rate value (SKAN)skan_total_ratings_valueCombined SKAN rating value.Metric

Unique generate lead (SKAN)skan_sales_leadSKAN-attributed leads.Metric

Total generate lead events (SKAN)skan_total_sales_leadTotal SKAN lead events.Metric

Total generate lead value (SKAN)skan_total_sales_lead_valueCombined SKAN lead value.Metric

Unique launch app (SKAN)skan_launch_appSKAN-attributed app launches.Metric

Launch app events (SKAN)skan_total_launch_appTotal SKAN app launches.Metric

Unique achieve level (SKAN)skan_achieve_levelSKAN-attributed level achievements.Metric

Achieve level events (SKAN)skan_total_achieve_levelTotal SKAN level achievements.Metric

Total achieve level value (SKAN)skan_total_achieve_level_valueCombined SKAN level value.Metric

Unique unlock achievement (SKAN)skan_unlock_achievementSKAN-attributed achievement unlocks.Metric

Unlock achievement events (SKAN)skan_total_unlock_achievementTotal SKAN achievement unlocks.Metric

Total unlock achievement value (SKAN)skan_total_unlock_achievement_valueCombined SKAN achievement value.Metric

Unique create role (SKAN)skan_create_gameroleSKAN-attributed role creations.Metric

Create role events (SKAN)skan_total_create_gameroleTotal SKAN role creations.Metric

Total create role value (SKAN)skan_total_create_gamerole_valueCombined SKAN role creation value.Metric

Unique create group (SKAN)skan_create_groupSKAN-attributed group creations.Metric

Create group events (SKAN)skan_total_create_groupTotal SKAN group creations.Metric

Total create group value (SKAN)skan_total_create_group_valueCombined SKAN group creation value.Metric

Unique join group (SKAN)skan_join_groupSKAN-attributed group joins.Metric

Join group events (SKAN)skan_total_join_groupTotal SKAN group joins.Metric

Total join group value (SKAN)skan_total_join_group_valueCombined SKAN group join value.Metric

Unique complete tutorial (SKAN)skan_complete_tutorialSKAN-attributed tutorial completions.Metric

Complete tutorial events (SKAN)skan_total_complete_tutorialTotal SKAN tutorial completions.Metric

Total complete tutorial value (SKAN)skan_total_complete_tutorial_valueCombined SKAN tutorial value.Metric

Unique spend credit (SKAN)skan_spend_creditsSKAN-attributed credit spends.Metric

Spend credit events (SKAN)skan_total_spend_creditsTotal SKAN credit spends.Metric

Total spend credit value (SKAN)skan_total_spend_credits_valueCombined SKAN credit spend value.Metric

Unique in app ad click (SKAN)skan_in_app_ad_clickSKAN-attributed in-app ad clicks.Metric

In app ad click events (SKAN)skan_total_in_app_ad_clickTotal SKAN in-app ad clicks.Metric

Total an app ad click value (SKAN)skan_total_in_app_ad_click_valueCombined SKAN in-app ad click value.Metric

Unique in app ad impressions (SKAN)skan_in_app_ad_imprSKAN-attributed in-app ad impressions.Metric

In app ad impressions events (SKAN)skan_total_in_app_ad_imprTotal SKAN in-app ad impressions.Metric

Total in app ad impressions value (SKAN)skan_total_in_app_ad_impr_valueCombined SKAN in-app impression value.Metric

Unique loan apply (SKAN)skan_loan_applySKAN-attributed loan applications.Metric

Loan apply event (SKAN)skan_total_loan_applyTotal SKAN loan applications.Metric

Unique loan approval (SKAN)skan_loan_creditSKAN-attributed loan approvals.Metric

Loan approval events (SKAN)skan_total_loan_creditTotal SKAN loan approvals.Metric

Unique loan disbursement (SKAN)skan_loan_disbursementSKAN-attributed loan disbursements.Metric

Loan disbursement events (SKAN)skan_total_loan_disbursementTotal SKAN loan disbursements.Metric

Offline events

33 fields

FieldDescriptionType

CRM eventsoffline_total_crm_eventsCRM events uploaded from offline sources.Metric

CRM event rateoffline_crm_event_rateCRM events divided by clicks.Metric

CRM event valueoffline_crm_event_valueCombined value of CRM events.Metric

Value per CRM eventoffline_value_per_crm_eventAverage value of a CRM event.Metric

Custom events (offline)offline_total_custom_eventsCustom offline conversion events.Metric

Custom event rate (offline)offline_custom_event_rateCustom offline events divided by clicks.Metric

Custom event value (offline)offline_total_custom_event_valueCombined value of custom offline events.Metric

Value per custom event (offline)offline_value_per_custom_eventAverage value of a custom offline event.Metric

Adds to cart (offline)offline_add_to_cart_eventsOffline adds to cart.Metric

Adds to wishlist (offline)offline_add_to_wishlist_eventsOffline wishlist adds.Metric

Payment info adds (offline)offline_add_payment_info_eventsOffline payment info additions.Metric

Checkouts initiated (offline)offline_initiate_checkout_eventsOffline checkouts started.Metric

Orders placed (offline)offline_place_order_eventsOrders placed offline.Metric

Registrations (offline)offline_complete_registration_eventsRegistrations completed offline.Metric

Contacts (offline)offline_contact_eventsContact events recorded offline.Metric

Downloads (offline)offline_download_eventsDownloads recorded offline.Metric

Searches (offline)offline_search_eventsSearches recorded offline.Metric

Subscriptions (offline)offline_subscribe_eventsSubscriptions recorded offline.Metric

Content views (offline)offline_view_content_eventsContent views recorded offline.Metric

Button clicks (offline)offline_click_button_eventsButton clicks recorded offline.Metric

Preferred leads (offline)offline_preferred_leadsLeads marked as preferred offline.Metric

Preferred leads rate (offline)offline_preferred_lead_ratePreferred leads divided by clicks.Metric

Total schedule (offline)offline_total_scheduleAppointments scheduled offline.Metric

Schedule rate (offline)offline_schedule_rateSchedules divided by clicks.Metric

Total schedule value (offline)offline_total_schedule_valueCombined value of offline schedules.Metric

Value per schedule (offline)offline_value_per_scheduleAverage value of an offline schedule.Metric

Total find location (offline)offline_total_find_locationStore locator uses recorded offline.Metric

Find location rate (offline)offline_find_location_rateLocation lookups divided by clicks.Metric

Total find location value (offline)offline_total_find_location_valueCombined value of location lookups.Metric

Value per find location (offline)offline_value_per_find_locationAverage value of a location lookup.Metric

Total customize product (offline)offline_total_customize_productProduct customisations recorded offline.Metric

Customize product rate (offline)offline_customize_product_rateCustomisations divided by clicks.Metric

Total customize product value (offline)offline_total_customize_product_valueCombined value of customisations.Metric

Campaign structure

12 fields

FieldDescriptionType

Advertiser IDadvertiser_idThe advertiser account the data belongs to.Dimension

Advertiser nameadvertiser_nameThe name of the advertiser account.Dimension

Campaign IDcampaign_idUnique identifier of the campaign.Dimension

Campaign namecampaign_nameThe name you gave the campaign.Dimension

Campaign objective typecampaign_objective_typeThe objective the campaign optimises for.Dimension

Ad group IDad_group_idUnique identifier of the ad group.Dimension

Ad group namead_group_nameThe name you gave the ad group.Dimension

Ad group operation statusad_group_opt_statusWhether the ad group is active or paused.Dimension

Ad IDad_idUnique identifier of the ad.Dimension

Ad namead_nameThe name you gave the ad.Dimension

Bidding strategybid_typeThe bid strategy applied to the ad group.Dimension

Bid methodbilling_eventHow you are charged, per click or impression.Dimension

Creative & placement

12 fields

FieldDescriptionType

Ad textad_textThe ad copy shown with the creative.Dimension

Call-to-actioncall_to_actionThe CTA label on the ad.Dimension

Image modeimage_modeThe creative format used.Dimension

Post IDpost_idThe TikTok post backing the ad.Dimension

Profile image URLprofile_imageThe profile image shown on the ad.Dimension

PlacementplacementWhere the ad was delivered.Dimension

Placement typeplacement_typeWhether placement is automatic or selected.Dimension

Device platformplatformThe operating system of the device.Dimension

Connection typeconnection_typeThe network connection of the viewer.Dimension

Mobile app IDmobile_app_idThe app being promoted.Dimension

TikTok app IDtt_app_idTikTok app identifier for the ad.Dimension

TikTok app namett_app_nameTikTok app name for the ad.Dimension

Audience & time

11 fields

FieldDescriptionType

AgeageThe age bracket of the audience.Dimension

GendergenderThe gender of the audience.Dimension

Interest categoryinterest_category_nameThe interest group the audience belongs to.Dimension

LanguagelanguageThe language of the audience.Dimension

Country codecountry_codeThe country the impression was served in.Dimension

Province IDprovince_idThe province or region identifier.Dimension

DMA IDdma_idDesignated market area identifier.Dimension

DatedateThe day the data was recorded.Dimension

WeekweekThe week the data belongs to.Dimension

MonthmonthThe month the data belongs to.Dimension

YearyearThe year the data belongs to.Dimension

Missing a field you need?

Tell us which metric or dimension you're after and we'll look at adding it to the connector.

Request a field

Ready to pull these into your report?

Connect TikTok Ads free and send every field above to Data Studio, Claude, ChatGPT or Gemini.

+Connect for free