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)
  },
  "youtubeAndPartnersBid": {
    object (YoutubeAndPartnersBiddingStrategy)
  }
  // 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.
youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

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

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

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.

YoutubeAndPartnersBiddingStrategy

Ustawienia sterujące 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.

Jeśli 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

Jeśli 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 korzystasz z odpowiedniej strategii, wartość w tym polu będzie wynosić 0.
adGroupEffectiveTargetCpaValue

string (int64 format)

Tylko dane wyjściowe. Rzeczywisty docelowy CPA dla grupy reklam w mikrowalucie reklamodawcy.
adGroupEffectiveTargetCpaSource

enum (BiddingSource)

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

YoutubeAndPartnersBiddingStrategyType

Możliwe typy strategii ustalania stawek w zasobach dotyczących YouTube i sieci partnerów wideo Google.

Wartości w polu enum
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED Typ nie jest określony lub nieznany.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV To strategia ustalania stawek, w której za wyświetlenie filmu płaci się kwotę, którą można skonfigurować.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Strategia ustalania stawek, która płaci za wyświetlenie kwotę, którą można skonfigurować.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Strategia ustalania stawek, która automatycznie optymalizuje liczbę konwersji na każdą wydaną złotówkę
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Strategia ustalania stawek, która płaci za wyświetlenie kwotę, którą można skonfigurować.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM Strategia ustalania stawek obowiązująca w przypadku elementów zamówienia z Szybką rezerwacją 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, by 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 ś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 tak, aby zmaksymalizować przychody w ramach określonego budżetu.

BiddingSource

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

Wartości w polu enum
BIDDING_SOURCE_UNSPECIFIED Źródło ustalania stawek nie zostało określone lub nieznane.
BIDDING_SOURCE_LINE_ITEM Wartość ustalania stawek jest przejmowana z elementu zamówienia.
BIDDING_SOURCE_AD_GROUP Wartość stawki jest zdefiniowana w grupie reklam.