Bing Ads API Release Notes

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

September 2019

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

Final Url Suffix in Reports

The FinalUrlSuffix column is added to the AdPerformanceReportColumn value set. The FinalUrlSuffix column is also available via the AdGroupPerformanceReportColumn, CampaignPerformanceReportColumn, DestinationUrlPerformanceReportColumn, and KeywordPerformanceReportColumn value sets.

The final URL suffix is a place in your final URL where you can add parameters that will be attached to the end of your landing page URL.

Product Negative Keyword Report

The ProductNegativeKeywordConflictReportRequest is added for Microsoft Shopping Campaigns. Use this report to confirm that negative keywords applied to your Shopping campaigns are not excessively restricting campaign performance. You can request negative keywords and the corresponding products which they're preventing from showing in your Shopping campaigns.

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.5.

August 2019

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

Audience Association Level in Reports

The AssociationLevel column is added to the AudiencePerformanceReportColumn value set.

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.4.

July 2019

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

Include in Conversions

Customers who are enabled for the Include in Conversions feature (GetCustomerPilotFeatures returns 574) can choose to exclude specific conversion goals from conversions report data.

Data will be excluded from the Conversions, ConversionRate, CostPerConversion, ReturnOnAdSpend, RevenuePerConversion, and Revenue report columns for any conversion goal that has its ExcludeFromBidding property set as true. Also, if you use an automated bidding bid strategy, setting this property true will result in the goal's conversions no longer factoring into automated bidding calculations.

The AllConversions, AllConversionRate, AllCostPerConversion, AllReturnOnAdSpend, AllRevenuePerConversion, and AllRevenue columns (NEW) will include data for all conversion goals regardless of their ExcludeFromBidding setting.

For more information, see the help article Conversion goals: "Conversions" versus "All conversions".

After the July service update, the table below summarizes all available conversion related report performance statistics per report type.

Reporting Value Set Available Conversion Columns
AccountPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdDynamicTextPerformanceReportColumn AllConversions
AllConversionRate
AllCostPerConversion
Conversions
ConversionRate
CostPerConversion
AdExtensionByAdReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdExtensionByKeywordReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdExtensionDetailReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdGroupPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AgeGenderAudienceReportColumn AllConversions
AllRevenue
Conversions
Revenue
AudiencePerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
CampaignPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ConversionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DestinationUrlPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSAAutoTargetPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSACategoryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSASearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
GeographicPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
GoalsAndFunnelsReportColumn AllConversions
AllRevenue
Conversions
Revenue
KeywordPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductDimensionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductPartitionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductPartitionUnitPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductSearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
RevenuePerConversion
ProfessionalDemographicsAudienceReportColumn AllConversions
AllRevenue
Conversions
Revenue
PublisherUsagePerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
SearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ShareOfVoiceReportColumn AllConversions
AllConversionRate
AllCostPerConversion
Conversions
ConversionRate
CostPerConversion
UserLocationPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
Conversions
Revenue
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion

Base Campaign Id in Reports

The BaseCampaignId column is added to the following value sets.

Average Position in Reports

The AveragePosition column is added to the ProfessionalDemographicsAudienceReportColumn value set.

Audience Association ID in Reports

The AssociationId column is added to the AudiencePerformanceReportColumn value set.

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 available for Sponsored Products in Microsoft 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.