bingads 12.13.4

Add Bulk entity mapping for the CustomLabel dynamic ad target condition.

Fix import issue introduced by version 12.13.3, where clients would observe error ModuleNotFoundError: No module named ‘bingads.v13.bulk.entities.feeds’.

Updated Bing Ads API version 12 and 13 service proxies to reflect recent interface changes. For more information please see the Bing Ads API Release Notes: https://docs.microsoft.com/en-us/advertising/guides/release-notes.

For Bing Ads API version 13, added BulkFeed and BulkFeedItem for ad customizer feeds and page feeds. For more information please see the Feed: https://docs.microsoft.com/en-us/advertising/bulk-service/feed?view=bingads-13 and Feed Item: https://docs.microsoft.com/en-us/advertising/bulk-service/feed-item?view=bingads-13 reference documentation.

For Bing Ads API version 13, added the mapping for PageFeedIds in BulkCampaign. For more information please see the Campaign: https://docs.microsoft.com/en-us/advertising/bulk-service/dynamic-search-ad?view=bingads-13#pagefeedids reference documentation.

For Bing Ads API version 13, added the mapping for TextPart2 in BulkDynamicSearchAd. For more information please see the Dynamic Search Ad: https://docs.microsoft.com/en-us/advertising/bulk-service/dynamic-search-ad?view=bingads-13#textpart2 reference documentation.

IMPORTANT: The default OAuth endpoint is updated from “Live Connect”: https://docs.microsoft.com/en-us/advertising/guides/authentication-oauth-live-connect endpoint to the “Microsoft Identity endpoint for developers”: https://docs.microsoft.com/en-us/advertising/guides/authentication-oauth-identity-platform. The “Microsoft Identity endpoint” supports both Microsoft Account (MSA) personal credentials and Azure Active Directory (AAD) work credentials. For more information, see “Upgrade to the Microsoft identity platform endpoint FAQ”: https://docs.microsoft.com/en-us/advertising/guides/authentication-oauth#upgrade-identity-platform-faq.

Updated Bing Ads API version 12 and 13 service proxies to reflect recent interface changes. For details please see the “Bing Ads API Release Notes”: https://docs.microsoft.com/en-us/bingads/guides/release-notes.

For Bing Ads API version 12 and 13, added a new Bulk property for Final Url Suffix phase 2 entities i.e., added FinalUrlSuffix to the existing BulkActionAdExtension, BulkAppAdExtension, BulkImageAdExtension, BulkPriceAdExtension, BulkSitelinkAdExtension, BulkAdGroupProductPartition, and BulkAd. For details see “Final Url Suffix”: https://docs.microsoft.com/en-us/advertising/guides/url-tracking-upgraded-urls#finalurlsuffixvalidation.

Added support for Bing Ads API Version 13. For more information, see Migrating to Bing Ads API Version 13: https://docs.microsoft.com/en-us/bingads/guides/migration-guide?view=bingads-13.

Updated version 12 service proxies to reflect recent interface changes. For details please see the Bing Ads API Release Notes: https://docs.microsoft.com/en-us/bingads/guides/release-notes?view=bingads-12.

For both version 12 and 13, added a new Bulk property for Final Url Suffix i.e., added FinalUrlSuffix to the existing BulkAccount, BulkAdGroup, BulkCampaign, and BulkKeyword. For details about Final Url Suffix in the Bulk file, see the Release Notes:https://docs.microsoft.com/en-us/bingads/guides/release-notes?view=bingads-12#finalurlsuffix-march2019.

Updated service proxies to reflect recent interface changes. For details please see the Bing Ads API Release Notes: https://docs.microsoft.com/en-us/bingads/guides/release-notes.

Added a new Bulk property for Action Text i.e., added ActionText to the existing BulkActionAdExtension.

Removed the is_expired property from BulkAdGroup. Use the Status property of the BulkAdGroup instead.

For optional fields, the Bulk file schema mapping is updated such that “delete_value” will only be written to the file for update operations. Update intent is assumed when the Bulk entity ID is greater than zero.

Updated the Status mapping for BulkExperiment i.e., map the string value directly instead of via bulk_optional_str.

Fix import issue introduced by version 12.0.3, in which version python 3 users will see error “ImportError: No module named ‘bulk_ad_group_negative_audience_association”. See issue: https://github.com/BingAds/BingAds-Python-SDK/issues/110.

BREAKING CHANGE for BulkAdGroupCustomAudienceAssociation, BulkAdGroupInMarketAudienceAssociation, BulkAdGroupNegativeCustomAudienceAssociation, BulkAdGroupNegativeInMarketAudienceAssociation, BulkAdGroupNegativeProductAudienceAssociation, BulkAdGroupNegativeRemarketingListAssociation, BulkAdGroupNegativeSimilarRemarketingListAssociation, BulkAdGroupProductAudienceAssociation, BulkAdGroupRemarketingListAssociation, and BulkAdGroupSimilarRemarketingListAssociation: Replaced custom_audience_name, in_market_audience_name, product_audience_name, remarketing_list_name, and similar_remarketing_list_name with audience_name. The audience_name property is now used to map from the ‘Audience Name’ field of a Bulk file via all audience association SDK objects.

Updated service proxies to reflect recent interface changes. For details please see the release notes: https://docs.microsoft.com/en-us/bingads/guides/release-notes.

