С 8 сентября 2025 года в каждой новой позиции необходимо будет указывать, будет ли она показывать политическую рекламу Европейского союза (ЕС). Загрузки через Display & Video 360 API и SDF без таких указаний будут отклонены. Подробнее о том, как обновить интеграцию и указать это указание, см. на странице «Устаревшие функции».
Настройки, определяющие целевую эффективность кампании или заказа на размещение.
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.}
Поле объединения performance_goal_value . Необходимый. Значение цели производительности, соответствующее данному performance_goal_type . performance_goal_value может быть только одним из следующих:
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\u003cp\u003eDisplay & Video 360 API v1 is sunsetted.\u003c/p\u003e\n"],["\u003cp\u003ePerformance goals can be set for campaigns or insertion orders using various types like CPM, CPC, CPA, CTR, and others.\u003c/p\u003e\n"],["\u003cp\u003ePerformance goals use either monetary values (in micros), percentages (in micros), or custom KPI strings depending on the goal type.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eperformanceGoalType\u003c/code\u003e defines the type of the performance goal, while \u003ccode\u003eperformance_goal_value\u003c/code\u003e specifies the target value in the appropriate format.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePerformanceGoalType\u003c/code\u003e offers a range of options like CPM, CPC, CPA, CTR, Viewability, CPIAVC, and others to align with campaign objectives.\u003c/p\u003e\n"]]],[],null,["# PerformanceGoal\n\n| Display \\& Video 360 API v1 has been sunset.\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [PerformanceGoalType](#PerformanceGoalType)\n\nSettings that control the performance goal of a campaign or insertion order.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"performanceGoalType\": enum (/display-video/api/reference/rest/v1/PerformanceGoal#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`. } ``` |\n\n| Fields ||\n|-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `performanceGoalType` | `enum (`[PerformanceGoalType](/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType)`)` Required. The type of the performance goal. |\n| Union field `performance_goal_value`. Required. The performance goal value corresponding to a given [performance_goal_type](/display-video/api/reference/rest/v1/PerformanceGoal#FIELDS.performance_goal_type). `performance_goal_value` can be only one of the following: ||\n| `performanceGoalAmountMicros` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The goal amount, in micros of the advertiser's currency. Applicable when [performanceGoalType](/display-video/api/reference/rest/v1/PerformanceGoal#FIELDS.performance_goal_type) 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. |\n| `performanceGoalPercentageMicros` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The decimal representation of the goal percentage in micros. Applicable when [performanceGoalType](/display-video/api/reference/rest/v1/PerformanceGoal#FIELDS.performance_goal_type) 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). |\n| `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](/display-video/api/reference/rest/v1/PerformanceGoal#FIELDS.performance_goal_type) is set to `PERFORMANCE_GOAL_TYPE_OTHER`. |\n\nPerformanceGoalType\n-------------------\n\nPossible types of performance goals.\n\n| Enums ||\n|-----------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| `PERFORMANCE_GOAL_TYPE_UNSPECIFIED` | Performance goal type is not specified or is unknown in this version. |\n| `PERFORMANCE_GOAL_TYPE_CPM` | The performance goal is set in CPM (cost per mille). |\n| `PERFORMANCE_GOAL_TYPE_CPC` | The performance goal is set in CPC (cost per click). |\n| `PERFORMANCE_GOAL_TYPE_CPA` | The performance goal is set in CPA (cost per action). |\n| `PERFORMANCE_GOAL_TYPE_CTR` | The performance goal is set in CTR (click-through rate) percentage. |\n| `PERFORMANCE_GOAL_TYPE_VIEWABILITY` | The performance goal is set in Viewability percentage. |\n| `PERFORMANCE_GOAL_TYPE_CPIAVC` | The performance goal is set as CPIAVC (cost per impression audible and visible at completion). |\n| `PERFORMANCE_GOAL_TYPE_CPE` | The performance goal is set in CPE (cost per engagement). |\n| `PERFORMANCE_GOAL_TYPE_CLICK_CVR` | The performance goal is set in click conversion rate (conversions per click) percentage. |\n| `PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR` | The performance goal is set in impression conversion rate (conversions per impression) percentage. |\n| `PERFORMANCE_GOAL_TYPE_VCPM` | The performance goal is set in VCPM (cost per thousand viewable impressions). |\n| `PERFORMANCE_GOAL_TYPE_VTR` | The performance goal is set in YouTube view rate (YouTube views per impression) percentage. |\n| `PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE` | The performance goal is set in audio completion rate (complete audio listens per impression) percentage. |\n| `PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE` | The performance goal is set in video completion rate (complete video views per impression) percentage. |\n| `PERFORMANCE_GOAL_TYPE_OTHER` | The performance goal is set to Other. |"]]