BiddingStrategy

Impostazioni che controllano la strategia di offerta. La strategia di offerta determina il prezzo dell'offerta.

Rappresentazione JSON
{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}
Campi
Campo unione bid_strategy_scheme. Obbligatorio. bid_strategy_scheme può essere solo uno dei seguenti:
fixedBid

object (FixedBidStrategy)

Una strategia che utilizza un prezzo di offerta fisso.

maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

Una strategia che regola automaticamente l'offerta in base all'obiettivo di rendimento, spendendo al contempo l'intero budget.

A livello di ordine di inserzione, il markupType degli elementi pubblicitari non può essere impostato su PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM. Inoltre, quando performanceGoalType è uno dei seguenti valori:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ,

lineItemType degli elementi pubblicitari dell'ordine di inserzione deve essere:

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT ,

e quando performanceGoalType è:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

Il lineItemType degli elementi pubblicitari dell'ordine di inserzione deve essere LINE_ITEM_TYPE_VIDEO_DEFAULT.

performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Una strategia che regola automaticamente l'offerta per raggiungere o superare un obiettivo di rendimento specificato. Deve essere utilizzato solo per un'entità elemento pubblicitario.

youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

Una strategia di offerta utilizzata dalle risorse di YouTube e dei partner. Può essere utilizzato solo per un'entità di gruppo di annunci o elemento pubblicitario YouTube e partner.

FixedBidStrategy

Una strategia che utilizza un prezzo di offerta fisso.

Rappresentazione JSON
{
  "bidAmountMicros": string
}
Campi
bidAmountMicros

string (int64 format)

L'importo dell'offerta fissa, in micro della valuta dell'inserzionista. Per l'entità ordine di inserzione, bidAmountMicros deve essere impostato su 0. Per l'entità voce di fattura, bidAmountMicros deve essere maggiore o uguale all'unità fatturabile della valuta specificata e minore o uguale al limite superiore 1000000000.

Ad esempio, 1500000 rappresenta 1,5 unità standard della valuta.

MaximizeSpendBidStrategy

Una strategia che regola automaticamente l'offerta per ottimizzare un obiettivo di rendimento specificato spendendo l'intero budget.

Rappresentazione JSON
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
Campi
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Obbligatorio. Il tipo di obiettivo di rendimento che la strategia di offerta cerca di ridurre al minimo spendendo l'intero budget. BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM non è supportato per questa strategia.

maxAverageCpmBidAmountMicros

string (int64 format)

Il CPM medio massimo che può essere offerto, in micro della valuta dell'inserzionista. Deve essere maggiore o uguale a un'unità fatturabile della valuta specificata.

Ad esempio, 1500000 rappresenta 1,5 unità standard della valuta.

raiseBidForDeals

boolean

Se la strategia tiene conto dei prezzi minimi dei deal.

customBiddingAlgorithmId

string (int64 format)

L'ID dell'algoritmo di offerte personalizzate utilizzato da questa strategia. Applicabile solo quando performanceGoalType è impostato su BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

BiddingStrategyPerformanceGoalType

Possibili tipi di obiettivo di rendimento per la strategia di offerta.

Enum
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED Il valore del tipo non è specificato o è sconosciuto in questa versione.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA Costo per azione.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Costo per clic.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM CPM visibile.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO Algoritmo di offerte personalizzate.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA Visualizzazioni in-view e udibili completate.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Visualizzazioni con tempo di visualizzazione superiore a 10 secondi.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Impressioni visibili.

PerformanceGoalBidStrategy

Una strategia che regola automaticamente l'offerta per raggiungere o superare un obiettivo di rendimento specificato.

Rappresentazione JSON
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
Campi
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Obbligatorio. Il tipo di obiettivo di rendimento che la strategia di offerta tenterà di raggiungere o superare.

Per l'utilizzo a livello di elemento pubblicitario, il valore deve essere uno dei seguenti:

  • 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)

