Tiktok Ads dbt Package
This dbt package transforms data from Fivetran's Tiktok Ads connector into analytics-ready tables.
Resources
- Number of materialized models¹: 22
- Connector documentation
- dbt package documentation
What does this dbt package do?
This package enables you to produce modeled tables, create reports on daily marketing performance, and generate comprehensive data dictionaries. It creates enriched models with metrics focused on spend, clicks, impressions, and conversions across various levels of granularity.
Output schema
Final output tables are generated in the following target schema:
<your_database>.<connector/schema_name>_tiktok_ads
Final output tables
By default, this package materializes the following final tables:
| Table | Description |
|---|---|
| tiktok_ads__ad_group_report | Represents daily performance aggregated at the ad group level, including spend, clicks, impressions, and conversions, enriched with demographic targeting data.Example Analytics Questions:
|
| tiktok_ads__campaign_report | Represents daily performance aggregated at the campaign level, including spend, clicks, impressions, and conversions.Example Analytics Questions:
|
| tiktok_ads__campaign_country_report | Represents daily performance aggregated at the campaign level by country, including spend, clicks, impressions, and conversions, enriched with geographic context.Example Analytics Questions:
|
| tiktok_ads__advertiser_report | Represents daily performance aggregated at the advertiser level (equivalent to account level), including spend, clicks, impressions, and conversions.Example Analytics Questions:
|
| tiktok_ads__ad_report | Represents daily performance at the individual ad level, including spend, clicks, impressions, and conversions, enriched with demographic targeting data.Example Analytics Questions:
|
| tiktok_ads__url_report | Represents daily performance of URLs at the ad level, including spend, clicks, impressions, and conversions, enriched with ad context and demographic targeting data.Example Analytics Questions:
|
¹ Each Quickstart transformation job run materializes these models if all components of this data model are enabled. This count includes all staging, intermediate, and final models materialized as view, table, or incremental.
Visualizations
Many of the above reports are now configurable for visualization via Streamlit. Check out some sample reports here.
Prerequisites
To use this dbt package, you must have the following:
- At least one Fivetran Tiktok Ads connection syncing data into your destination.
- A BigQuery, Snowflake, Redshift, PostgreSQL, or Databricks destination.
How do I use the dbt package?
You can either add this dbt package in the Fivetran dashboard or import it into your dbt project:
- To add the package in the Fivetran dashboard, follow our Quickstart guide.
- To add the package to your dbt project, follow the setup instructions in the dbt package's README file to use this package.
How is this package maintained and can I contribute?
Package Maintenance
The Fivetran team maintaining this package only maintains the latest version of the package. We highly recommend you stay consistent with the latest version of the package and refer to the CHANGELOG and release notes for more information on changes across versions.
Contributions
A small team of analytics engineers at Fivetran develops these dbt packages. However, the packages are made better by community contributions.
We highly encourage and welcome contributions to this package. Learn how to contribute to a package in dbt's Contributing to an external dbt package article.
Contributors
We thank everyone who has taken the time to contribute. Each PR, bug report, and feature request has made this package better and is truly appreciated.
A special thank you to Seer Interactive, who we closely collaborated with to introduce native conversion support to our Ad packages.