Release Notes
Collapse the table of content
Expand the table of content

Release Notes

 

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

For information about the changes to the Bing Ads services included in this release, see the following sections.

New Reporting Columns for Upgraded URLs

The TrackingTemplate and CustomParameters columns for upgraded URLs are added to the following reports.

Report RequestReport FilterReport Column
ProductPartitionPerformanceReportRequestProductPartitionPerformanceReportFilterProductPartitionPerformanceReportColumn
ProductPartitionUnitPerformanceReportRequestProductPartitionUnitPerformanceReportFilterProductPartitionUnitPerformanceReportColumn

For information about the changes to the Bing Ads services included in this release, see the following sections.

Sunset Version 9 Phase I

The Ad Intelligence, Bulk, Campaign Management, and Optimizer Version 9 services were sunset on June 30, 2016. For details on what has changed in version 10, see Migrating from Bing Ads API Version 9 to Version 10. If you have any questions, please feel free to contact support or post something in the Bing Ads API developer forum. Please note that the Customer Billing, Customer Management, and Reporting Version 9 services are still available. Later this summer we will announce details about the upgrade path for those services.

Remarketing Associations

Remarketing in Paid Search lets you improve your return on investment by optimizing your campaigns for specific audiences, which are the people who have visited your website before. Support is added to the Campaign Management and Bulk APIs for associating remarketing lists with ad groups in your search advertising campaigns. For more information about Remarketing in Paid Search, see Reach your audience.

System_CAPS_ICON_note.jpg Note

The Bing Ads API does not support the creation of new remarketing lists. After you have set up Universal Event Tracking (UET) and created a remarketing list in the Bing Ads web application, you can use the new APIs below to manage remarketing list associations and optimize bids per association.

System_CAPS_ICON_note.jpg Note

The Reporting API already lets you get remarketing data with the AudiencePerformanceReportRequest.

Bulk API Version 10 for Remarketing Associations

The following Bulk records are added for retrieving remarketing lists and managing remarketing list associations.

The new Remarketing Targeting Setting field is also added to the existing Ad Group record.

You can download these records using the respective RemarketingLists, AdGroupRemarketingListAssociations, and AdGroups BulkDownloadEntity values.

Campaign Management API Version 10 for Remarketing Associations

The following operations are added for retrieving remarketing lists (RemarketingList) and managing remarketing list associations (AdGroupRemarketingListAssociation).

Bid Strategy Type

Support is added to the Campaign Management and Bulk APIs for setting up the bid strategy type for how you want to manage your bids.

System_CAPS_ICON_note.jpg Note

Not everyone has this feature yet. If you don’t, don’t worry. It’s coming soon.

System_CAPS_ICON_note.jpg Note

This feature is not supported for campaigns of type Shopping.

System_CAPS_ICON_tip.jpg Tip

You can set your campaign’s bid strategy to Enhanced CPC and then, at any time, set an individual ad group’s or keyword’s bid strategy to Manual CPC.

Bulk API Version 10 for Bid Strategy Type

The new Bid Strategy Type field is added to these existing Bulk records.

You can download these records using the respective AdGroups, Campaigns, and Keywords BulkDownloadEntity values.

Campaign Management API Version 10 for Bid Strategy Type

The BiddingScheme object is added and defines the base object of a bidding scheme for how you want to manage your bids. A bidding scheme is known as a bid strategy type in the Bing Ads web application.

Do not try to instantiate a BiddingScheme. You can create one or more following objects that derive from it.

The following objects derived from BiddingScheme are reserved for future use.

Reporting API Version 9 for Bid Strategy Type

The new BidStrategyType column and BidStrategyTypeReportFilter are added to the following reports.

Report RequestReport FilterReport Column
KeywordPerformanceReportRequestKeywordPerformanceReportFilterKeywordPerformanceReportColumn
ShareOfVoiceReportRequestShareOfVoiceReportFilterShareOfVoiceReportColumn
SitePerformanceReportRequestSitePerformanceReportFilterSitePerformanceReportColumn

Structured Snippets

Support is added to the Campaign Management and Bulk APIs for managing structured snippet ad extensions. A structured snippet ad extension pairs one header with between 3 and 10 snippet values that tell customers more about your business.

In the following example, Courses is the header, and .NET, Java, Python, and PHP are examples of individual values.

Courses: .NET, Java, Python, PHP

