BiddingStrategy

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

Zapis 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.
}
Pola
Pole zbiorcze bid_strategy_scheme. Wymagane. bid_strategy_scheme może mieć tylko jedną z tych wartości:
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 związanego ze skutecznością przy wykorzystaniu całego budżetu.

Na poziomie zamówienia reklamowego markupType elementów zamówienia nie może być ustawione na PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM. Dodatkowo, 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 w zamówieniu reklamowym musi być:

  • LINE_ITEM_TYPE_DISPLAY_DEFAULT
  • LINE_ITEM_TYPE_VIDEO_DEFAULT ,

oraz gdy performanceGoalType jest:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN

lineItemType elementów zamówienia w zamówieniu reklamowym musi wynosić LINE_ITEM_TYPE_VIDEO_DEFAULT.

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 partnerów. Można go używać tylko w przypadku elementu zamówienia lub grupy reklam typu YouTube i sieć partnerów wideo Google.

FixedBidStrategy

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

Zapis JSON
{
  "bidAmountMicros": string
}
Pola
bidAmountMicros

string (int64 format)

Stała kwota stawki w milionowych częściach waluty reklamodawcy. W przypadku elementu zamówienia reklamowego wartość bidAmountMicros powinna być ustawiona na 0. W przypadku jednostki 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 waluty.

MaximizeSpendBidStrategy

Strategia, która automatycznie dostosowuje stawkę, aby optymalizować określony cel skuteczności przy jednoczesnym wykorzystaniu całego 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. W przypadku tej strategii atrybut BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM nie jest obsługiwany.

maxAverageCpmBidAmountMicros

string (int64 format)

Maksymalny średni CPM, jaki można zastosować w przypadku określania stawek, w mikro jednostkach waluty reklamodawcy. Musi być równa jednostce rozliczeniowej w danej walucie lub od niej większa.

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

raiseBidForDeals

boolean

Czy strategia uwzględnia ceny minimalne transakcji.

customBiddingAlgorithmId

string (int64 format)

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

Przypisanie algorytmu określania stawek niestandardowych, który korzysta z aktywności Floodlight nieokreślonych w floodlightActivityConfigs, spowoduje zwrócenie 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,

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 związanego ze 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,00 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 to 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 na przykład docelowa stawka CPM widocznych reklam wynosi 2 zł, a wyświetlenie ma 40% szans na widoczność, stawka wyniesie 0,80 zł CPM (40% z 2 zł).

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

maxAverageCpmBidAmountMicros

string (int64 format)

Maksymalny średni CPM, jaki można zastosować w przypadku określania stawek, w mikro jednostkach waluty reklamodawcy. Musi być równa jednostce rozliczeniowej w danej walucie lub od niej większa. Nie ma zastosowania, gdy performanceGoalType ma wartość BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM.

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

customBiddingAlgorithmId

string (int64 format)

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

Przypisanie algorytmu określania stawek niestandardowych, który korzysta z aktywności Floodlight nieokreślonych w floodlightActivityConfigs, spowoduje zwrócenie 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 mikro jednostkach waluty reklamodawcy.

adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Tylko dane wyjściowe. Źródło skutecznej 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 liczbę konwersji 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 Szybka rezerwacja 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 uzyskać 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 określania 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 budżetu.

BiddingSource

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

Wartości w polu enum
BIDDING_SOURCE_UNSPECIFIED Źródło określania stawek nie jest 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śla się w grupie reklam.