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:
-
In your Singular account, go to Settings > Data Connectors.
-
Click Add New Connector and start typing "TikTok". Select "TikTok Ads" from the list that appears.
-
In the configuration window that opens, click Sign In with TikTok and log into your TikTok For Business account.
-
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.
- After you grant the permissions, the configuration window in Singular indicates that you are connected. You can close the window.
-
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".
-
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:
