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
}
字段
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

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

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 从“设置”状态设置此状态。
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 操作已成功完成，但有警告消息。