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}/mediationAbexperiment/ {mediation_group_experiment_id}。例如:accounts/pub-9876543210987654/mediationGroups/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)

为实验组创建的实验中介订单项。当实验状态为 RUNNING 时,它们将用于投放。

controlMediationLines[]

object (ExperimentMediationLine)

仅限输出。对照组的实验中介行。它们继承自父级中介组。该字段仅限输出。

state

enum (ExperimentState)

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

startTime

string (Timestamp format)

仅限输出。实验的开始时间(以世界协调时间 [UTC] 表示)。

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

endTime

string (Timestamp format)

仅限输出。实验的结束时间或实验结束时间(以世界协调时间 (UTC) 表示)。

时间戳采用 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 实验并选择一个变体。