通过

必应广告 API 发行说明

  • 项目

有关按月对必应广告 API 版本 13 的更改的信息，请参阅下文。

注意

作为最佳做法，我们建议在旺季之外完成重要的开发工作。

最近和即将) (重大更改

重要

以下即将发生的更改可能需要你采取措施，以避免服务中断或功能丢失。

多重身份验证 API 通知

重要

2022 年 6 月，我们引入了 多重身份验证 作为必应广告的要求。 可能需要更改代码才能符合此要求。 Microsoft广告公司正在 10 月初进行技术强制检查。

此博客文章 概述了确保合规性应采取的步骤。

有关详细信息，请参阅 多重身份验证要求 指南。

2024 年 11 月

请参阅下文，了解本日历月的必应广告 API 更新。

REST API 文档更新

我们很高兴地宣布，我们的 API 文档已更新为包含新的 REST API。 你将能够在文档中的 REST 和 SOAP API 之间切换。 有关详细信息，请参阅有关新 REST API 的 博客文章 。

必应广告 API SDK 汇报

必应广告 .NET 和 Java SDK 已更新。 有关详细信息，请参阅 Microsoft Advertising .NET 的发行说明， Java SDK 版本 13.0.22。

2024 年 9 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

批量服务

必应广告 API SDK 汇报

必应广告 Java SDK 已更新。 有关详细信息，请参阅 Microsoft广告 Java SDK 版本 13.0.21.2 的发行说明。

2024 年 7 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

批量服务

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.21 的发行说明。

2024 年 3 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

批量服务

  • 在 BulkCampaign 中禁用 VerifiedTrackingSettings 。 BulkCampaign 中 Perfromance Max 的新字段 AutoGeneratedImageOptOut 和 AutoGeneratedTextOptOut 。
  • 为帐户级别负关键字列表添加大容量映射 BulkAccountNegativeKeywordList、 BulkAccountNegativeKeywordListAssociation 和 BulkAccountSharedNegativeKeyword 。
  • 支持 BulkCampaign 中性能最大值的 PageFeedId。
  • 为 TargetCostPerSale 添加大容量映射。
  • 为 AutoBidding、 BulkSeasonalityAdjustment 和 BulkDataExclusion 添加大容量映射。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.19 的发行说明。

2023 年 11 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

批量服务

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.18 的发行说明。

2023 年 8 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

  • 市场活动管理 API：AdGroup 级别的 GenreCriterion，市场活动级别的 DealCriterion。
  • 批量 API：LogoAdExtensions。

批量服务

  • AdGroupGenreCriterion 和 CampaignDealCriterion 的批量支持。
  • BulkCampaign 中的新字段 DestinationChannel 和 IsMultiChannelCampaign，BulkResponsiveAds 中的 VerifiedTrackingData。
  • 为 ImageAsset 添加了 TargetWidth 和 TargetHeight 的映射。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.17 的发行说明。

2023 年 6 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

批量服务

  • 批量支持 PMax 市场活动：AssetGroup、AssetGroupListingGroup、AudienceGroup、AudienceGroupAssetGroupAssociation、CampaignNegativeWebPage。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.16 的发行说明。

2022 年 12 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

批量服务

  • OnlineConversionAdjustment 的批量支持

  • 对酒店广告实体的批量支持，即 HotelAdvanceBookingWindowCriterion、HotelCheckInDayCriterion、HotelCheckInDateCriterion、HotelDateSelectionTypeCriterion、HotelLengthOfStayCriterion 和 HotelListingGroup

  • BulkAdGroup 中对 UseOptimizedTargeting、HotelAdGroupType、CommissionRate 和 PercentCpcBid 的批量支持

重要

将弃用 UseOptimizedTargeting。 请改用 UsePredictiveTargeting 。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.15 的发行说明。

2022 年 6 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

批量服务

  • 对 CampaignConversionGoal、AdCustomizerAttribute、CampaignAdCustomizerAttribute、AdGroupAdCustomizerAttribute、KeywordAdCustomizerAttribute 的批量支持，以及批量源中的计划支持。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.14 的发行说明。

2022 年 1 月

请参阅下文，了解本日历月的必应广告 API 更新。

新的 API 接口

批量服务

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.13 的发行说明。

2021 年 11 月

请参阅下文，了解本日历月的必应广告 API 更新。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.12 的发行说明。

2021 年 8 月

请参阅下文，了解本日历月的必应广告 API 更新。

Google Ads 导入实体映射

市场活动管理 GetImportEntityIdsMapping 服务操作现在支持从 Google Ads 到Microsoft广告的广告组、广告和关键字 (keyword) ID 映射。 以前只有市场活动 ID 映射可用。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.11 的发行说明。

2021 年 7 月

请参阅下文，了解本日历月的必应广告 API 更新。

多媒体广告

市场活动管理 ResponsiveAd 对象支持多媒体广告。

ResponsiveAd 对象用于搜索网络中的多媒体广告和Microsoft受众网络中的受众广告。

大多数支持的属性都相同，但有一些关键区别。 有关详细信息，请参阅响应式广告 备注。

无限制和开放式插入顺序

客户计费插入 Order 对象支持无限制和开放式插入订单。

对于开放式插入顺序，可以将 EndDate 元素设置为 nil 或空。

对于无限制的预算插入订单，可以将 SpendCapAmount 元素设置为 nil 或空。

2021 年 6 月

请参阅下文，了解本日历月的必应广告 API 更新。

页面访问者规则正常窗体扩展

如果已对再营销列表使用 页面访问者规则 ，请阅读此部分，了解所需更改。

再营销规则是用于确定要添加到再营销列表的人员的条件。 可以为自定义事件、页面访问者、未访问其他页面的页面访问者和访问过另一个页面的页面访问者创建规则。

对于页面访问者规则，以前Microsoft广告仅支持 (DNF) 的普通形式。 首先，在每个规则项组中，使用逻辑 AND 运算符联接同一页的规则项条件。 然后，使用逻辑 OR 运算符联接规则项组列表中的每个结果。 换句话说，如果在任何规则项组中满足所有指定的规则项条件，则将用户添加到再营销列表。

  • 规则 1 或规则 2
  • (规则 1 和规则 2) 或规则 3
  • (规则 1 和规则 2) 或 (规则 3 和规则 4)

我们正在引入对 CNF) (连接正常形式的支持。 首先，在每个规则项组中，使用逻辑 OR 运算符联接同一页的规则项条件。 然后，使用逻辑 AND 运算符联接规则项组列表中的每个结果。 换句话说，如果满足所有规则项组中的任何指定规则项条件，则将用户添加到再营销列表。

  • 规则 1 和规则 2
  • (规则 1 或规则 2) 和规则 3
  • (规则 1 或规则 2) and (规则 3 或规则 4)

该添加仅适用于 PageVisitorsRule，不包括 CustomEventsRule、PageVisitorsWhoDidNotVisitAnotherPageRule 或 PageVisitorsWhoVisitedAnotherPageRule。

重要

新页面访问者规则的默认普通形式仍为 DNF。 但是，必须确保应用程序可以适当地读取和区分 CNF 和 DNF。 应用程序不应再假定该规则具有分离性。

有关如何获取和设置新的普通窗体属性的详细信息，请参阅参考文档。

  • 市场活动管理 API：PageVisitorsRule 的 NormalForm 元素可以设置为 Conjunctive 或 Disjunctive。
  • 批量 API：继续使用批量文件中的 “再营销规则 ”列。 对于上传，可以选择将字符串的格式设置为 CNF 或 DNF。 对于下载，应用程序必须读取同一列中的字符串，并区分 CNF 和 DNF。

所需的转换目标类别

如果已使用转换目标，请阅读有关所需更改的此部分。

你可以对转换目标进行分类，但对业务有意义。 目标类别不会影响性能 - 它们可帮助你对目标及其性能指标进行细分。

以前，必应广告 API 不需要转换目标类别。 根据目标类型，默认类别设置为“下载”、“无”、“其他”或“购买”。

自 2021 年 6 月起 () 添加或更新自定义事件、脱机转换或 URL 目标时，必须设置目标类别，否则市场活动管理服务将返回错误。 没有更改其他目标类型的默认类别，如表所示。

目标类型 默认值之前 默认在之后
EventGoal
OfflineConversionGoal
UrlGoal		 None 无默认值;服务返回错误
DurationGoal
PagesViewedPerVisitGoal		 其他 其他
InStoreTransactionGoal 购买 购买
AppInstallGoal 下载 下载

有关详细信息，请参阅有关 转换目标类别的 API 文档。

减少了对批量下载的回溯

使用批量 API 下载市场活动 时，只能请求获取自特定日期和时间以来已修改 (添加、更新、删除) 的设置。

以前，如果设置的日期和时间早于 90 天，将返回错误。

最长回溯期从 2021 年 9 月 1 日的 90 天减少到 30 天。 现在，如果设置的日期和时间早于 30 天，将返回错误。

RSA 的资产性能标签

获取或下载响应式搜索广告时，资产性能标签作为只读属性提供。

这可让你了解为响应式搜索广告设置的标题和说明资产的性能如何。

下表介绍了可能的值。

值 说明
低 此资产的性能较低，建议替换此资产以提高广告性能。
Good 此资产性能良好。 建议保留此资产并添加更多资产以提高广告性能。
最好 此资产的性能是最好的，建议添加更多类似的资产。
未分级 对此资产没有任何性能评级。 这可能是由于资产处于非活动状态，没有足够的信息来确定其性能，或者没有足够的类似资产与之进行比较。
学习 正在积极评估资产的性能。 评估完成后，资产评级将为“低”、“良好”、“最佳”或“未评级”。

有关详细信息，请参阅 响应式搜索广告 记录 (批量 API) 和 AssetLink (市场活动管理 API) 。

动态搜索广告

不能再添加、更新或检索仅支持动态搜索广告的市场活动。 现有市场活动的市场活动类型已从“DynamicSearchAds”更新为“搜索”。 广告组现在被视为“动态”广告组，但没有任何结构性更改，即它们包含与以前相同的自动目标和动态搜索广告。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.10 的发行说明。

2021 年 5 月

请参阅下文，了解本日历月的必应广告 API 更新。

动态搜索广告

不能再使用 DynamicSearchAds 市场活动类型添加新市场活动。 市场活动类型在 5 月和 6 月从“DynamicSearchAds”更新为“搜索”。 你仍然可以在市场活动类型更新之前和之后查看和编辑这些市场活动。

2021 年 4 月

请参阅下文，了解本日历月的必应广告 API 更新。

项目组合出价策略

注意

还不是每个人都有此功能。 如果没有，请不要担心，它即将推出！

项目组合出价策略是一项自动出价功能，可跨多个市场活动管理竞价，这些市场活动都致力于实现同一目标。

我们会自动调整你的出价，以平衡具有相同策略的业绩不佳和过度表现的营销活动，无论是最大化转化率、点击次数、目标印象份额还是其他绩效目标。 对于希望确保其整个预算得到有效使用的广告客户来说，组合出价策略可能是一个不错的选择。

只需选择出价策略类型，并在项目组合中包含具有补充预算的营销活动。 Microsoft广告将根据整个项目组合的性能调整出价。 如果项目组合包含具有共享预算的任何市场活动，则应包括共享同一预算的所有市场活动。

项目组合出价策略在考虑一个目标时效果最佳，使用互补的营销活动和出价策略类型。 不能更改项目组合的出价策略类型。 如果希望项目组合中的市场活动使用不同的出价策略，则可以将其移动到另一个项目组合。 选择市场活动类型后，项目组合只能包含该类型的市场活动。

市场活动管理 BidStrategy 对象和批量投标策略记录支持项目组合 投标策略 。

目标展示次数份额

注意

还不是每个人都有此功能。 如果没有，请不要担心，它即将推出！

目标展示次数份额是一种自动出价策略，可用于获取要在其中显示广告的广告位置的目标展示次数份额。

市场活动管理 BidStrategy、 Campaign 和 TargetImpressionShareBiddingScheme 对象以及批量 出价策略 和 市场活动 记录支持目标印象共享。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.9 的发行说明。

2021 年 3 月

请参阅下文，了解本日历月的必应广告 API 更新。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.8 的发行说明。

2020 年 12 月

请参阅下文，了解本日历月的必应广告 API 更新。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.7 的发行说明。

2020 年 11 月

请参阅下文，了解本日历月的必应广告 API 更新。

拍卖见解绝对最高页速率

页面速率的绝对顶部定义为广告在自然搜索结果上方显示为第一个广告的次数，除以它实际收到的总印象数。 页面绝对顶部的广告往往会收到更多点击。

默认情况下不返回 AbsoluteTopOfPageRate 元素。 有关详细信息，请参阅 AuctionInsightKpiAdditionalField 值集。

响应式广告的印象跟踪 URL

1x1 展示跟踪像素的 URL。 每个像素将向第三方广告报告工具Microsoft受众网络印象。 每个响应式广告最多可以包含 2 个展示跟踪 URL。

对于每个Microsoft受众网络印象，Microsoft将对 URL 执行 ping 操作，以便在第三方广告报告工具中启用印象跟踪。 不支持高级用户跟踪，例如转换跟踪或基于 Cookie 或 IP 地址的跟踪。

市场活动管理 ResponsiveAd 对象和批量 响应式广告 记录支持展示跟踪 URL。

使用市场活动管理服务获取广告时，默认情况下不返回 ImpressionTrackingUrls 元素。 有关详细信息，请参阅 AdAdditionalField 值集。

传单广告扩展

传单扩展使广告客户能够向潜在客户分发产品或商店目录 (传单) 。 它们可以在广泛的查询（如“每周交易”或“每周销售额”）上突出显示，从而鼓励购物者点击你的广告，而不是竞争对手的广告。 根据其性质，它们有助于更好地通知搜索者，因此，提高用户参与度，例如点击率。

市场活动管理 FlyerAdExtension 对象和批量 传单广告扩展记录支持传单扩展 。

注意

功能试点 (GetCustomerPilotFeatures 返回 802) ，客户可以使用传单扩展。

突出指标

借助突出指标，可以更全面地了解广告在搜索结果页面上的显示位置。 这些清晰的见解可帮助你更好地优化出价策略。

将 AbsoluteTopImpressionRatePercent 和 TopImpressionRatePercent 列添加到以下报表列值集中。

2020 年 10 月

请参阅下文，了解本日历月的必应广告 API 更新。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.6 的发行说明。

2020 年 8 月

请参阅下文，了解本日历月的必应广告 API 更新。

报表格式版本

FormatVersion 元素将添加到 ReportRequest 数据对象。

某些字段的数据格式可以在当前 API 版本中更新，而不会中断现有客户端应用程序。 有关 格式版本 1.0 和 2.0 之间的差异，请参阅报表格式版本技术指南。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.5 的发行说明。

2020 年 7 月

请参阅下文，了解本日历月的必应广告 API 更新。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.4 的发行说明。

2020 年 6 月

请参阅下文，了解本日历月的必应广告 API 更新。

客户列表

客户列表是你为启用客户匹配而编译的一组客户联系信息。

注意

客户列表可用于功能试点 (GetCustomerPilotFeatures 返回 579) 。

客户列表可通过批量 API 获取，但尚未通过市场活动管理 API 提供。 使用批量 API，可以对客户列表目标或排除项使用以下记录类型。

有关访问群体的概述和详细信息，请参阅 受众 API 技术指南。

2020 年 5 月

请参阅下文，了解本日历月的必应广告 API 更新。

组合列表

组合列表是从多个现有访问群体的组合中创建的受众。

注意

功能试点 (GetCustomerPilotFeatures 返回 618) ，客户可以使用组合列表。

使用批量 API，可以将以下记录类型用于组合列表目标或排除项。

使用市场活动管理 API，可以使用 CombinedList 对象。

有关访问群体的概述和详细信息，请参阅 受众 API 技术指南。

并行跟踪

2020 年 5 月 31 日之后创建的所有帐户都需要并行跟踪。 在 2020 年 11 月之前，你可以为 2020 年 6 月 1 日之前创建的帐户启用和禁用该功能，即将 帐户属性 设置为 true 或 false。 到 2020 年 11 月底，所有帐户都将启用并行跟踪，并且该值只能设置为 true。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.3 的发行说明。

2020 年 4 月

请参阅下文，了解本日历月的必应广告 API 更新。

促销广告扩展

促销扩展插件在文本广告中突出显示特殊销售和优惠。 通过突出产品/服务，潜在客户更有可能点击你的广告，从而帮助你创造更多的销售。

可以将促销广告扩展插件与帐户或帐户中的市场活动及广告组相关联。 (帐户、市场活动或广告组) 的每个实体最多可与 20 个促销广告扩展相关联。

注意

在功能试点 (GetCustomerPilotFeatures 返回 720) ，客户可以使用促销扩展。

用于促销广告扩展的批量 API

使用批量 API，使用以下记录类型来管理促销广告扩展。

促销广告扩展的市场活动管理 API

通过市场活动管理 API，使用 PromotionAdExtension 对象，例如，通过 AddAdExtensions 服务操作。

放置排除列表

对帐户级网站排除的支持已添加到市场活动管理 API。 可以从共享网站排除列表 (PlacementExclusionList) 添加和删除负面网站 (NegativeSite) 。 网站排除列表可以共享或与多个广告帐户相关联。

注意

只能在重新设计的Microsoft广告 UI 中查看网站排除列表，即通过工具 -> 共享库 -> 网站排除列表。 如果未看到，请在登录时查找“试用新Microsoft广告”提示。 若要使用重新设计的Microsoft广告，还必须处于 UI 试点 (GetCustomerPilotFeatures 返回 522) 。

可以通过共享实体和共享列表操作（例如 AddSharedEntity 和 AddListItemsToSharedList）来管理新的网站排除列表。 以前，这些操作专用于负关键字 (keyword) 列表，现有应用程序应在不更改任何代码的情况下工作。 有关更多详细信息，请参阅 负面站点 技术指南。

Microsoft受众网络的印象共享

AudienceImpressionLostToBudgetPercent、AudienceImpressionLostToRankPercent 和 AudienceImpressionSharePercent 列将添加到以下值集中。

2020 年 3 月

请参阅下文，了解本日历月的必应广告 API 更新。

广告计划（按帐户时区）

按帐户时区的广告计划可供试点客户使用， (GetCustomerPilotFeatures 返回 655) 。 今年晚些时候，它将在所有客户中推出。

AdScheduleUseSearcherTimeZone 元素在 Campaign 和 Ad Group Campaign Management 对象中可用。 市场活动和广告组批量记录中提供了“广告计划使用搜索程序时区”字段。

每个市场活动的新属性和广告组确定是使用帐户时区还是搜索用户的时区来投放广告。

注意

如果未指定此元素或将其保留为 null，则将设置默认值 true ，并使用搜索用户的时区。 在 2020 年第 2 季度结束或第 3 季度开始之前，将设置新的默认值 false ，并使用帐户时区。

2020 年 2 月

请参阅下文，了解本日历月的必应广告 API 更新。

报表中的目标和目标类型

“目标”和“目标类型”列将添加到以下值集中。

这些列已在 GoalsAndFunnelsReportColumn 值集中提供。

目标是你为所需转换设置的目标的名称，这意味着客户在点击广告后执行的操作。 目标类型是转换目标的类型。 可能的值包括 AppInstall、 Duration、 Event、 InStoreTransaction、 OfflineConversion、 PagesViewedPerVisit 和 Url。

2020 年 1 月

请参阅下文，了解本日历月的必应广告 API 更新。

弃用加速预算交付

从 2020 年 1 月开始，共享和未共享预算的预算类型对于所有 DynamicSearchAds、Shopping 和 Search 市场活动都是只读的，尝试设置的任何预算类型值都将被忽略，而不会返回错误。 以前的预算设置将从加速迁移到标准版，并且 API 将仅返回 DynamicSearchAds、购物市场和搜索市场活动以及所有共享预算的“DailyBudgetStandard”。 你仍然可以将加速预算用于受众市场活动。 不会针对受众市场活动级别的非共享预算迁移预算类型数据。 但是，如果受众市场活动使用共享预算，则预算交付可能会发生上述更改。

操作广告扩展类型

从 2020 年 1 月开始，已弃用 9 种操作类型。 例如，如果将操作类型设置为“浏览”，则不会返回任何错误，但“LearnMore”是检索操作广告扩展时将存储和返回的有效值。 应用程序应使用替换值，而不是弃用的值。

已弃用的操作类型 替换操作类型
浏览 LearnMore
浏览 LearnMore
邮件 ContactUs
NewCars ViewCars
SeeMore LearnMore
StartFree FreeTrial
UsedCars ViewCars
ViewNow LearnMore
VisitSite LearnMore

此外，从 2020 年 1 月开始，将添加两个新的操作类型，即 RenewNow 和 Reorder。 请注意，如果使用市场活动管理 API，则默认返回的操作类型为“未知”。 (设计目标是避免具有严格值集依赖项的客户端发生中断性变更。) 若要确定有效操作类型（即 RenewNow 或 Reorder），请在调用 GetAdExtensionsAssociations 和 GetAdExtensionsByIds 操作时包括 ActionTypesPhase3。

从 2020 年 1 月开始的最后一次更新，对于所有受支持的语言，只有销售和优惠券的本地化文本分别更新为“查看销售”和“获取优惠券”。 这些操作类型的 API 值集保持不变。 有关当前本地化文本，请参阅 Action Ad Extensions 的操作文本。

2019 年 12 月

请参阅下文，了解本日历月的必应广告 API 更新。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.2 的发行说明。

2019 年 11 月

请参阅下文，了解本日历月的必应广告 API 更新。

最终 URL 后缀和自定义参数扩展

最终 URL 后缀现在在所有客户的帐户、市场活动、广告组、广告组条件、广告和关键字 (keyword) 级别提供。 最终 URL 后缀在阶段 3 试点客户的操作、价格和站点链接广告扩展级别提供， (GetCustomerPilotFeatures 返回 636) 。

现在，帐户、市场活动、广告组、广告组条件、广告和关键字 (keyword) 级别最多提供 8 个自定义参数和更长的自定义参数值。 自定义参数限制增加阶段 3 试点操作、价格和 sitelink ad 扩展级别最多提供 8 个自定义参数和更长的自定义参数值， (GetCustomerPilotFeatures 返回 635) 。

有关详细信息，请参阅 使用升级 URL 进行 URL 跟踪。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 13.0.1 的发行说明。

2019 年 10 月

请参阅下文，了解本日历月的必应广告 API 更新。

包括通过转换查看

浏览转换是用户在看到你的广告后进行转换，即使他们没有点击广告。

如果你处于功能试点 (GetCustomerPilotFeatures 返回 616) 默认情况下启用此功能，这意味着性能报告的“所有”转换列中的值将包括查看转换。 如果不想包括视图转换，可以选择禁用它。

可以通过批量和市场活动管理 API 为每个帐户启用或禁用该功能。

可以使用市场活动管理 API 通过转换窗口管理视图，即获取或设置 DurationGoal、EventGoal、PagesViewedPerVisitGoal 或 UrlGoal 的 ViewThroughConversionWindowInMinutes 属性。 调用 GetConversionGoalsByIds 和 GetConversionGoalsByTagIds 时，请务必显式请求 ViewThroughConversionWindowInMinutes 作为附加字段。

注意

查看转换需要 UETTag，因此此属性不适用于 AppInstallGoal、 InStoreTransactionGoal 和 OfflineConversionGoal。

配置文件扩展已启用

确定是否在帐户中扩展LinkedIn配置文件目标，以覆盖与当前目标客户类似的其他客户。

启用个人资料定位扩展允许Microsoft广告向其他客户展示你的广告，就像你当前定位的客户一样。 例如，如果你面向特定的LinkedIn受众细分，我们还将定位没有已确认LinkedIn帐户但与该细分中LinkedIn用户具有相同特征的必应用户。

可以通过批量和市场活动管理 API 为每个帐户启用或禁用该功能。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 12.13.6 的发行说明。

2019年九月

请参阅下文，了解本日历月的必应广告 API 更新。

试验类型

现在，可以通过试验市场活动管理对象中的 ExperimentType 元素或通过试验批量记录中的“试验类型”字段来设置试验拆分类型。

试验拆分类型确定是随机显示试验和原始市场活动中的单个客户广告，还是仅显示一个或另一个客户的广告。

可能的值包括 TrafficBased 和 CookieBased。

基于流量：这也称为基于搜索的选项。 每次客户搜索时，都会随机显示试验中的广告或原始市场活动的广告。 这意味着，如果单个客户多次搜索，他们可以看到来自这两个来源的广告。

基于 Cookie：当单个客户搜索时，我们会显示来自你的试验或原始市场活动的广告，并使用 Cookie 来确保他们以后只会看到来自此源的广告。 基于 Cookie 的选项有一个重要的权衡要考虑：一方面，你可能会获得更准确的数据，因为你要确保单个客户只响应一个源或另一个源。 另一方面，与基于搜索的选项相比，建立统计显著比较数据所需的时间可能更长。

报表中的最终 URL 后缀

FinalUrlSuffix 列将添加到 AdPerformanceReportColumn 值集中。 FinalUrlSuffix 列也可通过 AdGroupPerformanceReportColumn、 CampaignPerformanceReportColumn、 DestinationUrlPerformanceReportColumn 和 KeywordPerformanceReportColumn 值集获得。

最终 URL 后缀是最终 URL 中的一个位置，可在其中添加将附加到登陆页 URL 末尾的参数。

产品负关键字报告

为Microsoft购物活动添加了 ProductNegativeKeywordConflictReportRequest 。 使用此报告可以确认应用于购物市场活动的负面关键字不会过度限制市场活动性能。 可以请求负面关键字以及它们阻止在购物活动中展示的相应产品。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 12.13.5 的发行说明。

2019 年 8 月

请参阅下文，了解本日历月的必应广告 API 更新。

报表中的受众关联级别

AssociationLevel 列将添加到 AudiencePerformanceReportColumn 值集。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 12.13.4 的发行说明。

2019 年 7 月

请参阅下文，了解本日历月的必应广告 API 更新。

包括在转换中

启用了“转换中包括”功能 (GetCustomerPilotFeatures 的客户返回 574) 可以选择从转换报告数据中排除特定的转换目标。

对于将 ExcludeFromBiding 属性设置为 true 的任何转换目标，数据将从 、、、CostPerConversionReturnOnAdSpendRevenuePerConversion、 和 Revenue 报告列中排除。ConversionsConversionRate 此外，如果使用自动出价出价策略，将此属性设置为 true 将导致目标转换不再考虑自动出价计算。

新) (、、AllReturnOnAdSpend、 AllRevenuePerConversion和 AllRevenue 列将包括所有转换目标的数据，而不管其 ExcludeFromBiding 设置如何。AllConversionsAllConversionRateAllCostPerConversion

有关详细信息，请参阅帮助文章转换目标：“转换”与“所有转换”。

在 7 月服务更新后，下表汇总了每个报告类型的所有可用转换相关的报表性能统计信息。

报告值集 可用的转换列
AccountPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdDynamicTextPerformanceReportColumn AllConversions
AllConversionRate
AllCostPerConversion
转换
ConversionRate
CostPerConversion
AdExtensionByAdReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdExtensionByKeywordReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdExtensionDetailReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdGroupPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AgeGenderAudienceReportColumn AllConversions
AllRevenue
转换
收入
AudiencePerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
CampaignPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ConversionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DestinationUrlPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSAAutoTargetPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSACategoryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSASearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
GeographicPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
GoalsAndFunnelsReportColumn AllConversions
AllRevenue
转换
收入
KeywordPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductDimensionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductPartitionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductPartitionUnitPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductSearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
RevenuePerConversion
ProfessionalDemographicsAudienceReportColumn AllConversions
AllRevenue
转换
收入
PublisherUsagePerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
SearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ShareOfVoiceReportColumn AllConversions
AllConversionRate
AllCostPerConversion
转换
ConversionRate
CostPerConversion
UserLocationPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
转换
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion

报表中的基本市场活动 ID

BaseCampaignId 列将添加到以下值集中。

报表中的平均位置

AveragePosition 列将添加到 ProfessionalDemographicsAudienceReportColumn 值集。

报表中的受众关联 ID

AssociationId 列将添加到 AudiencePerformanceReportColumn 值集中。

2019 年 6 月

请参阅下文，了解本日历月的必应广告 API 更新。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 12.13.3 的发行说明。

最终 URL 后缀和自定义参数更新

最终 URL 后缀和自定义参数更新现已在所有客户的帐户、市场活动、广告组和关键字 (keyword) 级别正式发布。 广告、广告扩展和广告组条件的类似更新仍然仅适用于试点客户。

  • 最终 URL 后缀现已在所有客户的帐户、市场活动、广告组和关键字 (keyword) 级别提供。 最终 URL 后缀适用于第 2 阶段试点客户的广告、广告扩展和广告组标准， (GetCustomerPilotFeatures 返回 566) 。 今年晚些时候，最终 URL 后缀将适用于所有客户的广告、广告扩展和广告组标准。
  • 所有客户的自定义参数限制已从市场活动、广告组和关键字的 3 个增加到 8 个。 Microsoft广告将接受包含的前 8 个自定义参数键和值对，如果包含超过 8 个自定义参数，则会返回错误。 对于自定义参数限制增加阶段 2 试点 (GetCustomerPilotFeatures 针对广告、广告扩展和广告组条件返回 565) 的客户，Microsoft广告将接受你包含的前 8 个自定义参数键和值对，如果包含超过 8 个自定义参数，则会返回错误。 在 2019 日历年度，所有客户的广告、广告扩展和广告组条件限制将从 3 增加到 8。

星期一到星期日报表聚合

报告 API 已更新为支持周一到周日的每周聚合。 以前，只能从周日到周六每周聚合一次。

WeeklyStartingMonday 值将添加到 ReportAggregation 值集中。

ThisWeekStartingMonday、LastWeekStartingMonday 和 LastFourWeeksStartingMonday 值将添加到 ReportTimePeriod 值集中。

突出指标

借助新的和改进的突出指标，现在可以更全面地了解广告在搜索结果页面上的显示位置。 这些更清晰的见解可帮助你更好地优化出价策略。

将 AbsoluteTopImpressionRatePercent、AbsoluteTopImpressionShareLostToBudgetPercent、AbsoluteTopImpressionShareLostToRankPercent、TopImpressionRatePercent、TopImpressionShareLostToBudgetPercent、TopImpressionShareLostToRankPercent 和 TopImpressionSharePercent 列添加到以下报表列值集。

按工具提供的更改历史记录报告

“ 工具” 列现在随更改历史记录报告一起提供。 可以确定如何更改帐户、市场活动或广告属性，例如，是通过 Web 客户端、编辑器、批量上传还是市场活动管理 API 进行的。

通过批量 API 的源

添加了源和源项批量记录，以支持批量下载和上传广告定制器源和页面源。

“页面源 ID”字段将添加到页面源的“市场活动”记录中。

2019 年 5 月

请参阅下文，了解本日历月的必应广告 API 更新。

辅助转换

辅助转换是点击广告后产生的转换，这些广告已收到制造商合作伙伴的联合出价。 此性能统计信息仅适用于Microsoft购物活动中的赞助产品。 AssistedConversions 列将添加到以下报表列值集中。

动态搜索广告文本第 2 部分

动态搜索广告文本第 2 部分适用于试点客户， (GetCustomerPilotFeatures 返回 600) 。 今年晚些时候，它将在所有客户中推出。

TextPart2 元素在 DynamicSearchAd Campaign Management 对象中可用。 动态搜索广告批量记录中提供了“文本第 2 部分”字段。

必应广告 API SDK 汇报

更新了必应广告 .NET、Java、Php 和 Python SDK。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 12.13.2 的发行说明。

2019 年 4 月

请参阅下文，了解本日历月的必应广告 API 更新。

新建生产 OAuth 终结点

面向开发人员的Microsoft 标识平台终结点现已推出。 Microsoft 标识平台终结点允许来自 Azure AD 的工作或学校帐户和个人Microsoft帐户 (MSA) ，例如 hotmail.com、outlook.com 和 msn.com。 Live Connect终结点仅允许使用个人帐户进行身份验证。

重要

即使你的用户没有工作或学校帐户，即使你不使用必应广告 API SDK，我们也鼓励你在 2019 日历年度更新授权 URL，因为Live Connect终结点不再是Microsoft广告用户的建议方法。

必应广告 API SDK 汇报

必应广告 .NET、Java、Php 和 Python SDK 已更新，支持版本 13。 有关详细信息，请参阅 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 版本 12.13.1 的发行说明。

版本 13 正式发布

必应广告 API 版本 13 现已正式发布。 随着必应广告 API 版本 13 的发布，版本 12 已弃用，将于 2019 年 10 月 31 日结束。 有关详细信息，请参阅 迁移到版本 13。

2019 年 3 月

请参阅下文，了解本日历月的必应广告 API 更新。

版本 13 预览版

必应广告 API 版本 13 提供预览版。 有关从版本 12 迁移的更多详细信息，请参阅 迁移到版本 13。