Bing Ads API Release Notes

See below for information about changes to Bing Ads API Version 13 by month.

June 2019

See below for Bing Ads API updates during this calendar month.

Bing Ads API SDK Updates

The Bing Ads .NET, Java, Php, and Python SDKs are updated. For details please see release notes for Microsoft Advertising .NET, Java, Php, and Python SDK version 12.13.3.

Final Url Suffix and Custom Parameters Update

Final URL suffix and custom parameter updates are now generally available at the account, campaign, ad group, and keyword level for all customers. Similar updates for ads, ad extensions, and ad group criterions are still only available for pilot customers.

  • Final URL suffix is now available at the account, campaign, ad group, and keyword level for all customers. Final URL suffix is available for ads, ad extensions, and ad group criterions for Phase 2 pilot customers (GetCustomerPilotFeatures returns 566). Later this year the Final URL suffix will be available for ads, ad extensions, and ad group criterions for all customers.
  • The custom parameter limit for all customers has been increased from 3 to 8 for campaigns, ad groups, and keywords. Microsoft Advertising will accept the first 8 custom parameter key and value pairs that you include, and if you include more than 8 custom parameters an error will be returned. For customers in the Custom Parameters Limit Increase Phase 2 pilot (GetCustomerPilotFeatures returns 565) for ads, ad extensions, and ad group criterions, Microsoft Advertising will accept the first 8 custom parameter key and value pairs that you include, and if you include more than 8 custom parameters an error will be returned. During calendar year 2019 the limit for ads, ad extensions, and ad group criterions will be increased from 3 to 8 for all customers.

Monday to Sunday Report Aggregation

The Reporting API is updated to support Monday through Sunday weekly aggregation. Previously you could only aggregate weekly from Sunday through Saturday.

The WeeklyStartingMonday value is added to the ReportAggregation value set.

The ThisWeekStartingMonday, LastWeekStartingMonday, and LastFourWeeksStartingMonday values are added to the ReportTimePeriod value set.

Prominence Metrics

With new and improved prominence metrics, you may now take a more holistic view of where your ads are appearing on search results pages. These clearer insights can help you better optimize your bidding strategy.

The AbsoluteTopImpressionRatePercent, AbsoluteTopImpressionShareLostToBudgetPercent, AbsoluteTopImpressionShareLostToRankPercent, TopImpressionRatePercent, TopImpressionShareLostToBudgetPercent, TopImpressionShareLostToRankPercent, and TopImpressionSharePercent columns are added to the following report column value sets.

Change History Report by Tool

The Tool column is now available with the change history report. You can determine how changes were made to account, campaign or ad attributes e.g., whether via the Web client, Editor, Bulk upload, or Campaign Management API.

Feeds via Bulk API

The Feed and Feed Item Bulk records are added to support Bulk download and upload of both Ad Customizer Feeds and Page Feeds.

The Page Feed Ids field is added to the Campaign record for Page Feeds.

May 2019

See below for Bing Ads API updates during this calendar month.

Assisted Conversions

Assisted conversions are conversions resulting from the clicks on your ads that have received co-bids from your manufacturer partners. This performance statistic is only applicable for cooperative shopping campaigns. The AssistedConversions column is added to the following report column value sets.

Dynamic Search Ads Text Part 2

Dynamic Search Ads Text Part 2 is available for pilot customers (GetCustomerPilotFeatures returns 600). Later this year it will be available in all customers.

The TextPart2 element is available in the DynamicSearchAd Campaign Management object. The Text Part 2 field is available in the Dynamic Search Ad Bulk record.

Bing Ads API SDK Updates

The Bing Ads .NET, Java, Php, and Python SDKs are updated. For details please see release notes for Microsoft Advertising .NET, Java, Php, and Python SDK version 12.13.2.

April 2019

See below for Bing Ads API updates during this calendar month.

New Production OAuth Endpoint

The Microsoft identity platform endpoint for developers is now available. The Microsoft identity platform endpoint allows both work or school accounts from Azure AD and personal Microsoft accounts (MSA), such as hotmail.com, outlook.com, and msn.com. The Live Connect endpoint only allows authentication with personal accounts.

Important

Even if your users do not have work or school accounts, and even if you do not use the Bing Ads API SDKs we encourage you to update the authorization URL during calendar year 2019, since the Live Connect endpoint is no longer the recommended approach for Microsoft Advertising users. For details see Upgrade to the Microsoft identity platform endpoint FAQ and Authentication with the Microsoft identity platform endpoint.

Bing Ads API SDK Updates

The Bing Ads .NET, Java, Php, and Python SDKs are updated with support for version 13. For details please see release notes for Microsoft Advertising .NET, Java, Php, and Python SDK version 12.13.1.

Version 13 General Availability

Bing Ads API version 13 is now generally available. With the availability of Bing Ads API version 13, version 12 is deprecated and will sunset by October 31, 2019. For more details, see Migrate to Version 13.

March 2019

See below for Bing Ads API updates during this calendar month.

Version 13 Preview

Bing Ads API version 13 is available for preview. For more details about migrating from version 12, see Migrate to Version 13.