试验数据对象 - 市场活动管理

定义一个试验，在其中拆分市场活动的预算和流量，然后在有限的日期范围内运行 A/B 测试。

注意

从 2023 年 2 月 1 日开始，只能将基础市场活动中的扩展文本广告复制到试验市场活动，但无法再编辑这些扩展的文本广告。 请在每个广告组中至少创建一个 响应式搜索广告 。

使用不同的出价策略或不同类型的定位对广告市场活动的效果有何影响？ 是更好、更糟还是基本相同？ 现在，你可以运行 A/B 测试来找出结果！

使用Microsoft广告试验，可以创建一个搜索市场活动的副本，该活动接收基本市场活动的预算和广告流量的拆分。 每个基础市场活动最多可以创建 10 个非当前试验。 然后，可以：

• 尝试试验市场活动中的更改。
• 了解试验市场活动与基础市场活动相比的表现。
• 如果你喜欢试验的结果，请将更改应用到基本市场活动或创建一个全新的市场活动。

注意

试验仅适用于没有动态搜索广告设置的搜索市场活动。 混合市场活动不能是试验市场活动或试验的基础市场活动。

试验不支持共享预算。 如果市场活动使用共享预算，则不能将其用作试验的基础市场活动。

在帐户中创建试验时，将同时创建一个新试验和新市场活动。 下面是一些值得注意的细节：

• 使用指定的 BaseCampaignId、EndDate、Name、StartDate 和 TrafficSplitPercent 创建试验实体。 试验 ExperimentStatus 将通过Microsoft“广告”设置为“正在创建”自动设置，下次检索试验时，其状态将为“活动”、“正在创建”、“创建已失败”、“已暂停”或“已计划”。

• 试验 市场活动 创建为 基础市场活动的副本。 所有基本市场活动设置（包括广告组、广告、广告扩展插件关联和目标设置）都会复制到新的试验市场活动。 可以通过 Experiment 对象的 ExperimentCampaignId 元素（例如，批量上传结果文件中）获取此新市场活动的系统标识符。 从基础市场活动创建的试验市场活动的名称将与试验名称匹配，反之亦然。 如果更新了试验名称，试验市场活动的名称将自动更新为匹配，反之亦然。

  注意

  以下实体不会从基本市场活动复制到试验市场活动：

  • 过期的广告组（即结束日期已过）不会从基本市场活动复制到试验市场活动。 提升试验并且试验市场活动设置覆盖基本市场活动设置后，将删除基本市场活动中过期的广告组。 同样，在推广期间，试验市场活动中的任何过期广告组都不会复制到基本市场活动。
  • 具有目标 URL 的关键字不会从基本市场活动复制到试验市场活动。 我们建议升级到 FinalUrls，但如果仍具有目标 URL 的关键字，它们将不会在试验市场活动中使用，并且它们将保留在基本市场活动 (即使试验后来) 升级也是如此。
  • Standard文本广告 (STA) 不会从基本市场活动复制到试验市场活动。 我们建议升级到 扩展文本广告，但如果仍具有 STA，它们将不会在试验活动中使用，并且它们将保留在基本市场活动 (即使试验稍后) 推广也是如此。
  • 已删除的市场内受众的受众关联最初可能在基本市场活动中提供，但不会将其复制到试验市场活动。 如果稍后推广试验市场活动，你的基础市场活动将采用试验市场活动的所有设置，并且已删除的市场内受众的受众关联将从基础市场活动中删除。

  在Microsoft广告 Web 应用程序“试验”选项卡中，可以获取未从基础市场活动复制到试验市场活动的项目的详细列表。 列表的格式为批量上传结果文件，即未复制到试验市场活动的项目的错误记录。 如果你发现错误记录认为应该已复制到试验市场活动，请随时联系支持人员了解详细信息。

创建试验后，可以更新其 EndDate、 Name、 StartDate 和 TrafficSplitPercent。 存在一些例外，例如，在 ExperimentStatus 变为 活动 日期后，无法更新开始日期 (开始日期已到达) ，并且无法在 ExperimentStatus 变为 结束 日期后更新结束日期 (结束日期已) 。

创建试验市场活动后，可以更新其所有设置，但市场活动 预算、 预算类型、 状态和 时区除外。 试验市场活动的预算、状态和时区始终继承自基本市场活动设置。 如果要更改试验的预算，则需要更改基本市场活动的预算。 然后，将根据试验 TrafficSplitPercent 设置拆分值更改。 试验市场活动将具有非试验市场活动没有的新属性，即 ExperimentId。

提示

创建试验后，对基础市场活动设置所做的任何更改 (（预算和状态) 除外）不会影响试验。 为了确保你看到公平的比较，我们建议不要在试验运行时对基本市场活动的设置进行任何更改。