You can associate a structured snippet ad extension with one or more campaigns and ad groups. Each campaign or ad group can be associated with between 1 and 20 structured snippet ad extensions. A text ad will only include one structured snippet (one headline with 3 - 10 values) per impression.

System_CAPS_ICON_note.jpg Note

The Reporting API already lets you get ad extensions data, for example with the AdExtensionByAdReportRequest.

Bulk API Version 10 for Structured Snippets

The following Bulk records are added for managing structured snippets.

You can download these records using the respective StructuredSnippets, AdGroupStructuredSnippets, and CampaignStructuredSnippets BulkDownloadEntity values.

Campaign Management API Version 10 for Structured Snippets

You can use the existing Campaign Management operations such as AddAdExtensions and SetAdExtensionsAssociations for managing structured snippets (StructuredSnippetAdExtension).

Shared Budget

Shared budgets are coming to Bing Ads in the third quarter of calendar year 2016. With shared budgets you will be able to set a single daily budget that can be used by any campaign within the same account. This will enable you to efficiently distribute a single daily budget across all campaigns or across a defined group of campaigns within your Bing Ads account.

System_CAPS_ICON_note.jpg Note

Although support for shared budgets is not yet available, a preview of the service contract is added to the Campaign Management and Bulk APIs.

System_CAPS_ICON_important.jpg Important

To avoid a breaking change when updating campaigns, you might need to prepare for the introduction of shared budgets in the Bing Ads platform, even if you do not plan to use shared budgets right away.

In the context of shared budgets, the budget amount is a read-only property that is always returned regardless of whether or not the campaign uses a shared budget. When a campaign is associated to a shared budget the amount returned is that of the shared budget. If you try to update the budget amount of a campaign that has a shared budget, the service will return the CampaignServiceCannotUpdateSharedBudget error code. You can continue to update the budget amount for unshared budgets, and you can make other updates to the campaign regardless of whether the budget is shared. To determine whether the campaign uses a shared budget, check the value of the BudgetId element (Campaign object) or Budget Id field (Bulk (Campaign object) record).

Bulk API Version 10 for Shared Budget

The Budget Bulk record is added for managing shared budgets.

The new Budget Id and Budget Name fields are also added to the existing Campaign record.

You can download these records using the respective Budgets and Campaigns BulkDownloadEntity values.

Campaign Management API Version 10 for Shared Budget

The following operations are added for managing shared budgets (Budget).

Bing Shopping Campaign Countries

The GetBSCCountries operation is added, and returns the list of supported sales country codes for Bing Shopping campaigns.

Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, and Python SDKs are updated with support for the following features.

  • The Ad Intelligence, Bulk, Campaign Management, and Optimizer Version 9 service proxies have been removed from the SDKs, because each service sunsets on June 30, 2016. Important: The default version for the ServiceClient in the Python SDK has been updated from v9 to v10.
  • Service proxies are added to the Campaign Management and Bulk APIs for associating remarketing lists with ad groups in your search advertising campaigns.
  • Service proxies are added to the Campaign Management, Bulk, and Reporting APIs for managing bid strategy types. In addition to service proxy updates, support for the new Bid Strategy Type field is added to each of the BulkCampaign, BulkAdGroup, and BulkKeyword SDK objects.
  • Support for the Ad Format Preference field is added to the BulkTextAd SDK object. For more information about managing the ad format preference in bulk, see the Text Ad record.
  • Service proxies are added to the Campaign Management and Bulk APIs for managing structured snippet ad extensions.
  • Service proxies are added to the Campaign Management and Bulk APIs for managing shared budgets.
  • Service proxies are added to the Campaign Management API for getting the list of supported sales country codes for Bing Shopping campaigns.

For information about the changes to the Bing Ads services included in this release, see the following sections.

Reporting Version 9

Reporting Status Filters

You can filter the negative keyword conflict report by the status of your account, campaign, ad group, or keyword. The NegativeKeywordConflictReportFilter is added to the NegativeKeywordConflictReportRequest data object.

Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, and Python SDKs are updated with support for the following features.

  • Reporting API interface updates for the month of May.
  • Added support to download and upload the Bulk record type App Install Ad by reading and writing the new BulkAppInstallAd SDK object.
  • Added support for setting the 'state' parameter in OAuthAuthorization subclasses to help prevent cross site request forgery (CSRF).
  • Added support for constructing OAuthAuthorization subclasses using an existing access token.

