Version 11.12.2

• To extend support for Microsoft Audience Ads, new bulk objects are added to the SDK for reading and writing Bulk file records e.g., BulkResponsiveAd and BulkResponsiveAdLabel.
• Added retries for the 117 throttling error if encountered while polling for the status of a bulk or reporting operation.

Version 11.12.1

• Added support for Bing Ads API Version 12. For more information, see Migrating to Bing Ads API Version 12.

Version 11.5.9

• Updated to support Microsoft Account authentication in sandbox.
• Updated to Java 1.7. As announced previously at the end of March, we will disable TLS1.0/1.1 across all Bing Ads interfaces, and leave support for TLS1.2 only. You must upgrade at minimum to Java 1.7 e.g., update 131.

Version 11.5.8.1

Bug fix for the user agent string.

Version 11.5.8

The Bulk and Campaign Management proxies are updated to support audience search size. In addition the SDK supports audience search size via the BulkCustomAudience, BulkInMarketAudience, and BulkRemarketingList classes.

Version 11.5.7

• The org.apache.cxf library dependency is upgraded from version 3.0.2 to 3.0.5.

• The org.apache.httpcomponents library dependency is upgraded from version 4.0.1 to 4.5.3.

• The Version 11 Reporting service proxies are updated to support new columns for Estimated Bids.

Version 11.5.6

• Support for version 9 and 10 ended on October 31st, 2017. The following version 9 and 10 proxies are now removed from the SDK. You must upgrade to version 11.

  • Removed the Version 9 proxies for Customer Billing, Customer Management, and Reporting services. Also removed the Version 9 ReportingServiceManager.
  • Removed the Version 10 proxies for Ad Insight, Bulk, and Campaign Management services. Also removed the Version 10 BulkServiceManager and Version 10 Bulk entities.

• The Version 11 Reporting service proxies are updated to support new columns for Exact Match Impression Share Percent and Labels.

• Integrate Pull request 67 to improve performance. The ServiceClient will no longer call getServiceUrl in ServiceFactoryImpl when using CXF.

Version 11.5.5

• The Reporting service proxies are updated to support new columns for location targeting.
• Added an option to automatically delete the temporary bulk file used by BulkServiceManager for upload and download per the Github community pull request.
• Implemented internal retry logic for creating a new service with the wsdl.

Version 11.5.4

• The Campaign Management service proxies are updated to support inherited bid strategy type.
• The Reporting service proxies are updated to support new columns for Bing Shopping campaigns.
• New version 11 bulk labels objects are added i.e., BulkLabel, BulkCampaignLabel, BulkAdGroupLabel, BulkKeywordLabel, BulkAppInstallAdLabel, BulkDynamicSearchAdLabel, BulkExpandedTextAdLabel, BulkProductAdLabel, and BulkTextAdLabel objects are added to the SDK for reading and writing the corresponding Bulk file records.
• A new version 11 bulk offline conversion object is added i.e., the BulkOfflineConversion object is added to the SDK for writing and uploading the corresponding Bulk file record.

Version 11.5.3

Bing Ads Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, and Python SDKs are updated with support for the following features. Unless otherwise noted the changes only apply to Bing Ads API version 11. Some objects are reserved for future use, so please refer to the service reference documentation for availability details.

Breaking Changes

Before you upgrade to the latest SDK please note the following breaking changes.

• The Status property of the BulkCampaignProductScope object is removed. The Bulk file Status field is now mapped to the Status element of the BiddableCampaignCriterion of the BulkCampaignProductScope.
• All BulkEntity derived SDK objects (except BulkAdGroupProductPartition) which previously contained the AdGroupCriterion or CampaignCriterion property are updated as either Biddable or Negative. Both the type and the name are updated e.g. BulkAdGroupAgeCriterion has property name BiddableAdGroupCriterion and data type BiddableAdGroupCriterion. The purpose is to be clear about the supported data type per bulk entity up front, rather than causing friction later i.e., runtime errors due to mismatch of BulkEntity to concrete criterion type. Several bulk entities were updated during the May 2017 release; and the remaining mappings are fixed with this release.

Non Breaking Changes

• The Ad Insight service proxies are updated to support the keyword planner.
• The Bulk service proxies are updated to support labels.
• The Campaign Management service proxies are updated to support labels.
• The Bulk service proxies are updated to support offline conversions.
• The Campaign Management service proxies are updated to support offline conversions.
• Support is added for Bulk entity mapping of multiple campaign languages i.e., updated mapping of the Language field in the Bulk file to the BulkCampaign and BulkAdGroup. Note: Support is added for Bing Ads API version 10 and 11.
• Support is added for Bulk entity mapping of MaxConversions, MaxCpc, and TargetCpa bid strategy types i.e., mapping of the Bid Strategy Type, Bid Strategy MaxCpc, and Bid Strategy TargetCpa fields in the Bulk file to the BulkCampaign. Note: Support is added for Bing Ads API version 10 and 11.
• Support is added for Bulk entity mapping of LocalInventoryAdsEnabled for Bing Shopping campaigns i.e., mapping of the LocalInventoryAdsEnabled field in the Bulk file to the BulkCampaign.
• Performance data mapping is added to the BulkAdGroupRemarketingListAssociation object.
• New version 11 bulk audience objects are added i.e., BulkAdGroupNegativeRemarketingListAssociation, BulkCustomAudience, BulkAdGroupCustomAudience, BulkAdGroupNegativeCustomAudience, BulkInMarketAudience, BulkAdGroupInMarketAudience, and BulkAdGroupNegativeInMarketAudience objects are added to the SDK for reading and writing the corresponding Bulk file records.
• New version 11 bulk price ad extension objects are added i.e., BulkPriceAdExtension, BulkCampaignPriceAdExtension, and BulkAdGroupPriceAdExtension objects are added to the SDK for reading and writing the corresponding Bulk file records.
• New version 11 bulk account level ad extension objects are added i.e., BulkAccountAppAdExtension, BulkAccountCalloutAdExtension, BulkAccountImageAdExtension, BulkAccountLocationAdExtension, BulkAccountPriceAdExtension, BulkAccountReviewAdExtension, and BulkAccountSitelink2AdExtension objects are added to the SDK for reading and writing the corresponding Bulk file records.