Releases: BingAds/BingAds-Python-SDK
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.
Allow the Parent Id to be empty when deleting Bulk entities. Previously the Parent Id was required by the SDK although the Bulk service does not always require it.
Version 11.5.7
- 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.
- Improved memory usage for decompressing the bulk and report files.
- Set the default encoding to utf-8-sig and removed the chardet requirement. Bulk file download and upload should always be UTF-8 encoding with BOM.
Version 11.5.5.1
- Fix user-agent including '\n' character issue introduced by 11.5.5. Only (Major, Minor, Micro) tuple will be added into user-agent.
Version 11.5.5
- The Reporting service proxies are updated to support new columns for location targeting.
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.
v11.5.2
Updated the service client proxies with support for new features that were released to production in May e.g., Dynamic Search Ads reports.
This release also includes breaking changes for price ad extensions:
- Patched the data type for the UrlCustomParameters property of PriceAdExtension. This change ensures consistency with UrlCustomParameters of all other Campaign Management data objects.
- Added terms and conditions properties to the PriceTableRow that are reserved for future use.
version 11.5.1
The SDK is updated with support for Bing Ads API Version 11 web service addresses. This release enables you to upgrade existing features from version 9 and 10 to version 11. Bulk entity support for new version 11 features will be added in a future release.
version 10.4.12
The Python SDKs are updated with support for bulk upload of remarketing lists using the BulkRemarketingList class. Upload is already supported by the Bulk service, and now the SDK is also enabled.