TikTok Ads
TikTok is a video-sharing social networking platform. TikTok Ads gives you information about the performance of your ads.
Features
| Feature Name | Supported | Notes |
|---|---|---|
| Capture deletes | ||
| History mode | ||
| Custom data | ||
| Data blocking | check | |
| Column hashing | check | |
| Re-sync | check | |
| API configurable | check | API configuration |
| Priority-first sync | check | |
| Fivetran data models | check | |
| Private networking | ||
| Authorization via API | check |
Supported deployment models
We support the SaaS and Hybrid deployment models for the connector.
You must have an Enterprise or Business Critical plan to use the Hybrid Deployment model.
Source API version
This connector uses TikTok Ads API v1.3.
Setup guide
Follow our step-by-step TikTok Ads setup guide to connect TikTok Ads with your destination using Fivetran connectors.
Sync overview
Rollback sync
A rollback sync is a sync that automatically starts once a day. Rollback syncs capture the conversions within the attribution window.
Fivetran does not automatically capture the rollback window size. You can opt to configure the rollback window in the connection setup form. To do so, set the Show advanced options toggle to ON, and set the attribution window using the Rollback sync (optional) drop-down. The default setting is 7 days.
Schema information
This schema applies to all TikTok Ads connections.
Report schema information
We provide two types of reports:
- Prebuilt reports, which sync a pre-defined set of metrics. For prebuilt reports, we have predefined tables in the Schema tab that you can enable or disable.
- Custom reports, which require you to select the Report Level, Dimensions, Aggregate, and Metrics you want to sync in the connection setup form.
Sync notes
The data type of the following columns in the destination tables is LONG:
ad_idadgroup_idadvertiser_idapp_idcampaign_idevent_idpangle_block_app_list_idpixel_id
The data type of the skip_learning_phase column of the ADGROUP_HISTORY table is INT.
Due to source API limitation, we can fetch only the first 10000 videos per advertiser ordered by updated_at (also referred to as modify_time in the source documentation) for the VIDEO_HISTORY table in every sync. For more information, see TikTok Ads' API document.