TikTok Marketing
Use the TikTok Marketing connector to sync campaigns, ads, creatives, and delivery metrics into your Athena lakehouse. Blotout runs the Airbyte TikTok Marketing connector inside your deployment.
For connector reference (streams, rate limits, changelog), see the Airbyte TikTok Marketing docs.
Prerequisites
Section titled “Prerequisites”- A tag with Blotout Cloud set up (green checkmark in the Tags table)
- A TikTok For Business account with access to the advertiser accounts you want to sync
- A TikTok developer application for Production (OAuth 2.0)
Production (OAuth 2.0) credentials
Section titled “Production (OAuth 2.0) credentials”Create a TikTok For Business developer app and collect:
| Credential | Purpose |
|---|---|
| App ID | Developer application ID |
| Secret | Developer application secret |
| Access Token | OAuth access token for the TikTok Marketing API |
Optional: Advertiser ID — scope the sync to a specific advertiser. Sandbox setups typically require Access Token + Advertiser ID; Production OAuth uses App ID, Secret, and Access Token.
See TikTok’s guides for creating a Business account, creating a developer application, and (if needed) a Sandbox Ad Account.
Create the pipeline
Section titled “Create the pipeline”Follow the shared Create a pipeline steps until the source catalogue appears, then select TikTok Marketing.
Source configuration
Section titled “Source configuration”On the Source step, configure the connector:
| Field | Purpose |
|---|---|
| Schedule Type | How the pipeline runs — typically Scheduled |
| Sync Frequency | How often Airbyte syncs (for example, Every 24 hours) |
| Source Name | Name for this pipeline — used in the Athena schema <SOURCE_NAME>_<ENV> |
Authentication (OAuth 2.0)
Section titled “Authentication (OAuth 2.0)”Blotout Cloud uses OAuth2.0 for TikTok Marketing Production:
- Under TikTok Marketing Configuration, set Authentication Method to OAuth2.0.
- Enter App ID, Secret, and Access Token from your TikTok developer application.
- Optionally enter Advertiser ID to limit the sync to a specific advertiser account.
Optional fields (start date, end date, attribution window, daily reports date step, include deleted data) can be expanded under Optional if your UI exposes them. Attribution window defaults to about 3 days — TikTok Reporting API metrics can lag by roughly 11 hours.
Complete Schema and Summary
Section titled “Complete Schema and Summary”Continue through the Schema and Summary steps to choose streams and confirm the connection. Save and run the first sync.
After a successful sync, Airflow creates an organization-scoped DAG for the pipeline, and dbt models feed the TikTok Dashboard.
Related documentation
Section titled “Related documentation”- Data Pipelines overview — Tags-first create flow
- TikTok Dashboard — analytics built on this pipeline
- Airbyte TikTok Marketing — streams and connector reference