À partir du 8 septembre 2025, chaque nouvelle ligne devra indiquer si elle diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et les appels à l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour savoir comment mettre à jour votre intégration afin d'effectuer cette déclaration, consultez notre page sur les abandons de compatibilité.
Paramètres qui contrôlent l'objectif de performances d'une campagne ou d'un ordre d'insertion.
Représentation 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.}
Champ d'union performance_goal_value. Obligatoire. Valeur de l'objectif de performances correspondant à un performance_goal_type donné. La performance_goal_value ne peut être qu'un des éléments suivants :
Représentation décimale du pourcentage de l'objectif en micros.
Applicable lorsque performanceGoalType correspond à l'une des valeurs suivantes:
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
Par exemple, 70 000 représente 7% (0,07 décimal).
performanceGoalString
string
Une chaîne d'indicateur clé de performance (KPI), qui peut être vide. Doit être encodé au format UTF-8 avec une longueur maximale de 100 caractères.
Applicable lorsque performanceGoalType est défini sur PERFORMANCE_GOAL_TYPE_OTHER.
PerformanceGoalType
Types d'objectifs de performances possibles.
Enums
PERFORMANCE_GOAL_TYPE_UNSPECIFIED
Le type d'objectif de performances n'est pas spécifié ou est inconnu dans cette version.
PERFORMANCE_GOAL_TYPE_CPM
L'objectif de performances est défini en CPM (coût pour mille impressions).
PERFORMANCE_GOAL_TYPE_CPC
L'objectif de performances est défini en CPC (coût par clic).
PERFORMANCE_GOAL_TYPE_CPA
L'objectif de performances est défini en CPA (coût par action).
PERFORMANCE_GOAL_TYPE_CTR
L'objectif de performances est défini en pourcentage du CTR (taux de clics).
PERFORMANCE_GOAL_TYPE_VIEWABILITY
L'objectif de performances est défini en pourcentage de visibilité.
PERFORMANCE_GOAL_TYPE_CPIAVC
L'objectif de performances est défini sur CPIAVC (coût par impression audible et visible à la fin).
PERFORMANCE_GOAL_TYPE_CPE
L'objectif de performances est défini en CPE (coût par engagement).
PERFORMANCE_GOAL_TYPE_CLICK_CVR
L'objectif de performances est défini en pourcentage du taux de conversion des clics (conversions par clic).
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
L'objectif de performances est défini en pourcentage du taux de conversion des impressions (conversions par impression).
PERFORMANCE_GOAL_TYPE_VCPM
L'objectif de performances est défini en vCPM (coût pour mille impressions visibles).
PERFORMANCE_GOAL_TYPE_VTR
L'objectif de performances est défini en pourcentage du taux de vue YouTube (vues YouTube par impression).
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
L'objectif de performances est défini en pourcentage du taux de lecture complète de l'audio (écoutes complètes de l'audio par impression).
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE
L'objectif de performances est défini en pourcentage du taux de lecture complète de la vidéo (visionnages de vidéos complètes par impression).
PERFORMANCE_GOAL_TYPE_OTHER
L'objectif de performances est défini sur "Autre".
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]