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]）。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

仅限输出。实验结束或计划结束的时间（采用世界协调时间 [UTC]）。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 实验并选择一个变体。