- JSON 表示法
- ExperimentType
- ExperimentStatus
- MetricGoal
- ExperimentMetric
- ExperimentMetricDirection
- AsyncActionStatus
Google Ads 實驗功能,可在多個廣告活動中實驗變更、比較成效並套用有效的變更。
JSON 表示法 |
---|
{ "resourceName": string, "name": string, "description": string, "suffix": string, "type": enum ( |
欄位 | |
---|---|
resourceName |
不可變動。實驗的資源名稱。實驗資源名稱的格式如下:
|
name |
必要欄位。實驗的名稱。長度下限為 1,長度上限則為 1024。不得重複。 |
description |
實驗的說明。長度下限為 1 且長度上限為 2048。 |
suffix |
如果是系統管理的實驗,廣告客戶必須在建立期間提供在設定階段的後置字串,再進行這項程序。後置字串會附加在設計內部和實驗的廣告活動名稱中,做為基礎廣告活動名稱 + 後置字串。 |
type |
必要欄位。使用這項實驗的產品/功能。 |
status |
這項實驗的廣告主選擇狀態。 |
goals[] |
此實驗的目標。 |
promoteStatus |
僅供輸出。實驗宣傳程序的狀態。 |
experimentId |
僅供輸出。實驗的 ID。唯讀。 |
startDate |
實驗開始日期。根據預設,實驗會立即開始或在廣告活動的開始日期 (以較晚者為準) 開始。如果設定了這個欄位,實驗會在指定日期 (以客戶的時區為準) 開始執行。 格式:YYYY-MM-DD,範例:2019-03-14 |
endDate |
實驗結束日期。根據預設,實驗會在廣告活動的結束日期結束。如果設定了這個欄位,實驗會在指定日期的結束時間 (以客戶時區為準)。 格式:YYYY-MM-DD,範例:2019-04-18 |
longRunningOperation |
僅供輸出。長時間執行作業的資源名稱,可用於輪詢實驗排程完成或升級。系統會傳回最近長時間執行的作業。 |
syncEnabled |
不可變動。如要同步處理基礎廣告活動的變更,請將變更同步處理至試用廣告活動,設為 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 ( |
欄位 | |
---|---|
metric |
目標的指標。例如點擊次數、曝光次數、費用、轉換次數等。 |
direction |
目標的指標方向。例如提高、降低、沒有變化。 |
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 |
動作已順利完成,但出現警告。 |