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 从 ENABLED 状态设置。
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 操作已成功完成，但出现警告。