BiddingStrategy

Teklif stratejisini kontrol eden ayarlar. Teklif stratejisi, teklif fiyatını belirler.

JSON gösterimi
{

  // 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.
}
Alanlar
Zorunlu. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
fixedBid

object (FixedBidStrategy)

Sabit teklif verme kullanan bir strateji.

maximizeSpendAutoBid

object (MaximizeSpendBidStrategy)

Bütçenin tamamını harcarken performans hedefinize göre optimizasyon yapmak için teklifi otomatik olarak ayarlayan bir strateji.

Kampanya siparişi düzeyinde, satır öğelerinin markupType değeri PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM olarak ayarlanamaz.

Ayrıca, bir kampanya siparişine atanan performanceGoalType değeri, bu kampanya siparişinin altındaki satır öğeleri için kullanılabilen olası lineItemType değerlerini belirler:

  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC ve BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED yalnızca LINE_ITEM_TYPE_DISPLAY_DEFAULT veya LINE_ITEM_TYPE_VIDEO_DEFAULT satır öğelerine izin verir.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA ve BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN yalnızca LINE_ITEM_TYPE_VIDEO_DEFAULT satır öğelerine izin verir.
  • BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH yalnızca LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP satır öğesine izin verir.
performanceGoalAutoBid

object (PerformanceGoalBidStrategy)

Belirli bir performans hedefine ulaşmak veya bu hedefi aşmak için teklifi otomatik olarak ayarlayan bir strateji. Yalnızca bir satır öğesi varlığı için kullanılmalıdır.

youtubeAndPartnersBid

object (YoutubeAndPartnersBiddingStrategy)

YouTube ve İş Ortakları kaynakları tarafından kullanılan bir teklif stratejisi.

Yalnızca YouTube ve iş ortakları satır öğesi veya reklam grubu öğesi için kullanılabilir.

demandGenBid

object (DemandGenBiddingStrategy)

Talep Yaratma kaynakları tarafından kullanılan bir teklif stratejisi.

Yalnızca Talep Yaratma satır öğesi veya reklam grubu öğesi için kullanılabilir.

Birbirini hariç tutan alanların sonu.

FixedBidStrategy

Sabit teklif verme kullanan bir strateji.

JSON gösterimi
{
  "bidAmountMicros": string
}
Alanlar
bidAmountMicros

string (int64 format)

Reklamverenin para biriminin mikro cinsinden sabit teklif tutarı. Kampanya siparişi öğesi için bidAmountMicros 0 olarak ayarlanmalıdır. Satır öğesi için bidAmountMicros, belirtilen para biriminin faturalandırılabilir biriminden büyük veya bu birime eşit ve 1.000.000.000 üst sınırından küçük veya bu sınıra eşit olmalıdır.

Örneğin, 1500000, para biriminin 1,5 standart birimini temsil eder.

MaximizeSpendBidStrategy

Bütçenin tamamını harcarken belirli bir performans hedefini optimize etmek için teklifi otomatik olarak ayarlayan strateji.

JSON gösterimi
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "maxAverageCpmBidAmountMicros": string,
  "raiseBidForDeals": boolean,
  "customBiddingAlgorithmId": string
}
Alanlar
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Zorunlu. Teklif stratejisinin bütçenin tamamını harcarken en aza indirmeye çalıştığı performans hedefinin türü. BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM bu strateji için desteklenmiyor.

maxAverageCpmBidAmountMicros

string (int64 format)

Reklamverenin para biriminin mikro birimi cinsinden teklif verilebilecek maksimum ortalama BGBM. Belirtilen para biriminin faturalandırılabilir birimine eşit veya ondan büyük olmalıdır.

Örneğin, 1500000, para biriminin 1,5 standart birimini temsil eder.

raiseBidForDeals

boolean

Stratejinin anlaşma taban fiyatlarını dikkate alıp almadığı.

customBiddingAlgorithmId

string (int64 format)

Bu strateji tarafından kullanılan özel teklif verme algoritmasının kimliği. Yalnızca performanceGoalType, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO olarak ayarlandığında geçerlidir.

floodlightActivityConfigs içinde tanımlanmayan Floodlight etkinliklerini kullanan bir özel teklif algoritması atandığında hata döndürülür.

BiddingStrategyPerformanceGoalType

Teklif stratejisi için olası performans hedefi türleri.

Sıralamalar
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED Tür değeri belirtilmemiş veya bu sürümde bilinmiyor.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA İşlem başına maliyet.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC Tıklama başına maliyet.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM Görüntülenebilir BGBM.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO Özel teklif verme algoritması.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA Tamamlanmış görüntülü ve sesli görüntülemeler.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN 10 saniyeden uzun görüntüleme süresi görüntülemeleri.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED Görüntülenebilir gösterimler.
BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_REACH Erişimi artırma

