PerformanceGoal

JSON 表示法
PerformanceGoalType

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

JSON 表示法

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),

  // 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`	成效目標設為「其他」。