- Kaynak: Satır Öğesi
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- Platform
- Yöntemler
Kaynak: Satır Öğesi
Tek bir satır öğesi.
JSON gösterimi |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Satır öğesinin kaynak adı. |
advertiserId |
Yalnızca çıkış. Satır öğesinin ait olduğu reklamverenin benzersiz kimliği. |
campaignId |
Yalnızca çıkış. Satır öğesinin ait olduğu kampanyanın benzersiz kimliği. |
insertionOrderId |
Zorunlu. Sabit. Satır öğesinin ait olduğu kampanya siparişinin benzersiz kimliği. |
lineItemId |
Yalnızca çıkış. Satır öğesinin benzersiz kimliği. Sistem tarafından atanır. |
displayName |
Zorunlu. Satır öğesinin görünen adı. Maksimum 240 baytlık bir boyutla kodlanmış UTF-8 olmalıdır. |
lineItemType |
Zorunlu. Sabit. Satır öğesinin türü. |
entityStatus |
Zorunlu. Satır öğesinin bütçesini harcayıp harcayamayacağını ve envantere teklif verip veremeyeceğini kontrol eder.
|
updateTime |
Yalnızca çıkış. Satır öğesinin en son güncellendiği zaman damgası. Sistem tarafından atanır. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
partnerCosts[] |
Satır öğesiyle ilişkilendirilen iş ortağı maliyetleri.
|
flight |
Zorunlu. Satır öğesi yayınının başlangıç ve bitiş zamanı. |
budget |
Zorunlu. Satır öğesinin bütçe ayırma ayarı. |
pacing |
Zorunlu. Satır öğesinin bütçe harcama hızı ayarı. |
frequencyCap |
Zorunlu. Satır öğesinin gösterim sıklık sınırı ayarları. Sınırlı bir sınır atandıysa bu ayar nesnesindeki |
partnerRevenueModel |
Zorunlu. Satır öğesinin iş ortağı gelir modeli ayarı. |
conversionCounting |
Satır öğesinin dönüşüm izleme ayarı. |
creativeIds[] |
Satır öğesiyle ilişkilendirilen reklam öğelerinin kimlikleri. |
bidStrategy |
Zorunlu. Satır öğesinin teklif stratejisi. |
integrationDetails |
Satır öğesinin entegrasyon ayrıntıları. |
inventorySourceIds[] |
Satır öğesine atanan gizli envanter kaynaklarının kimlikleri. |
targetingExpansion |
Satır öğesinin optimize hedefleme ayarları. Bu yapılandırma yalnızca otomatik teklif özelliğini kullanan ve uygun kitle listelerini pozitif olarak hedefleyen görüntülü, video veya işitsel satır öğeleri için geçerlidir. |
warningMessages[] |
Yalnızca çıkış. Satır öğesi tarafından oluşturulan uyarı mesajları. Bu uyarılar satır öğesinin kaydedilmesini engellemez ancak bazıları satır öğesinin çalışmasını engelleyebilir. |
mobileApp |
Satır öğesi tarafından tanıtılan mobil uygulama. Bu yalnızca |
reservationType |
Yalnızca çıkış. Satır öğesinin rezervasyon türü. |
excludeNewExchanges |
Yeni exchange'lerin, satır öğesi tarafından otomatik olarak hedeflenmelerinden hariç tutulup tutulmayacağı. Bu alan varsayılan olarak yanlıştır. |
LineItemType
Satır öğesinin olası türleri.
Satır öğesinin türü, hangi ayar ve seçeneklerin (ör. reklamların biçimi veya hedefleme seçenekleri) geçerli olduğunu belirler.
Sıralamalar | |
---|---|
LINE_ITEM_TYPE_UNSPECIFIED |
Tür değeri belirtilmedi veya bu sürümde bilinmiyor. Bu türdeki satır öğeleri ve hedeflemeleri API kullanılarak oluşturulamaz veya güncellenemez. |
LINE_ITEM_TYPE_DISPLAY_DEFAULT |
Resim, HTML5, yerel veya rich media reklamlar. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
Bir uygulamanın yüklenmesini teşvik eden görüntülü reklamlar. |
LINE_ITEM_TYPE_VIDEO_DEFAULT |
Çeşitli ortamlarda BGBM'ye dayalı olarak satılan video reklamlar. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL |
Bir uygulamanın yüklenmesini teşvik eden video reklamlar. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY |
Mobil uygulama envanterinde yayınlanan görüntülü reklamlar. Bu türdeki satır öğeleri ve hedeflemeleri API kullanılarak oluşturulamaz veya güncellenemez. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY |
Mobil uygulama envanterinde yayınlanan video reklamlar. Bu türdeki satır öğeleri ve hedeflemeleri API kullanılarak oluşturulamaz veya güncellenemez. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
GZT İşitsel reklamlar çeşitli ortamlar için satılır. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
Over-the-top reklamlar OTT kampanya siparişlerinde bulunur. Bu tür yalnızca insertionOrderType OVER_THE_TOP kampanya siparişi olan satır öğeleri için geçerlidir. |
LineItemFlight
Bir satır öğesinin etkin süresini kontrol eden ayarlar.
JSON gösterimi |
---|
{ "flightDateType": enum ( |
Alanlar | |
---|---|
flightDateType |
Zorunlu. Satır öğesinin yayın tarihlerinin türü. |
dateRange |
Satır öğesinin yayın başlangıç ve bitiş tarihleri. Üst reklamverenin saat dilimine göre çözümlenirler.
|
triggerId |
Satır öğesiyle ilişkili manuel tetikleyicinin kimliği.
Uyarı: Manuel tetikleyici kullanan satır öğeleri artık Display & Video 360'ta yayınlanmamaktadır. Bu alan 1 Ağustos 2023'te kullanımdan kaldırılacak. Daha fazla bilgi için özelliklerin kullanımdan kaldırılmasıyla ilgili duyurumuzu okuyun. |
LineItemFlightDateType
Bir satır öğesinin yayın tarihinin olası türleri.
Sıralamalar | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
Tür değeri belirtilmedi veya bu sürümde bilinmiyor. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
Satır öğesinin yayın tarihleri, üst kampanya siparişinden devralınır. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
Satır öğesi kendi özel yayın tarihlerini kullanır. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
Satır öğesi bir tetikleyici kullanıyor. Uyarı: Manuel tetikleyici kullanan satır öğeleri artık Display & Video 360'ta yayınlanmamaktadır. Bu değer 1 Ağustos 2023'te kullanımdan kaldırılacak. Daha fazla bilgi için özelliklerin kullanımdan kaldırılmasıyla ilgili duyurumuzu okuyun. |
LineItemBudget
Bütçenin nasıl dağıtıldığını kontrol eden ayarlar.
JSON gösterimi |
---|
{ "budgetAllocationType": enum ( |
Alanlar | |
---|---|
budgetAllocationType |
Zorunlu. Ayrılan bütçe türü.
|
budgetUnit |
Yalnızca çıkış. Bütçe birimi, bütçenin para birimine mi yoksa gösterime mi dayalı olduğunu belirtir. Bu değer, üst kampanya siparişinden devralınır. |
maxAmount |
Satır öğesinin harcayacağı maksimum bütçe tutarı. 0'dan büyük olmalıdır.
|
LineItemBudgetAllocationType
Olası bütçe ayırma türleri.
Sıralamalar | |
---|---|
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED |
Tür değeri belirtilmedi veya bu sürümde bilinmiyor. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC |
Satır öğesi için otomatik bütçe ayırma etkinleştirildi. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED |
Satır öğesi için sabit bir maksimum bütçe tutarı ayrılır. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
Satır öğesine bütçe sınırı uygulanmaz. |
PartnerRevenueModel
İş ortağı gelirinin nasıl hesaplandığını kontrol eden ayarlar.
JSON gösterimi |
---|
{
"markupType": enum ( |
Alanlar | |
---|---|
markupType |
Zorunlu. İş ortağı gelir modelinin kâr marjı türü. |
markupAmount |
Zorunlu. İş ortağı gelir modelinin kâr marjı tutarı. En az "0" olmalıdır.
|
PartnerRevenueModelMarkupType
İş ortağı gelir modelinin olası kâr marjı türleri.
Sıralamalar | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED |
Tür değeri belirtilmedi veya bu sürümde bilinmiyor. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM |
Sabit bir BGBM ile iş ortağı gelirini hesaplayın. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP |
İş ortağı gelirini, medya maliyetinin bir ek ücretine göre hesaplar. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
İş ortağı gelirini, toplam medya maliyetinin tüm iş ortağı maliyetlerini ve veri maliyetlerini içeren ek yüzdelik ücretine göre hesaplar. |
ConversionCountingConfig
Dönüşümlerin nasıl sayıldığını kontrol eden ayarlar.
Tüm tıklama sonrası dönüşümler sayılır. Görüntüleme sonrası dönüşümlerin sayılması için bir yüzde değeri ayarlanabilir.
JSON gösterimi |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Alanlar | |
---|---|
postViewCountPercentageMillis |
Milisaniye cinsinden sayılacak görüntüleme sonrası dönüşümlerin yüzdesi (yüzde 1/1000). 0 ile 100.000 (dahil) arasında olmalıdır. Örneğin, tıklama sonrası dönüşümlerin% 50'sini izlemek için 50.000 değerini ayarlayın. |
floodlightActivityConfigs[] |
Dönüşümleri izlemek için kullanılan Floodlight etkinliği yapılandırmaları. Sayılan dönüşümlerin sayısı, bu alanda belirtilen tüm Floodlight etkinlik kimlikleri tarafından sayılan tüm dönüşümlerin toplamıdır. |
TrackingFloodlightActivityConfig
Tek bir Floodlight etkinlik yapılandırmasının davranışını kontrol eden ayarlar.
JSON gösterimi |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
Alanlar | |
---|---|
floodlightActivityId |
Zorunlu. Floodlight etkinliğinin kimliği. |
postClickLookbackWindowDays |
Zorunlu. Bir reklamın tıklanmasından sonra dönüşüm sayılabilecek gün sayısıdır. 0 ile 90 arasında (0 ve 90 dahil) olmalıdır. |
postViewLookbackWindowDays |
Zorunlu. Bir reklamın görüntülendikten sonra dönüşüm olarak sayılabileceği gün sayısı. 0 ile 90 arasında (0 ve 90 dahil) olmalıdır. |
TargetingExpansionConfig
Satır öğesinin optimize hedefleme ayarlarını kontrol eden ayarlar.
JSON gösterimi |
---|
{
"targetingExpansionLevel": enum ( |
Alanlar | |
---|---|
targetingExpansionLevel |
Zorunlu. Optimize hedeflemenin açık olup olmadığı. Bu alan aşağıdaki değerleri destekler:
Bu alan başka bir değere ayarlanırsa otomatik olarak
|
excludeFirstPartyAudience |
Birinci taraf kitlelerin hedefleme genişletmesinde kullanımdan hariç tutulup tutulmayacağı. Optimize hedeflemenin kullanıma sunulmasıyla birlikte bu alan kullanımdan kaldırılmıştır. Bu alan |
TargetingExpansionLevel
Optimize hedefleme ayarı.
Sıralamalar | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
Optimize hedefleme ayarı bu sürümde belirtilmemiş veya bilinmiyor. |
NO_EXPANSION |
Optimize hedefleme kapalı. |
LEAST_EXPANSION |
Optimize hedefleme açık. |
SOME_EXPANSION |
Kullanılırsa otomatik olarak |
BALANCED_EXPANSION |
Kullanılırsa otomatik olarak |
MORE_EXPANSION |
Kullanılırsa otomatik olarak |
MOST_EXPANSION |
Kullanılırsa otomatik olarak |
LineItemWarningMessage
Satır öğesi tarafından oluşturulan uyarı mesajları. Bu tür uyarılar, satır öğesinin kaydedilmesini engellemez ancak satır öğesinin çalışmasını engelleyebilir.
Sıralamalar | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Belirtilmemiş veya bilinmiyor. |
INVALID_FLIGHT_DATES |
Bu satır öğesi geçersiz yayın tarihlerine sahip. Satır öğesi yayınlanmayacak. |
EXPIRED |
Bu satır öğesinin bitiş tarihi geçmiş bir tarihe ayarlanmış. |
PENDING_FLIGHT |
Bu satır öğesi gelecekte yayınlanmaya başlayacak. |
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED |
İş ortağı tarafından etkinleştirilen tüm exchange'ler negatif hedeflendi. Satır öğesi yayınlanmayacak. |
INVALID_INVENTORY_SOURCE |
Hedeflenen etkin envanter kaynağı yok. Satır öğesi yayınlanmayacak. |
APP_INVENTORY_INVALID_SITE_TARGETING |
Bu satır öğesinin Uygulama ve URL hedeflemesi mobil uygulama içermiyor. Bu satır öğesinin türü, kanalınıza, site listenize veya uygulama hedeflemenize mobil uygulamaları dahil etmenizi gerektirir. Satır öğesi yayınlanmayacak. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
Bu satır öğesi herhangi bir mobil kullanıcıyı hedeflemiyor. Bu satır öğesinin türü, mobil kullanıcı içeren bir kullanıcı listesini hedeflemenizi gerektirir. Satır öğesi yayınlanmayacak. |
NO_VALID_CREATIVE |
Bu satır öğesi, geçerli herhangi bir reklam öğesi içermiyor. Satır öğesi yayınlanmayacak. |
PARENT_INSERTION_ORDER_PAUSED |
Bu satır öğesinin ekleme talimatı duraklatıldı. Satır öğesi yayınlanmayacak. |
PARENT_INSERTION_ORDER_EXPIRED |
Bu satır öğesinin kampanya siparişinin bitiş tarihi geçmiş bir tarihe ayarlanmış. Satır öğesi yayınlanmayacak. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
Bu satır öğesi hiçbir kitle listesini hedeflemiyor. Bu durum, bütçenizin çok hızlı harcanmasına yol açabilir. |
APP_INSTALL_NO_CONVERSION_PIXEL |
Bu uygulama yükleme satır öğesi için dönüşüm pikseli ayarlanmamış. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
Bu satır öğesi, artık mevcut olmayan bir veya daha fazla kullanıcı listesini hedefliyor. Bu, ileride satır öğesinin yayınlanmasını engelleyeceğinden bu listeleri hedeflemenizden kaldırmanız önerilir. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
Bu uygulama yükleme satır öğesinde optimum teklif verme stratejisi yok. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
Bu satır öğesinin hedeflediği anlaşmalar, kullanımda olmayan reklam boyutlarını kabul ediyor. Bu, satır öğesinin yayınlanmasını veya performansını sınırlayabilir. |
NO_CREATIVE_FOR_TARGETED_DEALS |
Bu satır öğesi, hedeflenen anlaşmalar için reklam öğesi içermiyor. |
TARGETING_DEPRECATED_GEO_TARGET |
Bu satır öğesi, kullanımdan kaldırılmış bir coğrafi hedefi hedefliyor. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Bu satır öğesi, kullanımdan kaldırılan ve 25 Mart 2023'ten sonra kullanımdan kaldırılması planlanan
|
MobileApp
Mobil uygulama yükleme satır öğesi tarafından tanıtılan bir mobil uygulama.
JSON gösterimi |
---|
{
"appId": string,
"platform": enum ( |
Alanlar | |
---|---|
appId |
Zorunlu. Platform mağazası tarafından sağlanan uygulama kimliği. Android uygulamaları, Android Play Store'da kullanılan paket kimliğiyle (ör. iOS uygulamaları, Apple'ın App Store'u tarafından kullanılan dokuz haneli bir uygulama kimliğiyle (ör. |
platform |
Yalnızca çıkış. Uygulama platformu. |
displayName |
Yalnızca çıkış. Uygulama adı. |
publisher |
Yalnızca çıkış. Uygulama yayıncısı. |
Platform
Olası mobil uygulama platformları.
Sıralamalar | |
---|---|
PLATFORM_UNSPECIFIED |
Platform belirtilmedi. |
IOS |
iOS platformu. |
ANDROID |
Android platformu. |
Yöntemler |
|
---|---|
|
Hedefleme seçeneklerini tek bir satır öğesi altında toplu olarak düzenler. |
|
Hedefleme türlerinde bir satır öğesine atanan hedefleme seçeneklerini listeler. |
|
Yeni bir satır öğesi oluşturur. |
|
Bir satır öğesini siler. |
|
Kampanya siparişinden devralınan ayarlarla (hedefleme dahil) yeni bir satır öğesi ve bir ENTITY_STATUS_DRAFT entity_status oluşturur. |
|
Bir satır öğesi getirir. |
|
Bir reklamverendeki satır öğelerini listeler. |
|
Mevcut bir satır öğesini günceller. |