- Kaynak: Kampanya Siparişi
- InsertionOrderType
- Kpi
- KpiType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- OptimizationObjective
- Yöntemler
Kaynak: Kampanya Siparişi
Tek bir kampanya siparişi.
JSON gösterimi |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Kampanya siparişinin kaynak adı. |
advertiserId |
Yalnızca çıkış. Kampanya siparişinin ait olduğu reklamverenin benzersiz kimliği. |
campaignId |
Zorunlu. Sabit. Kampanya siparişinin ait olduğu kampanyanın benzersiz kimliği. |
insertionOrderId |
Yalnızca çıkış. Kampanya siparişinin benzersiz kimliği. Sistem tarafından atanır. |
displayName |
Zorunlu. Kampanya siparişinin görünen adı. Maksimum 240 bayt boyutta UTF-8 olarak kodlanmış olmalıdır. |
insertionOrderType |
Kampanya siparişinin türü. Oluşturma sırasında bu alan belirtilmemişse değer varsayılan olarak |
entityStatus |
Zorunlu. Kampanya siparişinin, bütçesini ve envanter teklifini harcayıp harcamayacağını kontrol eder.
|
updateTime |
Yalnızca çıkış. Kampanya siparişinin en son güncellendiği zaman damgası. Sistem tarafından atanır. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
partnerCosts[] |
Kampanya siparişiyle ilişkili iş ortağı maliyetleri.
|
pacing |
Zorunlu. Kampanya siparişinin bütçe harcama hızı ayarı. |
frequencyCap |
Zorunlu. Kampanya siparişinin sıklık sınırı ayarı. |
integrationDetails |
Kampanya siparişinin ek entegrasyon ayrıntıları. |
kpi |
Zorunlu. Kampanya siparişinin temel performans göstergesi (KPI). Bu, "Hedef" olarak ifade edilir. ve Görüntülü Reklam Ağı'nda Video 360 arayüzü. |
budget |
Zorunlu. Kampanya siparişinin bütçe ayırma ayarları. |
bidStrategy |
Kampanya siparişinin teklif stratejisi. Varsayılan olarak |
reservationType |
Yalnızca çıkış. Kampanya siparişinin rezervasyon türü. |
optimizationObjective |
İsteğe bağlı. Kampanya siparişinin optimizasyon hedefi. Bu alan yalnızca izin verilenler listesindeki müşteriler tarafından kullanılabilir. Bir müşteri izin verilenler listesinde değilse bu alan boş olur ve ayarlamaya çalışırsa hata verilir. |
InsertionOrderType
Olası Kampanya Siparişi türleri.
Kampanya Siparişi'nin türü, hangi ayar ve seçeneklerin (ör. reklamların biçimi veya hedefleme seçenekleri) geçerli olduğunu belirler.
Sıralamalar | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
Kampanya siparişi türü belirtilmedi veya bilinmiyor. |
RTB |
Gerçek zamanlı teklif verme. |
OVER_THE_TOP |
Baypas. |
TPG
Kampanya siparişinin temel performans göstergesini veya TPG'sini kontrol eden ayarlar.
JSON gösterimi |
---|
{ "kpiType": enum ( |
Alanlar | |
---|---|
kpiType |
Zorunlu. TPG'nin türü. |
kpiAlgorithmId |
İsteğe bağlı. KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST ile ilişkili Özel Teklif Algoritması Kimliği. Uygun TPG seçilmezse bu alan yoksayılır. |
Birleştirme alanı kpi_value . Zorunlu. TPG'nin değeri. İlgili alan, kpi_type öğesine karşılık gelir. kpi_value şunlardan yalnızca biri olabilir: |
|
kpiAmountMicros |
Reklamverenin para biriminin mikro cinsinden hedef tutarı.
Örneğin: 1500000, para biriminin 1,5 standart birimini temsil eder. |
kpiPercentageMicros |
Hedef yüzdesinin mikro cinsinden ondalık gösterimi.
Örneğin: 70000, %7'yi (ondalık 0,07) temsil eder. |
kpiString |
Boş olabilecek bir TPG dizesi. UTF-8 olarak kodlanmış ve en fazla 100 karakter uzunluğunda olmalıdır.
|
KpiType
Olası temel performans göstergesi (KPI) türleri.
Sıralamalar | |
---|---|
KPI_TYPE_UNSPECIFIED |
TPG türü belirtilmedi veya bu sürümde bilinmiyor. |
KPI_TYPE_CPM |
TPG, BGBM'dir (bin gösterim başına maliyet). |
KPI_TYPE_CPC |
TPG, TBM'dir (tıklama başına maliyet). |
KPI_TYPE_CPA |
TPG, EBM'dir (işlem başına maliyet). |
KPI_TYPE_CTR |
TPG, TO (tıklama oranı) yüzdesidir. |
KPI_TYPE_VIEWABILITY |
TPG, görüntülenebilirlik yüzdesidir. |
KPI_TYPE_CPIAVC |
TPG, CPIAVC'dir (tamamlandığında sesli ve görünür gösterim başına maliyet). |
KPI_TYPE_CPE |
TPG, ETBM'dir (etkileşim başına maliyet). |
KPI_TYPE_CPV |
KPI, GBM (görüntüleme başına maliyet) olarak ayarlanır. |
KPI_TYPE_CLICK_CVR |
TPG, tıklama dönüşüm oranı (tıklama başına dönüşüm sayısı) yüzdesidir. |
KPI_TYPE_IMPRESSION_CVR |
TPG, gösterim dönüşüm oranı (gösterim başına dönüşüm sayısı) yüzdesidir. |
KPI_TYPE_VCPM |
TPG, GBGBM'dir (bin görüntülenebilir gösterim başına maliyet). |
KPI_TYPE_VTR |
TPG, YouTube görüntüleme oranı (gösterim başına YouTube görüntüleme sayısı) yüzdesidir. |
KPI_TYPE_AUDIO_COMPLETION_RATE |
TPG, ses tamamlanma oranı (gösterim başına tamamlanmış ses dinleme sayısı) yüzdesidir. |
KPI_TYPE_VIDEO_COMPLETION_RATE |
TPG, videonun tamamını izleme oranı (gösterim başına tam video görüntüleme sayısı) yüzdesidir. |
KPI_TYPE_CPCL |
TPG, TBML (tamamlanmış ses dinleme başına maliyet) olarak ayarlanır. |
KPI_TYPE_CPCV |
KPI, TGBM (tamamlanmış video görüntüleme başına maliyet) olarak ayarlanır. |
KPI_TYPE_TOS10 |
TPG, 10 saniyeden uzun bir süre ekranda görünme hızına göre ayarlanır (en az 10 saniye boyunca ekranda olan ölçülebilir, atlanamayan gösterimlerin yüzdesi). |
KPI_TYPE_MAXIMIZE_PACING |
TPG, bütçenin tamamının harcanmasına öncelik verirken marka etkisini en üst düzeye çıkaracak şekilde ayarlanmıştır. |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST |
TPG, özel gösterim değerinin maliyete bölünmesiyle belirlenir. |
KPI_TYPE_OTHER |
TPG ise başka bir değerdir. |
InsertionOrderBudget
Kampanya siparişi bütçesinin nasıl ayrıldığını kontrol eden ayarlar.
JSON gösterimi |
---|
{ "budgetUnit": enum ( |
Alanlar | |
---|---|
budgetUnit |
Zorunlu. Sabit. Bütçe birimi, bütçenin para birimine mi yoksa gösterime mi dayalı olduğunu belirtir. |
automationType |
Kampanya siparişinin teklifini ve bütçesini yönetmek için kullanılan otomasyon türü. Oluşturma sırasında bu alan belirtilmemişse değer varsayılan olarak |
budgetSegments[] |
Zorunlu. Bütçe segmentlerinin listesi. Kampanya siparişinin yayınlandığı süre için belirli bir bütçe belirtmek üzere bütçe segmenti kullanın. |
InsertionOrderAutomationType
Kampanya siparişi teklifini ve bütçesini otomatikleştirmek için olası seçenekler.
Sıralamalar | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
Kampanya siparişi otomasyon seçeneği bu sürümde belirtilmemiş veya bilinmiyor. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Otomatik bütçe ayırma. kpi tarafından tanımlanan performansı optimize etmek için sistemin bütçeyi otomatik olarak sahip satır öğelerine kaydırmasına izin verin. Teklif ayarlarında otomasyon yok. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Kampanya siparişi seviyesinde teklif veya bütçe otomasyonu yok. Teklif ve bütçe, satır öğesi düzeyinde manuel olarak yapılandırılmalıdır. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
kpi tarafından tanımlanan performansı optimize etmek için sistemin teklifleri otomatik olarak ayarlamasına ve bütçeyi sahip satır öğelerine kaydırmasına izin verin. |
InsertionOrderBudgetSegment
Tek bir bütçe segmentinin bütçesini kontrol eden ayarlar.
JSON gösterimi |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Alanlar | |
---|---|
budgetAmountMicros |
Zorunlu. Kampanya siparişinin belirtilen |
description |
Bütçe segmenti açıklaması. Her bütçe segmentine ait Satın Alma Siparişi bilgilerini girmek ve bu bilgileri faturalara yazdırmak için kullanılabilir. UTF-8 kodlu olmalıdır. |
dateRange |
Zorunlu. Bütçe segmentinin başlangıç ve bitiş tarihi ayarları. Üst reklamverenin saat dilimine göre çözümlenirler.
|
campaignBudgetId |
Bu kampanya siparişi bütçe segmentinin parçası olduğu kampanya bütçesinin |
OptimizationObjective
Olası optimizasyon hedefi türleri.
Sıralamalar | |
---|---|
OPTIMIZATION_OBJECTIVE_UNSPECIFIED |
Bu sürümde tür değeri belirtilmemiş veya bilinmiyor. |
CONVERSION |
Satışları ve dönüşümleri artıran gösterimlere öncelik verin. |
CLICK |
Web sitesi trafiğini, uygulamaları, uygulama mağazalarını artıran gösterimlere öncelik verin. |
BRAND_AWARENESS |
Belirli kalitedeki gösterimlere öncelik ver. |
CUSTOM |
Hedef, atanan özel teklif verme algoritması tarafından tanımlanır. |
NO_OBJECTIVE |
Hedef tanımlanmadı. Herhangi bir TPG veya teklif stratejisi kullanılabilir. |
Yöntemler |
|
---|---|
|
Yeni bir kampanya siparişi oluşturur. |
|
Kampanya siparişini siler. |
|
Kampanya siparişi alır. |
|
Bir reklamverendeki kampanya siparişlerini listeler. |
|
Hedefleme türleri genelinde bir kampanya siparişinin atanan hedefleme seçeneklerini listeler. |
|
Mevcut bir kampanya siparişini günceller. |