Linking TikTok Ads as a source
Contents
You can sync data from TikTok Ads reports by configuring it as a source in PostHog. The supported reports that can be synced include Ad Groups, Campaigns, Ads, Ad Group Report, Campaign Report, and Ad Report, as described here:
- Ad Groups
- Campaigns
- Ads
- Ad Groups Report: Filter by
adgroup_ids - Campaign Report: Filter by
campaign_ids - Ad Report: Filter by
ad_ids
Additional reports will be added based on user feedback we receive via our in-app support form.
Requirements
- A TikTok Ads account with permission to access data from accounts you want to sync.
Configuring PostHog
Connect PostHog to your TikTok Ads account. The TikTok account must have permission to access data.
- In PostHog, go to the Data pipelines tab.
- Open the + New drop-down menu in the top-right and select Source.
- Find TikTok Ads in the sources list and click Link.
- Select an existing TikTok Ads integration, or create a new one by clicking Connect.
- Select the advertiser account you want to sync from the dropdown.
- (Optional) Add a prefix for the table name.
Configuration
| Option | Type | Required |
|---|---|---|
TikTok Ads account | oauth | Yes |
TikTok Ads Advertiser ID | oauth-account-select | Yes |
Supported tables
| Table | Description | Sync method | Incremental field | Primary key |
|---|---|---|---|---|
campaigns | An advertising campaign in your TikTok Ads account, with its objective and budget. | Full refresh | — | — |
ad_groups | An ad group within a campaign, defining targeting, placement, and bidding. | Full refresh | — | — |
ads | An individual ad creative within an ad group. | Full refresh | — | — |
campaign_report | Daily performance metrics for each campaign. | Incremental, Full refresh | stat_time_day | — |
ad_group_report | Daily performance metrics for each ad group. | Incremental, Full refresh | stat_time_day | — |
ad_report | Daily performance metrics for each ad. | Incremental, Full refresh | stat_time_day | — |
Troubleshooting
Finding your account ID manually
If the advertiser account dropdown in step 5 doesn't load, you can find your account ID manually in TikTok Ads Manager:
- Go to the TikTok Ads Manager dashboard.
- Click your account name in the top right and open the dropdown.
- Find your ad account ID, or check the dashboard URL, e.g.
https://ads.tiktok.com/i18n/dashboard?aadvid=ID_HERE
