BiddingStrategy

Paramètres qui contrôlent la stratégie d'enchères. La stratégie d'enchères détermine le prix de l'enchère.

Représentation JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "demandGenBid": {
    object (DemandGenBiddingStrategy)
  }
  // End of mutually exclusive fields.
}
Champs
Obligatoire. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
fixedBid

object (FixedBidStrategy)

Stratégie qui utilise un prix d'enchère fixe.
maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

Stratégie qui ajuste automatiquement l'enchère pour optimiser votre objectif de performances tout en dépensant l'intégralité du budget.

Au niveau de l'ordre d'insertion, le champ markupType des éléments de campagne ne peut pas être défini sur PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM.

De plus, la valeur performanceGoalType attribuée à un ordre d'insertion détermine les valeurs lineItemType possibles pour les éléments de campagne de cet ordre d'insertion :

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC et BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED n'autorisent que les éléments de campagne LINE_ITEM_TYPE_DISPLAY_DEFAULT ou LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA et BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN n'autorisent que les éléments de campagne LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH n'autorise que les éléments de campagne LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Stratégie qui ajuste automatiquement l'enchère pour atteindre ou dépasser un objectif de performances spécifié. Il ne doit être utilisé que pour une entité d'élément de campagne.
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

Stratégie d'enchères utilisée par les ressources YouTube et partenaires.

Il ne peut être utilisé que pour une entité d'élément de campagne ou de groupe d'annonces YouTube et partenaires.
demandGenBid

object (DemandGenBiddingStrategy)

Stratégie d'enchères utilisée par les ressources Demand Gen.

Il ne peut être utilisé que pour une entité d'élément de campagne ou de groupe d'annonces Demand Gen.
Fin des champs mutuellement exclusifs.

FixedBidStrategy

Stratégie qui utilise un prix d'enchère fixe.

Représentation JSON 
{
  "bidAmountMicros": string
}
Champs
bidAmountMicros

string (int64 format)

Montant de l'enchère fixe, en micros de la devise de l'annonceur. Pour l'entité d'ordre d'insertion, bidAmountMicros doit être défini sur 0. Pour l'entité d'élément de campagne, bidAmountMicros doit être supérieur ou égal à l'unité facturable de la devise donnée, et inférieur ou égal à la limite supérieure de 1 000 000 000.

Par exemple, 1500000 représente 1,5 unité standard de la devise.

MaximizeSpendBidStrategy

Stratégie qui ajuste automatiquement l'enchère pour optimiser un objectif de performances spécifié tout en dépensant l'intégralité du budget.

Représentation JSON 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
Champs
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Obligatoire. Type d'objectif de performances que la stratégie d'enchères tente de minimiser tout en dépensant l'intégralité du budget. BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM n'est pas compatible avec cette stratégie.
maxAverageCpmBidAmountMicros

string (int64 format)

CPM moyen maximal pouvant être proposé, en micros de la devise de l'annonceur. Doit être supérieur ou égal à une unité facturable de la devise donnée.

Par exemple, 1500000 représente 1,5 unité standard de la devise.
raiseBidForDeals

boolean

Indique si la stratégie tient compte des prix plancher de l'accord.
customBiddingAlgorithmId

string (int64 format)

ID de l'algorithme d'enchères personnalisées utilisé par cette stratégie. Ne s'applique que lorsque performanceGoalType est défini sur BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

L'attribution d'un algorithme d'enchères personnalisées qui utilise des activités Floodlight non identifiées dans floodlightActivityConfigs renverra une erreur.

BiddingStrategyPerformanceGoalType

Types possibles d'objectifs de performances pour la stratégie d'enchères.

Enums
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED La valeur du type n'est pas spécifiée ou est inconnue dans cette version.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA Coût par action.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Coût par clic.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM CPM visible.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO Algorithme d'enchères personnalisées.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA Vues terminées, visibles et audibles.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Vues avec une durée de visionnage supérieure à 10 secondes.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Impressions visibles.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH Maximiser la couverture.

PerformanceGoalBidStrategy

Stratégie qui ajuste automatiquement l'enchère pour atteindre ou dépasser un objectif de performances spécifié.

Représentation JSON 
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
Champs
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Obligatoire. Type d'objectif de performances que la stratégie d'enchères tentera d'atteindre ou de dépasser.

Pour une utilisation au niveau de l'élément de campagne, la valeur doit être l'une des suivantes :

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.
performanceGoalAmountMicros

string (int64 format)

Obligatoire. Objectif de performances que la stratégie d'enchères tentera d'atteindre ou de dépasser, en micros de la devise de l'annonceur ou en micros de la valeur du ROAS (retour sur les dépenses publicitaires), qui est également basée sur la devise de l'annonceur. Doit être supérieur ou égal à une unité facturable de la devise donnée, et inférieur ou égal aux limites supérieures. Chaque performanceGoalType a sa limite supérieure :

  • quand performanceGoalType est BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, la limite supérieure est de 10 000,00 USD.
  • quand performanceGoalType est BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, la limite supérieure est de 1 000 USD.
  • quand performanceGoalType est BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, la limite supérieure est de 1 000 USD.
  • Lorsque performanceGoalType est défini sur BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, la limite supérieure est de 1 000,00 et la limite inférieure est de 0,01.

Exemple : Si vous sélectionnez BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, le prix de l'enchère sera basé sur la probabilité que chaque impression disponible soit visible. Par exemple, si le CPM visible cible est de 2 € et que la probabilité qu'une impression soit visible est de 40 %, le prix de l'enchère sera de 0,80 € (40% de 2 €).

