Release Notes

August 2026

In v1.4.2, we removed the image_ids field from src_tiktok_ads.yml. It's not used downstream, and TikTok will stop populating it starting August 2026.

We've updated the following quickstart data model packages to add DuckDB as a supported destination:

Expand to see full list

Ad Reporting to version v2.7.3
Amazon Ads to version v1.3.1
Amazon Selling Partner to version v0.5.1
Amplitude to version v1.4.1
App Reporting to version v1.3.2
Apple App Store to version v1.3.2
Apple Search Ads to version v1.3.1
Asana to version v1.4.1
AWS Cloud Cost to version v0.4.1
Facebook Ads to version v1.5.1
Facebook Pages to version v1.3.1
Fivetran Platform Connector to version v2.5.3
GitHub to version v1.4.1
Google Ads to version v1.4.1
Google Analytics 4 Export to version v0.7.2
Google Play to version v1.3.1
Greenhouse to version v1.4.1
HubSpot to version v1.9.2
Instagram Business to version v1.2.1
Intercom to version v1.7.1
Iterable to version v1.5.1
Jira to version v1.10.2
Klaviyo to version v1.4.1
Lever to version v1.3.1
LinkedIn Ad Analytics to version v1.3.1
LinkedIn Company Pages to version v1.5.1
Mailchimp to version v1.3.2
Marketo to version v1.4.1
Microsoft Advertising to version v1.3.1
Microsoft Dynamics 365 CRM to version v0.4.1
Mixpanel to version v0.17.1
NetSuite SuiteAnalytics to version v1.7.1
Pardot to version v1.4.1
Pendo to version v1.4.1
Pinterest Ads to version v1.3.1
Qualtrics to version v1.3.1
QuickBooks to version v1.9.1
Recharge to version v1.5.2
Recurly to version v1.5.1
Reddit Ads to version v1.5.1
Sage Intacct to version v1.4.1
Salesforce to version v2.4.1
Salesforce Marketing Cloud to version v0.6.1
SAP to version v0.8.1
ServiceNow to version v1.0.2
Shopify to version v1.9.2
Shopify Holistic to version v1.3.1
Snapchat Ads to version v1.3.1
Social Media Reporting to version v1.6.2
StackAdapt to version v0.2.1
Stripe to version v1.10.1
TikTok Ads to version v1.4.1
Twilio to version v1.4.1
Unified RAG to version v0.3.1
Workday HCM to version v1.0.3
X Ads to version v1.3.1
X Organic to version v1.2.1
Xero to version v1.6.1
YouTube Analytics to version v1.2.1
Zendesk Support to version v1.7.1
Zuora to version v1.4.1

June 2026

v1.4.0

Schema/Data Changes

1 total change • 0 possible breaking changes

Data Model	Change Type	Old	New	Notes
All models	`source_relation` column (when using a single TikTok Ads schema)	Empty string (`''`)	`<database>.<schema>`

Feature Updates

Introduces the new (recommended) tiktok_ads_sources variable for more robust union data configuration. The old tiktok_ads_union_schemas and tiktok_ads_union_databases variables will still be supported. See the README for specific details.

Under the Hood

Adds the fivetran_using_source_casing variable for case-sensitive destination support. When enabled, downstream transformations respect source casing to ensure consistent results. See the Additional Configurations section of the README for details.
Introduces fivetran_utils.partition_by_source_relation to conditionally include source_relation in partition clauses only when multiple sources are configured.

May 2026

v1.3.0

Schema/Data Changes

3 total changes • 0 possible breaking changes

Data Model	Change Type	New
tiktok_ads__campaign_country_report	New Columns	`country_name`, `location_id`, `parent_location_id`, `has_support_below_18`
stg_tiktok_ads__location_tmp	New Tmp Model
stg_tiktok_ads__location	New Staging Model

Feature Updates

For dbt Core users:

Adds the tiktok_ads__using_location variable (true by default). If you do not sync or want to use the location table, set this variable to false in your dbt_project.yml. See the README for more details.

Bug Fix

Fixes potential data type failures for Databricks users not syncing the campaign_country_report.stat_time_day field.

January 2026

v1.2.0

Documentation

Updates README with standardized Fivetran formatting.
Removes duplicative column yml definitions.

Under the Hood

In the quickstart.yml file:
- Adds supported_vars for Quickstart UI customization.

v1.1.0

Features

Increases the required dbt version upper limit to v3.0.0

August 2025

v1.0.0

Breaking Changes

Source Package Consolidation

Removed the dependency on the fivetran/tiktok_ads_source package.
- All functionality from the source package has been merged into this transformation package for improved maintainability and clarity.
- If you reference fivetran/tiktok_ads_source in your packages.yml, you must remove this dependency to avoid conflicts.
- Any source overrides referencing the fivetran/tiktok_ads_source package will also need to be removed or updated to reference this package.
- Update any tiktok_ads_source-scoped variables to be scoped to only under this package. See the README for how to configure the build schema of staging models.
As part of the consolidation, vars are no longer used to reference staging models, and only sources are represented by vars. Staging models are now referenced directly with ref() in downstream models.

dbt Fusion Compatibility Updates

Updated package to maintain compatibility with dbt-core versions both before and after v1.10.6, which introduced a breaking change to multi-argument test syntax (e.g., unique_combination_of_columns).
Temporarily removed unsupported tests to avoid errors and ensure smoother upgrades across different dbt-core versions. These tests will be reintroduced once a safe migration path is available.
- Removed all dbt_utils.unique_combination_of_columns tests.
- Moved loaded_at_field: _fivetran_synced under the config: block in src_tiktok_ads.yml.

Under the Hood

Updated conditions in .github/workflows/auto-release.yml.
Added .github/workflows/generate-docs.yml.