Bing Ads API Release Notes

For information about the changes to the Bing Ads Version 12 services for each month, see the following sections.

August 2018

For information about this month's changes to Bing Ads services, see the following sections.

Bing Ads Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, Php, and Python SDKs are updated.

  • Updated service proxies to support customer address, campaign level profile criteria, similar audiences for remarketing lists, and new change history report columns.

Customer Address

The CustomerAddress element is added back to the Customer object. This element had been removed during the transition from Bing Ads API Version 11 to Version 12. Although you must set the account BusinessAddress, the customer address is optional if your application has a dependency on it. Bing Ads does not use the customer address, and instead uses the account business address.

Validate Address

The ValidateAddress operation is added. The operation determines whether or not the submitted address is valid for Bing Ads accounts. For Australia (AU), Canada (CA), and The United States (US), the operation validates whether or not you could ship something to the address. For all other countries basic address verification (AVS) is completed.

Entity Attributes for the Change History Report

The EntityId and EntityName elements are added to the SearchCampaignChangeHistoryReportColumn value set.

Profile Criteria for Campaigns

Professional profile targeting via LinkedIn is coming soon to Dynamic Search Ads, Search, and Shopping campaigns.

The Campaign Management service is updated to support the new campaign level profile criterion types i.e., the CompanyName, Industry, and JobFunction values are added to the CampaignCriterionType value set. Use the existing BiddableCampaignCriterion object with the corresponding operations e.g., AddCampaignCriterions to manage campaign level criterions. The Campaign Management service already includes definitions for ad group level profile criterion types via the AdGroupCriterionType value set. Use the existing BiddableAdGroupCriterion object with the corresponding operations e.g., AddAdGroupCriterions to manage ad group level criterions.

The Bulk service is updated to support the new profile criterion types i.e., upload and download the Campaign Company Name Criterion, Campaign Industry Criterion, and Campaign Job Function Criterion records in a Bulk file. Use the existing CampaignTargetCriterions value flag for Bulk download. The Bulk service already includes definitions for ad group level profile criterion types via the Ad Group Company Name Criterion, Ad Group Industry Criterion, and Ad Group Job Function Criterion records in a Bulk file. Use the existing AdGroupTargetCriterions value flag for Bulk download.

Similar Audiences for Remarketing Lists

Similar audiences for remarketing lists is coming soon. Bing Ads will automatically generate similar audiences for remarketing lists for pilot participants. You cannot create or edit the similar audiences for remarketing lists. If you delete the source remarketing list, then the similar audience will also be deleted. If a similar audience is associated with an ad group, then you cannot delete the source remarketing list.

The Campaign Management service is updated to support similar audiences for remarketing i.e., the SimilarRemarketingList object. Use the existing GetAudiencesByIds operation to retrieve the similar audiences. Use the existing AddAdGroupCriterions, DeleteAdGroupCriterions, GetAdGroupCriterionsByIds, and UpdateAdGroupCriterions operations to manage ad group level associations for the similar audiences.

Note

Bulk service support for similar audiences for remarketing lists is coming soon.

July 2018

For information about this month's changes to Bing Ads services, see the following sections.

Bing Ads Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, Php, and Python SDKs are updated.

  • Limited the scope to bingads.manage for access token requests. Previously the default scope was used, which can vary if a user granted your app permissions to multiple scopes. The Bing Ads SDKs only support the bingads.manage scope.
  • Updated the Customer Management proxies to support LinkedAccountIds for agencies. For agency users the customer role can contain a list of linked accounts that the user can access as an agency on behalf of another customer.

June 2018

For information about this month's changes to Bing Ads services, see the following sections.

Bing Ads Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, and Python SDKs are updated to extend support for Cooperative Bidding i.e., the BulkAdGroup now supports the coop setting.

Linked Account Ids per Customer Role

The LinkedAccountIds element is added to the CustomerRole object. For agency users the element contains a list of linked accounts that the user can access as an agency on behalf of another customer.

Important

The CustomerRole objects that represent the user's permissions for agency-linked accounts will not be returned by default when you call the GetUser service operation. In other words by default the GetUser operation will only return CustomerRole objects for customers that the user can directly access without agency linking. To retrieve CustomerRole objects that represent the user's permissions for agency-linked accounts you must set the optional IncludeLinkedAccountIds element to True when calling the GetUser operation.

May 2018

For information about this month's changes to Bing Ads services, see the following sections.

Bing Ads Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, PHP, and Python SDKs are updated to extend support for Audience Ads. New bulk objects are added to the SDK for reading and writing Bulk file records e.g., BulkResponsiveAd and BulkResponsiveAdLabel.

The Bing Ads .NET, Java, and Python SDKs are updated with retries for the 117 throttling error if encountered while polling for the status of a bulk or reporting operation.

Microsoft Audience Network Preview

Support is added for the Microsoft Audience Network in preview. For details see Audience Ads. For differences between version 11 and 12, see Migrate to Version 12.

April 2018

For information about this month's changes to Bing Ads services, see the following sections.

Version 12 General Availability

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

Bing Ads Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, PHP, and Python SDKs are updated to support Bing Ads API Version 12.

Bing Ads .NET SDK

The Bing Ads .NET SDK is updated to support .NET Standard 2.0. This will enable you to choose from a variety of platforms e.g., .NET Core or .NET Framework 4.6.1. For more information on .NET Standard and how it relates to other .NET frameworks, refer to this article on .NET Standard.

Bing Ads Python SDK

The version parameter is now required when creating each ServiceClient. Previously the version was optional and defaulted to version 11. The version parameter is moved to the second position between the service client name and the authorization data.

The file_type parameter now defaults to 'Csv' as an str datatype instead of the DownloadFileType for BulkFileReader, BulkServiceManager, DownloadParameters and SubmitDownloadParameters. You can set 'Tsv' if you prefer the tab separated file format type.

Product Match Count Report

The ProductMatchCountReportRequest is added for Bing Shopping campaigns. You can include details in the report such as impressions, clicks, and spend that you can use to see if you are covering and bidding across your Bing shopping campaigns inventory. Note that this only provides the matched data for your current Product Group level, and you cannot obtain historical views.

March 2018

For information about this month's changes to Bing Ads services, see the following sections.

Version 12 Sandbox Beta

The sandbox endpoints for Bing Ads API version 12 are available in beta. The interfaces are subject to change prior to general availability. For more details, see Migrate to Version 12.