Obbligatorio. L'obiettivo di rendimento che la strategia di offerta cercherà di raggiungere o superare, in micro della valuta dell'inserzionista o in micro del valore del ROAS (ritorno sulla spesa pubblicitaria), che si basa anch'esso sulla valuta dell'inserzionista. Deve essere maggiore o uguale a un'unità fatturabile della valuta specificata e minore o uguale ai limiti superiori. Ogni performanceGoalType ha il proprio limite superiore:

  • quando performanceGoalType è BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, il limite superiore è 10000,00 $.
  • quando performanceGoalType è BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, il limite superiore è 1000,00 $.
  • quando performanceGoalType è BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, il limite superiore è 1000.00 $.
  • quando performanceGoalType è BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, il limite superiore è 1000,00 e il limite inferiore è 0,01.

Esempio: se impostato su BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, il prezzo dell'offerta si baserà sulla probabilità che ogni impressione disponibile sia visibile. Ad esempio, se il target CPM visibile è 2 $e un'impressione ha il 40% di probabilità di essere visibile, il prezzo dell'offerta sarà CPM 0,80 $ (40% di 2 $).

Ad esempio, 1500000 rappresenta 1,5 unità standard della valuta o del valore ROAS.

maxAverageCpmBidAmountMicros

string (int64 format)

Il CPM medio massimo che può essere offerto, in micro della valuta dell'inserzionista. Deve essere maggiore o uguale a un'unità fatturabile della valuta specificata. Non applicabile quando performanceGoalType è impostato su BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

Ad esempio, 1500000 rappresenta 1,5 unità standard della valuta.

customBiddingAlgorithmId

string (int64 format)

L'ID dell'algoritmo di offerte personalizzate utilizzato da questa strategia. Applicabile solo quando il criterio performanceGoalType è impostato su BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

YoutubeAndPartnersBiddingStrategy

Impostazioni che controllano la strategia di offerta per le risorse di YouTube e Partners.

Rappresentazione JSON
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
Campi
type

enum (YoutubeAndPartnersBiddingStrategyType)

Il tipo di strategia di offerta.

value

string (int64 format)

Il valore utilizzato dalla strategia di offerta.

Quando la strategia di offerta viene assegnata a livello di elemento pubblicitario, questo campo è applicabile solo per i seguenti tipi di strategia:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Quando la strategia di offerta viene assegnata a livello di gruppo di annunci, questo campo è applicabile solo per i seguenti tipi di strategia:

  • 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

Se non utilizzi una strategia applicabile, il valore di questo campo sarà 0.

adGroupEffectiveTargetCpaValue

string (int64 format)

Solo output. Il CPA target effettivo per il gruppo di annunci, in micro della valuta dell'inserzionista.

adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Solo output. Origine del valore del CPA target effettivo per il gruppo di annunci.

YoutubeAndPartnersBiddingStrategyType

Possibili tipi di strategia di offerta per le risorse di YouTube e partner.

Enum
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED Il tipo non è specificato o è sconosciuto.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV Una strategia di offerta che prevede il pagamento di un importo configurabile per ogni visualizzazione di video.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Una strategia di offerta che paga un importo configurabile per impressione.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Una strategia di offerta che ottimizza automaticamente le conversioni per dollaro.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Una strategia di offerta che paga un importo configurabile per impressione.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM Una strategia di offerta per gli elementi pubblicitari Prenotazione istantanea di YouTube che paga un importo fisso per impressione.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Una strategia di offerta automatica che imposta le offerte in modo da ottenere il massimo rendimento.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Una strategia di offerta che massimizza automaticamente il numero di conversioni in base a un budget giornaliero.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Una strategia di offerta che ottimizza automaticamente il costo per visualizzazione di video.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Una strategia di offerta che massimizza automaticamente le entrate, calcolando al contempo la media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Una strategia di offerta che imposta automaticamente le offerte in modo da massimizzare le entrate rispettando il budget.

BiddingSource

Origine del valore dell'offerta.

Enum
BIDDING_SOURCE_UNSPECIFIED L'origine asta non è specificata o è sconosciuta.
BIDDING_SOURCE_LINE_ITEM Il valore dell'offerta viene ereditato dall'elemento pubblicitario.
BIDDING_SOURCE_AD_GROUP Il valore di offerta è definito nel gruppo di annunci.