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] (含)。詳情請參閱 https://support.google.com/admob/answer/9572326

treatmentMediationLines[]

object (ExperimentMediationLine)

為實驗組建立的實驗中介服務線。實驗狀態為「執行中」時,系統會使用這些素材資源放送廣告。

controlMediationLines[]

object (ExperimentMediationLine)

僅供輸出。實驗控制組的中介服務廣告空間。這些設定是從父項中介服務群組沿用而來。這是僅供輸出的欄位。

state

enum (ExperimentState)

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

startTime

string (Timestamp format)

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

使用 RFC 3339,產生的輸出內容一律會經過 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)

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

使用 RFC 3339,產生的輸出內容一律會經過 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。可用於篩選清單實驗 API 中的實驗。

variantLeader

enum (VariantLeader)

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

ExperimentMediationLine

實驗的中介服務群組行。實驗執行期間會使用這個廣告活動放送廣告。

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

object (MediationGroupLine)

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

ExperimentState

實驗狀態。這是唯讀欄位。實驗可處於下列三種狀態,並依據以下方式轉換:1. 執行中:實驗建立完成後,就會進入執行中狀態。系統會根據指定的實驗組流量百分比,放送控制組和實驗組的中介服務群組行。

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