可以让试验在 EndDate 中运行、暂时暂停或提前结束试验。 若要暂停试验，必须暂停基础市场活动。 暂停基础市场活动也会暂停试验活动和试验本身。 若要提前结束试验，请将试验 ExperimentStatus 设置为 “已结束”。 结束试验时，试验活动将暂停。 实验一旦结束，便无法重启。 稍后可以升级、毕业或删除已结束的试验。

有多个选项可用于使用从试验中学到的内容。

• 你可以让基本市场活动采用试验市场活动的所有设置，即将 ExperimentStatus 设置为 “已提升”。 试验市场活动设置和实体将复制回基础市场活动，试验市场活动将暂停。 基础运动将再次拥有其原始预算和流量的100%。 将尽可能多地保留原始系统标识符。 可能存在一些例外，例如，如果在创建试验市场活动后从基础市场活动中删除了广告组。 试验期间对基本市场活动设置的任何更改（例如，新广告组）将有效删除。
• 可以使用自己的预算和广告流量（即将 ExperimentStatus 设置为 Graduated）将实验作为独立市场活动毕业。 基础市场活动将再次拥有其原始预算和流量的 100%，而分级竞选活动 (以前试验性活动) 将以与基本活动相同的预算开始。
• 你可能希望将试验市场活动设置的子集合并到基本市场活动，而不是使用所有试验市场活动设置。

删除 试验时，试验 市场活动 也将被删除，反之亦然：但是，不会删除基本市场活动。 删除基础市场活动时，其所有相关试验和试验市场活动也将被删除。

语法

XML

<xs:complexType name="Experiment" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="BaseCampaignId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="ExperimentCampaignId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ExperimentStatus" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ExperimentType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="TrafficSplitPercent" nillable="true" type="xs:int" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "BaseCampaignId": "LongValueHere",
  "EndDate": {
    "Day": IntValueHere,
    "Month": IntValueHere,
    "Year": IntValueHere
  },
  "ExperimentCampaignId": "LongValueHere",
  "ExperimentStatus": "ValueHere",
  "ExperimentType": "ValueHere",
  "Id": "LongValueHere",
  "Name": "ValueHere",
  "StartDate": {
    "Day": IntValueHere,
    "Month": IntValueHere,
    "Year": IntValueHere
  },
  "TrafficSplitPercent": IntValueHere
}

元素

Experiment 对象具有以下元素：BaseCampaignId、EndDate、ExperimentCampaignId、ExperimentStatus、ExperimentType、Id、Name、StartDate、TrafficSplitPercent。

元素	说明	数据类型
BaseCampaignId	用作试验市场活动基础的市场活动的Microsoft广告标识符。 每个基础市场活动最多可以创建 10 个非当前试验。 换句话说，同一基本市场活动的多个试验不能有重叠的时间间隔。 试验仅适用于搜索市场活动。 如果市场活动使用共享预算，则不能将其用作试验的基础市场活动。 加： 只读和必需。 更新： 只读。 不能更改试验的基础市场活动。	long
EndDate	试验将过期的日期。 如果未指定结束日期，广告将不会过期。 结束日期过后，不能延长结束日期。 结束日期是包含的。 例如，如果将结束日期设置为 2020 年 12 月 31 日，试验将在 2020 年 12 月 31 日晚上 11：59 结束。 时间相对于 基本市场活动 时区。 加： 自选。 如果将此元素留空或为空，则试验在采取进一步操作（例如，将试验 状态 设置为 “已结束”）之前不会过期。 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 若要删除当前结束日期并有效地不设置结束日期，请将 “日”、“ 月”和 “年 ”分别设置为“0” (零) 。 下次检索试验时，不会设置此元素。	Date
ExperimentCampaignId	作为基本市场活动的副本创建的市场活动的Microsoft 广告标识符。 所有基本市场活动设置（包括广告组、广告、广告扩展插件关联和目标设置）都会复制到新的试验市场活动。 创建试验市场活动后，可以更新除市场活动 预算、 BudgetType 和 TimeZone 之外的所有设置。 试验市场活动的预算和时区始终继承自基本市场活动设置。 加： 只读 更新： 只读	long
ExperimentStatus	试验的状态。 以下 备注 中介绍了可能的状态值。 加： 必填。 必须将状态设置为“活动”;但是，通过将“广告”Microsoft为“正在创建”来自动设置状态，下次检索试验时，其状态将为“活动”、“正在创建”、“已创建”、“已暂停”或“已计划”。 更新： 只读	string
ExperimentType	确定是随机显示试验和原始市场活动中的单个客户广告，还是仅显示一个或另一个客户的广告。 可能的值包括 TrafficBased 和 CookieBased。 基于流量：这也称为基于搜索的选项。 每次客户搜索时，都会随机显示试验中的广告或原始市场活动的广告。 这意味着，如果单个客户多次搜索，他们可以看到来自这两个来源的广告。 基于 Cookie：当单个客户搜索时，我们会显示来自你的试验或原始市场活动的广告，并使用 Cookie 来确保他们以后只会看到来自此源的广告。 基于 Cookie 的选项有一个重要的权衡要考虑：一方面，你可能会获得更准确的数据，因为你要确保单个客户只响应一个源或另一个源。 另一方面，与基于搜索的选项相比，建立统计显著比较数据所需的时间可能更长。 加： 自选。 默认值为 TrafficBased。 更新： 只读。 无法更新试验类型。	string
ID	试验的唯一Microsoft广告标识符。 加： 只读 更新： 必填	long
名称	试验的名称。 从基础市场活动创建的试验市场活动的名称将与试验名称匹配，反之亦然。 如果更新了试验名称，试验市场活动的名称将自动更新为匹配，反之亦然。 该名称必须是唯一的， (帐户内所有市场活动和试验中不区分大小写的) 。 该名称最多可包含 128 个字符。 加： 必填 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。	string
StartDate	试验市场活动可以开始投放广告的日期。 试验开始后（即开始日期到达后）无法更新开始日期。 开始日期是包含的。 例如，如果将开始日期设置为 2020 年 5 月 5 日，试验将从 2020 年 5 月 5 日凌晨 12：00 开始。 时间相对于 基本市场活动 时区。 加： 必填 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。	Date
TrafficSplitPercent	要为此试验分配的基本市场活动预算和广告流量的百分比。 广告流量根据单个搜索在试验和基础市场活动之间进行拆分。 相关搜索将随机显示试验中的广告或基础市场活动中的广告。 这意味着，如果单个客户多次搜索，他们可以看到来自这两个来源的广告。 可能的值范围为 1 到 99。 加： 必填 更新： 只读。 在试验运行时，不能更改拆分。	int

