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 aggiusta automaticamente l'offerta per ottimizzare il rendimento in base all'obiettivo di rendimento, spendendo 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 ,

il 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 aggiusta 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 YouTube e partner. Può essere utilizzato solo per un elemento pubblicitario o un gruppo di annunci 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à elemento pubblicitario, bidAmountMicros deve essere maggiore o uguale all'unità fatturabile della valuta specificata e inferiore o uguale al limite superiore 1000000000.

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

MaximizeSpendBidStrategy

Una strategia che aggiusta 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 tenta di minimizzare 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 offerta personalizzata utilizzato da questa strategia. Applicabile solo quando performanceGoalType è impostato su BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

L'assegnazione di un algoritmo di offerta personalizzato che utilizza attività Floodlight non identificate in floodlightActivityConfigs restituirà un errore.

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 offerta personalizzata.
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 aggiusta 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 tenterà di raggiungere o superare, in micro della valuta dell'inserzionista o in micro del valore ROAS (Return On Advertising Spend), anch'esso basato 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 è 10.000 USD.
  • quando performanceGoalType è BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, il limite superiore è 1000 USD.
  • quando performanceGoalType è BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, il limite superiore è 1000 USD.
  • 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 CPM visibile target è di 2 $e un'impressione ha il 40% di probabilità di essere visibile, il prezzo dell'offerta sarà di 0,80 $CPM (il 40% di 2 $).

Ad esempio, 1500000 rappresenta 1,5 unità standard del valore di valuta o 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 offerta personalizzata utilizzato da questa strategia. Applicabile solo quando performanceGoalType è impostato su BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

L'assegnazione di un algoritmo di offerta personalizzato che utilizza attività Floodlight non identificate in floodlightActivityConfigs restituirà un errore.

YoutubeAndPartnersBiddingStrategy

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

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 ai 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 ai 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 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 paga un importo configurabile per ogni visualizzazione del 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 per ottenere il massimo incremento.
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 mantenendo una 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 nei limiti di spesa del budget.

BiddingSource

Origine del valore dell'offerta.

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