BiddingStrategy

Ustawienia, które kontrolują strategię ustalania stawek. Strategia ustalania stawek określa cenę stawki.

Zapis 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.
}
Pola
Wymagane. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
fixedBid

object (FixedBidStrategy)

Strategia, która używa stałej ceny stawki.

maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

Strategia, która automatycznie dostosowuje stawkę, aby optymalizować skuteczność pod kątem celu, przy jednoczesnym wykorzystaniu pełnego budżetu.

Na poziomie zamówienia reklamowego nie można ustawić markupType elementów zamówienia na PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM.

Dodatkowo wartość performanceGoalType przypisana do zamówienia reklamowego określa możliwe wartości lineItemType dostępne dla elementów zamówienia w ramach tego zamówienia reklamowego:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC i BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED zezwalają tylko na elementy zamówienia typu LINE_ITEM_TYPE_DISPLAY_DEFAULT lub LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • W przypadku BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA i BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN dozwolone są tylko elementy zamówienia typu LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH dopuszcza tylko LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP elementy zamówienia.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Strategia, która automatycznie dostosowuje stawkę, aby osiągnąć lub przekroczyć określony cel skuteczności. Można go używać tylko w przypadku elementu zamówienia.

youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

Strategia ustalania stawek używana przez zasoby YouTube i sieci partnerów wideo Google.

Można go używać tylko w przypadku elementu zamówienia typu YouTube i sieć partnerów wideo Google lub grupy reklam.

demandGenBid

object (DemandGenBiddingStrategy)

Strategia ustalania stawek używana przez kampanie generujące popyt.

Można go używać tylko w przypadku elementu zamówienia lub grupy reklam kampanii generującej popyt.

Koniec pól wykluczających się wzajemnie.

FixedBidStrategy

Strategia, która używa stałej ceny określania stawek.

Zapis JSON
{
  "bidAmountMicros": string
}
Pola
bidAmountMicros

string (int64 format)

Kwota stałej stawki w mikrowartościach waluty reklamodawcy. W przypadku encji zamówienia reklamowego wartość bidAmountMicros powinna być ustawiona na 0. W przypadku elementu zamówienia wartość bidAmountMicros musi być większa lub równa jednostce rozliczeniowej danej waluty i mniejsza lub równa górnemu limitowi 1 000 000 000.

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

MaximizeSpendBidStrategy

Strategia, która automatycznie dostosowuje stawkę, aby optymalizować określony cel skuteczności przy wykorzystaniu pełnego budżetu.

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

enum (BiddingStrategyPerformanceGoalType)

Wymagane. Typ celu skuteczności, który strategia ustalania stawek stara się zminimalizować, wydając cały budżet. BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM nie jest obsługiwany w przypadku tej strategii.

maxAverageCpmBidAmountMicros

string (int64 format)

Maksymalny średni CPM, jaki może być oferowany, w mikrowalucie reklamodawcy. Musi być równa jednostce rozliczeniowej danej waluty lub od niej większa.

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 parametr performanceGoalType ma wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

Przypisanie algorytmu ustalania stawek niestandardowych, który używa aktywności Floodlight niezidentyfikowanych w floodlightActivityConfigs, spowoduje błąd.

BiddingStrategyPerformanceGoalType

Możliwe typy celów skuteczności 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, widoczne i z włączonym dźwiękiem.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN Wyświetlenia z czasem widoczności powyżej 10 sekund.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Widoczne wyświetlenia.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH Maksymalizacja zasięgu.

PerformanceGoalBidStrategy

Strategia, która automatycznie dostosowuje stawkę, aby osiągnąć lub przekroczyć określony cel skuteczności.

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

enum (BiddingStrategyPerformanceGoalType)

Wymagane. Typ celu skuteczności, który strategia ustalania stawek będzie próbowała osiągnąć lub przekroczyć.

W przypadku użycia na poziomie elementu zamówienia wartość musi być jedną z tych:

  • 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. Cel skuteczności, który strategia ustalania stawek będzie próbowała osiągnąć lub przekroczyć, wyrażony w mikrojednostkach waluty reklamodawcy lub w mikrojednostkach wartości ROAS (zwrotu z nakładów na reklamę), która również jest oparta na walucie reklamodawcy. Musi być większa lub równa jednostce rozliczeniowej danej waluty i mniejsza lub równa górnej granicy. Każdy performanceGoalType ma górną granicę:

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

Przykład: jeśli ustawisz wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, cena stawki będzie oparta na prawdopodobieństwie, że każde dostępne wyświetlenie będzie widoczne. Jeśli na przykład docelowy CPM widocznych reklam wynosi 2 zł, a wyświetlenie ma 40-procentowe prawdopodobieństwo widoczności, stawka wyniesie 0,80 zł CPM (40% z 2 zł).

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

maxAverageCpmBidAmountMicros

string (int64 format)

Maksymalny średni CPM, jaki może być oferowany, w mikrowalucie reklamodawcy. Musi być równa jednostce rozliczeniowej danej waluty lub od niej większa. Nie dotyczy, gdy właściwość 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 parametr performanceGoalType ma wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO.

Przypisanie algorytmu ustalania stawek niestandardowych, który używa aktywności Floodlight niezidentyfikowanych w floodlightActivityConfigs, spowoduje błąd.

YoutubeAndPartnersBiddingStrategy

