Od 8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej stronie dotyczącej wycofania.
Ustawienia, które kontrolują cel skuteczności kampanii lub zamówienia reklamowego.
Zapis 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.}
Pole sumy performance_goal_value. Wymagane. Wartość docelowej skuteczności odpowiadającej danej wartości performance_goal_type. performance_goal_value może mieć tylko jedną z tych wartości:
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eDisplay & Video 360 API v2 is no longer supported.\u003c/p\u003e\n"],["\u003cp\u003ePerformance goals can be set for campaigns and insertion orders, and are controlled through settings that define the goal type and its corresponding value.\u003c/p\u003e\n"],["\u003cp\u003ePerformance goals can be based on various metrics like CPM, CPC, CPA, CTR, Viewability, CPIAVC and others, each with a specific type and value format.\u003c/p\u003e\n"],["\u003cp\u003ePerformance goal values can be represented as monetary amounts in micros, percentages in micros or custom KPI strings depending on the selected goal type.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eperformanceGoalType\u003c/code\u003e dictates how the \u003ccode\u003eperformance_goal_value\u003c/code\u003e should be interpreted, with options like \u003ccode\u003ePERFORMANCE_GOAL_TYPE_CPM\u003c/code\u003e, \u003ccode\u003ePERFORMANCE_GOAL_TYPE_CPC\u003c/code\u003e, etc.that map to specific metrics.\u003c/p\u003e\n"]]],[],null,["# PerformanceGoal\n\n| Display \\& Video 360 API v2 has 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/v2/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/v2/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/v2/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/v2/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/v2/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/v2/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. |"]]