Quickstart · Source connector
TikTok Ads ELT Connector
Extract brings TikTok Ads quickstart data into data warehouses and databases for analysis with the rest of your business data. Teams use it to build recurring reporting and compare business activity across systems. Flexible scheduling keeps reporting current for routine analysis and time-sensitive decisions.
View setup guide
Use cases
What teams use this connector for
Business performance reporting
Use TikTok Ads data to monitor recurring activity and investigate meaningful changes over time.
Cross-system analysis
Combine TikTok Ads data with customer, finance, and operational metrics for consistent reporting.
Data quality monitoring
Compare TikTok Ads record totals and reporting periods to identify incomplete or unexpected data.
Flexible reporting cadence
Refresh TikTok Ads reporting every 15 minutes, hourly, daily, or on a custom schedule as business needs change.
Warehouse and database analysis
Use Extract to make TikTok Ads quickstart data available in data warehouses and databases such as Snowflake, BigQuery, Redshift, and PostgreSQL for governed analysis.
Connector data
Available streams
| Stream | Description | Sync mode |
|---|---|---|
ad | Fields include advertiser_id, ad_id, adgroup_id, campaign_id. | Incremental |
ad_daily_age_gender | Fields include ad_id, age, gender, stat_time_day. | Incremental |
ad_daily_country | Fields include ad_id, country_code, stat_time_day, _singular_extract_timestamp. | Incremental |
ad_daily_dma | Fields include ad_id, dma_id, stat_time_day, _singular_extract_timestamp. | Incremental |
ad_daily_language | Fields include ad_id, language, stat_time_day, _singular_extract_timestamp. | Incremental |
ad_daily_placement | Fields include ad_id, placement, stat_time_day, _singular_extract_timestamp. | Incremental |
ad_daily_platform | Fields include ad_id, platform, stat_time_day, _singular_extract_timestamp. | Incremental |
ad_group | Fields include advertiser_id, campaign_id, adgroup_id, _singular_extract_timestamp. | Incremental |
adgroup_daily_age_gender | Fields include adgroup_id, age, gender, stat_time_day. | Incremental |
adgroup_daily_country | Fields include adgroup_id, country_code, stat_time_day, _singular_extract_timestamp. | Incremental |
adgroup_daily_dma | Fields include adgroup_id, dma_id, stat_time_day, _singular_extract_timestamp. | Incremental |
adgroup_daily_language | Fields include adgroup_id, language, stat_time_day, _singular_extract_timestamp. | Incremental |
adgroup_daily_placement | Fields include adgroup_id, placement, stat_time_day, _singular_extract_timestamp. | Incremental |
adgroup_daily_platform | Fields include adgroup_id, platform, stat_time_day, _singular_extract_timestamp. | Incremental |
advertisers | Fields include advertiser_id, _singular_extract_timestamp, address, advertiser_account_type. | Full refresh |
auction_ad_basic_daily | Fields include ad_id, _singular_extract_timestamp, ad_type, average_video_play. | Incremental |
auction_adgroup_basic_daily | Fields include adgroup_id, stat_time_day, _singular_extract_timestamp, achieve_level. | Incremental |
auction_campaign_basic_daily | Fields include campaign_id, stat_time_day, _singular_extract_timestamp, achieve_level. | Incremental |
auction_skan_ad_basic_daily | Fields include ad_id, _singular_extract_timestamp, app_install, average_video_play. | Incremental |
business_center_invoices | Fields include bc_id, invoice_id, _singular_extract_timestamp, account_id. | Full refresh |
campaign | Fields include advertiser_id, campaign_id, _singular_extract_timestamp, app_id. | Incremental |
campaign_daily_age_gender | Fields include campaign_id, age, gender, stat_time_day. | Incremental |
campaign_daily_country | Fields include campaign_id, country_code, stat_time_day, _singular_extract_timestamp. | Incremental |
campaign_daily_dma | Fields include campaign_id, dma_id, stat_time_day, _singular_extract_timestamp. | Incremental |
campaign_daily_language | Fields include campaign_id, language, stat_time_day, _singular_extract_timestamp. | Incremental |
campaign_daily_placement | Fields include campaign_id, placement, stat_time_day, _singular_extract_timestamp. | Incremental |
campaign_daily_platform | Fields include campaign_id, platform, stat_time_day, _singular_extract_timestamp. | Incremental |
creative_basic_images_daily | Fields include _singular_extract_timestamp, adgroup_number, app_install, clicks. | Incremental |
creative_basic_images_lifetime | Fields include _singular_extract_timestamp, adgroup_number, app_install, clicks. | Full refresh |
creative_basic_videos_daily | Fields include _singular_extract_timestamp, adgroup_number, app_install, average_video_play. | Incremental |
creative_basic_videos_lifetime | Fields include _singular_extract_timestamp, adgroup_number, app_install, average_video_play. | Full refresh |
image | Fields include advertiser_id, image_id, _singular_extract_timestamp, create_time. | Incremental |
pixel | Fields include advertiser_id, pixel_id, _singular_extract_timestamp, advanced_matching_fields.email. | Full refresh |
pixel_event | Fields include advertiser_id, pixel_id, _singular_extract_timestamp, currency. | Full refresh |
pixel_event_rule | Fields include advertiser_id, event_id, pixel_id, _singular_extract_timestamp. | Full refresh |
pixel_statistics | Fields include advertiser_id, pixel_id, _singular_extract_timestamp, attributed_count. | Incremental |
video | Fields include advertiser_id, video_id, _singular_extract_timestamp, allow_download. | Incremental |
video_insights_daily | Fields include _singular_extract_timestamp, clicks, conversion, conversion_rate_v2. | Incremental |
Schema
Data model at a glance
ad
advertiser_idstringad_idstringadgroup_idstringcampaign_idstring_singular_extract_timestampstringad_formatstringad_namestringad_textstring
ad_daily_age_gender
ad_idstringagestringgenderstringstat_time_daystring_singular_extract_timestampstringaverage_video_playnumberaverage_video_play_per_usernumberclicksinteger
ad_daily_country
ad_idstringcountry_codestringstat_time_daystring_singular_extract_timestampstringaverage_video_playnumberaverage_video_play_per_usernumberclicksintegerclicks_on_music_discinteger
ad_daily_dma
ad_idstringdma_idstringstat_time_daystring_singular_extract_timestampstringaverage_video_playnumberaverage_video_play_per_usernumberclicksintegerclicks_on_music_discinteger
ad_daily_language
ad_idstringlanguagestringstat_time_daystring_singular_extract_timestampstringaverage_video_playnumberaverage_video_play_per_usernumberclicksintegerclicks_on_music_discinteger
ad_daily_placement
ad_idstringplacementstringstat_time_daystring_singular_extract_timestampstringaverage_video_playnumberaverage_video_play_per_usernumberclicksintegerclicks_on_music_discinteger
No verified relationships are available in this schema preview.
Connector pairings
Popular destinations
Commonly paired with TikTok Ads in Extract workflows.
Why Extract
Why Extract for TikTok Ads
- Rust-native performanceUse Rust-native data movement to refresh TikTok Ads reporting every 15 minutes, hourly, daily, or on a custom schedule as volume grows.
- Full run transparencyInspect TikTok Ads API activity, execution steps, and timing in Extract's run-level logs when data needs review.
- ELT + Reverse ETL in oneCombine TikTok Ads data with customer and finance models, then send approved outputs through a separately configured Reverse ETL destination.
FAQ
Frequently asked questions
How does Extract handle incremental and full TikTok Ads syncs?
An incremental sync processes only new or changed data since a stored checkpoint or new date partition, while a full sync processes the complete selected dataset or date range again. By avoiding repeated processing and writes for the full dataset, incremental syncs can reduce destination database updates and warehouse compute costs. Stream schemas define full refresh, incremental changes, partition-based extraction. Behavior varies by stream and configuration. Extract records run details so teams can verify each sync.
Can I backfill historical TikTok Ads data with Extract?
Historical coverage for TikTok Ads: Backfill (Days) (backfill): The backfill setting revisits and updates data from the past X days, ensuring the most current and accurate information replaces any previously pulled data. Use the setup guide and run details to confirm the available source records and selected settings.
How can teams monitor TikTok Ads data quality and freshness?
Compare expected reporting periods and record totals in your models, then use Extract's run-level logs to inspect TikTok Ads API activity, execution steps, and timing. This helps teams distinguish a source-data delay from a failed or incomplete run.
How often can Extract sync data from TikTok Ads?
Extract supports schedules every 15 minutes, hourly, daily, or on a custom cadence. Teams can choose a frequency that matches routine reporting, time-sensitive monitoring, or operational activation needs.
What does the TikTok Ads data model look like in the destination?
The Available streams table describes the datasets Extract can read from TikTok Ads. The inline schema previews entities and fields. Only relationships verified from the exported schema are shown. Use the full schema link for more details.