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 時適用。

成效目標類型

可能的成效目標類型。

列舉
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 成效目標是以單次參與出價設定。
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 成效目標設為「其他」。