A partir de 8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
Configurações que controlam a meta de desempenho de uma campanha ou pedido de inserção.
Representação 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.}
Campo de união performance_goal_value. Obrigatório. O valor da meta de performance correspondente a um determinado performance_goal_type. performance_goal_value pode ser apenas de um dos tipos a seguir:
Uma string do indicador principal de desempenho (KPI, na sigla em inglês), que pode estar vazia. Precisa ser codificado em UTF-8 e ter no máximo 100 caracteres.
Aplicável quando performanceGoalType é definido como PERFORMANCE_GOAL_TYPE_OTHER.
PerformanceGoalType
Possíveis tipos de metas de performance.
Enums
PERFORMANCE_GOAL_TYPE_UNSPECIFIED
O tipo de meta de desempenho não foi especificado ou é desconhecido nesta versão.
PERFORMANCE_GOAL_TYPE_CPM
A meta de desempenho é definida em CPM (custo por mil).
PERFORMANCE_GOAL_TYPE_CPC
A meta de desempenho é definida no custo por clique (CPC).
PERFORMANCE_GOAL_TYPE_CPA
A meta de performance é definida no custo por ação (CPA).
PERFORMANCE_GOAL_TYPE_CTR
A meta de desempenho é definida na porcentagem da CTR (taxa de cliques).
PERFORMANCE_GOAL_TYPE_VIEWABILITY
A meta de desempenho é definida na porcentagem de visibilidade.
PERFORMANCE_GOAL_TYPE_CPIAVC
A meta de performance é definida como custo por impressão audível e visível na conclusão (CPIAVC, na sigla em inglês).
PERFORMANCE_GOAL_TYPE_CPE
A meta de desempenho é definida no CPE (custo por engajamento).
PERFORMANCE_GOAL_TYPE_CLICK_CVR
A meta de desempenho é definida com base na porcentagem da taxa de conversão de cliques (conversões por clique).
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
A meta de desempenho é definida usando a porcentagem da taxa de conversão de impressões (conversões por impressão).
PERFORMANCE_GOAL_TYPE_VCPM
A meta de performance é definida no custo por mil impressões visíveis (VCPM).
PERFORMANCE_GOAL_TYPE_VTR
A meta de desempenho é definida com base na porcentagem da taxa de visualização do YouTube (visualizações por impressão do YouTube).
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
A meta de desempenho é definida com base na porcentagem da taxa de conclusão de áudio (ouvações completas de áudio por impressão).
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE
A meta de desempenho é definida com base na porcentagem da taxa de visualizações completas (visualizações completas de vídeos por impressão).
[null,null,["Última atualização 2025-07-25 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. |"]]