Experiment

JSON 表示法
ExperimentType
ExperimentStatus
MetricGoal
- JSON 表示法
ExperimentMetric
ExperimentMetricDirection
AsyncActionStatus

Google Ads 實驗功能，可在多個廣告活動中實驗變更、比較成效並套用有效的變更。

JSON 表示法

JSON 表示法
{ "resourceName": string, "name": string, "description": string, "suffix": string, "type": enum (`ExperimentType`), "status": enum (`ExperimentStatus`), "goals": [ { object (`MetricGoal`) } ], "promoteStatus": enum (`AsyncActionStatus`), "experimentId": string, "startDate": string, "endDate": string, "longRunningOperation": string, "syncEnabled": boolean }

{
  "resourceName": string,
  "name": string,
  "description": string,
  "suffix": string,
  "type": enum (ExperimentType),
  "status": enum (ExperimentStatus),
  "goals": [
    {
      object (MetricGoal)
    }
  ],
  "promoteStatus": enum (AsyncActionStatus),
  "experimentId": string,
  "startDate": string,
  "endDate": string,
  "longRunningOperation": string,
  "syncEnabled": boolean
}

欄位
`resourceName`	`string` 不可變動。實驗的資源名稱。實驗資源名稱的格式如下： `customers/{customerId}/experiments/{experimentId}`
`name`	`string` 必要欄位。實驗的名稱。長度下限為 1，長度上限則為 1024。不得重複。
`description`	`string` 實驗的說明。長度下限為 1 且長度上限為 2048。
`suffix`	`string` 如果是系統管理的實驗，廣告客戶必須在建立期間提供在設定階段的後置字串，再進行這項程序。後置字串會附加在設計內部和實驗的廣告活動名稱中，做為基礎廣告活動名稱 + 後置字串。
`type`	`enum (ExperimentType)` 必要欄位。使用這項實驗的產品/功能。
`status`	`enum (ExperimentStatus)` 這項實驗的廣告主選擇狀態。
`goals[]`	`object (MetricGoal)` 此實驗的目標。
`promoteStatus`	`enum (AsyncActionStatus)` 僅供輸出。實驗宣傳程序的狀態。
`experimentId`	`string (int64 format)` 僅供輸出。實驗的 ID。唯讀。
`startDate`	`string` 實驗開始日期。根據預設，實驗會立即開始或在廣告活動的開始日期 (以較晚者為準) 開始。如果設定了這個欄位，實驗會在指定日期 (以客戶的時區為準) 開始執行。格式：YYYY-MM-DD，範例：2019-03-14
`endDate`	`string` 實驗結束日期。根據預設，實驗會在廣告活動的結束日期結束。如果設定了這個欄位，實驗會在指定日期的結束時間 (以客戶時區為準)。格式：YYYY-MM-DD，範例：2019-04-18
`longRunningOperation`	`string` 僅供輸出。長時間執行作業的資源名稱，可用於輪詢實驗排程完成或升級。系統會傳回最近長時間執行的作業。
`syncEnabled`	`boolean` 不可變動。如要同步處理基礎廣告活動的變更，請將變更同步處理至試用廣告活動，設為 true。系統會保留直接對試用廣告活動所做的任何變更。這個欄位只能在建立實驗時設定。

ExperimentType

實驗的類型。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	這個版本無法辨識這個值。
`DISPLAY_AND_VIDEO_360`	這是 DISPLAY_AND_VIDEO_360 實驗。
`AD_VARIATION`	這是廣告變化形式實驗。
`YOUTUBE_CUSTOM`	包含影片廣告活動的自訂實驗。
`DISPLAY_CUSTOM`	由多媒體廣告活動組成的自訂實驗。
`SEARCH_CUSTOM`	由搜尋廣告活動組成的自訂實驗。
`DISPLAY_AUTOMATED_BIDDING_STRATEGY`	比較多媒體廣告活動出價策略的實驗。
`SEARCH_AUTOMATED_BIDDING_STRATEGY`	比較搜尋廣告活動的出價策略的實驗。」
`SHOPPING_AUTOMATED_BIDDING_STRATEGY`	比較購物廣告活動出價策略的實驗。
`SMART_MATCHING`	已淘汰。搜尋廣告活動的智慧比對實驗。
`HOTEL_CUSTOM`	由飯店廣告活動組成的自訂實驗。

ExperimentStatus

實驗的狀態。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	這個版本無法辨識這個值。
`ENABLED`	實驗已啟用。
`REMOVED`	已移除這項實驗。
`HALTED`	已暫停實驗。您可以透過 API 將狀態從「已啟用」狀態設為「已啟用」。
`PROMOTED`	實驗將會脫離實驗狀態。
`SETUP`	實驗的初始狀態。
`INITIATED`	實驗的廣告活動尚未完成具體化。這個狀態可透過 API 從 SETUP 狀態設定。
`GRADUATED`	實驗已經升級。

MetricGoal

實驗的指標目標。

JSON 表示法
{ "metric": enum (`ExperimentMetric`), "direction": enum (`ExperimentMetricDirection`) }

欄位

欄位
`metric`	`enum (ExperimentMetric)` 目標的指標。例如點擊次數、曝光次數、費用、轉換次數等。
`direction`	`enum (ExperimentMetricDirection)` 目標的指標方向。例如提高、降低、沒有變化。

metric

enum (ExperimentMetric)

目標的指標。例如點擊次數、曝光次數、費用、轉換次數等。

direction

enum (ExperimentMetricDirection)

目標的指標方向。例如提高、降低、沒有變化。

ExperimentMetric

實驗指標的類型。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	這個版本無法辨識這個值。
`CLICKS`	實驗的目標是點擊次數。
`IMPRESSIONS`	實驗的目標是曝光次數。
`COST`	實驗的目標是費用。
`CONVERSIONS_PER_INTERACTION_RATE`	實驗的目標是轉換率。
`COST_PER_CONVERSION`	實驗的目標是單次轉換費用。
`CONVERSIONS_VALUE_PER_COST`	實驗的目標是單筆費用轉換價值。
`AVERAGE_CPC`	實驗的目標是平均單次點擊出價。
`CTR`	實驗目標是點閱率。
`INCREMENTAL_CONVERSIONS`	實驗的目標是增加轉換。
`COMPLETED_VIDEO_VIEWS`	實驗的目標是影片觀看次數。
`CUSTOM_ALGORITHMS`	實驗的目標是自訂演算法。
`CONVERSIONS`	實驗的目標是轉換。
`CONVERSION_VALUE`	實驗的目標是轉換價值。

ExperimentMetricDirection

實驗指標方向的類型。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	這個版本無法辨識這個值。
`NO_CHANGE`	實驗的目標是不要改變指標。
`INCREASE`	實驗的目標是建立指標。
`DECREASE`	實驗的目標是降低指標。
`NO_CHANGE_OR_INCREASE`	實驗的目標是不更改或增加指標。
`NO_CHANGE_OR_DECREASE`	實驗的目標是不要更改或減少指標。

AsyncActionStatus

實驗的非同步動作狀態。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	這個版本無法辨識這個值。
`NOT_STARTED`	動作尚未開始。
`IN_PROGRESS`	正在執行動作。
`COMPLETED`	動作已成功完成。
`FAILED`	動作失敗。
`COMPLETED_WITH_WARNING`	動作已順利完成，但出現警告。