Experiment

一种 Google Ads 实验，用户可以在实验中对多个广告系列进行更改、比较效果并应用有效更改。

JSON 表示法 
{
  "resourceName": string,
  "name": string,
  "description": string,
  "suffix": string,
  "type": enum (ExperimentType),
  "status": enum (ExperimentStatus),
  "goals": [
    {
      object (MetricGoal)
    }
  ],
  "promoteStatus": enum (AsyncActionStatus),
  "experimentId": string,
  "startDate": string,
  "endDate": string,
  "longRunningOperation": string,
  "syncEnabled": boolean
}
字段
resourceName

string

不可变。实验的资源名称。实验资源名称的格式如下：

customers/{customerId}/experiments/{experimentId}
name

string

必需。实验的名称。长度下限必须为 1，长度上限为 1024。它在客户名下必须是唯一的。
description

string

实验的说明。长度下限必须为 1，长度上限为 2048。
suffix

string

对于由系统管理的实验，广告客户必须在实验构建过程中（在设置阶段）提供后缀，然后才能转为“启动”。系统会将此后缀附加到设计中的广告系列名称和实验广告系列名称，使其名称为基本广告系列名称 + 后缀。
type

enum (ExperimentType)

必需。使用此实验的产品/功能。
status

enum (ExperimentStatus)

此实验由广告客户选择的状态。
goals[]

object (MetricGoal)

此实验的目标。
promoteStatus

enum (AsyncActionStatus)

仅供输出。实验推广流程的状态。
experimentId

string (int64 format)

仅供输出。实验的 ID。只读。
startDate

string

实验的开始日期。默认情况下，实验会立即或广告系列的开始日期（以较晚者为准）启动。如果设置了此字段，则实验会在指定日期的开始时间（以客户所在时区为准）启动。

格式：YYYY-MM-DD 示例：2019-03-14
endDate

string

实验的结束日期。默认情况下，实验在广告系列的结束日期结束。如果设置了此字段，则实验会在指定日期的结束时间（以客户所在时区为准）结束。

格式：YYYY-MM-DD 示例：2019-04-18
longRunningOperation

string

仅供输出。长时间运行的操作的资源名称，可用于轮询实验时间表的完成情况或提升作业的完成情况。返回最近的长时间运行的操作。
syncEnabled

boolean

不可变。如果对基本广告系列的更改应同步到实验广告系列，则设置为 true。对实验广告系列直接做出的任何更改都会保留。此字段只能在创建实验时设置。

ExperimentType

实验的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
DISPLAY_AND_VIDEO_360 这是一个 DISPLAY_AND_VIDEO_360 实验。
AD_VARIATION 这是一个广告变体实验。
YOUTUBE_CUSTOM 包含视频广告系列的自定义实验。
DISPLAY_CUSTOM 由展示广告系列组成的自定义实验。
SEARCH_CUSTOM 由搜索广告系列组成的自定义实验。
DISPLAY_AUTOMATED_BIDDING_STRATEGY 一种实验，用于比较展示广告系列的出价策略。
SEARCH_AUTOMATED_BIDDING_STRATEGY 比较搜索广告系列的出价策略的实验。”
SHOPPING_AUTOMATED_BIDDING_STRATEGY 一种实验，用于比较购物广告系列的出价策略。
SMART_MATCHING 已弃用。针对搜索广告系列的智能匹配实验。
HOTEL_CUSTOM 包含酒店广告系列的自定义实验。

ExperimentStatus

实验的状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
ENABLED 实验已启用。
REMOVED 该实验已移除。
HALTED 此实验已暂停。您可以通过 API 从“已启用”状态设置此状态。
PROMOTED 相应实验将退出实验状态。
SETUP 实验的初始状态。
INITIATED 实验的广告系列正在等待具体化。可通过 API 从“SETUP”状态设置此状态。
GRADUATED 此实验已升级。

MetricGoal

实验的指标目标。

JSON 表示法 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
字段
metric

enum (ExperimentMetric)

目标的指标。例如点击次数、展示次数、费用、转化次数等。
direction

enum (ExperimentMetricDirection)

目标的指标方向。例如，增加、减少、无变化。

ExperimentMetric

实验指标的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
CLICKS 该实验的目标是增加点击次数。
IMPRESSIONS 实验目标是展示次数。
COST 实验目标是费用。
CONVERSIONS_PER_INTERACTION_RATE 实验的目标是提高转化率。
COST_PER_CONVERSION 实验目标是每次转化费用。
CONVERSIONS_VALUE_PER_COST 实验目标是单位费用转化价值。
AVERAGE_CPC 实验的目标是平均每次点击费用。
CTR 实验目标是点击率。
INCREMENTAL_CONVERSIONS 实验的目标是增加转化次数。
COMPLETED_VIDEO_VIEWS 实验的目标是完整观看视频。
CUSTOM_ALGORITHMS 实验的目标是自定义算法。
CONVERSIONS 该实验的目标是转化次数。
CONVERSION_VALUE 该实验的目标是提高转化价值。

ExperimentMetricDirection

实验指标方向的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
NO_CHANGE 实验的目标是不更改指标。
INCREASE 实验的目标是创建指标。
DECREASE 实验的目标是降低指标。
NO_CHANGE_OR_INCREASE 实验的目标是不更改或提高指标。
NO_CHANGE_OR_DECREASE 实验的目标是不更改或降低指标。

AsyncActionStatus

实验的异步操作状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 在此版本中，此值未知。
NOT_STARTED 操作尚未开始。
IN_PROGRESS 操作正在进行。
COMPLETED 操作已成功完成。
FAILED 操作失败。
COMPLETED_WITH_WARNING 操作已成功完成，但出现警告。