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 成效目標可在單次點擊出價中設定。
PERFORMANCE_GOAL_TYPE_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 成效目標可設為千次可視曝光出價。
PERFORMANCE_GOAL_TYPE_VTR 成效目標是在 YouTube 收視率 (YouTube 單次曝光觀看次數) 百分比中設定。
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE 成效目標是設定音訊完成率 (每次曝光的完整音訊聆聽次數) 百分比。
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE 成效目標以影片播放完成率 (每次曝光的完整影片觀看次數) 百分比設定。
PERFORMANCE_GOAL_TYPE_OTHER 成效目標設為「其他」。