BiddingStrategy

Ustawienia sterujące strategią ustalania stawek. Strategia ustalania stawek określa stawkę.

Zapis JSON
{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}
Pola
Pole sumy bid_strategy_scheme. Wymagane. bid_strategy_scheme może mieć tylko jedną z tych wartości:
fixedBid

object (FixedBidStrategy)

Strategia ze stałą stawką.

maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

Strategia, która automatycznie dostosowuje stawkę pod kątem optymalizacji pod kątem docelowej skuteczności w ramach całego budżetu.

Na poziomie zamówienia reklamowego wartość markupType elementów zamówienia nie może mieć wartości PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM. Ponadto, gdy performanceGoalType jest jednym z tych elementów:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED

lineItemType elementów zamówienia reklamowego musi mieć jeden z tych elementów:

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT

a gdy performanceGoalType to:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

lineItemType elementów zamówienia reklamowego musi mieć wartość LINE_ITEM_TYPE_VIDEO_DEFAULT.

performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Strategia, która automatycznie dostosowuje stawkę, aby osiągnąć lub przekroczyć ustaloną docelową skuteczność. Ma być używane tylko w elemencie zamówienia.

FixedBidStrategy

Strategia ze stałą stawką.

Zapis JSON
{
  "bidAmountMicros": string
}
Pola
bidAmountMicros

string (int64 format)

Kwota stawki stałej w mikrowalucie reklamodawcy. W przypadku elementu zamówienia reklamowego pole bidAmountMicros powinno mieć wartość 0. W przypadku elementu zamówienia wartość bidAmountMicros musi być większa lub równa jednostki rozliczeniowej danej waluty i nie może być większa niż górny limit (1 000 000 000).

Na przykład 1500000 oznacza 1, 5 standardowej jednostki waluty.

MaximizeSpendBidStrategy

Strategia, która automatycznie dostosowuje stawkę, aby zoptymalizować określony cel skuteczności w ramach całego budżetu.

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

enum (BiddingStrategyPerformanceGoalType)

Wymagane. Rodzaj celu dotyczącego skuteczności, który strategia ustalania stawek stara się zminimalizować przy wydawaniu całego budżetu. Pole BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM nie jest obsługiwane w przypadku tej strategii.

maxAverageCpmBidAmountMicros

string (int64 format)

Maksymalna średnia stawka CPM, w mikrowalucie reklamodawcy. Wartość nie może być mniejsza od jednostki rozliczeniowej danej waluty.

Na przykład 1500000 oznacza 1, 5 standardowej jednostki waluty.

raiseBidForDeals

boolean

Czy strategia uwzględnia ceny minimalne umów.

customBiddingAlgorithmId

string (int64 format)

Identyfikator algorytmu ustalania stawek niestandardowych używanego przez tę strategię. Ma zastosowanie tylko wtedy, gdy zasada performanceGoalType ma wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

BiddingStrategyPerformanceGoalType

Możliwe typy celu dotyczącego skuteczności w strategii ustalania stawek.

Wartości w polu enum
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA Koszt działania.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Koszt kliknięcia.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM CPM widocznych reklam.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO Algorytm ustalania stawek niestandardowych.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA Ukończone wyświetlenia niewidoczne z włączonym dźwiękiem.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Czas wyświetlania (ponad 10 sekund)
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Widoczne wyświetlenia.

PerformanceGoalBidStrategy

Strategia, która automatycznie dostosowuje stawkę, aby osiągnąć lub przekroczyć ustaloną docelową skuteczność.

Zapis JSON
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
Pola
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Wymagane. Rodzaj celu dotyczącego skuteczności, który strategia ustalania stawek chce osiągnąć lub przekroczyć.

Aby można było używać na poziomie elementu zamówienia, wartość musi wynosić jedną z tych wartości:

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

Wymagane. Docelową skuteczność, którą strategia ustalania stawek będzie próbowała osiągnąć lub przekroczyć, w mikrowalucie reklamodawcy lub w mikro wartości ROAS (zwrotu z nakładów na reklamę), która jest też zależna od waluty reklamodawcy. Wartość nie może być mniejsza od jednostki rozliczeniowej danej waluty i musi być mniejsza od górnej granicy lub jej równa. Każdy element typu performanceGoalType ma swoją górną granicę:

  • gdy performanceGoalType to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, górna granica to 10 000.00 PLN.
  • gdy performanceGoalType to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC, górna granica to 1000.00 PLN.
  • gdy performanceGoalType to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, górna granica to 1000.00 PLN.
  • gdy performanceGoalType to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO, górna granica to 1000,00, a dolna 0,01.

Przykład: jeśli ustawisz wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, stawka będzie ustalana na podstawie prawdopodobieństwa, że każde dostępne wyświetlenie będzie widoczne. Jeśli np.docelowy CPM widocznych reklam wynosi 2 zł, a wyświetlenie ma 40% szans na widoczność, stawka CPM wyniesie 0,80 zł (CPM) (40% z 2 zł).

Na przykład 1500000 oznacza 1, 5 standardowej jednostki waluty lub wartości ROAS.

maxAverageCpmBidAmountMicros

string (int64 format)

Maksymalna średnia stawka CPM, w mikrowalucie reklamodawcy. Wartość nie może być mniejsza od jednostki rozliczeniowej danej waluty. Nie ma zastosowania, gdy performanceGoalType ma wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

Na przykład 1500000 oznacza 1, 5 standardowej jednostki waluty.

customBiddingAlgorithmId

string (int64 format)

Identyfikator algorytmu ustalania stawek niestandardowych używanego przez tę strategię. Ma zastosowanie tylko wtedy, gdy zasada performanceGoalType ma wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.