Bing Ads
Use this page to set up the Bing Ads source connector and find reference information.
Prerequisites
- Microsoft Advertising account
- Microsoft Developer Token
Setup guide
For Airbyte Open Source, set up your application to get a Client ID, Client Secret, and Refresh Token:
- Register your application in the Azure portal.
- Request user consent to get the authorization code.
- Use the authorization code to get a refresh token.
:::note
Microsoft refresh tokens remain valid for 90 days and rotate each time they’re used. Airbyte saves the rotated refresh token whenever it refreshes the access token. Your connection therefore stays authenticated if it syncs at least once every 90 days. If it doesn’t sync for over 90 days, the refresh token expires. You must then repeat the authorization process to get a new token. The full authentication process is described here. Authenticate using the personal or work email address you use for the Microsoft Advertising platform.
:::
Step 1: Set up Bing Ads
-
Get your Microsoft developer token. You need a developer token and valid user credentials to use Bing Ads APIs. See Microsoft Advertising docs for more information.
- Sign in with Super Admin credentials at the Microsoft Advertising Developer Portal account tab.
- Choose the user you want to associate with the developer token. An application typically needs only one universal token, regardless of how many users it supports.
- Click the Request Token button.
-
If your OAuth app has a custom tenant, you may be unable to use Microsoft’s recommended common tenant. Enter the custom tenant in the Tenant ID field when you set up the connector.
:::info
The authentication URL uses the tenant. For example: https://login.microsoftonline.com/<tenant>/oauth2/v2.0/authorize
:::
Step 2: Set up the source connector in Airbyte
Airbyte Cloud
- Log into your Airbyte Cloud account.
- Click Sources, then click + New source.
- On the Set up the source page, select Bing Ads from the Source type dropdown.
- Enter a name for the Bing Ads connector.
- For Tenant ID, enter the custom tenant or use the common tenant.
- Add the developer token from Step 1.
- For Account Names Predicates, see predicates in the Bing Ads docs. This filters your accounts using a specified operator and account name. You can use multiple predicate pairs. The Operator is either Contains or Equals. The Account Name is the value compared with the Account Name field using the specified operator. For operator=Contains and name=Dev, all accounts with names containing “Dev” will be replicated. For operator=Equals and name=Airbyte, all accounts with names equal to “Airbyte” will be replicated. Account Name values aren’t case-sensitive.
- For Reports Replication Start Date, enter the date in YYYY-MM-DD format. Data added on or after this date will be replicated. If this field is blank, Airbyte will replicate all data from previous and current calendar years.
- For Lookback window, enter how many days before the saved report cursor Airbyte should re-read. This captures late conversions or corrected metrics. Round conversion windows measured in hours or minutes up to whole days. This setting applies to all report streams in incremental mode, including budget summary and custom reports. It applies whether or not Reports Replication Start Date is set. That start date remains the earliest date to read. Bulk entity streams ignore this setting. If you aren’t using incremental report streams, keep the default value of 0.
- For Custom Reports, see the custom reports section.
- For Report Name, enter the name you want for your custom report.
- For Reporting Data Object, add the Bing Ads Reporting Object you want to sync in the custom report.
- For Columns, add the Reporting Data Object columns you want to see in the custom report.
- For Aggregation, add the time aggregation. See the report aggregation section.
- (Optional) For Disable Custom Report Names Camel to Snake Case Conversion, enable this option to use the exact report name. This prevents automatic conversion from camelCase to snake_case. See custom report name conversion for details.
- Click Authenticate your Bing Ads account.
- Log in and authorize the Bing Ads account.
- Click Set up source.
Airbyte Open Source
- Go to the Airbyte Open Source dashboard.
- Click Sources, then click + New source.
- On the Set up the source page, select Bing Ads from the Source type dropdown.
- Enter a name for the Bing Ads connector.
- For Tenant ID, enter the custom tenant or use the common tenant.
- Enter the Client ID, Client Secret, Refresh Token, and Developer Token from Step 1.
- For Account Names Predicates, see predicates in the Bing Ads docs. This filters your accounts using a specified operator and account name. You can use multiple predicate pairs. The Operator is either Contains or Equals. The Account Name is the value compared with the Account Name field using the specified operator. For operator=Contains and name=Dev, all accounts with names containing “Dev” will be replicated. For operator=Equals and name=Airbyte, all accounts with names equal to “Airbyte” will be replicated. Account Name values aren’t case-sensitive.
- For Reports Replication Start Date, enter the date in YYYY-MM-DD format. Data added on or after this date will be replicated. If this field is blank, Airbyte will replicate all data from previous and current calendar years.
- For Lookback window, enter how many days before the saved report cursor Airbyte should re-read. This captures late conversions or corrected metrics. Round conversion windows measured in hours or minutes up to whole days. This setting applies to all report streams in incremental mode, including budget summary and custom reports. It applies whether or not Reports Replication Start Date is set. That start date remains the earliest date to read. Bulk entity streams ignore this setting. If you aren’t using incremental report streams, keep the default value of 0.
- For Custom Reports, see the custom reports section.
- For Report Name, enter the name you want for your custom report.
- For Reporting Data Object, add the Bing Ads Reporting Object you want to sync in the custom report.
- For Columns, add the Reporting Data Object columns you want to see in the custom report.
- For Aggregation, select the time aggregation. See the report aggregation section.
- (Optional) For Disable Custom Report Names Camel to Snake Case Conversion, enable this option to use the exact report name. This prevents automatic conversion from camelCase to snake_case. See custom report name conversion for details.
- Click Set up source.
Supported sync modes
The Bing Ads source connector supports these sync modes:
Supported streams
The Bing Ads source connector supports these streams. See the Bing Ads API for more information.
Basic streams
- Accounts (Full Refresh)
- Ad Groups (Full Refresh)
- Ad Group Labels (Incremental)
- Ads (Full Refresh)
- App Install Ads (Incremental)
- App Install Ad Labels (Incremental)
- Budget (Incremental)
- Campaigns (Full Refresh)
- Campaign Labels (Incremental)
- Keywords (Incremental)
- Keyword Labels (Incremental)
- Labels (Incremental)
Report streams
:::warning
Removing fields in the replication settings doesn’t change the report’s API request. Reports always include every field in the stream schema. Invisible grouping by removed fields may therefore make report results inaccurate. Use a custom report if you need a report with fewer fields.
:::
- Account Performance Report Hourly
- Account Performance Report Daily
- Account Performance Report Weekly
- Account Performance Report Monthly
- Account Impression Performance Report Hourly
- Account Impression Performance Report Daily
- Account Impression Performance Report Weekly
- Account Impression Performance Report Monthly
- Ad Group Performance Report Hourly
- Ad Group Performance Report Daily
- Ad Group Performance Report Weekly
- Ad Group Performance Report Monthly
- Ad Group Impression Performance Report Hourly
- Ad Group Impression Performance Report Daily
- Ad Group Impression Performance Report Weekly
- Ad Group Impression Performance Report Monthly
- Ad Performance Report Hourly
- Ad Performance Report Daily
- Ad Performance Report Weekly
- Ad Performance Report Monthly
- Age Gender Audience Report Hourly
- Age Gender Audience Report Daily
- Age Gender Audience Report Weekly
- Age Gender Audience Report Monthly
- Audience Performance Report Hourly
- Audience Performance Report Daily
- Audience Performance Report Weekly
- Audience Performance Report Monthly
- Geographic Performance Report Hourly
- Geographic Performance Report Daily
- Geographic Performance Report Weekly
- Geographic Performance Report Monthly
- Goals And Funnels Report Hourly
- Goals And Funnels Report Daily
- Goals And Funnels Report Weekly
- Goals And Funnels Report Monthly
- Budget Summary Report
- Campaign Performance Report Hourly
- Campaign Performance Report Daily
- Campaign Performance Report Weekly
- Campaign Performance Report Monthly
- Campaign Impression Performance Report Hourly
- Campaign Impression Performance Report Daily
- Campaign Impression Performance Report Weekly
- Campaign Impression Performance Report Monthly
- Keyword Performance Report Hourly
- Keyword Performance Report Daily
- Keyword Performance Report Weekly
- Keyword Performance Report Monthly
- User Location Performance Report Hourly
- User Location Performance Report Daily
- User Location Performance Report Weekly
- User Location Performance Report Monthly
- Product Dimension Performance Report Hourly
- Product Dimension Performance Report Daily
- Product Dimension Performance Report Weekly
- Product Dimension Performance Report Monthly
- Product Search Query Performance Report Hourly
- Product Search Query Performance Report Daily
- Product Search Query Performance Report Weekly
- Product Search Query Performance Report Monthly
- Search Query Performance Report Hourly
- Search Query Performance Report Daily
- Search Query Performance Report Weekly
- Search Query Performance Report Monthly
:::info
You can define a primary key for the following report streams. Set it on your connection’s Replication tab:
- Ad Group Impression Performance Report, example:
[AdGroupId, Status, TimePeriod, AccountId] - Geographic Performance Report, example:
[AdGroupId, Country, State, MetroArea, City] - Account Impression Performance Report, example:
[AccountName, AccountNumber, AccountId, TimePeriod]
These examples are only a guide. Choose a primary key that fits your data. See user-defined primary key for details.
:::
Entity-relationship diagram
Custom reports
Build your own report by providing:
- Report Name: the stream name
- Reporting Data Object: the Bing Ads reporting data object, which you can find here. You can use any data object ending in
ReportRequestfor custom reports. - Columns: the reporting object columns you want to sync. Find available columns on the
ReportRequestdata object page. Follow the...ReportColumnlink in the Bing Ads docs. The report must include every required column. Each report generally needs at least one attribute column. It also needs at least one performance statistics column that isn’t for impression share. You can’t add columns absent from the Bing Ads docs, and you can’t omit every optional column. - Aggregation: Hourly, Daily, Weekly, Monthly, DayOfWeek, HourOfDay, WeeklyStartingMonday, Summary. See report aggregation.
Custom report name conversion
By default, custom report names are automatically converted from camelCase to snake_case. For example:
MyCustomReportbecomesmy_custom_reportCampaignPerformanceDailybecomescampaign_performance_dailykeywordAnalysisReportbecomeskeyword_analysis_report
This conversion keeps names consistent with Airbyte’s naming conventions and compatible with most data destinations.
Disable name conversion
You can keep exact custom report names by disabling automatic conversion for each per-report basis. Set the Disable Custom Report Names Camel to Snake Case Conversion option to true for each custom report.
When you disable conversion for a report:
- Airbyte uses that report’s name exactly as specified
- Airbyte doesn’t convert that report’s name from camelCase to snake_case
- You control the resulting stream name for that report
- Other custom reports still use the default conversion unless you disable it
:::warning Breaking change warning
Changing this setting for an existing custom report will create a new stream and remove the old one. This breaking change may affect your data pipelines and downstream processes.
For example, you may have an existing custom report named MyCustomReport, which creates a stream called my_custom_report. If you later disable conversion, Airbyte creates a new stream called MyCustomReport. The old my_custom_report stream will no longer be available.
Be careful when modifying this setting for existing custom reports in production environments.
:::
Example configuration:
{
"custom_reports": [
{
"name": "MyExactReportName",
"reporting_object": "CampaignPerformanceReportRequest",
"report_columns": ["CampaignName", "Impressions", "Clicks"],
"report_aggregation": "Daily",
"disable_custom_report_names_camel_to_snake_conversion": true
},
{
"name": "AnotherReport",
"reporting_object": "AccountPerformanceReportRequest",
"report_columns": ["AccountName", "Impressions", "Clicks"],
"report_aggregation": "Daily"
}
]
}
In this example:
- The first report is named exactly
MyExactReportNamebecause conversion is disabled - The second report is named
another_reportbecause the default conversion applies
Report aggregation
You can aggregated every report synced by this connector using hourly, daily, weekly, or monthly time windows.
For example, select daily aggregation to create one row for each day in the report period. Each row shows the impressions recorded that day.
The report name shows its aggregation window. For example, account_performance_report_hourly is the Account Performance Report with hourly aggregation.
Upgrade the connector
See the Bing Ads Migration Guide for breaking changes and migration steps.
Limitations and troubleshooting
Expand to see details about Bing Ads connector limitations and troubleshooting.
Connector limitations
Rate limits
The Bing Ads API limits requests from all Microsoft Advertising clients. See here for detailed information. Microsoft doesn’t publish specific rate limits for the Bing Ads API. If you exceed the service call limit, the API returns error code 117 (CallRateExceeded). The connector retries automatically. However, persistent throttling may slow syncs for large accounts.
Bulk stream incremental behaviour
Bulk streams use the Microsoft Bulk API. These streams are Ad Group Labels, App Install Ads, App Install Ad Labels, Campaign Labels, Keywords, Keyword Labels, Labels, and Budget. In incremental mode, the Bulk API ignores LastSyncTimeInUTC for dates over 30 days ago. This triggers a full download. After a gap exceeding 30 days, the first sync therefore downloads all data, regardless of state.
Troubleshooting
- Find common troubleshooting guidance for the Bing Ads source connector on the Airbyte Forum.
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 3.0.23 | 2026-11-10 | 91310 | Declare the refreshed access_token and token_expiry_date as hidden spec fields so the access token is masked |
| 3.0.22 | 2026-11-10 | 91361 | Update dependencies |
| 3.0.21 | 2026-11-03 | 88968 | Add actionable messages for Microsoft Entra refresh token errors |
| 3.0.20 | 2026-11-03 | 89720 | Sync App, Hotel and Objective-based campaigns (and their ad groups and ads), which were previously skipped |
| 3.0.19 | 2026-11-03 | 90478 | Update dependencies |
| 3.0.18 | 2026-11-02 | 89620 | Apply lookback only to report streams to avoid unnecessary full downloads of bulk entities |
| 3.0.17 | 2026-10-27 | 89793 | Update dependencies |
| 3.0.16 | 2026-10-21 | 89609 | Classify expired file download URL errors as transient with a clearer error message |
| 3.0.15 | 2026-10-20 | 89107 | Update dependencies |
| 3.0.14 | 2026-10-13 | 88521 | Update dependencies |
| 3.0.13 | 2026-10-06 | 87771 | Update dependencies |
| 3.0.12 | 2026-09-29 | 87061 | Update dependencies |
| 3.0.11 | 2026-09-22 | 86541 | Update dependencies |
| 3.0.10 | 2026-09-15 | 85943 | Update dependencies |
| 3.0.9 | 2026-09-08 | 85411 | Update dependencies |
| 3.0.8 | 2026-08-18 | 84507 | Update dependencies |
| 3.0.7 | 2026-08-11 | 83859 | Update dependencies |
| 3.0.6 | 2026-07-28 | 83194 | Update to CDK 7.23.8 (fixes AirbyteCustomCodeNotPermittedError for bundled custom components) and remove the temporary Cloud version override |
| 3.0.5 | 2026-07-28 | 1082 | Roll Cloud back to 3.0.3 — 3.0.4 is built on SDM 7.23.7, which breaks bundled custom components |
| 3.0.4 | 2026-07-28 | 82806 | Update dependencies |
| 3.0.3 | 2026-07-21 | 82339 | Update dependencies |
| 3.0.2 | 2026-07-14 | 77143 | Update dependencies |
| 3.0.1 | 2026-07-08 | 79625 | Add refresh_token_updater to persist rotated Microsoft OAuth refresh tokens; remove non-standard OAuth refresh params |
| 3.0.0 | 2026-05-12 | 78031 | Breaking: include every attribute (dimension) column in the primary keys of all report streams to prevent silent row collapse at the destination during incremental append+dedup. A stream reset is required for the affected report streams after upgrading. |
| 2.23.17 | 2026-05-29 | 78518 | Add num_workers config for user-adjustable concurrency |
| 2.23.17-rc.2 | 2026-05-27 | 78438 | Revert concurrency to 10, add num_workers config and HTTP API budget |
| 2.23.17-rc.1 | 2026-05-26 | 78438 | Enable progressive rollout for concurrency tuning |
| 2.23.16 | 2026-04-21 | 76515 | Update dependencies |
| 2.23.15 | 2026-04-08 | 76165 | Promote 2.23.15-rc.3 to GA — fixes SAS token expiry during report downloads |
| 2.23.15-rc.3 | 2026-04-02 | 76053 | Fix SAS token expiry during report downloads by re-polling for fresh URL before each download |
| 2.23.15-rc.2 | 2026-03-30 | 74885 | Fix OOM on large report downloads by using streaming ZIP decoder and reducing concurrency |
| 2.23.15-rc.1 | 2026-03-12 | 74745 | Increase default concurrency from 2 to 40 to test rate limit behavior |
| 2.23.14 | 2026-03-10 | 74483 | Update dependencies |
| 2.23.13 | 2026-03-03 | 73654 | Use streaming decompression in BingAdsGzipCsvDecoder to prevent OOM on large accounts |
| 2.23.12 | 2026-03-03 | 73829 | Update dependencies |
| 2.23.11 | 2026-02-17 | 69578 | Update dependencies |
| 2.23.10 | 2026-02-05 | 72264 | Update CDK version from 7.4.1 to 7.6.5 |
| 2.23.9 | 2025-10-29 | 68883 | Update dependencies |
| 2.23.8 | 2025-10-21 | 68406 | Update dependencies |
| 2.23.7 | 2025-10-14 | 68008 | Update dependencies |
| 2.23.6 | 2025-10-07 | 67170 | Update dependencies |
| 2.23.5 | 2025-09-30 | 66038 | Update dependencies |
| 2.23.4 | 2025-09-16 | 66234 | Promoting release candidate 2.23.4-rc.1 to a main version. |
| 2.23.4-rc.1 | 2025-09-10 | 65894 | Fix Custom Report Names - Add Option to Disable camel_case_to_snake_case |
| 2.23.3 | 2025-09-10 | 65995 | Update to CDK v7 |
| 2.23.2 | 2025-08-16 | 64952 | Always decompress bulk download response |
| 2.23.1 | 2025-07-26 | 60669 | Update dependencies |
| 2.23.0 | 2025-07-09 | 62872 | Promoting release candidate 2.23.0-rc.1 to a main version. |
| 2.23.0-rc.1 | 2025-07-07 | 62520 | Migrate Source Bing Ads to manifest-only |
| 2.22.0 | 2025-07-02 | 62087 | Migrate custom report streams to manifest |
| 2.21.0 | 2025-06-26 | 62079 | Migrate search_query_performance_report and product_search_query_performance_report streams to manifest |
| 2.20.0 | 2025-06-26 | 62060 | Migrate budget_summary_report stream to manifest, refactor ad_performance_report and account_performance_report to use dynamic definition |
| 2.19.0 | 2025-06-25 | 62073 | Migrate audience_peformance_report, goals_and_funnels_report, account_impression_performance_report and user_location_performance_report streams to manifest |
| 2.18.0 | 2025-06-25 | 62013 | Migrate product_dimension_performance_report, ad_group_impression_performance_report and campaign_impression_performance_report streams to manifest |
| 2.17.0 | 2025-06-25 | 61719 | Migrate keywords, keyword_labels, campaign_labels and budget streams to manifest |
| 2.16.0 | 2025-06-24 | 61725 | Migrate keyword_performance_report and geographic_performance_report streams to manifest |
| 2.15.0 | 2025-06-23 | 61675 | Migrate ad_group_performance_report streams to manifest |
| 2.14.0 | 2025-06-18 | 61693 | Migrate ad_group_labels, app_install_ad_labels, and app_install_ads streams to manifest |
| 2.13.0 | 2025-06-16 | 61495 | Migrate campaign_performance_report and age_gender_audience_report streams to manifest |
| 2.12.0 | 2025-06-12 | 61578 | Promoting release candidate 2.12.0-rc.1 to a main version. |
| 2.12.0-rc.1 | 2025-06-12 | 60947 | Migrate ads and ad_groups streams to manifest |
| 2.11.0 | 2025-06-10 | 61517 | Promoting release candidate 2.11.0-rc.1 to a main version. |
| 2.11.0-rc.1 | 2025-06-09 | 61325 | Migrate account_performance_report streams and labels stream to manifest |
| 2.10.0 | 2025-06-02 | 61329 | Promoting release candidate 2.10.0-rc.1 to a main version. |
| 2.10.0-rc.1 | 2025-06-01 | 59750 | Migrate ad_performance_reports and campaigns streams to manifest |
| 2.9.4 | 2025-05-29 | 60909 | Remove account records if duplicated caused by predicate |
| 2.9.3 | 2025-05-28 | 60929 | Fix duplicated slices/jobs when reports_start_date is not set |
| 2.9.2 | 2025-05-22 | 60832 | Fix handling of account_names predicate in declarative stream |
| 2.9.1 | 2025-05-10 | 54233 | Update dependencies |
| 2.9.0 | 2025-05-07 | 59719 | Promoting release candidate 2.9.0-rc.1 to a main version. |
| 2.9.0-rc.1 | 2025-05-06 | 59136 | Bump CDK v6 and migrate Accounts stream to low-code |
| 2.8.13 | 2025-02-15 | 53882 | Update dependencies |
| 2.8.12 | 2025-02-01 | 52930 | Update dependencies |
| 2.8.11 | 2025-01-25 | 52198 | Update dependencies |
| 2.8.10 | 2025-01-18 | 51735 | Update dependencies |
| 2.8.9 | 2025-01-11 | 51230 | Update dependencies |
| 2.8.8 | 2025-01-04 | 50905 | Update dependencies |
| 2.8.7 | 2024-12-28 | 50443 | Update dependencies |
| 2.8.6 | 2024-12-21 | 50181 | Update dependencies |
| 2.8.5 | 2024-12-14 | 49283 | Update dependencies |
| 2.8.4 | 2024-11-25 | 48650 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 2.8.3 | 2024-11-04 | 48169 | Update dependencies |
| 2.8.2 | 2024-10-29 | 47850 | Update dependencies |
| 2.8.1 | 2024-10-28 | 47093 | Update dependencies |
| 2.8.0 | 2024-10-21 | 46991 | Update CDK to v5 |
| 2.7.9 | 2024-10-12 | 46847 | Update dependencies |
| 2.7.8 | 2024-10-05 | 46504 | Update dependencies |
| 2.7.7 | 2024-09-28 | 46151 | Update dependencies |
| 2.7.6 | 2024-09-21 | 45512 | Update dependencies |
| 2.7.5 | 2024-09-07 | 45246 | Update dependencies |
| 2.7.4 | 2024-08-31 | 44276 | Update dependencies |
| 2.7.3 | 2024-08-12 | 43742 | Update dependencies |
| 2.7.2 | 2024-08-10 | 43591 | Update dependencies |
| 2.7.1 | 2024-08-03 | 43245 | Update dependencies |
| 2.7.0 | 2024-07-31 | 42548 | Migrate to CDK v4.1.0 |
| 2.6.12 | 2024-07-27 | 42812 | Update dependencies |
| 2.6.11 | 2024-07-20 | 42360 | Update dependencies |
| 2.6.10 | 2024-07-13 | 41875 | Update dependencies |
| 2.6.9 | 2024-07-10 | 41383 | Update dependencies |
| 2.6.8 | 2024-07-09 | 41314 | Update dependencies |
| 2.6.7 | 2024-07-06 | 40906 | Update dependencies |
| 2.6.6 | 2024-07-05 | 34966 | Add support for Performance Max campaigns. |
| 2.6.5 | 2024-06-27 | 40585 | Replaced deprecated AirbyteLogger with logging.Logger |
| 2.6.4 | 2024-06-25 | 40457 | Update dependencies |
| 2.6.3 | 2024-06-22 | 40006 | Update dependencies |
| 2.6.2 | 2024-06-06 | 39177 | [autopull] Upgrade base image to v1.2.2 |
| 2.6.1 | 2024-05-02 | 36632 | Schema descriptions |
| 2.6.0 | 2024-04-25 | 35878 | Add missing fields in keyword_performance_report |
| 2.5.0 | 2024-03-21 | 35891 | Accounts stream: add TaxCertificate field to schema |
| 2.4.0 | 2024-03-19 | 36267 | Pin airbyte-cdk version to ^0 |
| 2.3.0 | 2024-03-05 | 35812 | New streams: Audience Performance Report, Goals And Funnels Report, Product Dimension Performance Report. |
| 2.2.0 | 2024-02-13 | 35201 | New streams: Budget and Product Dimension Performance. |
| 2.1.4 | 2024-02-12 | 35179 | Manage dependencies with Poetry |
| 2.1.3 | 2024-01-31 | 34712 | Fix duplicated records for report-based streams |
| 2.1.2 | 2024-01-09 | 34045 | Speed up record transformation |
| 2.1.1 | 2023-12-15 | 33500 | Fix state setter when state was provided |
| 2.1.0 | 2023-12-05 | 33095 | Add account filtering |
| 2.0.1 | 2023-11-16 | 32597 | Fix start date parsing from stream state |
| 2.0.0 | 2023-11-07 | 31995 | Schema update for Accounts, Campaigns and Search Query Performance Report streams. Convert date and date-time fields to standard RFC3339 |
| 1.13.0 | 2023-11-13 | 32306 | Add Custom reports and decrease backoff max tries number |
| 1.12.1 | 2023-11-10 | 32422 | Normalize numeric values in reports |
| 1.12.0 | 2023-11-09 | 32340 | Remove default start date in favor of Time Period - Last Year and This Year, if start date is not provided |
| 1.11.0 | 2023-11-06 | 32201 | Skip broken CSV report files |
| 1.10.0 | 2023-11-06 | 32148 | Add new fields to stream Ads: “BusinessName”, “CallToAction”, “Headline”, “Images”, “Videos”, “Text” |
| 1.9.0 | 2023-11-03 | 32131 | Add “CampaignId”, “AccountId”, “CustomerId” fields to Ad Groups, Ads and Campaigns streams. |
| 1.8.0 | 2023-11-02 | 32059 | Add new streams CampaignImpressionPerformanceReport (daily, hourly, weekly, monthly) |
| 1.7.1 | 2023-11-02 | 32088 | Raise config error when user does not have accounts |
| 1.7.0 | 2023-11-01 | 32027 | Add new streams AdGroupImpressionPerformanceReport |
| 1.6.0 | 2023-10-31 | 32008 | Add new streams Keywords |
| 1.5.0 | 2023-10-30 | 31952 | Add new streams Labels, App install ads, Keyword Labels, Campaign Labels, App Install Ad Labels, Ad Group Labels |
| 1.4.0 | 2023-10-27 | 31885 | Add new stream: AccountImpressionPerformanceReport (daily, hourly, weekly, monthly) |
| 1.3.0 | 2023-10-26 | 31837 | Add new stream: UserLocationPerformanceReport (daily, hourly, weekly, monthly) |
| 1.2.0 | 2023-10-24 | 31783 | Add new stream: SearchQueryPerformanceReport (daily, hourly, weekly, monthly) |
| 1.1.0 | 2023-10-24 | 31712 | Add new stream: AgeGenderAudienceReport (daily, hourly, weekly, monthly) |
| 1.0.2 | 2023-10-19 | 31599 | Base image migration: remove Dockerfile and use the python-connector-base image |
| 1.0.1 | 2023-10-16 | 31432 | Remove primary keys from the geographic performance reports - complete what was missed in version 1.0.0 |
| 1.0.0 | 2023-10-11 | 31277 | Remove primary keys from the geographic performance reports |
| 0.2.3 | 2023-09-28 | 30834 | Wrap auth error with the config error |
| 0.2.2 | 2023-09-27 | 30791 | Fix missing fields for geographic performance reports |
| 0.2.1 | 2023-09-04 | 30128 | Add increasing download timeout if ReportingDownloadException occurs |
| 0.2.0 | 2023-08-17 | 27619 | Add Geographic Performance Report |
| 0.1.24 | 2023-06-22 | 27619 | Retry request after facing temporary name resolution error |
| 0.1.23 | 2023-05-11 | 25996 | Implement a retry logic if SSL certificate validation fails |
| 0.1.22 | 2023-05-08 | 24223 | Add CampaignLabels report column in campaign performance report |
| 0.1.21 | 2023-04-28 | 25668 | Add undeclared fields to accounts, campaigns, campaign_performance_report, keyword_performance_report and account_performance_report streams |
| 0.1.20 | 2023-03-09 | 23663 | Add lookback window for performance reports in incremental mode |
| 0.1.19 | 2023-03-08 | 23868 | Add dimensional-type columns for reports |
| 0.1.18 | 2023-01-30 | 22073 | Fix null values in the Keyword column of keyword_performance_report streams |
| 0.1.17 | 2022-12-10 | 20005 | Add Keyword to keyword_performance_report stream |
| 0.1.16 | 2022-10-12 | 17873 | Fix: added missing campaign types in (Audience, Shopping and DynamicSearchAds) in campaigns stream |
| 0.1.15 | 2022-10-03 | 17505 | Fix: limit cache size for ServiceClient instances |
| 0.1.14 | 2022-09-29 | 17403 | Fix: limit cache size for ReportingServiceManager instances |
| 0.1.13 | 2022-09-29 | 17386 | Migrate to per-stream states |
| 0.1.12 | 2022-09-05 | 16335 | Added backoff for socket.timeout |
| 0.1.11 | 2022-08-25 | 15684 (published in 15987) | Fixed log messages being unreadable |
| 0.1.10 | 2022-08-12 | 15602 | Fixed bug caused Hourly Reports to crash due to invalid fields set |
| 0.1.9 | 2022-08-02 | 14862 | Added missing columns |
| 0.1.8 | 2022-06-15 | 13801 | All reports hourly/daily/weekly/monthly will be generated by default, these options are removed from input configuration |
| 0.1.7 | 2022-05-17 | 12937 | Added OAuth2.0 authentication method, removed redirect_uri from input configuration |
| 0.1.6 | 2022-04-30 | 12500 | Improve input configuration copy |
| 0.1.5 | 2022-01-01 | 11652 | Rebump attempt after DockerHub failure at registring the 0.1.4 |
| 0.1.4 | 2022-03-22 | 11311 | Added optional Redirect URI & Tenant ID to spec |
| 0.1.3 | 2022-01-14 | 9510 | Fixed broken dependency that blocked connector’s operations |
| 0.1.2 | 2021-12-14 | 8429 | Update titles and descriptions |
| 0.1.1 | 2021-08-31 | 5750 | Added reporting streams |
| 0.1.0 | 2021-07-22 | 4911 | Initial release supported core streams (Accounts, Campaigns, Ads, AdGroups) |