PerformanceGoalBidStrategy

Belirli bir performans hedefine ulaşmak veya bu hedefi aşmak için teklifi otomatik olarak ayarlayan bir strateji.

JSON gösterimi
{
  "performanceGoalType": enum (BiddingStrategyPerformanceGoalType),
  "performanceGoalAmountMicros": string,
  "maxAverageCpmBidAmountMicros": string,
  "customBiddingAlgorithmId": string
}
Alanlar
performanceGoalType

enum (BiddingStrategyPerformanceGoalType)

Zorunlu. Teklif stratejisinin karşılamaya veya aşmaya çalışacağı performans hedefinin türü.

Satır öğesi düzeyinde kullanım için değer aşağıdakilerden biri olmalıdır:

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

Zorunlu. Teklif stratejisinin karşılamaya veya aşmaya çalışacağı performans hedefi. Reklamverenin para biriminin mikro değeri veya reklamverenin para birimine dayalı reklam harcamasının getirisi (ROAS) değerinin mikro değeri cinsinden ifade edilir. Belirtilen para biriminin faturalandırılabilir biriminden büyük veya bu birime eşit ve üst sınırlardan küçük ya da üst sınırlara eşit olmalıdır. Her performanceGoalType için üst sınır vardır:

  • performanceGoalType, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA olduğunda üst sınır 10.000,00 ABD dolarıdır.
  • performanceGoalType, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC olduğunda üst sınır 1.000,00 ABD dolarıdır.
  • performanceGoalType, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM olduğunda üst sınır 1.000,00 ABD dolarıdır.
  • performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO olduğunda üst sınır 1.000,00, alt sınır ise 0,01'dir.

Örnek: BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM olarak ayarlanırsa teklif fiyatı, her kullanılabilir gösterimin görüntülenebilir olma olasılığına göre belirlenir. Örneğin, görüntülenebilir BGBM hedefi 2 TL ise ve bir gösterimin görüntülenebilir olma olasılığı% 40 ise teklif fiyatı 0, 80 TL BGBM (2 TL'nin% 40'ı) olur.

Örneğin, 1500000, para biriminin veya ROAS değerinin 1,5 standart birimini temsil eder.

maxAverageCpmBidAmountMicros

string (int64 format)

Reklamverenin para biriminin mikro birimi cinsinden teklif verilebilecek maksimum ortalama BGBM. Belirtilen para biriminin faturalandırılabilir birimine eşit veya ondan büyük olmalıdır. performanceGoalType, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM olarak ayarlandığında geçerli değildir.

Örneğin, 1500000, para biriminin 1,5 standart birimini temsil eder.

customBiddingAlgorithmId

string (int64 format)

Bu strateji tarafından kullanılan özel teklif verme algoritmasının kimliği. Yalnızca performanceGoalType, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO olarak ayarlandığında geçerlidir.

floodlightActivityConfigs içinde tanımlanmayan Floodlight etkinliklerini kullanan bir özel teklif algoritması atandığında hata döndürülür.

YoutubeAndPartnersBiddingStrategy

YouTube ve iş ortakları kaynakları için teklif stratejisini kontrol eden ayarlar.

JSON gösterimi
{
  "type": enum (YoutubeAndPartnersBiddingStrategyType),
  "value": string,
  "adGroupEffectiveTargetCpaValue": string,
  "adGroupEffectiveTargetCpaSource": enum (BiddingSource)
}
Alanlar
type

enum (YoutubeAndPartnersBiddingStrategyType)

Teklif stratejisinin türü.

value

string (int64 format)

Teklif stratejisi tarafından kullanılan değer.

Teklif stratejisi satır öğesi düzeyinde atandığında bu alan yalnızca aşağıdaki strateji türleri için geçerlidir:

  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Teklif stratejisi reklam grubu düzeyinde atandığında bu alan yalnızca aşağıdaki strateji türleri için geçerlidir:

  • 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

Geçerli bir strateji kullanılmıyorsa bu alanın değeri 0 olur.

adGroupEffectiveTargetCpaValue

string (int64 format)

Yalnızca çıkış. Reklamverenin para biriminin mikro birimi cinsinden reklam grubu için geçerli hedef EBM.

adGroupEffectiveTargetCpaSource

enum (BiddingSource)

Yalnızca çıkış. Reklam grubu için geçerli hedef EBM değerinin kaynağı.

YoutubeAndPartnersBiddingStrategyType

