Experiment

Google Ads 實驗可讓使用者在多個廣告活動中實驗變更，比較成效並套用效果最好的變更。

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
}
欄位
resourceName

string

無法變更。實驗的資源名稱。實驗資源名稱的格式為：

customers/{customerId}/experiments/{experimentId}
name

string

必要欄位。實驗的名稱。長度須介於 1 至 1024 個字元之間。此 ID 不得與客戶 ID 重複。
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

僅供輸出。長時間執行作業的資源名稱，可用於輪詢實驗時間表或升級作業。會傳回最近的長時間執行作業。

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)

目標的指標方向。例如增加、減少、沒有變化。

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 動作已成功完成，但出現警告。