Additionally the Java SDK added Bulk format version verification. The BulkFileReader will now return UnsupportedOperationException if the Bulk format version in the given CSV file is not supported by the corresponding version of Bulk API. For example, Bulk API V10 only supports Bulk format version 4.0.

For information about the changes to the Bing Ads services included in this release, see the following sections.

Campaign Management Version 10

Ad Type for Get Ads Operations

Once app install ads are available, you can set the AdTypes request element of the following operations to retrieve the AppInstallAd objects.

System_CAPS_ICON_important.jpg Important

In March the GetAdsByAdGroupId, GetAdsByEditorialStatus, and GetAdsByIds operations were released with a single AdType request element. This service bug was fixed in the April release, and in order to retrieve AppInstallAd objects, you must specify the AdTypes element as an array of AdType. The AdTypes element is still optional, and if not specified the get ads operations return TextAd and ProductAd objects by default.

Reporting Version 9

Search Term Campaign Type

The CampaignType column is added to the SearchQueryPerformanceReportColumn value set. When you include this column in your SearchQueryPerformanceReportRequest, the report data will include a CampaignType column with possible values of Shopping and Search & content. Note: The AudiencePerformanceReportFilter and CallDetailReportFilter data objects are also new. They come with the new status filters as described in the table below.

Reporting Status Filters

One or more of the AccountStatus, AdGroupStatus, AdStatus, CampaignStatus, and KeywordStatus status filters have been added to the following reports. Note: The AudiencePerformanceReportFilter and CallDetailReportFilter data objects are also new. They come with the new status filters as described in the table below.

Report RequestReport FilterStatus Filters Added
AccountPerformanceReportRequestAccountPerformanceReportFilterAccountStatus
AdDynamicTextPerformanceReportRequestAdDynamicTextPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

KeywordStatus
AdExtensionByAdReportRequestAdExtensionByAdReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
AdExtensionByKeywordReportRequestAdExtensionByKeywordReportFilterAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
AdExtensionDetailReportRequestAdExtensionDetailReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
AdGroupPerformanceReportRequestAdGroupPerformanceReportFilter AccountStatus

CampaignStatus
AdPerformanceReportRequestAdPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
AgeGenderDemographicReportRequestAgeGenderDemographicReportFilterAccountStatus

AdGroupStatus

CampaignStatus
AudiencePerformanceReportRequestAudiencePerformanceReportFilterAccountStatus

AdGroupStatus

CampaignStatus
CallDetailReportRequestCallDetailReportFilterAccountStatus

AdGroupStatus

CampaignStatus
CampaignPerformanceReportRequestCampaignPerformanceReportFilterAccountStatus
ConversionPerformanceReportRequestConversionPerformanceReportFilterAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
DestinationUrlPerformanceReportRequestDestinationUrlPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
GeoLocationPerformanceReportRequestGeoLocationPerformanceReportFilterAccountStatus

AdGroupStatus

CampaignStatus
GoalsAndFunnelsReportRequestGoalsAndFunnelsReportFilterAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
KeywordPerformanceReportRequestKeywordPerformanceReportFilterAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
ProductDimensioPerformanceReportRequestProductDimensionPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
ProductOfferPerformanceReportRequestProductOfferPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
ProductPartitionPerformanceReportRequestProductPartitionPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
ProductPartitionUnitPerformanceReportRequestProductPartitionUnitPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
ProductTargetPerformanceReportRequestProductTargetPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus

KeywordStatus
PublisherUsagePerformanceReportRequestPublisherUsagePerformanceReportFilterAccountStatus

AdGroupStatus

CampaignStatus
RichAdComponentPerformanceReportRequestRichAdComponentPerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
SearchQueryPerformanceReportRequestSearchQueryPerformanceReportFilterAccountStatus

AdGroupStatus

KeywordStatus
ShareOfVoiceReportRequestShareOfVoiceReportFilterAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
SitePerformanceReportRequestSitePerformanceReportFilterAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
TacticChannelReportRequestTacticChannelReportFilterAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
TrafficSourcesReportRequestTrafficSourcesReportFilterAccountStatus

The AccountStatusReportFilter value set is added with possible values of Active, Paused, and Inactive. The KeywordStatusReportFilter value set is added with possible values of Active, Paused, and Deleted. The Paused value is added to the AdStatusReportFilter value set. The Suspended value is added to the CampaignStatusReportFilter value set.

One or more of the AccountStatus, AdGroupStatus, AdStatus, CampaignStatus, and KeywordStatus status columns have been added to the following report column value sets.