YouTube ve İş Ortakları kaynakları için olası teklif stratejisi türleri.

Sıralamalar
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_UNSPECIFIED Tür belirtilmemiş veya bilinmiyor.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPV Video görüntüleme başına yapılandırılabilir bir tutar ödeyen teklif stratejisi.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MANUAL_CPM Gösterim başına yapılandırılabilir bir tutar ödeyen teklif stratejisi.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPA Dolar başına dönüşümleri otomatik olarak optimize eden bir teklif stratejisi.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM Gösterim başına yapılandırılabilir bir tutar ödeyen teklif stratejisi.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_RESERVE_CPM YouTube Anında Rezervasyon ayrılmış satır öğeleri için gösterim başına sabit bir tutar ödeyen teklif stratejisi.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_LIFT Teklifleri maksimum artış elde edecek şekilde ayarlayan otomatik teklif stratejisi.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Günlük bütçe dahilinde dönüşüm sayısını otomatik olarak artıran bir teklif stratejisidir.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV Video görüntüleme başına maliyeti otomatik olarak optimize eden bir teklif stratejisidir.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS Reklam harcamalarından elde edilen gelir hedefi (ROAS) için belirli bir ortalama değeri korurken geliri otomatik olarak en üst düzeye çıkaran teklif stratejisidir.
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Bütçenizi harcarken geliri artırmak için teklifleri otomatik olarak ayarlayan bir teklif stratejisi.

BiddingSource

Teklif değerinin kaynağı.

Sıralamalar
BIDDING_SOURCE_UNSPECIFIED Teklifli sistem kaynağı belirtilmemiş veya bilinmiyor.
BIDDING_SOURCE_LINE_ITEM Teklif değeri, satır öğesinden devralınır.
BIDDING_SOURCE_AD_GROUP Teklif değeri reklam grubunda tanımlanır.

DemandGenBiddingStrategy

Talep Yaratma kaynaklarının teklif stratejisini kontrol eden ayarlar.

JSON gösterimi
{
  "type": enum (DemandGenBiddingStrategyType),
  "value": string,
  "effectiveBiddingValue": string,
  "effectiveBiddingValueSource": enum (BiddingSource)
}
Alanlar
type

enum (DemandGenBiddingStrategyType)

İsteğe bağlıdır. Teklif stratejisinin türü.

Bu, yalnızca bir satır öğesine atandığında ayarlanabilir. Reklam grupları bu değeri satır öğelerinden devralır.

value

string (int64 format)

İsteğe bağlıdır. Teklif stratejisi tarafından kullanılan değer. Bu, satır öğelerine veya reklam gruplarına atandığında ayarlanabilir. Bu alan yalnızca aşağıdaki strateji türleri için geçerlidir:

  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC
  • DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS

Bu alanın değeri, reklamverenin para biriminin mikro değeri veya ROAS değeridir. Örneğin, 1000000, para biriminin 1,0 standart birimini veya% 100 ROAS değerini temsil eder. Geçerli bir strateji kullanılmıyorsa bu alanın değeri 0 olur.

effectiveBiddingValue

string (int64 format)

Yalnızca çıkış. Teklif stratejisi tarafından etkili bir şekilde kullanılan değer. Bu alan, ayarlanmışsa value ile aynı olur. value ayarlanmazsa ve strateji bir reklam grubuna atanırsa bu alan, satır öğesinin teklif stratejisinden devralınır.

type, DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA veya DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS değilse bu alan 0 olur.

effectiveBiddingValueSource

enum (BiddingSource)

Yalnızca çıkış. Geçerli teklif değerinin kaynağı.

DemandGenBiddingStrategyType

Talep Yaratma kaynakları için olası teklif stratejisi türleri.

Sıralamalar
DEMAND_GEN_BIDDING_STRATEGY_TYPE_UNSPECIFIED Tür belirtilmemiş veya bilinmiyor.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA Dolar başına dönüşümleri otomatik olarak optimize eden bir teklif stratejisi.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_ROAS Reklam harcamalarından elde edilen gelir hedefi (ROAS) için belirli bir ortalama değeri korurken geliri otomatik olarak en üst düzeye çıkaran teklif stratejisidir.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSIONS Dönüşüm sayısını otomatik olarak artıran bir teklif stratejisi
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE Bütçenizi harcarken geliri otomatik olarak artıran bir teklif stratejisi.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_MAXIMIZE_CLICKS Belirli bir bütçe dahilinde tıklamaları otomatik olarak artıran bir teklif stratejisidir.
DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPC Tıklama başına maliyeti otomatik olarak optimize eden bir teklif stratejisi.