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

Tip: For more information about any field in Singular reporting, see the Metrics and Dimensions Glossary.

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

Network Clicks

adn_clicks click_cnt
Network Impressions adn_impressions show_cnt
Network Installs adn_installs convert_cnt
Original Cost adn_original_cost stat_cost
Original Currency adn_original_currency currency
Video Views video_views total_play
Video Views - 25% video_views_25pct play_first_quartile
Video Views - 50% video_views_50pct play_midpoint
Video Views - 75% video_views_75pct play_third_quartile
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?