- Kaynak: Kampanya Siparişi
- InsertionOrderType
- Kpi
- KpiType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- 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 boyutunda UTF-8 olarak kodlanmış olmalıdır. |
insertionOrderType |
Kampanya siparişinin türü. Bu alan, oluşturma sırasında belirtilmezse değer varsayılan olarak |
entityStatus |
Zorunlu. Kampanya siparişinin bütçesini harcayıp harcayamayacağını ve envantere teklif verip veremeyeceğini kontrol eder.
|
updateTime |
Yalnızca çıkış. Kampanya siparişinin en son güncellendiği zaman damgası. Sistem tarafından atanır. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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, Display & Video 360 arayüzünde"Hedef " olarak temsil edilir. |
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ü. |
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ü belirtilmemiş 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 KPI seçilmezse bu alan yoksayılır. |
Birleştirme alanı kpi_value . Zorunlu. TPG'nin değeri. İlgili alan, kpi_type değerine 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. Şifre, 100 karakteri aşmayacak şekilde UTF-8 biçiminde olmalıdır.
|
KpiType
Olası temel performans göstergesi (TPG) türleri.
Sıralamalar | |
---|---|
KPI_TYPE_UNSPECIFIED |
Bu sürümde TPG türü belirtilmemiş veya 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 (gösterim başına maliyet tamamlandığında sesli ve görünür). |
KPI_TYPE_CPE |
TPG, ETBM'dir (etkileşim başına maliyet). |
KPI_TYPE_CPV |
TPG, 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) 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, sesin tamamını dinleme 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 tamamlanmış 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 |
TPG, TGBM (tam video görüntüleme başına maliyet) olarak ayarlanır. |
KPI_TYPE_TOS10 |
TPG, ekranda en az 10 saniye boyunca görünme süresi olarak ayarlanır (En az 10 saniye boyunca ekranda olan ölçülebilir, atlanamayan gösterimlerin yüzdesi). |
KPI_TYPE_MAXIMIZE_PACING |
TPG, tüm bütçenin harcanmasına öncelik verirken marka etkisini en üst düzeye çıkaracak şekilde ayarlanır. |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST |
TPG, özel gösterim değerinin maliyete bölünmesiyle ayarlanır. |
KPI_TYPE_OTHER |
TPG 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şi için teklifi ve bütçeyi yönetmek üzere kullanılan otomasyon türü. Bu alan, oluşturma sırasında belirtilmezse değer varsayılan olarak |
budgetSegments[] |
Zorunlu. Bütçe segmentlerinin listesi. Kampanya siparişinin yayınlandığı süre boyunca belirli bir bütçeyi belirtmek için bütçe segmenti kullanın. |
InsertionOrderAutomationType
Kampanya siparişi teklifini ve bütçesini otomatik hale getirmek için olası seçenekler.
Sıralamalar | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
Kampanya siparişi otomasyon seçeneği belirtilmemiş veya bu sürümde 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 yoktur. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Kampanya siparişi seviyesinde teklif veya bütçe otomasyonu yok. Teklif ve bütçe, satır öğesi seviyesinde 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 olunan 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 segmenti için Satın Alma Siparişi bilgilerini girmek ve bu bilgilerin faturalara yazdırılmasını sağlamak için kullanılabilir. UTF-8 kodlu olmalıdır. |
dateRange |
Zorunlu. Bütçe segmentinin başlangıç ve bitiş tarihi ayarları. Bunlar üst reklamverenin saat dilimine göre çözümlenir.
|
campaignBudgetId |
Bu kampanya siparişi bütçe segmentinin parçası olduğu kampanya bütçesinin |
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ürlerinde bir kampanya siparişinin atanan hedefleme seçeneklerini listeler. |
|
Mevcut bir kampanya siparişini günceller. |