Report RequestReport Column SetStatus Columns Added
AccountPerformanceReportRequestAccountPerformanceReportColumnAccountStatus
AdDynamicTextPerformanceReportRequestAdDynamicTextPerformanceReportColumnAccountStatus

AdGroupStatus

AdStatus

KeywordStatus
AdExtensionByAdReportRequestAdExtensionByAdReportColumnAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
AdExtensionByKeywordReportRequestAdExtensionByKeywordReportColumnAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
AdExtensionDetailReportRequestAdExtensionDetailReportColumnAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
AdGroupPerformanceReportRequestAdGroupPerformanceReportColumn AccountStatus

CampaignStatus
AdPerformanceReportRequestAdPerformanceReportColumnAccountStatus

AdGroupStatus

CampaignStatus
AgeGenderDemographicReportRequestAgeGenderDemographicReportColumnAccountStatus

AdGroupStatus

CampaignStatus
AudiencePerformanceReportRequestAudiencePerformanceReportColumnAccountStatus

AdGroupStatus

CampaignStatus
CallDetailReportRequestCallDetailReportColumnAccountStatus

AdGroupStatus

CampaignStatus
CampaignPerformanceReportRequestCampaignPerformanceReportColumnAccountStatus
ConversionPerformanceReportRequestConversionPerformanceReportColumnAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
DestinationUrlPerformanceReportRequestDestinationUrlPerformanceReportColumnAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
GeoLocationPerformanceReportRequestGeoLocationPerformanceReportColumnAccountStatus

AdGroupStatus

CampaignStatus
GoalsAndFunnelsReportRequestGoalsAndFunnelsReportColumnAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
ProductDimensioPerformanceReportRequestProductDimensionPerformanceReportColumnAdStatus
ProductOfferPerformanceReportRequestProductOfferPerformanceReportColumnAccountStatus

AdGroupStatus

CampaignStatus
ProductPartitionPerformanceReportRequestProductPartitionPerformanceReportColumnAdStatus
ProductPartitionUnitPerformanceReportRequestProductPartitionUnitPerformanceReportColumnAdStatus
ProductTargetPerformanceReportRequestProductTargetPerformanceReportColumnAdStatus
PublisherUsagePerformanceReportRequestPublisherUsagePerformanceReportColumnAccountStatus

AdGroupStatus

CampaignStatus
RichAdComponentPerformanceReportRequestRichAdComponentPerformanceReportColumnAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
SearchQueryPerformanceReportRequestSearchQueryPerformanceReportColumnAccountStatus

AdGroupStatus

KeywordStatus
ShareOfVoiceReportRequestShareOfVoiceReportColumnAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
SitePerformanceReportRequestSitePerformanceReportColumnAccountStatus

AdGroupStatus

AdStatus

CampaignStatus
TacticChannelReportRequestTacticChannelReportColumnAccountStatus

AdGroupStatus

CampaignStatus

KeywordStatus
TrafficSourcesReportRequestTrafficSourcesReportColumnAccountStatus

Site Placements Sunset in Campaign Management Versions 9 and 10

Site placement features are now sunset. This completes the content ads deprecation, which we announced last summer in the blog article Changes coming to Bing Ads due to Content Ads Deprecation.

The site placement ad groups in your account have been removed from Bing Ads, and new errors will be thrown for the following operations:

Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, and Python SDKs are updated with support for the Campaign Management API and Reporting API interface changes in April.

The Bing Ads Python SDK is updated with the following bug fixes.

  • Fixed the bug where the BulkFileReader failed to parse the 'Sitelink Ad Extension' record type if 'Sitelink Extension Order' column is empty.
  • Fixed the bug that setting any other supported key value pair except of 'location' to the suds_option parameter does not take effect in BulkServiceManager and ReportingServiceManger methods.
  • Fixed the bug where 'BulkKeyword.Bid' is defaulted to deleting the keyword bid. With this fix, keyword bids are unchanged by default. If you want to delete the keyword level bid, and inherit from the ad group level bid, you can explicitly set the 'Bid' to 'None'. It is also important to note that previously if you had explicitly set the 'Bid' to 'None', the keyword bid would not have been updated. For more information, see the BulkKeywordsAds.py code example on GitHub.

For information about the changes to the Bing Ads services included in this release, see the following sections.

Bulk Version 10

The following bulk records are added for managing callout and review extensions.

Campaign Management Version 10

Callout and Review Extensions

The following objects are added for managing callout and review extensions.

