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 się wzajemnie 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ć ją pod kątem celu skuteczności przy wykorzystaniu pełnego budżetu.

Na poziomie zamówienia reklamowego nie można ustawić wartości 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 w przypadku elementów zamówienia w tym zamówieniu reklamowym:

  • 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 LINE_ITEM_TYPE_DISPLAY_DEFAULT lub LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • W przypadku pól 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 zezwala tylko na elementy zamówienia LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

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

object (YoutubeAndPartnersBiddingStrategy)

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

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

object (DemandGenBiddingStrategy)

Strategia ustalania stawek używana przez zasoby kampanii generujących popyt.

Można go używać tylko w przypadku elementu zamówienia generującego popyt lub grupy reklam.
Koniec pól wykluczających się nawzajem.

FixedBidStrategy

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

Zapis JSON 
{
  "bidAmountMicros": string
}
Pola
bidAmountMicros

string (int64 format)

Stała kwota stawki w mikro jednostkach 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 w danej walucie i mniejsza lub równa górnej granicy 1000000000.

Na przykład 1500000 oznacza 1, 5 jednostki standardowej 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. Rodzaj celu skuteczności, który strategia ustalania stawek próbuje 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, który może być użyty do ustalania stawek, w mikro waluty reklamodawcy. Musi być równa jednostce rozliczeniowej w danej walucie lub od niej większa.

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

boolean

Czy strategia uwzględnia ceny minimalne transakcji.
customBiddingAlgorithmId

string (int64 format)

Identyfikator algorytmu 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 korzysta z aktywności Floodlight nieokreślonych w floodlightActivityConfigs, spowoduje wyświetlenie błędu.

BiddingStrategyPerformanceGoalType

Możliwe typy celu 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 w czasie 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. Rodzaj celu skuteczności, który strategia ustalania stawek będzie próbować 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ć osiągnąć lub przekroczyć, w mikro jednostkach waluty reklamodawcy lub w mikro jednostkach 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 w danej walucie i mniejsza lub równa górnej granicy. Każdy performanceGoalType ma górną granicę:

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

Przykład: jeśli ustawisz tę opcję na BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, cena stawki będzie zależeć od 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-procentowe prawdopodobieństwo widoczności, cena stawki 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, który może być użyty do ustalania stawek, w mikro waluty reklamodawcy. Musi być równa jednostce rozliczeniowej w danej walucie lub od niej większa. Nie ma zastosowania, gdy wartość performanceGoalType to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

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

string (int64 format)

Identyfikator algorytmu 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 korzysta z aktywności Floodlight nieokreślonych w floodlightActivityConfigs, spowoduje wyświetlenie błędu.

YoutubeAndPartnersBiddingStrategy

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

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 w przypadku 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 wynosi 0.
adGroupEffectiveTargetCpaValue

string (int64 format)

Tylko dane wyjściowe. Efektywny docelowy CPA w grupie reklam w mikrojednostkach waluty reklamodawcy.
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Tylko dane wyjściowe. Źródło efektywnej wartości docelowego CPA w grupie reklam.

YoutubeAndPartnersBiddingStrategyType

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

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, w której płacisz konfigurowalną kwotę za obejrzenie filmu.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Strategia ustalania stawek, w której płacisz konfigurowalną kwotę za wyświetlenie.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Strategia ustalania stawek, która automatycznie optymalizuje konwersje w przeliczeniu na 1 zł.
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 Szybkiej rezerwacji w YouTube, która płaci stałą kwotę 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 obejrzenia filmu.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Strategia ustalania stawek, która automatycznie maksymalizuje przychody przy zachowaniu określonego 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 tak, aby maksymalizować przychody w ramach określonego budżetu.

BiddingSource

Źródło wartości stawki.

Wartości w polu enum
BIDDING_SOURCE_UNSPECIFIED Źródło reklam z ustalaniem stawek nie zostało określone lub jest nieznane.
BIDDING_SOURCE_LINE_ITEM Wartość określania stawek jest dziedziczona z elementu zamówienia.
BIDDING_SOURCE_AD_GROUP Wartość określania stawek jest zdefiniowana 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 je ustawić tylko wtedy, gdy są przypisane 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 ją ustawić po przypisaniu 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 podana w mikrojednostkach waluty reklamodawcy lub w wartości 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 wynosi 0.
effectiveBiddingValue

string (int64 format)

Tylko dane wyjściowe. Wartość skutecznie wykorzystywana przez strategię ustalania stawek. Jeśli to pole jest ustawione, ma taką samą wartość jak pole 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 wartość type nie jest równa DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA ani DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS, to pole ma 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 w przeliczeniu na 1 zł.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Strategia ustalania stawek, która automatycznie maksymalizuje przychody przy zachowaniu określonego 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 przy jednoczesnym wykorzystywaniu budżetu.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS Strategia określania stawek, która automatycznie maksymalizuje liczbę kliknięć w ramach określonego budżetu.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC Strategia określania stawek, która automatycznie optymalizuje koszt kliknięcia.