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 實驗的專屬 ID。這是僅供輸出的屬性。

treatmentTrafficPercentage

string (int64 format)

傳送給實驗組的中介服務 A/B 實驗流量百分比 (版本 B)。餘數會傳送至控制項 (變化版本 A)。百分比會以 [1,99] (包括本範圍的 1,99) 之間的整數表示。詳情請參閱 https://support.google.com/admob/answer/9572326

treatmentMediationLines[]

object (ExperimentMediationLine)

為實驗組建立的實驗中介服務行。實驗狀態是「執行中」時,就會用來放送廣告。

controlMediationLines[]

object (ExperimentMediationLine)

僅供輸出。控制組的實驗組中介服務行。這些走向沿用自上層中介服務群組。這是僅供輸出的欄位。

state

enum (ExperimentState)

僅供輸出。實驗的狀態。這是僅供輸出的欄位。

startTime

string (Timestamp format)

僅供輸出。實驗開始的時間 (世界標準時間)。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

僅供輸出。實驗結束或指定結束的時間 (世界標準時間)。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

mediationGroupId

string

僅供輸出。這項實驗所屬的中介服務群組 ID。這可用於篩選 ListExperimental API 中的實驗。

variantLeader

enum (VariantLeader)

僅供輸出。根據部分重要指標,實驗的變化版本勝出者。

ExperimentMediationLine

實驗的中介服務群組行。在實驗期間,系統會放送這類代碼。

JSON 表示法
{
  "mediationGroupLine": {
    object (MediationGroupLine)
  }
}
欄位
mediationGroupLine

object (MediationGroupLine)

實驗使用的中介服務群組行。

ExperimentState

實驗狀態。此為唯讀欄位。實驗可能處於下列三種狀態和轉換狀態的其中一種:1. 執行中:實驗建立後會進入執行狀態。系統會根據指定的 treatmentTrafficPercentage 放送控制組和實驗組中介服務群組。

  1. 已結束:如未選擇勝出的變化版本,實驗會在 90 天後結束。

  2. 已失效:如果選擇勝出的變化版本,或實驗結束後已過 30 天,實驗就會進入「EXPIRED」狀態,並刪除變化版本 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 實驗,並選擇變化版本。