TikTok For Business Data Connector

Learn about the data connector that pulls data from TikTok For Business into Singular: what data it pulls and how to set it up.

Quick Details

Data Connector Technology API
How far back we pull data 7 days
Time zone UTC by default
Is data available on the creative (ad) level? Yes
Does Singular show your creative assets? Yes

Data Mapping

  Field in Singular UI Field in Singular API Field in TikTok API
Campaign Dimensions Account ID adn_account_id (Taken from [advertiser/info])
Campaign Dimensions Account Name adn_account_name advertiser_name
Campaign Dimensions App app app_name
Campaign Dimensions App Site ID app_site_id (Taken from the [app_download_url])
Campaign Dimensions Country country_field location
Campaign Dimensions Date date_field stat_datetime
Campaign Dimensions DMA ID dma_id_field location
Campaign Dimensions DMA Name dma_name_field location
Campaign Dimensions Network Campaign ID adn_campaign_id campaign_id
Campaign Dimensions Network Campaign Name adn_campaign_name campaign_name
Creative Dimensions Network Creative ID adn_creative_id ad_id
Creative Dimensions Network Creative Name adn_creative_name ad_name
Campaign Dimensions Network Sub Campaign ID adn_sub_campaign_id adgroup_id
Campaign Dimensions Network Sub Campaign Name adn_sub_campaign_name adgroup_name
Campaign Dimensions Platform platform (Taken from the [app_download_url])
Campaign Dimensions Timezone adn_timezone timezone
Creative Dimensions Text creative_text ad_text
Campaign Dimensions Campaign URL adn_campaign_url landing_page_url
Campaign Properties Bid Type bid_type bid_type
Campaign Properties Campaign Objective campaign_objective objective_type
Campaign Properties Campaign Status campaign_status opt_status
Campaign Properties Original Bid Amount original_bid_amount bid
Campaign Properties Original Bid Currency original_metadata_currency currency
Campaign Properties Standardized Bid Type standardized_bid_strategy optimize_goal
Metrics

Network Clicks

adn_clicks click_cnt
Metrics Network Impressions adn_impressions show_cnt
Metrics Network Installs adn_installs convert_cnt
Metrics Original Cost adn_original_cost stat_cost
Metrics Original Currency adn_original_currency currency
Metrics Video Views video_views total_play
Metrics Video Views - 25% video_views_25pct play_first_quartile
Metrics Video Views - 50% video_views_50pct play_midpoint
Metrics Video Views - 75% video_views_75pct play_third_quartile
Metrics Completed Video Views completed_video_views play_over

Setup Instructions

To set up the TikTok for Business data connector:

  1. In your Singular account, go to Settings > Data Connectors.

    screenshot--2019.08.11-12-54-10.png

  2. Click Add New Connector and start typing "TikTok". Select "TikTok Ads" from the list that appears.

    Screen_Shot_2021-03-02_at_17.09.53.png

  3. In the configuration window that opens, click Sign In with TikTok and log into your TikTok For Business account.

    Screen_Shot_2021-03-02_at_17.11.10.png

  4. The TikTok platform asks if you want to grant Singular permissions to access TikTok data. Check the Agree to the Platform Service Agreement checkbox and click Confirm.

    Screen_Shot_2021-03-02_at_17.20.30.png

  5. After you grant the permissions, the configuration window in Singular indicates that you are connected. You can close the window.
  6. TikTok now appears in the list of data connectors. The data connector status is "Pending" while Singular performs the first data pull. Once the first data pull is completed, the status will change to "Active".

    Screen_Shot_2021-03-02_at_17.31.58.png

  7. After the data connector has successfully pulled data into Singular, you can start running reports that include TikTok data. For more information see the Reports FAQ, Singular API Reference, or Singular Data Destinations FAQ.

    Sample report:

    Screen_Shot_2021-03-02_at_17.49.17.png

Was this article helpful?