Ustawienia, które kontrolują strategię ustalania stawek w przypadku zasobów YouTube i sieci partnerów wideo Google.

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

enum (YoutubeAndPartnersBiddingStrategyType)

Typ strategii ustalania stawek.

value

string (int64 format)

Wartość używana przez strategię ustalania stawek.

Gdy strategia ustalania stawek jest przypisana na poziomie elementu zamówienia, to pole ma zastosowanie tylko w przypadku tych typów strategii:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Gdy strategia ustalania stawek jest przypisana na poziomie grupy reklam, to pole ma zastosowanie tylko do tych typów strategii:

  • 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

Jeśli nie używasz odpowiedniej strategii, wartość tego pola będzie wynosić 0.

adGroupEffectiveTargetCpaValue

string (int64 format)

Tylko dane wyjściowe. Efektywny docelowy CPA grupy reklam w mikrowalucie reklamodawcy.

adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Tylko dane wyjściowe. Źródło wartości skutecznego docelowego CPA dla grupy reklam.

YoutubeAndPartnersBiddingStrategyType

Możliwe typy strategii ustalania stawek w przypadku zasobów YouTube i sieci partnerów wideo Google.

Wartości w polu enum
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED Typ nie został określony lub jest nieznany.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV Strategia ustalania stawek, która płaci konfigurowalną kwotę za wyświetlenie filmu.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Strategia ustalania stawek, która płaci konfigurowalną kwotę za wyświetlenie.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Strategia ustalania stawek, która automatycznie optymalizuje konwersje na każdą wydaną złotówkę.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Strategia ustalania stawek, w której płacisz konfigurowalną kwotę za wyświetlenie.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM Strategia ustalania stawek w przypadku elementów zamówienia z Szybką rezerwacją w YouTube, która polega na płaceniu stałej kwoty za wyświetlenie.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Strategia automatycznego określania stawek, która ustala stawki tak, aby osiągnąć maksymalny wzrost.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Strategia ustalania stawek, która automatycznie maksymalizuje liczbę konwersji w ramach budżetu dziennego.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Strategia ustalania stawek, która automatycznie optymalizuje koszt wyświetlenia filmu.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Strategia ustalania stawek, która automatycznie maksymalizuje przychody przy zachowaniu określonego średniego docelowego zwrotu z nakładów na reklamę (ROAS).
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Strategia ustalania stawek, która automatycznie ustala stawki, aby maksymalizować przychody w ramach budżetu.

BiddingSource

Źródło wartości określania stawek.

Wartości w polu enum
BIDDING_SOURCE_UNSPECIFIED Źródło reklam z ustalaniem stawek jest nieokreślone lub nieznane.
BIDDING_SOURCE_LINE_ITEM Wartość określania stawek jest dziedziczona z elementu zamówienia.
BIDDING_SOURCE_AD_GROUP Wartość stawki jest określona w grupie reklam.

DemandGenBiddingStrategy

Ustawienia, które kontrolują strategię ustalania stawek w przypadku zasobów kampanii generujących popyt.

Zapis JSON
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
Pola
type

enum (DemandGenBiddingStrategyType)

Opcjonalnie: Typ strategii ustalania stawek.

Można to ustawić tylko wtedy, gdy jest przypisany do elementu zamówienia. Grupy reklam odziedziczą tę wartość z elementu zamówienia.

value

string (int64 format)

Opcjonalnie: Wartość używana przez strategię ustalania stawek. Można to ustawić podczas przypisywania do elementów zamówienia lub grup reklam. To pole ma zastosowanie tylko w przypadku tych typów strategii:

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Wartość tego pola jest podawana w mikrojednostkach waluty reklamodawcy lub jako wartość ROAS. Na przykład 1000000 oznacza 1, 0 jednostki standardowej waluty lub wartość ROAS na poziomie 100%. Jeśli nie używasz odpowiedniej strategii, wartość tego pola będzie wynosić 0.

effectiveBiddingValue

string (int64 format)

Tylko dane wyjściowe. Wartość skutecznie używana przez strategię ustalania stawek. Jeśli to pole jest ustawione, będzie takie samo jak value. Jeśli pole value nie jest ustawione, a strategia jest przypisana do grupy reklam, to pole zostanie odziedziczone ze strategii ustalania stawek elementu zamówienia.

Jeśli type nie jest DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA ani DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS, to pole będzie miało wartość 0.

effectiveBiddingValueSource

enum (BiddingSource)

Tylko dane wyjściowe. Źródło efektywnej wartości określania stawek.

DemandGenBiddingStrategyType

Możliwe typy strategii ustalania stawek w przypadku zasobów kampanii generujących popyt.

Wartości w polu enum
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED Typ nie został określony lub jest nieznany.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA Strategia ustalania stawek, która automatycznie optymalizuje konwersje na każdą wydaną złotówkę.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Strategia ustalania stawek, która automatycznie maksymalizuje przychody przy zachowaniu określonego średniego docelowego zwrotu z nakładów na reklamę (ROAS).
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Strategia ustalania stawek, która automatycznie maksymalizuje liczbę konwersji
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Strategia ustalania stawek, która automatycznie maksymalizuje przychody w ramach budżetu.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS Strategia ustalania stawek, która automatycznie maksymalizuje liczbę kliknięć w ramach danego budżetu.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC Strategia ustalania stawek, która automatycznie optymalizuje koszt kliknięcia.