Release Notes

August 2026

v2.7.3

Feature Updates

Adds DuckDB as a supported destination.

July 2026

v2.7.1

Feature Update

Adds support for configuring individual package-level variables and models in Quickstart.

v2.7.2

Under the Hood

Removes Quickstart UI redundancies by surfacing only connector-level models that are not implicitly run by Ad Reporting:

June 2026

v2.6.1

Bug Fixes

Updates macro argument type annotations in macros_docs.yml to support dbt's validate_macro_args flag.

v2.7.0

Schema/Data Changes (--full-refresh required after upgrading)

1 total change • 1 possible breaking change

Data Model(s)	Change type	Old	New	Notes
All models	`source_relation` column (when not using the union connections of the same type feature)	Empty string (`''`)	`<database>.<schema>`

Feature Updates

Introduces the new (recommended) {connector_name}_sources variables for more robust union data configuration. The old {connector_name}_union_schemas and {connector_name}_union_databases variables will still be supported. See the README for specific details.

Upstream Dependency Changes

Increases the required Amazon Ads package to version 1.3.0
Increases the required Apple Search Ads package to version 1.3.0
Increases the required Facebook Ads package to version 1.5.0
Increases the required Google Ads package to version 1.4.0
Increases the required LinkedIn Ads package to version 1.3.0
Increases the required Microsoft Ads package to version 1.3.0
Increases the required Pinterest Ads package to version 1.3.0
Increases the required Reddit Ads package to version 1.5.0
Increases the required Snapchat Ads package to version 1.3.0
Increases the required TikTok Ads package to version 1.3.0
Increases the required Twitter Ads package to version 1.3.0

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

v2.6.0

Under the Hood

For TikTok Ads, the country column in ad_reporting__monthly_campaign_country_report now sources directly from country_name in the upstream package when tiktok_ads__using_location is true, rather than relying on the country code mapping table. No change in output expected.

April 2026

v2.5.0

Upstream Breaking Change

Increases the required google_ads package to version 1.3.0
- This version includes configurable threshold variables for customizable diagnostic report optimization logic.

Schema/Data Change - Google Ads

8 total changes • 2 possible breaking changes

Data Model(s)	Change type	New	Notes
`google_ads__campaign_report`	New Column	`ctr`	Click-through rate for ad relevance analysis Possible breaking change: New column may affect downstream use
`google_ads__campaign_report`	New Column	`serving_status`	Current serving status of the campaign Possible breaking change: New column may affect downstream use
`google_ads__campaign_bid_modifiers_report`	New Model		Analyzes bid modifier effectiveness at campaign-criterion level with performance-based recommendations
`google_ads__campaign_budget_diagnostics_report`	New Model		Diagnoses daily campaign budget utilization and performance constraints with prioritized optimization recommendations
`stg_google_ads__campaign_bid_modifier_history` `stg_google_ads__campaign_bid_modifier_history_tmp`	New Staging Models		Historical bid modifier configurations and adjustments at campaign-criterion level
`stg_google_ads__campaign_bidding_strategy_history` `stg_google_ads__campaign_bidding_strategy_history_tmp`	New Staging Models		Historical bidding strategy configurations including target CPA and ROAS settings
`stg_google_ads__campaign_budget_history` `stg_google_ads__campaign_budget_history_tmp`	New Staging Models		Historical campaign budget configurations including daily and lifetime budget settings
`stg_google_ads__campaign_criterion_history` `stg_google_ads__campaign_criterion_history_tmp`	New Staging Models		Historical campaign-level targeting criteria including location, device, and audience settings

January 2026

v2.3.0

Upstream Breaking Changes

Increases the required facebook_ads package to version 1.3.0
Increases the required reddit_ads package to version 1.3.0.

v2.4.0

Documentation

Updates README with standardized Fivetran formatting

Upstream Dependency Changes

Increases the required Amazon Ads package to version 1.2.0
Increases the required Apple Search Ads package to version 1.2.0
Increases the required Facebook Ads package to version 1.4.0
Increases the required Google Ads package to version 1.2.0
Increases the required LinkedIn Ads package to version 1.2.0
Increases the required Microsoft Ads package to version 1.2.0
Increases the required Pinterest Ads package to version 1.2.0
Increases the required Reddit Ads package to version 1.4.0
Increases the required Snapchat Ads package to version 1.2.0
Increases the required TikTok Ads package to version 1.2.0
Increases the required Twitter Ads package to version 1.2.0

August 2025

v2.1.0

Schema Updates - Facebook Ads

4 total changes • 0 possible breaking changes

Data Model	Change type	New name	Notes
stg_facebook_ads__basic_ad_action_values	New Columns	`index`, `_fivetran_id`	Adding composite fields for primary keys for `basic_ad_action_values` source table.
stg_facebook_ads__basic_ad_actions	New Columns	`index`, `_fivetran_id`	Adding composite fields for primary keys for `basic_ad_actions` source table.
stg_facebook_ads__demographics_country_actions	New Column	`index`	Adding composite field for primary key for `demographics_country_actions` source table.
stg_facebook_ads__demographics_region_actions	New Column	`index`	Adding composite field for primary key for `demographics_region_actions` source table.