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 成效目標設為 CPIAVC (在影片結束播放時仍然可聽可見的單次曝光費用)。
PERFORMANCE_GOAL_TYPE_CPE 成效目標是在單次參與出價 (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 成效目標設為「其他」。