PerformanceGoal

  • Display & Video 360 API v2 has sunset.

  • The PerformanceGoal object controls the performance goal of a campaign or insertion order.

  • A PerformanceGoal object has a required performanceGoalType field and a required performance_goal_value union field.

  • The performance_goal_value can be performanceGoalAmountMicros, performanceGoalPercentageMicros, or performanceGoalString, depending on the performanceGoalType.

  • There are various PerformanceGoalType enums available, including CPM, CPC, CPA, CTR, Viewability, and more.

Settings that control the performance goal of a campaign or insertion order.

JSON representation 
{
  "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.
}
Fields
performanceGoalType

enum (PerformanceGoalType)

Required. The type of the performance goal.
Union field performance_goal_value. Required. The performance goal value corresponding to a given performance_goal_type. performance_goal_value can be only one of the following:
performanceGoalAmountMicros

string (int64 format)

The goal amount, in micros of the advertiser's currency.

Applicable when performanceGoalType is one of:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_VCPM

For example 1500000 represents 1.5 standard units of the currency.
performanceGoalPercentageMicros

string (int64 format)

The decimal representation of the goal percentage in micros.

Applicable when performanceGoalType is one of:

  • 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

For example, 70000 represents 7% (decimal 0.07).
performanceGoalString

string

A key performance indicator (KPI) string, which can be empty. Must be UTF-8 encoded with a length of no more than 100 characters.

Applicable when performanceGoalType is set to PERFORMANCE_GOAL_TYPE_OTHER.

PerformanceGoalType

Possible types of performance goals.

Enums
PERFORMANCE_GOAL_TYPE_UNSPECIFIED Performance goal type is not specified or is unknown in this version.
PERFORMANCE_GOAL_TYPE_CPM The performance goal is set in CPM (cost per mille).
PERFORMANCE_GOAL_TYPE_CPC The performance goal is set in CPC (cost per click).
PERFORMANCE_GOAL_TYPE_CPA The performance goal is set in CPA (cost per action).
PERFORMANCE_GOAL_TYPE_CTR The performance goal is set in CTR (click-through rate) percentage.
PERFORMANCE_GOAL_TYPE_VIEWABILITY The performance goal is set in Viewability percentage.
PERFORMANCE_GOAL_TYPE_CPIAVC The performance goal is set as CPIAVC (cost per impression audible and visible at completion).
PERFORMANCE_GOAL_TYPE_CPE The performance goal is set in CPE (cost per engagement).
PERFORMANCE_GOAL_TYPE_CLICK_CVR The performance goal is set in click conversion rate (conversions per click) percentage.
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR The performance goal is set in impression conversion rate (conversions per impression) percentage.
PERFORMANCE_GOAL_TYPE_VCPM The performance goal is set in VCPM (cost per thousand viewable impressions).
PERFORMANCE_GOAL_TYPE_VTR The performance goal is set in YouTube view rate (YouTube views per impression) percentage.
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE The performance goal is set in audio completion rate (complete audio listens per impression) percentage.
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE The performance goal is set in video completion rate (complete video views per impression) percentage.
PERFORMANCE_GOAL_TYPE_OTHER The performance goal is set to Other.