备注

下表介绍了可能的试验状态值。

状态	说明
活动	试验市场活动有资格提供广告。 实验 StartDate 已到达， 但 EndDate 尚未通过。
创建	试验已创建，试验活动仍在创建中。
CreationFailed	试验已创建，但无法创建试验活动。 如果创建失败，试验状态只能设置为“已删除”。 应删除试验并尝试创建一个新试验。 如果问题仍然存在，请联系支持人员寻求帮助。
Deleted	实验和试验活动已删除。
结束	试验不再有资格提供广告。 EndDate 已过，或者状态直接设置为“已结束”。
毕业	你的实验已毕业为具有自己的预算和广告流量的独立市场活动。 基础竞选活动再次拥有其原始预算和流量的 100%，而分级竞选活动 (以前是一个试验性竞选活动，) 已经开始与基础竞选活动相同的预算。
毕业	试验活动正在逐步成为一个独立的市场活动，有自己的预算和广告流量。 成功完成后，状态将自动设置为“已毕业”。 如果毕业失败，则没有任何更改，状态将恢复为“活动”。 (该服务不会返回内部“GraduateFailed”状态。) 可以通过将状态设置为“已毕业”来重试，如果试验的毕业仍然不成功，请联系支持人员寻求帮助。
已暂停	基本市场活动和试验市场活动暂时暂停，没有资格投放广告。 实验 StartDate 已到达， 但 EndDate 尚未通过。 请注意，当基本市场活动暂停时，试验市场活动以及试验本身也会暂停。 同样，当基础市场活动未暂停时，试验活动和实验本身将取消暂停。 取消暂停试验时，它将移动到“活动”或“计划”状态。
促进	你的基础市场活动采用了试验市场活动的所有设置。 试验市场活动设置和实体已复制回基础市场活动，试验市场活动已暂停。 基础运动再次拥有其原始预算和流量的100%。 应尽可能多地保留原始系统标识符。 可能存在一些例外，例如，如果在创建试验市场活动后从基础市场活动中删除了广告组。 试验期间对基本市场活动设置的任何更改（例如，新广告组）已被有效删除。
PromoteFailed	试验市场活动设置无法应用于基础市场活动。 可以通过将状态设置为“已升级”来重试，如果 PromoteFailed 状态仍然存在，请联系支持人员寻求帮助。
促进	试验市场活动设置正在应用于基本市场活动。 成功完成后，状态将自动设置为“已升级”，否则状态将设置为 PromoteFailed。 如果升级失败，试验状态只能设置为“已删除”。 在删除试验和试验市场活动之前，请考虑是否要自行将试验市场活动中的任何设置复制到基础市场活动，例如通过Microsoft广告 Web 应用程序或 API。
Scheduled	试验市场活动已创建，并计划在 StartDate 到达后开始投放广告。

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13

使用者

AddExperiments
GetExperimentsByIds
UpdateExperiments