BiddingStrategy

Paramètres qui contrôlent la stratégie d'enchères. La stratégie d'enchères détermine le montant des enchères.

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. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul 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 les performances en fonction de votre objectif de performances tout en dépensant l'intégralité du budget.

Au niveau de l'ordre d'insertion, la markupType des éléments de campagne ne peut pas être définie 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écifique. Elle ne doit être utilisée 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.

Elle ne peut être utilisée que pour un élément de campagne ou un groupe d'annonces Demand Gen.
Fin des champs qui s'excluent mutuellement.

FixedBidStrategy

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

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

string (int64 format)

Montant fixe de l'enchère, 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 ligne, 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écifique 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 enchéri, en micros de la devise de l'annonceur. Doit être supérieur ou égal à une unité facturable de la devise indiqué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 des accords.
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.

Si vous attribuez un algorithme d'enchères personnalisées qui utilise des activités Floodlight non identifiées dans floodlightActivityConfigs, une erreur sera renvoyée.

BiddingStrategyPerformanceGoalType

Types possibles d'objectif de performances pour une 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 Lectures terminées, visibles et audibles
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Vues avec durée de visionnage supérieure à 10 secondes.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Impressions visibles.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH Maximisez votre couverture.

PerformanceGoalBidStrategy

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

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 micro-unités de la devise de l'annonceur ou en micro-unités de la valeur du ROAS (retour sur les dépenses publicitaires), qui est également basé 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 propre limite supérieure :

  • lorsque performanceGoalType est BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, la limite supérieure est de 10 000 USD.
  • lorsque performanceGoalType est BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, la limite supérieure est de 1 000 USD.
  • lorsque 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 la valeur est définie sur 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 l'objectif de CPM visible 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 € de CPM (40% de 2 €).

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

string (int64 format)

CPM moyen maximal pouvant être enchéri, en micros de la devise de l'annonceur. Doit être supérieur ou égal à une unité facturable de la devise indiquée. Ne s'applique pas lorsque performanceGoalType est défini sur BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

Par exemple, 1500000 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.

Si vous attribuez un algorithme d'enchères personnalisées qui utilise des activités Floodlight non identifiées dans floodlightActivityConfigs, une erreur sera renvoyée.

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 définie sur 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 de stratégies d'enchères possibles 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 YouTube de type "Réservation instantanée" qui paie un montant fixe par impression.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Cette stratégie d'enchères automatiques définit les enchères afin de 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 vidéo.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Stratégie d'enchères qui maximise automatiquement les revenus tout en atteignant un retour sur les dépenses publicitaires (ROAS) cible 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 d'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 d'enchère est héritée de l'élément de campagne.
BIDDING_SOURCE_AD_GROUP La valeur d'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 valeur 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 l'attribuez à 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, 1000000 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 définie sur 0.
effectiveBiddingValue

string (int64 format)

Uniquement en sortie. Valeur effectivement utilisée par la stratégie d'enchères. Si ce champ est défini, il sera identique à value. 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 ni 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 efficace.

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.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Stratégie d'enchères qui maximise automatiquement les revenus tout en atteignant un retour sur les dépenses publicitaires (ROAS) cible 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.