PerformanceGoal

控管廣告活動或廣告訂單成效目標的設定。

JSON 表示法 
{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}
欄位
performanceGoalType

enum (PerformanceGoalType)

必要欄位。成效目標的類型。
聯集欄位 performance_goal_value。必要欄位。與指定 performance_goal_type 對應的成效目標值。performance_goal_value 只能採用下列其中一種設定：
performanceGoalAmountMicros

string (int64 format)

目標金額 (以廣告客戶貨幣的百萬分之一表示)。

當 performanceGoalType 為下列任一值時即適用：

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_VCPM

例如 1500000 代表貨幣的 1.5 個標準單位。
performanceGoalPercentageMicros

string (int64 format)

目標百分比的十進位表示法，以微量為單位。

當 performanceGoalType 為下列任一值時即適用：

  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_CLICK_CVR
  • PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
  • PERFORMANCE_GOAL_TYPE_VTR
  • PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
  • PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

舉例來說，70000 代表 7% (十進位 0.07)。
performanceGoalString

string

主要成效指標 (KPI) 字串，可以留空。必須是 UTF-8 編碼，且長度不超過 100 個字元。

當 performanceGoalType 設為 PERFORMANCE_GOAL_TYPE_OTHER 時適用。

PerformanceGoalType

可能的成效目標類型。

列舉
PERFORMANCE_GOAL_TYPE_UNSPECIFIED 未指定成效目標類型，或是這個版本不支援該目標類型。
PERFORMANCE_GOAL_TYPE_CPM 成效目標是以千次曝光出價 (CPM) 設定。
PERFORMANCE_GOAL_TYPE_CPC 成效目標可透過單次點擊出價 (CPC) 設定。
PERFORMANCE_GOAL_TYPE_CPA 成效目標設為以單次操作出價 (CPA) 計費。
PERFORMANCE_GOAL_TYPE_CTR 成效目標是以點閱率 (點閱率) 百分比來設定。
PERFORMANCE_GOAL_TYPE_VIEWABILITY 成效目標的設定依據為可視度百分比。
PERFORMANCE_GOAL_TYPE_CPIAVC 成效目標可設為「單次有聲可視完整播放的曝光出價」。
PERFORMANCE_GOAL_TYPE_CPE 成效目標是設為單次參與出價。
PERFORMANCE_GOAL_TYPE_CLICK_CVR 成效目標是根據點擊轉換率 (單次點擊轉換) 百分比來設定。
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR 成效目標是以曝光轉換率 (每次曝光的轉換) 百分比來設定。
PERFORMANCE_GOAL_TYPE_VCPM 成效目標是設為千次可視曝光出價 (vCPM)。
PERFORMANCE_GOAL_TYPE_VTR 成效目標是根據 YouTube 收視率 (每次曝光的 YouTube 觀看) 百分比設定。
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE 系統會以音訊播放完成率 (單次曝光完整播放音訊) 百分比設定成效目標。
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE 成效目標是以影片播放完成率 (單次曝光完整影片觀看次數) 百分比來設定。
PERFORMANCE_GOAL_TYPE_OTHER 成效目標設為「其他」。