You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/integrations/sources/bing-ads.md
+39-39Lines changed: 39 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,21 +17,21 @@ This page contains the setup guide and reference information for the [Bing Ads](
17
17
18
18
For Airbyte Open Source set up your application to get **Client ID**, **Client Secret**, **Refresh Token**
19
19
20
-
1.[Register your application](https://docs.microsoft.com/en-us/advertising/guides/authentication-oauth-register?view=bingads-13) in the Azure portal.
21
-
2.[Request user consent](https://docs.microsoft.com/en-us/advertising/guides/authentication-oauth-consent?view=bingads-13) to get the authorization code.
22
-
3. Use the authorization code to [get a refresh token](https://docs.microsoft.com/en-us/advertising/guides/authentication-oauth-get-tokens?view=bingads-13).
20
+
1.[Register your application](https://learn.microsoft.com/en-us/advertising/guides/authentication-oauth-register?view=bingads-13) in the Azure portal.
21
+
2.[Request user consent](https://learn.microsoft.com/en-us/advertising/guides/authentication-oauth-consent?view=bingads-13) to get the authorization code.
22
+
3. Use the authorization code to [get a refresh token](https://learn.microsoft.com/en-us/advertising/guides/authentication-oauth-get-tokens?view=bingads-13).
23
23
24
24
:::note
25
25
26
-
The refresh token expires in 90 days. Repeat the authorization process to get a new refresh token. The full authentication process described [here](https://docs.microsoft.com/en-us/advertising/guides/get-started?view=bingads-13#access-token).
27
-
Please be sure to authenticate with the email (personal or work) that you used to sign in to the Bing ads/Microsoft ads platform.
26
+
The refresh token expires in 90 days. Repeat the authorization process to get a new refresh token. The full authentication process is described [here](https://learn.microsoft.com/en-us/advertising/guides/get-started?view=bingads-13#access-token).
27
+
Authenticate with the email address (personal or work) that you used to sign in to the Microsoft Advertising platform.
28
28
:::
29
29
30
30
<!-- /env:oss -->
31
31
32
32
### Step 1: Set up Bing Ads
33
33
34
-
1. Get your [Microsoft developer token](https://ads.microsoft.com/cc/Settings/DevSettings). To use Bing Ads APIs, you must have a developer token and valid user credentials. See [Microsoft Advertising docs](https://docs.microsoft.com/en-us/advertising/guides/get-started?view=bingads-13#get-developer-token) for more info.
34
+
1. Get your [Microsoft developer token](https://ads.microsoft.com/cc/Settings/DevSettings). To use Bing Ads APIs, you must have a developer token and valid user credentials. See [Microsoft Advertising docs](https://learn.microsoft.com/en-us/advertising/guides/get-started?view=bingads-13#get-developer-token) for more info.
35
35
36
36
1. Sign in with [Super Admin](https://learn.microsoft.com/en-us/advertising/guides/account-hierarchy-permissions?view=bingads-13#user-roles-permissions) credentials at the [Microsoft Advertising Developer Portal](https://developers.ads.microsoft.com/Account) account tab.
37
37
2. Choose the user that you want associated with the developer token. Typically an application only needs one universal token regardless how many users will be supported.
@@ -107,18 +107,18 @@ The Bing Ads source connector supports the following [sync modes](https://docs.a
107
107
108
108
## Supported Streams
109
109
110
-
The Bing Ads source connector supports the following streams. For more information, see the [Bing Ads API](https://docs.microsoft.com/en-us/advertising/guides/?view=bingads-13).
110
+
The Bing Ads source connector supports the following streams. For more information, see the [Bing Ads API](https://learn.microsoft.com/en-us/advertising/guides/?view=bingads-13).
@@ -134,26 +134,26 @@ The results of such a report may be inaccurate due to invisible values in the re
134
134
If you encounter this issue, use a custom report where you can define only the fields that you want to see in the report. No other fields will be included in the request.
-[Ad Group Performance Report Hourly](https://learn.microsoft.com/en-us/advertising/reporting-service/adgroupperformancereportrequest?view=bingads-13)
146
+
-[Ad Group Performance Report Daily](https://learn.microsoft.com/en-us/advertising/reporting-service/adgroupperformancereportrequest?view=bingads-13)
147
+
-[Ad Group Performance Report Weekly](https://learn.microsoft.com/en-us/advertising/reporting-service/adgroupperformancereportrequest?view=bingads-13)
148
+
-[Ad Group Performance Report Monthly](https://learn.microsoft.com/en-us/advertising/reporting-service/adgroupperformancereportrequest?view=bingads-13)
149
149
-[Ad Group Impression Performance Report Hourly](https://learn.microsoft.com/en-us/advertising/reporting-service/adgroupperformancereportrequest?view=bingads-13)
150
150
-[Ad Group Impression Performance Report Daily](https://learn.microsoft.com/en-us/advertising/reporting-service/adgroupperformancereportrequest?view=bingads-13)
151
151
-[Ad Group Impression Performance Report Weekly](https://learn.microsoft.com/en-us/advertising/reporting-service/adgroupperformancereportrequest?view=bingads-13)
152
152
-[Ad Group Impression Performance Report Monthly](https://learn.microsoft.com/en-us/advertising/reporting-service/adgroupperformancereportrequest?view=bingads-13)
All reports synced by this connector can be [aggregated](https://docs.microsoft.com/en-us/advertising/reporting-service/reportaggregation?view=bingads-13) using hourly, daily, weekly, or monthly time windows.
289
+
All reports synced by this connector can be [aggregated](https://learn.microsoft.com/en-us/advertising/reporting-service/reportaggregation?view=bingads-13) using hourly, daily, weekly, or monthly time windows.
290
290
291
291
For example, if you select a report with daily aggregation, the report will contain a row for each day for the duration of the report. Each row will indicate the number of impressions recorded on that day.
292
292
@@ -303,7 +303,7 @@ Expand to see details about Bing Ads connector limitations and troubleshooting.
303
303
304
304
#### Rate limiting
305
305
306
-
The Bing Ads API limits the number of requests for all Microsoft Advertising clients. You can find detailed info [here](https://docs.microsoft.com/en-us/advertising/guides/services-protocol?view=bingads-13#throttling).
306
+
The Bing Ads API limits the number of requests for all Microsoft Advertising clients. You can find detailed info [here](https://learn.microsoft.com/en-us/advertising/guides/services-protocol?view=bingads-13#throttling). Microsoft does not publish specific rate limits for the Bing Ads API. If you exceed the service call limit, the API returns error code 117 (`CallRateExceeded`). When this occurs, wait 60 seconds before retrying the request.
307
307
308
308
### Troubleshooting
309
309
@@ -319,7 +319,7 @@ The Bing Ads API limits the number of requests for all Microsoft Advertising cli
| 2.23.15-rc.1 | 2026-03-11|[*PR_NUMBER_PLACEHOLDER*](https://github.com/airbytehq/airbyte/pull/*PR_NUMBER_PLACEHOLDER*)| Increase default concurrency from 2 to 40 to test rate limit behavior |
322
+
| 2.23.15-rc.1 | 2026-03-12|[74745](https://github.com/airbytehq/airbyte/pull/74745)| Increase default concurrency from 2 to 40 to test rate limit behavior |
| 2.23.13 | 2026-03-03 |[73654](https://github.com/airbytehq/airbyte/pull/73654)| Use streaming decompression in BingAdsGzipCsvDecoder to prevent OOM on large accounts |
0 commit comments