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.