试验记录 - 批量

定义可在批量文件中下载的试验。

注意

在 2023 年 2 月 1 日之前，将展开的文本广告升级到响应式搜索广告。 在此日期之后，你将无法再创建新的或编辑现有的扩展文本广告。 有关详细信息，请参阅 关于响应式搜索广告。

通过试验，可以拆分市场活动的预算和流量，然后在有限的日期范围内运行 A/B 测试。

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

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

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

注意

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

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

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

• 使用指定的“基本市场活动 ID”、“结束日期”、“名称”、“开始日期”和“流量拆分百分比”创建试验实体。 实验状态将由 Microsoft Advertising 自动设置为“正在创建”，下次下载试验时，其状态将为“活动”、“正在创建”、“创建已创建”、“已暂停”或“已计划”。

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

  注意

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

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

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

创建试验后，可以更新其 结束日期、 名称、 开始日期和 流量拆分百分比。 有一些例外，例如，在 状态 变为 “活动 ”后无法更新开始日期， (开始日期已到达) ，并且无法在 状态 变为 “结束 ” (结束日期后更新结束日期) 。

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

提示

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

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

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

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

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

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 Experiment 的 DownloadEntity 值，可以下载帐户中的所有试验记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。

以下 Bulk CSV 示例将添加新试验。

Type,Status,Id,Parent Id,Client Id,Modified Time,Start Date, End Date,Name,Traffic Split Percent,Base Campaign Id,Experiment Campaign Id
Format Version,,,,,,,,6.0,,,
Experiment,Active,-20,,ClientIdGoesHere,11/12/2020,12/31/2021,My Campaign - Experiment,50,-111,

如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkExperiment 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkExperiment
var bulkExperiment = new BulkExperiment
{  
    // Map properties in the Bulk file to the 
    // Experiment object of the Campaign Management service.
    Experiment = new Experiment
    {
        // 'Base Campaign Id' column header in the Bulk file
        BaseCampaignId = campaignIdKey,
        // 'End Date' column header in the Bulk file
        EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = 12,
            Day = 31,
            Year = DateTime.UtcNow.Year + 1
        },
        // 'Experiment Campaign Id' column header in the Bulk file
        ExperimentCampaignId = null,
        // 'Status' column header in the Bulk file
        ExperimentStatus = "Active",
        // 'Id' column header in the Bulk file
        Id = experimentIdKey,
        // 'Name' column header in the Bulk file
        Name = "My Campaign - Experiment",
        // 'Start Date' column header in the Bulk file
        StartDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = DateTime.UtcNow.Month,
            Day = DateTime.UtcNow.Day,
            Year = DateTime.UtcNow.Year
        },
        // 'Traffic Split Percent' column header in the Bulk file
        TrafficSplitPercent = 50,
    },

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkExperiment);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

对于 试验 记录，批量 文件架构中提供了以下属性字段。

• 基本市场活动 ID
• "结束日期"
• 试验市场活动 ID
• 试验类型
• 客户端 ID
• Id
• 修改时间
• 名称
• "开始日期"
• 状态
• 流量拆分百分比

基本市场活动 ID

用作试验市场活动基础的活动的 Microsoft Advertising 标识符。

每个基础市场活动最多可以创建 10 个非当前试验。 换句话说，同一基本市场活动的多个试验不能有重叠的时间间隔。

注意

试验仅适用于搜索市场活动。 如果市场活动使用共享预算，则不能将其用作试验的基础市场活动。

添加： 只读和必需。 必须指定现有的市场活动标识符，或指定等于父市场活动记录的 ID 字段的负标识符。 如果要在同一批量文件中为新市场活动创建试验，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读。 不能更改试验的基础市场活动。
删除： 只读

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。

添加： 选
更新： 选
删除： 只读

End Date

试验将过期的日期。

如果未指定结束日期，广告将不会过期。 结束日期过后，不能延长结束日期。

结束日期是包含的。 例如，如果将结束日期设置为 2020 年 12 月 31 日，试验将在 2020 年 12 月 31 日晚上 11：59 结束。 时间相对于 基本市场活动 时区。

添加： 选。 如果将此元素留空或为空，则试验在采取进一步操作（例如，将试验 状态 设置为 “已结束”）之前不会过期。
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 若要删除当前结束日期并有效地不设置结束日期，请将此字段设置为 delete_value 字符串。 下次检索试验时，不会设置此字段。
删除： 只读

试验市场活动 ID

作为 基础市场活动的副本创建的市场活动的 Microsoft Advertising 标识符。

所有基本市场活动设置（包括广告组、广告、广告扩展插件关联和目标设置）都会复制到新的试验市场活动。

创建试验市场活动后，可以更新其所有设置，但市场活动 预算和 预算类型除外。 试验市场活动的预算和时区始终继承自基本市场活动设置。

添加： 只读
更新： 只读
删除： 只读

试验类型

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

可能的值包括 TrafficBased 和 CookieBased。

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

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

添加： 选。 默认值为 TrafficBased。
更新： 只读。 无法更新试验类型。
删除： 只读

Id

试验的系统生成的标识符。

添加： 只读
更新： 只读和必需
删除： 只读和必需

修改时间

上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。

注意

日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

添加： 只读
更新： 只读
删除： 只读

名称

试验的名称。

从基础市场活动创建的试验市场活动的名称将与试验名称匹配，反之亦然。 如果更新了试验名称，试验市场活动的名称将自动更新为匹配，反之亦然。

该名称必须是唯一的， (帐户内所有市场活动和试验中不区分大小写的) 。 该名称最多可包含 128 个字符。

添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读

开始日期

试验市场活动可以开始投放广告的日期。

试验开始后（即开始日期到达后）无法更新开始日期。

开始日期是包含的。 例如，如果将开始日期设置为 2020 年 5 月 5 日，试验将从 2020 年 5 月 5 日凌晨 12：00 开始。 时间相对于 基本市场活动 时区。

添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 试验开始后（即开始日期到达后）无法更新开始日期。
删除： 只读

状态

试验的状态。

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

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

添加： 必填。 必须将状态设置为“活动”;但是，Microsoft Advertising 会自动将状态设置为“正在创建”，下次检索试验时，其状态将为“活动”、“正在创建”、“已创建”、“已暂停”或“已计划”。
更新： 只读
删除： 必填。 “状态”必须设置为 “已删除”。

流量拆分百分比

要为此试验分配的基本市场活动预算和广告流量的百分比。

广告流量根据单个搜索在试验和基础市场活动之间进行拆分。 相关搜索将随机显示试验中的广告或基础市场活动中的广告。 这意味着，如果单个客户多次搜索，他们可以看到来自这两个来源的广告。

可能 int 的值范围为 1 到 99。

添加： 必填
更新： 只读。 在试验运行时，不能更改拆分。
删除： 只读