App Install Ads

The AppInstallAd object is added and reserved for future use.

When app install ads are available, you can set the AdType request element of the following operations to retrieve the AppInstallAd objects.

System_CAPS_ICON_important.jpg Important

In March the GetAdsByAdGroupId, GetAdsByEditorialStatus, and GetAdsByIds operations were released with a single AdType request element. This service bug was fixed in the April release, and in order to retrieve AppInstallAd objects, you must specify the AdTypes element as an array of AdType. The AdTypes element is still optional, and if not specified the get ads operations return TextAd and ProductAd objects by default.

System_CAPS_ICON_note.jpg Note

Not everyone has this feature yet. If you don’t, don’t worry. It’s coming soon.

Customer Management Version 9

The BusinessAddress, TaxId, and TaxIdStatus elements are added to the AdvertiserAccount Data Object.

System_CAPS_ICON_note.jpg Note

Not everyone has this feature yet. If you don’t, don’t worry. It’s coming soon.

The new BusinessAddress, TaxId, and TaxIdStatus elements are not returned by default when calling the GetAccount and SearchAccounts operations. The IncludeTaxDetails element is added as optional for the GetAccount and SearchAccounts request messages, and is used to gate the new elements for forward compatibility. To include the BusinessAddress, TaxId, and TaxIdStatus elements, set the value of IncludeTaxDetails to True.

Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, and Python SDKs are updated with support for the following new features.

  • Added proxy support for Bulk, Campaign Management, Customer Management, and Reporting service updates from February through March.
  • Added retry and timeout processing in BulkServiceManager and ReportingServiceManager. The retry feature is an internal implementation. For information on getting started with using the new timeout feature, see Using BulkServiceManager (C# | Java | Python) and Using ReportingServiceManager (C# | Java | Python).
  • Added more exception handling for both download and upload methods in BulkServiceManager and ReportingServiceManager.
  • Added support for using the SDK with either the Sandbox or Production environment by specifying the Bing Ads environment parameter in BulkServiceManager/ReportingServiceManager and BulkOperation/ReportingDownloadOperation. Previously you could only set the environment globally or through the ServiceClient, so this option provides additional flexibility. For more information, see Configuring Sandbox (C# | Java | Python).

For a full list of March updates, please see the release notes on GitHub (.NET | Java | Python).

For more information on getting started with the SDKs, reference, and samples, please see Bing Ads Client Libraries.

For information about the changes to the Bing Ads services included in this release, see the following sections.

Reporting Version 9

New columns are added to the following reports.

The following columns are added to the AgeGenderDemographicReportColumn Value Set.

  • EstimatedClicks
  • EstimatedConversions
  • EstimatedConversionRate
  • EstimatedImpressions

The following columns are added to the ProductDimensionPerformanceReportColumn Value Set.

  • SellerName
  • OfferLanguage
  • CountryOfSale

The following columns are added to the ProductPartitionPerformanceReportColumn Value Set.

  • OfferLanguage
  • CountryOfSale

For information about the changes to the Bing Ads services included in this release, see the following sections.

Bing Ads API Version 10

Bing Ads API Version 10 Ad Insight, Bulk, and Campaign Management services are now generally available in production and sandbox.

Web Service NameProductionSandbox
Ad Insighthttps://adinsight.api.bingads.microsoft.com/Api/Advertiser/AdInsight/V10/AdInsightService.svchttps://adinsight.api.sandbox.bingads.microsoft.com/Api/Advertiser/AdInsight/V10/AdInsightService.svc
Bulkhttps://bulk.api.bingads.microsoft.com/Api/Advertiser/CampaignManagement/V10/BulkService.svchttps://bulk.api.sandbox.bingads.microsoft.com/Api/Advertiser/CampaignManagement/V10/BulkService.svc
Campaign Managementhttps://campaign.api.bingads.microsoft.com/Api/Advertiser/CampaignManagement/V10/CampaignManagementService.svchttps://campaign.api.sandbox.bingads.microsoft.com/Api/Advertiser/CampaignManagement/V10/CampaignManagementService.svc

Campaign Management Version 10

The CampaignType element is now required when calling GetCampaignsByAccountId and GetCampaignsByIds.

Software Development Kit (SDK) Updates

The Bing Ads .NET, Java, and Python SDKs are updated with support for Bing Ads API Version 10. For more information, see Bing Ads Client Libraries.

Community Additions

ADD
Show:
© 2016 Microsoft