Par exemple, 1500000 représente 1,5 unité standard de la devise ou de la valeur du ROAS.
maxAverageCpmBidAmountMicros

string (int64 format)

CPM moyen maximal pouvant être proposé, en micros de la devise de l'annonceur. Doit être supérieur ou égal à une unité facturable de la devise donnée. Non applicable lorsque performanceGoalType est défini sur BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

Par exemple, 1 500 000 représente 1,5 unité standard de la devise.
customBiddingAlgorithmId

string (int64 format)

ID de l'algorithme d'enchères personnalisées utilisé par cette stratégie. Ne s'applique que lorsque performanceGoalType est défini sur BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

L'attribution d'un algorithme d'enchères personnalisées qui utilise des activités Floodlight non identifiées dans floodlightActivityConfigs renverra une erreur.

YoutubeAndPartnersBiddingStrategy

Paramètres qui contrôlent la stratégie d'enchères pour les ressources YouTube et partenaires.

Représentation JSON 
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
Champs
type

enum (YoutubeAndPartnersBiddingStrategyType)

Type de stratégie d'enchères.
value

string (int64 format)

Valeur utilisée par la stratégie d'enchères.

Lorsque la stratégie d'enchères est attribuée au niveau de l'élément de campagne, ce champ ne s'applique qu'aux types de stratégies suivants :

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Lorsque la stratégie d'enchères est attribuée au niveau du groupe d'annonces, ce champ ne s'applique qu'aux types de stratégies suivants :

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Si vous n'utilisez pas de stratégie applicable, la valeur de ce champ sera 0.
adGroupEffectiveTargetCpaValue

string (int64 format)

Uniquement en sortie. CPA cible effectif pour le groupe d'annonces, en micros de la devise de l'annonceur.
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Uniquement en sortie. Source de la valeur du CPA cible effectif pour le groupe d'annonces.

YoutubeAndPartnersBiddingStrategyType

Types possibles de stratégie d'enchères pour les ressources YouTube et partenaires.

Enums
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED Le type n'est pas spécifié ou est inconnu.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV Stratégie d'enchères qui paie un montant configurable par vue de vidéo.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Stratégie d'enchères qui paie un montant configurable par impression.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Stratégie d'enchères qui optimise automatiquement les conversions par euro.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Stratégie d'enchères qui paie un montant configurable par impression.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM Stratégie d'enchères pour les éléments de campagne de réservation instantanée YouTube qui paie un montant fixe par impression.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Stratégie d'enchères automatiques qui définit des enchères pour maximiser l'impact.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Stratégie d'enchères qui maximise automatiquement le nombre de conversions en fonction d'un budget quotidien.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Stratégie d'enchères qui optimise automatiquement le coût par vue de la vidéo.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Stratégie d'enchères qui maximise automatiquement les revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) spécifique.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Stratégie d'enchères qui définit automatiquement les enchères pour maximiser les revenus tout en dépensant votre budget.

BiddingSource

Source de la valeur de l'enchère.

Enums
BIDDING_SOURCE_UNSPECIFIED La source d'enchères n'est pas spécifiée ou est inconnue.
BIDDING_SOURCE_LINE_ITEM La valeur de l'enchère est héritée de l'élément de campagne.
BIDDING_SOURCE_AD_GROUP La valeur de l'enchère est définie dans le groupe d'annonces.

DemandGenBiddingStrategy

Paramètres qui contrôlent la stratégie d'enchères pour les ressources Demand Gen.

Représentation JSON 
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
Champs
type

enum (DemandGenBiddingStrategyType)

Facultatif. Type de stratégie d'enchères.

Cette option ne peut être définie que lorsqu'elle est attribuée à un élément de campagne. Les groupes d'annonces hériteront de cette valeur de leur élément de campagne.
value

string (int64 format)

Facultatif. Valeur utilisée par la stratégie d'enchères. Vous pouvez définir cette option lorsque vous attribuez des composants à des éléments de campagne ou à des groupes d'annonces. Ce champ ne s'applique qu'aux types de stratégies suivants :

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

La valeur de ce champ est exprimée en micros de la devise de l'annonceur ou en valeur de ROAS. Par exemple, 1 000 000 représente 1,0 unité standard de la devise ou une valeur de ROAS de 100 %. Si vous n'utilisez pas de stratégie applicable, la valeur de ce champ sera 0.
effectiveBiddingValue

string (int64 format)

Uniquement en sortie. Valeur effectivement utilisée par la stratégie d'enchères. Ce champ sera identique à value s'il est défini. Si value n'est pas défini et que la stratégie est attribuée à un groupe d'annonces, ce champ sera hérité de la stratégie d'enchères de l'élément de campagne.

Si type n'est pas DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA ou DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS, ce champ sera défini sur 0.
effectiveBiddingValueSource

enum (BiddingSource)

Uniquement en sortie. Source de la valeur d'enchère effective.

DemandGenBiddingStrategyType

Types possibles de stratégies d'enchères pour les ressources Demand Gen.

Enums
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED Le type n'est pas spécifié ou est inconnu.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA Stratégie d'enchères qui optimise automatiquement les conversions par euro dépensé.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Stratégie d'enchères qui maximise automatiquement les revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) spécifique.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Stratégie d'enchères qui maximise automatiquement le nombre de conversions
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Stratégie d'enchères qui maximise automatiquement les revenus tout en dépensant votre budget.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS Stratégie d'enchères qui maximise automatiquement les clics dans les limites d'un budget donné.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC Stratégie d'enchères qui optimise automatiquement le coût par clic.