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。每个客户名下的这个 ID 必须是独一无二的。
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 实验目标是平均 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 操作已成功完成，但有警告。