REST Resource: accounts.mediationGroups.mediationAbExperiments

资源:MediationAbExperiment

中介 A/B 实验。

JSON 表示法
{
  "name": string,
  "displayName": string,
  "experimentId": string,
  "treatmentTrafficPercentage": string,
  "treatmentMediationLines": [
    {
      object (ExperimentMediationLine)
    }
  ],
  "controlMediationLines": [
    {
      object (ExperimentMediationLine)
    }
  ],
  "state": enum (ExperimentState),
  "startTime": string,
  "endTime": string,
  "mediationGroupId": string,
  "variantLeader": enum (VariantLeader)
}
字段
name

string

此实验的资源名称。格式如下:accounts/{publisherId}/ mediationGroups/{ mediationGroupId}/MediationAbExperimental/ {PRIVACY_group_experiment_id}。例如:accounts/pub-9876543210987654/verticalGroups/0123456789/ mediationAbExperiment/12345

displayName

string

中介 A/B 实验的显示名称。

experimentId

string

仅限输出。中介 A/B 实验的唯一标识符。该属性是仅限输出的属性。

treatmentTrafficPercentage

string (int64 format)

将发送到实验组(变体 B)的中介 A/B 实验流量所占的百分比。剩余流量会发送到对照组(变体 A)。百分比表示为 [1,99](含)范围内的整数。如需了解详情,请参阅 https://support.google.com/admob/answer/9572326

treatmentMediationLines[]

object (ExperimentMediationLine)

为实验组创建的实验中介行。当实验状态为“正在运行”时,将用于投放。

controlMediationLines[]

object (ExperimentMediationLine)

仅限输出。对照组的实验中介行。这些中介组沿用自父级中介组。该字段是仅限输出的字段。

state

enum (ExperimentState)

仅限输出。实验的状态。该字段是仅限输出的字段。

startTime

string (Timestamp format)

仅限输出。实验的开始时间(采用世界协调时间)。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

仅限输出。实验结束或目标的结束时间(采用世界协调时间)。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

mediationGroupId

string

仅限输出。此实验所属的中介组 ID。这可用于在 List experiments API 中过滤实验。

variantLeader

enum (VariantLeader)

仅限输出。根据某些关键指标确定的实验变体领先变体。

ExperimentMediationLine

实验的中介组行。它将用于在实验运行期间投放广告。

JSON 表示法
{
  "mediationGroupLine": {
    object (MediationGroupLine)
  }
}
字段
mediationGroupLine

object (MediationGroupLine)

实验使用的中介组行。

ExperimentState

实验的状态。此字段是只读字段。实验可以处于下述三种状态和转换中的一种:1. 正在运行:实验创建完毕后,会处于正在运行状态。对照组和实验组中介组行均根据指定的 treatmentTrafficPercentage 进行投放。

  1. 已结束:如果未选择胜出的变体,实验将在 90 天后结束。

  2. 已过期:如果胜出的变体被选中,或者实验结束 30 天后,实验会进入“已过期”状态,并且变体 B 会被删除。

枚举
EXPERIMENT_STATE_UNSPECIFIED 未设置字段的默认值。请勿使用。
EXPIRED 此实验已过期。
RUNNING 实验正在运行,因此已在投放中使用。
ENDED 实验已结束,但尚未到期。在实验准备好调用操作期间,系统会继续在原始配置中投放广告。

VariantLeader

实验的变体领先变体。

枚举
VARIANT_LEADER_UNSPECIFIED 枚举的默认值。请勿使用。
CONTROL 对照组是指主导实验的对照组。
TREATMENT 主导实验的实验组。
INSUFFICIENT_DATA 收集的数据(展示次数)不足以确定领先变体。
TOO_EARLY_TO_CALL 实验运行时间不够长,无法确定领先变体。
NO_VARIANT_LEADER 从观测到的数据中,两个变体都不是决定性的胜者。

方法

create

为指定的 AdMob 帐号和中介组创建 A/B 测试实验。

stop

停止中介 A/B 实验并选择变体。