REST Resource: accounts.mediationGroups.mediationAbExperiments

資源:MediationAbExperimental

中介服務 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/ {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] 之間的整數表示。詳情請參閱 https://support.google.com/admob/answer/9572326

treatmentMediationLines[]

object (ExperimentMediationLine)

為實驗組建立的實驗中介服務行。實驗狀態若為「執行中」,就會用於放送。

controlMediationLines[]

object (ExperimentMediationLine)

僅供輸出。控制組的實驗中介服務線。這些沿用自上層中介服務群組。這是一個僅限輸出的欄位。

state

enum (ExperimentState)

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

startTime

string (Timestamp format)

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

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

endTime

string (Timestamp format)

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

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

mediationGroupId

string

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

variantLeader

enum (VariantLeader)

僅供輸出。根據某些重要指標算出的實驗變化版本勝出版本。

ExperimentMediationLine

實驗的中介服務群組行。系統會在實驗期間使用這組 ID。

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 實驗並選擇變化版本。