Release Notes
October 2025
We unified each connector’s pre-built dbt Core*–compatible data models into a single model. It standardizes and documents the Fivetran schemas created in your destination and outputs analytics-ready tables. Previously, most connectors used distinct source and transform models.
* dbt Core is a trademark of dbt Labs, Inc. All rights therein are reserved to dbt Labs, Inc. Fivetran Transformations is not a product or service of or endorsed by dbt Labs, Inc.
July 2025
We now support Google Ads API 20.
The following reports have been deprecated:
extension_feed_itemfeed_itemfeed_placeholder_view
June 2025
We've added a new metadata table, CAMPAIGN_CONVERSION_GOAL_HISTORY. We are slowly rolling that report out to all existing connections.
We have added a new Quickstart package for the Microsoft Dynamics 365 CRM connector.
We have updated the Quickstart packages for the following connectors:
- Connectors supporting the Ad Reporting data model to version 1.15.0.
- Connectors supporting the App Reporting data model to version 0.6.0.
- Connectors supporting the Shopify Holistic Reporting data model to version 0.8.0.
- Amazon Ads to version 0.5.0.
- Amplitude to version 0.7.0.
- Apple App Store to version 0.6.0.
- Apple Search Ads to version 0.6.0.
- Asana to version 0.9.0.
- Facebook Ads to version 0.10.0.
- Fivetran Platform to version 2.2.0.
- GitHub to version 0.9.0.
- Google Ads to version 0.14.0.
- Google Play to version 0.5.0.
- Greenhouse to version 0.9.0.
- HubSpot to version 0.24.0.
- Intercom to version 0.10.0.
- Jira to version 0.21.0.
- Klaviyo to version 0.9.0.
- Lever to version 0.8.0.
- LinkedIn Ad Analytics to version 0.12.0.
- Mailchimp to version 0.12.0.
- Microsoft Advertising to version 0.12.0.
- Mixpanel to version 0.13.0.
- NetSuite SuiteAnalytics to version 0.20.0.
- Pendo to version 0.6.0.
- Pinterest Ads to version 0.13.0.
- QuickBooks to version 0.20.0.
- Recurly to version 0.7.0.
- Reddit Ads to version 0.5.0.
- Sage Intacct to version 0.7.0.
- Salesforce to version 1.3.0.
- Snapchat Ads to version 0.10.0.
- Stripe to version 0.19.0.
- TikTok Ads to version 0.9.0.
- Twilio to version 0.5.0.
- Twitter Ads to version 0.10.0.
- Workday HCM to version 0.4.0.
- Zendesk Support to version 0.24.1.
May 2025
We have updated the Quickstart packages for the following connectors:
- Connectors supporting the Ad Reporting data model to version 1.14.0.
- Connectors supporting the Social Media Reporting data model to version 0.7.0.
- Google Ads to version 0.13.0.
- Instagram Business to version 0.3.0.
- Intercom to version 0.9.2.
- Mailchimp to version 0.10.1.
- QuickBooks to version 0.18.1.
- Recharge to version 0.4.0.
- Recurly to version 0.6.0.
- Shopify to version 0.19.0.
- Stripe to version 0.18.0.
- TikTok Ads to version 0.8.1.
- Zendesk Support to version 0.22.0.
- Zuora to version 0.5.0.
April 2025
We now support the following fields for the AD_GROUP_AD custom report:
ad_group_ad.ad.app_pre_registration_ad.descriptions,ad_group_ad.ad.app_pre_registration_ad.headlines,ad_group_ad.ad.app_pre_registration_ad.images,ad_group_ad.ad.app_pre_registration_ad.youtube_videos,
We've added a new prebuilt report, SEARCH_TERM_KEYWORD_STATS. We are slowly rolling that report out to all existing connections.
We have updated the Quickstart packages for the following connectors:
- Facebook Ads to version 0.9.0
- Google Ads to version 0.12.0
- HubSpot to version 0.23.0
- LinkedIn Ad Analytics to version 0.11.0
- Microsoft Advertising to version 0.11.1
- NetSuite SuiteAnalytics to version 0.19.0
- Pinterest to version 0.12.0
- Recharge to version 0.3.1
- Reddit Ads to version 0.4.0
- TikTok Ads to version 0.8.0
- Twitter Ads to version 0.9.0
- Xero to version 0.9.0
- Zuora to version 0.4.0
December 2024
We now support Google Ads v18.
We now support the following resources as custom reports:
We now support the following fields for the CAMPAIGN report:
segments.travel_destination_citysegments.travel_destination_countrysegments.travel_destination_regionmetrics.general_invalid_clicksmetrics.general_invalid_click_ratecampaign.brand_guidelines_enabled
We now support the following fields for the AD_GROUP report:
segments.travel_destination_citysegments.travel_destination_countrysegments.travel_destination_regionad_group.exclude_demographic_expansion
November 2024
The Google Ads connector now supports the Hybrid Deployment model. For more information, see our setup instructions.
We have added two new metadata tables, AD_GROUP_BID_MODIFIER_HISTORY and CAMPAIGN_BID_MODIFIER_HISTORY.
October 2024
We now support the CAMPAIGN_SEARCH_TERM_INSIGHT resource as a custom report.
The Google Ads API limits the sync speed of the CAMPAIGN_SEARCH_TERM_INSIGHT report.
September 2024
We've added the following new prebuilt reports with leads data:
LEAD_FORM_SUBMISSION_DATALOCAL_SERVICES_LEADLOCAL_SERVICES_LEAD_CONVERSATIONS
We are gradually rolling out these reports to all existing connections.
Syncing the LEAD_FORM_SUBMISSION_DATA report requires specific access permissions.
Also, we've added the following new prebuilt reports:
CLICK_STATSLANDING_PAGE_STATSSEARCH_KEYWORD_STATSSEARCH_TERM_STATS
We are gradually rolling out these reports to all existing connections.
August 2024
We now support Google Ads API v17.1.
We've renamed the DISCOVERY_CAROUSEL_AD_HISTORY metadata table to DEMAND_GEN_CAROUSEL_AD_HISTORY.
We've renamed the DISCOVERY_MULTI_ASSET_AD_HISTORY metadata table to DEMAND_GEN_MULTI_ASSET_AD_HISTORY.
We've renamed the segments.sk_ad_network_conversion_value segment to segments.sk_ad_network_fine_conversion_value.
We now support the following new resources as custom reports with new metrics for Performance Max and Search campaigns:
We now support the PER_STORE_VIEW resource as a custom report.
We now support the following new fields for the CAMPAIGN report:
campaign.keyword_match_typecampaign.fixed_cpm.goalcampaign.fixed_cpm.target_frequency_info.target_countcampaign.fixed_cpm.target_frequency_info.time_unitcampaign.target_cpvcampaign.video_brand_safety_suitabilitycampaign.video_campaign_settings.video_ad_inventory_control.allow_in_feedcampaign.video_campaign_settings.video_ad_inventory_control.allow_in_streamcampaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
We now support the ad_group.fixed_cpm_micros and ad_group.target_cpv_micros fields for the AD_GROUP report.
We've added support for the segments.sk_ad_network_redistributed_fine_conversion_value and segments.sk_ad_network_version segments in the CAMPAIGN report.
We've added support for a new segment, segments.ad_format_type, that lets you segment the following reports based on the video ad format type:
AD_GROUPAD_GROUP_ADAD_GROUP_AD_ASSET_VIEWCAMPAIGNCUSTOMER
We've added support for a new metric, metrics.search_impression_share, in the GENDER_VIEW report.
We've added support for a new metric, metrics.phone_calls, to the KEYWORD_VIEW report.
We've added support for demand_gen_carousel_ad and demand_gen_multi_asset_ad fields in the AD_GROUP_AD report.
We've added the following new fields to the SHARED_CRITERION_HISTORY metadata table:
brand_display_namebrand_primary_urlbrand_rejection_reasonbrand_status
July 2024
We've added the option to disable skipping empty account reports. This feature is enabled by default for all connections. Now, you can also manually toggle it On or Off on the connector setup form.
See our Skip Empty Reports documentation for further details.
June 2024
We have added the segments.week and segments.month timeline segments and now provide a finer timeline granularity for custom reports. All new connections created after June 7, 2024 support this functionality.
We've added the option to skip empty account reports to improve connector performance. This feature is enabled by default for all connections created after June 20, 2024. You can also manually toggle it On or Off on the connector setup form. See our Skip Empty Reports documentation for further details.
April 2024
We now support Google Ads API v16.
We now support asset_group and conversion_action as a custom reports.
We have added a new metadata table DEMAND_GEN_PRODUCT_AD_HISTORY and will gradually add it to all existing connections.
We have added the following fields related to Demand Gen product ad to the AD_GROUP_AD report:
ad_group_ad.ad.demand_gen_product_ad.breadcrumb1ad_group_ad.ad.demand_gen_product_ad.breadcrumb2ad_group_ad.ad.demand_gen_product_ad.business_namead_group_ad.ad.demand_gen_product_ad.call_to_actionad_group_ad.ad.demand_gen_product_ad.descriptionad_group_ad.ad.demand_gen_product_ad.headlinead_group_ad.ad.demand_gen_product_ad.logo_image
We have added the following fields to the AD_GROUP_AD report:
ad_group_ad.primary_statusad_group_ad.primary_status_reasons
We have added a new field, campaign.shopping_setting.disable_product_feed, to the CAMPAIGN report.
We have added the following fields to the TRAVEL_ACTIVITY_PERFORMANCE_VIEW report:
segments.activity_citysegments.activity_countrysegments.activity_state
February 2024
We have introduced a 1-hour minimal sync frequency for custom reports to reduce the load on Google Ads API based on the following resources:
EXPANDED_LANDING_PAGE_VIEWGEOGRAPHIC_VIEWLANDING_PAGE_VIEWSEARCH_TERM_VIEW
January 2024
We have updated the Quickstart packages for the following connectors:
- Fivetran Platform Connector to version 1.4.0
- Google Ads to version 0.10.1
* dbt Core is a trademark of dbt Labs, Inc. All rights therein are reserved to dbt Labs, Inc. Fivetran Transformations is not a product or service of or endorsed by dbt Labs, Inc.
We now support Google Ads API 15.
We have added the following reports:
ANDROID_PRIVACY_SHARED_KEY_GOOGLE_AD_GROUPANDROID_PRIVACY_SHARED_KEY_GOOGLE_CAMPAIGNANDROID_PRIVACY_SHARED_KEY_GOOGLE_NETWORK_TYPEASSET_GROUP_TOP_COMBINATION_VIEW
We have added a new field, ad_group_ad_asset_view.source, to the AD_GROUP_AD_ASSET_VIEW report.
We have added the following metrics and segments fields related to SKAdNetwork to the CUSTOMER and CAMPAIGN reports:
metrics.sk_ad_network_installsmetrics.sk_ad_network_total_conversionssegments.sk_ad_network_coarse_conversion_valuesegments.sk_ad_network_postback_sequence_indexsegments.sk_ad_network_source_domainsegments.sk_ad_network_source_type
We have added the following metrics fields to the TRAVEL_ACTIVITY_GROUP_VIEW and TRAVEL_ACTIVITY_PERFORMANCE_VIEW reports:
metrics.search_absolute_top_impression_sharemetrics.search_budget_lost_absolute_top_impression_sharemetrics.search_budget_lost_impression_sharemetrics.search_budget_lost_top_impression_sharemetrics.search_impression_sharemetrics.search_rank_lost_absolute_top_impression_sharemetrics.search_rank_lost_impression_sharemetrics.search_rank_lost_top_impression_sharemetrics.search_top_impression_share
We have added the following fields to the TRAVEL_ACTIVITY_PERFORMANCE_VIEW report:
segments.activity_account_idsegments.activity_ratingsegments.external_activity_id
We have added the metrics.average_impression_frequency_per_user and metrics.unique_users fields to the CAMPAIGN report and segments.device for Display, Video, Discovery, and App campaigns.
We have added multiple fields for the following reports:
AD_GROUPAD_GROUP_ADASSET_GROUP_PRODUCT_GROUP_VIEWCAMPAIGNCUSTOMERKEYWORD_VIEWPRODUCT_GROUP_VIEWSHOPPING_PERFORMANCE_VIEW
Expand for the full list of new metrics fields
metrics.average_cart_sizemetrics.average_order_value_microsmetrics.cost_of_goods_sold_microsmetrics.cross_sell_cost_of_goods_sold_microsmetrics.cross_sell_gross_profit_microsmetrics.cross_sell_revenue_microsmetrics.cross_sell_units_soldmetrics.gross_profit_microsmetrics.gross_profit_marginmetrics.lead_cost_of_goods_sold_microsmetrics.lead_gross_profit_microsmetrics.lead_revenue_microsmetrics.lead_units_soldmetrics.ordersmetrics.revenue_microsmetrics.units_sold
We have renamed the following columns in the AD_LISTING_GROUP_CRITERION_HISTORY metadata table:
product_bidding_category_country_codetoproduct_category_country_codeproduct_bidding_category_idtoproduct_category_idproduct_bidding_category_leveltoproduct_category_level
We have renamed the following columns in the CAMPAIGN_CRITERION_LISTING_SCOPE_DIMENSION_HISTORY metadata table:
product_bidding_category_country_codetoproduct_category_country_codeproduct_bidding_category_idtoproduct_category_idproduct_bidding_category_leveltoproduct_category_level
We have renamed the metrics.sk_ad_network_conversions metric to metrics.sk_ad_network_installs .
We have made the following changes to the CUSTOMER report:
- added the
customer.local_services_settings.granular_insurance_statusesfield - added the
customer.local_services_settings.granular_license_statusesfield - removed the
customer.offline_conversion_client_summariesfield
We have made the following changes to the SHOPPING_PERFORMANCE_VIEW report:
- replaced
segments.product_bidding_category_level1withsegments.product_category_level1 - replaced
segments.product_bidding_category_level2withsegments.product_category_level2 - replaced
segments.product_bidding_category_level3withsegments.product_category_level3 - replaced
segments.product_bidding_category_level4withsegments.product_category_level4 - replaced
segments.product_bidding_category_level5withsegments.product_category_level5
We have made the following changes to the CAMPAIGN_SHOPPING_SETTING_HISTORY metadata table:
- added the
feed_labelfield - removed the
sales_countryfield
October 2023
We have added the ability to update the Historical Sync Time Frame value even after a Google connector has been set up.
The following connectors now support this feature:
- Google Ads
- Google Ads Manager
- Google Analytics 4
- Google Campaign Manager 360
- Google Display Video 360
- Google Search Ads 360
- Google Search Console.
Updating the timeframe option to a larger value will trigger a connector re-sync.
September 2023
We have upgraded our Google Ads connector from version 14 to 14.1 of the Google Ads API and added the following metrics and segments to custom reports:
metrics.new_customer_lifetime_valuemetrics.all_new_customer_lifetime_valuesegments.new_versus_returning_customers
August 2023
We have added three new Metadata tables:
CAMPAIGN_SHARED_SETSHARED_CRITERIONSHARED_SET
July 2023
We have added a new field, customer.offline_conversion_client_summaries, to the CUSTOMER report.
We now support Google Ads API v14.
June 2023
We have added a new field, metrics.cost_per_conversion, to the AD_STATS prebuilt report.
We have added a new field, metrics.cost_per_conversion, to the AD_GROUP_STATS prebuilt report.
To fetch historical data for these fields, trigger a table re-sync for these tables.
We are migrating connector metadata tables to Fivetran history mode over the next few weeks. We will keep updating the updated_at column for metadata tables during the migration period and some time after that for backward compatibility.
May 2023
We have upgraded our Google Ads connector from version 13 to 13.1 of the Google Ads API and added the following metrics to custom reports:
For more information about the changes, see the Google Ads API's changelog.
March 2023
We have made the following schema changes to support Google Ads API v13:
We have added two new reports,
TRAVEL_ACTIVITY_GROUP_VIEWandTRAVEL_ACTIVITY_PERFORMANCE_VIEW.We have added the following fields to the
AD_GROUP_CRITERIONresource:ad_group_criterion.listing_group.case_value.activity_country.valuead_group_criterion.listing_group.case_value.activity_id.valuead_group_criterion.listing_group.case_value.activity_rating.value
We have added the following fields to the
ASSETresource:asset.field_type_policy_summariesasset.hotel_property_asset.hotel_addressasset.hotel_property_asset.hotel_name
We have added the
asset_set.hotel_property_data.hotel_center_idandasset_set.hotel_property_data.partner_namefields to theASSET_SETresource.We have added the
campaign_criterion.local_service_id.service_idfield to theCAMPAIGN_CRITERIONresource.We have added the following fields to the
AD_GROUP_ADreport:ad_group_ad.ad.travel_adad_group_ad.ad.video_ad.bumper.action_button_labelad_group_ad.ad.video_ad.bumper.action_headline
We have added the following fields to the
AD_GROUP_ASSETreport:ad_group_asset.primary_statusad_group_asset.primary_status_detailsad_group_asset.primary_status_reasons
We have added the following fields to the
CAMPAIGNreport:campaign.hotel_property_asset_setcampaign.travel_campaign_settings.travel_account_idcampaign.target_cpm.target_frequency_goal.target_countcampaign.target_cpm.target_frequency_goal.time_unit
We have added the following fields to the
CAMPAIGN_ASSETreport:campaign_asset.primary_statuscampaign_asset.primary_status_detailscampaign_asset.primary_status_reasons
We have added the following fields to the
CUSTOMERreport:customer.image_asset_auto_migration_donecustomer.image_asset_auto_migration_done_date_timecustomer.location_asset_auto_migration_donecustomer.location_asset_auto_migration_done_date_time
We have added the following fields to the
CUSTOMER_ASSETreport:customer_asset.primary_statuscustomer_asset.primary_status_detailscustomer_asset.primary_status_reasons
We have replaced the
ad_group.explorer_auto_optimizer_setting.opt_infield with thead_group.optimized_targeting_enabledfield inAD_GROUPreport.We have removed the
user_list.rule_based_user_list.combined_rule_user_list.*anduser_list.rule_based_user_list.expression_rule_user_list.*fields from theUSER_LISTresource, since the Google Ads API no longer supportsCombinedRuleUserListandExpressionRuleUserList.We have removed the
ad_group_criterion.listing_group.case_value.product_bidding_category.country_codefield from theAD_GROUP_CRITERIONresource andcampaign.target_cpmfield fromCAMPAIGNreport, since these fields are no longer supported in the Google Ads API.
We have improved how we fetch account labels for the ACCOUNT_LABEL_HISTORY table. Now, we get additional label information using the Customer Label resource. If a customer client doesn't have access to all labels assigned to it, we need to send the request using the manager client ID to increase the privileges. We are gradually rolling out this improvement for all the existing connections. If you have a lot of accounts with labels, this change may result in a slight increase in MAR.
We now support Google Ads API v13.
February 2023
We have changed our sync strategy and no longer perform an automatic table re-sync if:
- A field is added to or removed from a custom report
- The report name has changed
Previously, when we changed the available field set to match changes in the Google API, we performed a table re-sync for the affected reports, which may have contributed to higher MAR.
December 2022
We now support Google Ads API v12.
We have made the following schema changes to support Google Ads API v12:
We have added two new reports,
ASSET_SET_ASSETandASSET_SET_TYPE_VIEW.We have added the
asset_setresource fields to theASSET_SET_ASSETreport.We have added the
ad_group_ad_asset_view.pinned_fieldfield to theAD_GROUP_AD_ASSET_VIEWreport.We have added the
bidding_strategy.aligned_campaign_budget_idfield to theBIDDING_STRATEGYreport.We have added the
campaign_budget.aligned_bidding_strategy_idfield to theCAMPAIGN_BUDGETreport.We have added the
campaign_criterion.location_group.enable_customer_level_location_asset_setfield to theCAMPAIGN_CRITERIONresource.We have added the following fields to the
ASSETresource:asset.location_asset.business_profile_locationsasset.location_asset.location_ownership_typeasset.location_asset.place_id
We have added the following fields to the
CAMPAIGNreport:campaign.primary_statuscampaign.primary_status_reasons
We have added two new metadata tables,
DISCOVERY_CAROUSEL_AD_HISTORYandDISCOVERY_MULTI_ASSET_AD_HISTORY.We have removed the
ad_group_ad.ad.gmail_ad.*fields fromAD_GROUP_ADreport and theGMAIL_AD_HISTORYtable, since the Google Ads API no longer supportsGMAIL_AD.
November 2022
We have changed the way we sync geo targets. Previously, we only synced geo targets that were bound to campaign criteria. Now, we sync all geo targets twice per month on the 1st and 15th days of the month.
July 2022
We have upgraded our Google Ads connector to version 11 of the Google Ads API. For more information, see Google's v11 release note.
We have added two new reports, CAMPAIGN_ASSET and CUSTOMER_ASSET.
We have added the asset.source field to the asset resource.
We have added the ad_group_asset.source field to the AD_GROUP_ASSET report.
We have added the following fields to the CAMPAIGN report:
campaign.local_services_campaign_settings.category_bidscampaign.manual_cpacampaign.performance_max_upgrade.performance_max_campaigncampaign.performance_max_upgrade.pre_upgrade_campaigncampaign.performance_max_upgrade.statuscampaign.shopping_setting.feed_label
We have replaced the following fields in the following reports:
accessible_bidding_strategy.maximize_conversions.target_cpawithaccessible_bidding_strategy.maximize_conversions.target_cpa, in theACCESSIBLE_BIDDING_STRATEGYreportbidding_strategy.maximize_conversions.target_cpawithbidding_strategy.maximize_conversions.target_cpa, in theBIDDING_STRATEGYreportcampaign.maximize_conversions.target_cpawithcampaign.maximize_conversions.target_cpa, in theCAMPAIGNreport
We have removed the following fields from the USER_LIST report:
user_list.rule_based_user_list.date_specific_rule_user_list.end_dateuser_list.rule_based_user_list.date_specific_rule_user_list.rule.rule_item_groupsuser_list.rule_based_user_list.date_specific_rule_user_list.rule.rule_typeuser_list.rule_based_user_list.date_specific_rule_user_list.start_date
We have added the manual_cpa field to the CAMPAIGN_BIDDING_STRATEGY_HISTORY metadata table.
We have renamed the target_cpa field to target_cpa_micros in the CAMPAIGN_BIDDING_STRATEGY_HISTORY metadata table.
We have added the video_views metric to the AD_STATS prebuilt report. We automatically re-sync the AD_STATS table to capture the video views data. This re-sync is free.
June 2022
We have upgraded our Google Ads connector to version 10.1 of the Google Ads API. For more information, see Google's v10.1 release note.
We have added a new report, ASSET_FIELD_TYPE_VIEW.
We have added the following fields that correspond to the relevant asset types in the ASSET report:
dynamic_real_estate_assetdynamic_custom_assetdynamic_hotels_and_rentals_assetdynamic_flights_assetdynamic_travel_assetdynamic_local_assetdynamic_jobs_assetYou cannot use
ASSETas a separate report because it doesn't have thesegments.datefield. You can find this report as a part ofad_group_ad_asset_vieworad_group_asset.
We have added the following fields to the reports below:
asset_group_product_group_view.asset_groupandasset_group_product_group_view.asset_group_listing_group_filterfields to theASSET_GROUP_PRODUCT_GROUP_VIEWreportad_group_ad_asset_combination_view.enabledfield to theAD_GROUP_AD_ASSET_COMBINATION_VIEWreportcustomer.conversion_tracking_setting.google_ads_conversion_customerfield to theCUSTOMERreport
We have added the following fields to the AdGroupCriterionHistory metadata table:
cpc_bid_microscpm_bid_microscpv_bid_micros
We have added the breadcrumb1 and breadcrumb2 fields to the VideoResponsiveAdHistory metadata table.
April 2022
We no longer support the AdWords API, because Google has deprecated the AdWords API. We have migrated all the existing active Google Ads connections to the Google Ads API.
March 2022
We've updated the REST API config format for the Google Ads connector. See the Google Ads configuration section in our REST API documentation for details.
We have upgraded our Google Ads connector to version 10 of the Google Ads API. For more information, see Google's v10.0 release note.
We have added a new report, AD_GROUP_AD_ASSET_COMBINATION_VIEW.
We have added the following fields to the CUSTOMER report:
customer.statuscustomer.conversion_tracking_setting.accepted_customer_data_termscustomer.conversion_tracking_setting.conversion_tracking_statuscustomer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled
We have added the following fields to the reports below:
ad_group.audience_setting.use_audience_groupedto theAD_GROUPreportad_group_criterion.audience.audienceto theAD_GROUP_CRITERIONreportcampaign.audience_setting.use_audience_groupedandcampaign.shopping_setting.use_vehicle_inventoryto theCAMPAIGNreporthotel_reconciliation.campaignto theHOTEL_RECONCILIATIONreport
February 2022
We now support Google Ads API v9. We have made the following schema changes:
- We added the
ASSET_GROUP_PRODUCT_GROUP_VIEWandHOTEL_RECONCILIATIONreports - We now populate the
cpc_bid_ceiling_microsandcpc_bid_floor_microscolumns for theMAXIMIZE_CONVERSION_VALUEandMAXIMIZE_CONVERSIONSbidding strategy types in theCampaignBiddingStrategyHistorytable - We now populate the
in_stream_action_button_labelandin_stream_action_headlinecolumns forVIDEO_NON_SKIPPABLE_IN_STREAM_ADin theVideoAdHistorytable
We have removed the keyword_ad_group_criterion field from the AD_STATS pre-built report in the Google Ads connectors that use the new Google Ads API. This field segments data by keyword and all other segments are excluded from the report when this field is used. As a result, we observed discrepancies in the fetched reporting data. For all connectors using the new Google Ads API and syncing the AD_STATS table, Fivetran re-syncs the AD_STATS table to backfill the correct historical data.
January 2022
You can now configure your Google Ads connector through the Google Ads API. This feature is in Beta.
December 2021
We have changed the design of the Authorize and Re-Authorize buttons to comply with Google's Sign-In Branding Guidelines.
August 2021
We have removed the URL_PERFORMANCE_REPORT and AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT reports from the Report name list to support Google AdWords API changes.
June 2021
We have added the ad_group_id field to the following tables:
AD_GROUP_CRITERION_LABEL_HISTORYCUSTOM_PARAMETER_HISTORYDISAPPROVAL_REASON_HISTORYFINAL_APP_URL_HISTORYFINAL_MOBILE_URL_HISTORYFINAL_URL_HISTORY.
We have added the campaign_id and updated_at fields to the LOCATION table.
January 2021
We now support metadata tables that were previously available in the Google Ads Account connector. You can select or deselect the metadata tables on the Schema tab of your dashboard or select or deselect them during the Schema configuration using our REST API.
You can now configure custom reports in the connector setup form and existing prebuilt reports from the Schema tab of your connector dashboard.
We have changed the configuration format. We have deprecated the Prebuilt configuration type and support it only for backward compatibility, and we will end support soon.
We have replaced the Prebuilt report type with the Custom report type that has a predefined set of selected fields. You can select the tables in all existing prebuilt reports during the Schema configuration.
For more information, see our Google Ads schema documentation and our Google Ads REST API documentation.
These changes only affect new Google Ads connections created after January 18, 2021. We will migrate existing Google Ads and Google Ads Account connectors to Google Ads connectors in the new format in the future.
We now sync metadata tables that were previously available in the Google Ads Account connector:
ACCOUNTAD_FINAL_APP_URL_HISTORYAD_FINAL_MOBILE_URL_HISTORYAD_FINAL_URL_HISTORYAD_GROUP_CRITERION_HISTORYAD_GROUP_CRITERION_LABEL_HISTORYAD_GROUP_EXPLORER_AUTO_OPTIMIZER_SETTING_HISTORYAD_GROUP_HISTORYAD_GROUP_LABEL_HISTORYAD_GROUP_LABEL_HISTORYAD_GROUP_TARGETING_SETTING_HISTORYAD_HISTORYAD_LABEL_HISTORYAD_POLICY_CONSTRAINT_HISTORYAD_POLICY_EVIDENCE_HISTORYAD_POLICY_TOPIC_HISTORYBUDGET_HISTORYCALL_ONLY_AD_HISTORYCAMPAIGN_CONVERSION_OPTIMIZER_ELIGIBILITY_HISTORYCAMPAIGN_CRITERION_HISTORYCAMPAIGN_CRITERION_PRODUCT_SCOPECAMPAIGN_DYNAMIC_SEARCH_ADS_SETTING_HISTORYCAMPAIGN_GEO_TARGET_TYPE_SETTING_HISTORYCAMPAIGN_HISTORYCAMPAIGN_LABEL_HISTORYCAMPAIGN_REAL_TIME_BIDDING_SETTING_HISTORYCAMPAIGN_SHOPPING_SETTING_HISTORYCAMPAIGN_TARGETING_SETTING_HISTORYCAMPAIGN_TRACKING_SETTING_HISTORYCUSTOM_PARAMETER_HISTORYDEPRECATED_AD_HISTORYDISAPPROVAL_REASON_HISTORYDYNAMIC_SEARCH_AD_HISTORYEXPANDED_DYNAMIC_SEARCH_AD_HISTORYEXPANDED_TEXT_AD_HISTORYFINAL_APP_URL_HISTORYFINAL_MOBILE_URL_HISTORYFINAL_URL_HISTORYGMAIL_AD_HISTORYIMAGE_AD_HISTORYLABELLOCATIONRESPONSIVE_DISPLAY_AD_HISTORYSHOWCASE_AD_HISTORYTEMPLATE_AD_HISTORYTEXT_AD_HISTORY
We now sync tables related to prebuilt reports that were previously configured during the connector setup:
ACCOUNT_STATSACCOUNT_HOURLY_STATSAD_STATSAD_GROUP_STATSAD_GROUP_HOURLY_STATSAUDIENCE_STATSCAMPAIGN_STATSCAMPAIGN_HOURLY_STATSKEYWORD_STATS
For more information, see the Google Ads ERD.
November 2020
We have released pre-built, dbt Core-compatible data models for Google Ads. Find the models in Fivetran's dbt hub or data models documentation. Learn more about our dbt Core integration in our Transformations for dbt Core documentation*.
* dbt Core is a trademark of dbt Labs, Inc. All rights therein are reserved to dbt Labs, Inc. Fivetran Transformations is not a product or service of or endorsed by dbt Labs, Inc.
We have expanded the public API endpoints Create a connection and Update a connection. Now you can authorize the following connectors by adding the auth section to payloads:
October 2020
Now we perform a table re-sync whenever a field is added to or removed from a custom table. Previously, we only used incremental and rollback syncs, which may have caused incorrect metrics values being displayed in the table and unwanted report segmentation inconsistencies when the field set was changed.
September 2020
We improved the way we sync Placement Performance report data. Previously, the only AdNetworkTypes that the report contained were Display Network. Now, it receives placement data for all network types: Display Network, Search Network, YouTube Search, YouTube Videos, and Cross-network.
August 2020
You can now configure multiple reports in one connector. For example, you can configure several Google Ads reports for the same Customer ID without re-entering the credentials for each report.
All existing Google Ads connections are now considered legacy, but they continue to function just as they did before this change. You can change their setup in the same way as you did previously.
All new connections created after August 12, 2020 are multi-report. You can no longer direct multiple connections to the same schema in the destination because the schema name must be unique. If you need to use different credentials (for example, another Customer ID) for the same kind of reports, you have to create a separate connector and choose a different schema name for it.
We have added report schema configuration in the Schema tab. You can enable or disable the sync for any report you set up. The Schema tab shows the table name you chose when you set up the report, rather than the report name.
Read more about the new setup process in our Google Ads Setup Guide.
We now sync the BaseAdGroupId and BaseCampaignId columns from the KEYWORD_PERFORMANCE_REPORT report again. These columns were previously deprecated.
When you sync the KEYWORD_STATS pre-built report or a custom report based on the KEYWORD_PERFORMANCE_REPORT, you may notice the following warnings in your logs:
ADWORDS_DEPRECATED_FIELD : Deleting BaseAdGroupId from the set of fields of the report KEYWORDS_PERFORMANCE_REPORT. Remove the field by editing the setup form.ADWORDS_DEPRECATED_FIELD : Deleting BaseCampaignId from the set of fields of the report KEYWORDS_PERFORMANCE_REPORT. Remove the field by editing the setup form.
These warnings appear because we previously did not sync the BaseAdGroupId and BaseCampaignId columns. You do not need to take any action to resolve these warnings - these columns will be automatically added to your destination table.
June 2020
When creating a connector, now you can select specific manager accounts (former sub-MCC accounts) to sync. Fivetran will automatically find and sync clients of these manager accounts. Read more about sync modes in our Google Ads Setup Guide.
May 2020
You can now set the conversion window size for your Google Ads connector from your Fivetran dashboard and via the REST API. You can either set it manually or let Fivetran detect it automatically. Read more about setting your conversion window size from the dashboard and via the API.
April 2020
We now add a _fivetran_synced column while syncing empty tables and columns from the source.
March 2020
You can now configure your Google Ads connector using the Fivetran REST API. This feature is in BETA and available only for Standard and Enterprise accounts.
November 2019
We now force the creation of schemas even if they contain no data. This is especially helpful for Looker users, since Looker's pre-built SQL queries fail if all tables and columns in a schema are not present. Previously, we did not create schemas when they contained no data.
We now sync default empty -- values to your destination as NULL values to keep column types consistent.
October 2019
You can now select how many months' worth of reporting data you'd like to include in your initial sync. Choose from the following options:
- 3 months
- 6 months
- 12 months (default)
- 24 months
- All time
September 2019
We are removing the AveragePosition field from all of our predefined reports, because Google will sunset the average position metric on September 30, 2019. See Ads Developer Blog: Sunset of the Average Position Metric.
Your own reports will remain intact, but starting on September 29, 2019, we will ignore the AveragePosition field and log a warning. We recommend that you remove the AveragePosition field from any of your custom reports and use top and absolute top metrics instead. See Ads Developer Blog: Top and Absolute Top metrics.
Any old data will remain as is and the average_position column will stay in your tables. If you want to remove it completely, you'll have to drop the corresponding tables and run a historical re-sync.
August 2019
We have updated the Google Ads connector setup form. You can only add report fields that are compatible with each other. You no longer need to refer to Google Ads’ documentation to identify conflicting fields.
May 2019
We have removed support for the CAMPAIGN_GROUP_PERFORMANCE_REPORT because it does not contain a date field, which we require for incremental updates.
April 2019
We have removed support for the CAMPAIGN_CRITERIA_REPORT because it does not contain a date field, which we require for incremental updates.
March 2019
In all the report tables, the primary key _fivetran_id now contains hash id instead of row index to ensure each row has a unique ID.
We upgraded our connector from AdWords API v201806 to v201809 and handled deprecation. As part of the upgrade, we renamed the DESTINATION_URL_REPORT report to FINAL_URL_REPORT. Read more about the deprecations and changes in Google's AdWords API documentation.
January 2019
Since acquiring DoubleClick, Google has re-branded all DoubleClick sources. We have renamed the DoubleClick connectors as follows:
- DoubleClick Campaign Manager to Campaign Manager
- DoubleClick for Publishers to Google Ad Manager
- AdWords to Google Ads
This name change applies to the Fivetran dashboard and our documentation.
September 2018
Customer IDs will now be included in the Specific Accounts section of the Fivetran setup form.
July 2018
We have upgraded the Adwords API from v201710 to v201806 and handled deprecated fields.
- The
bidtypefield has been deprecated. - The
shopping_universal_adsfield has been renamedshopping_goal_optimized_ads.
For additional details, see Adwords' API deprecation schedule.
June 2018
We no longer support the LABEL_REPORT report because it does not support date fields.
April 2018
The CLICK_PERFORMANCE_REPORT table is now limited to fetching 90 days' worth of data, which is AdWords' maximum retention.