Added Bulk mapping for responsive ad images i.e., added Images to the existing BulkResponsiveAd.

Added Bulk mapping for campaign target setting i.e., added TargetSetting to the existing BulkCampaign.

Added Bulk mapping for campaign level audience associations i.e.,BulkCampaignCustomAudienceAssociation, BulkCampaignInMarketAudienceAssociation, BulkCampaignNegativeCustomAudienceAssociation, BulkCampaignNegativeInMarketAudienceAssociation, BulkCampaignNegativeProductAudienceAssociation, BulkCampaignNegativeRemarketingListAssociation, BulkCampaignNegativeSimilarRemarketingListAssociation, BulkCampaignProductAudienceAssociation, BulkCampaignRemarketingListAssociation, and BulkCampaignSimilarRemarketingListAssociation.

Added the get_response_header method in class ServiceClient, to access the service TrackingId, etc per GitHub issue https://github.com/BingAds/BingAds-Python-SDK/issues/106.

Updated service proxies to reflect recent interface changes. For details please see the Bing Ads API Release Notes: https://docs.microsoft.com/en-us/bingads/guides/release-notes.

Added Bulk mapping for campaign experiments i.e., BulkExperiment and BulkCampaign.

Added Bulk mapping for action ad extensions i.e., BulkActionAdExtension, BulkAccountActionAdExtension, BulkAdGroupActionAdExtension, and BulkCampaignActionAdExtension.

Removed support for Bing Ads API Version 11, per the October 31, 2018 sunset.

Added Bulk mapping for responsive search ads i.e., BulkResponsiveSearchAd and BulkResponsiveSearchAdLabel.

Added all fragments returned via the tokens request as a new property in the OAuthTokens SDK class.

Update service proxies to reflect recent interface changes.

Map TitlePart3 and TextPart2 to BulkExpandedTextAd.

Updated service proxies to reflect recent Bulk, Campaign Management, Customer Management, and Reporting API changes.

Added Bulk mapping for similar remarketing lists i.e., BulkSimilarRemarketingList, BulkAdGroupSimilarRemarketingListAssociation, and BulkAdGroupNegativeSimilarRemarketingListAssociation.

Updated service proxies to support customer address, campaign level profile criteria, similar audiences for remarketing lists, and new change history report columns. For details see the service release notes: https://docs.microsoft.com/en-us/bingads/guides/release-notes?view=bingads-12#august2018.

Added BulkEntity mappings for campaign level profile criteria i.e., added BulkCampaignCompanyNameCriterion, BulkCampaignJobFunctionCriterion, and BulkCampaignIndustryCriterion.

Added a mapping for the Domain column in the Bulk file to the BulkExpandedTextAd object.

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.

Added support for Cooperative bidding e.g., added mappings for “Bid Boost Value”, “Bid Option” and “Maximum Bid” fields via the BulkAdGroup.

Added mappings for the ‘MSCLKID Auto Tagging Enabled” and “Tracking Tempalte” fields via the BulkAccount.

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.

dAdded retries for the 117 throttling error if encountered while polling for the status of a bulk or reporting operation.

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

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.

Updated to support Microsoft Account authentication in sandbox.

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.

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

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.

Fix user-agent including ‘n’ character issue introduced by 11.5.5. Only (Major, Minor, Micro) tuple will be added into user-agent.

The Reporting service proxies are updated to support new columns for location targeting.

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.

Support Remarketing list bulk upload

Add Remarketing Rule in bulk schema

Add bulk support for Dynamic Search Ads feature

Update wsdl proxy to latest version

Bug fixes

Update wsdl proxy for Dynamic Search Ads Bulk

Update wsdl proxy for Remarketing Add/Update/Delete APIs

Update wsdl proxy for Dynamic Search Ads APIs

Update wsdl proxy for Remarketing

Add Sitelink2 Ad Extension

Add Budget

Add Budget Id in Campaign for Shared Budget

Add Scheduling in Ad Extensions

Update wsdl proxy to latest version

Add Remarketing List and Ad Group Remarketing List Association

Add Expanded Text Ad

Add Structured Snippet Ad Extension

Update wsdl proxy to latest version

Fix Reporting Service default version bug

Sunset campaign management, bulk, ad intelligence, optimizer services in v9

Add Ad Format Preference in Text Ad

Add Bid Strategy Type in Campaign, AdGroup and Keyword

Updated wsdl proxy to latest version

Bug fixes

Add App Install Ad support

Add state property in OAuthAuthorization classes

Support oauth_tokens initialization in Authentication classes

Updated wsdl proxy to latest version

Changed condition to write delete value for Keyword Bid in bulk

Support suds option in BulkServiceManager and ReportingServiceManager

Updated wsdl proxy to latest version

Bug fixes

Add suds option parameter to support timeout and location settings in soap service

Add timeout logic for bulk upload, bulk download and report download methods

Add retry logic for upload and download status tracking

New exception types to handle bulk and reporting errors

Remove location_target_version parameter from DownloadParameters and SubmitDownloadParameters

Updated wsdl proxy file to latest version

Support Bing Ads API V10 and upgrade bulk format version to 4.0

Compatible with Bing Ads API V9

Add Reporting Service support to SDK 9.3

Bug Fixes

Replace SSLv3 with SSLv23 for TLS support

Add Bing Shopping Campaign Support

Add Native Ads Support

Add App AdExtension support.

Bug Fixes.

First release on PyPI.