- 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 bayt boyutta UTF-8 olarak kodlanmış olmalıdır. |
lineItemType |
Zorunlu. Sabit. Satır öğesinin türü. |
entityStatus |
Zorunlu. Satır öğesinin, bütçesini harcayıp envantere teklif verilip veremeyeceğini kontrol eder.
|
updateTime |
Yalnızca çıkış. Satır öğesinin en son güncellendiği zaman damgası. Sistem tarafından atanır. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
partnerCosts[] |
Satır öğesiyle ilişkili 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 atanıyorsa bu ayarlar 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 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 yayınlanması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 hedeflenmemesi için hariç tutulup tutulmayacağı. Bu alan varsayılan olarak yanlıştır. |
LineItemType
Olası satır öğesi 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 |
Bu sürümde tür değeri belirtilmemiş veya bilinmiyor. Bu tür satır öğeleri ve bunların 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 sağlayan 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 sağlayan video reklamlar. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY |
Mobil uygulama envanterinde yayınlanan görüntülü reklamlar. Bu tür satır öğeleri ve bunların 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ür satır öğeleri ve bunların hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
Çeşitli ortamlarda satılan GZT İşitsel reklamlar. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
OTT kampanya siparişlerinde baypas reklamları bulunur. Bu tür yalnızca insertionOrderType OVER_THE_TOP kampanya siparişine sahip 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 Görüntülü Reklam Ağı ve Video 360. Bu alan 1 Ağustos 2023'te kullanımdan kaldırılacaktır. Daha fazla bilgi için özelliklerin kullanımdan kaldırılmasıyla ilgili duyurumuzu okuyun. |
LineItemFlightDateType
Satır öğesinin yayın tarihlerinin olası türleri.
Sıralamalar | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
Bu sürümde tür değeri belirtilmemiş veya 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 Görüntülü Reklam Ağı ve Video 360. 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 ayrılacağı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ındı. |
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 |
Bu sürümde tür değeri belirtilmemiş veya bilinmiyor. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC |
Satır öğesi için otomatik bütçe ayırma etkin. |
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ı. 0'dan büyük veya 0'a eşit olmalıdır.
|
PartnerRevenueModelMarkupType
İş ortağı gelir modelinin olası kâr marjı türleri.
Sıralamalar | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED |
Bu sürümde tür değeri belirtilmemiş veya bilinmiyor. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM |
Sabit bir BGBM'ye göre iş ortağı gelirini hesaplamak. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP |
İş ortağı gelirini, medya maliyetindeki ek ücret yüzdesine göre hesaplayın. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
İş ortağı gelirini, tüm iş ortağı maliyetlerini ve veri maliyetlerini içeren toplam medya maliyetinin belirli bir ek yüzdesine göre hesaplayın. |
ConversionCountingConfig
Dönüşümlerin sayılma şeklini 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 yüzde değeri ayarlanabilir.
JSON gösterimi |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Alanlar | |
---|---|
postViewCountPercentageMillis |
Görüntüleme sonrası dönüşümlerin milisaniye cinsinden sayılma yüzdesi (yüzde 1/1000). 0 ile 100.000 (bu değerler 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ıklandıktan sonra dönüşüm olarak sayılabileceği gün sayısı. 0 ile 90 (bu değerler dahil) arasında olmalıdır. |
postViewLookbackWindowDays |
Zorunlu. Bir reklamın görüntülendikten sonra sayılabileceği gün sayısı. 0 ile 90 (bu değerler dahil) arasında olmalıdır. |
TargetingExpansionConfig
Satır öğesinin optimize hedefleme ayarlarını kontrol eden ayarlar.
JSON gösterimi |
---|
{
"targetingExpansionLevel": enum ( |
Alanlar | |
---|---|
targetingExpansionLevel |
Zorunlu. Optimize hedeflemenin etkin 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 hariç tutulup tutulmayacağı. Optimize hedefleme özelliğinin kullanıma sunulmasıyla bu alan kullanımdan kaldırılmıştır. Bu alan |
TargetingExpansionLevel
Optimize hedefleme ayarı
Sıralamalar | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
Optimize hedefleme ayarı belirtilmemiş veya bu sürümde 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 yayınlanmasını engelleyebilir.
Sıralamalar | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Belirtilmedi 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 Uygulamalar ve URL hedeflemesi mobil uygulama içermez. Bu satır öğesinin türü, mobil uygulamaları kanalınıza, site listenize veya uygulama hedeflemenize 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 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 kullanılamayan bir veya daha fazla kullanıcı listesini hedefliyor. Gelecekte bu, satır öğesinin yayınlanmasını engelleyecektir. Bu nedenle, 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 öğesi tarafından hedeflenen anlaşmalar, kullanımda olmayan reklam boyutlarını kabul eder. 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 herhangi bir reklam öğesi içermiyor. |
TARGETING_DEPRECATED_GEO_TARGET |
Bu satır öğesi, desteği sonlandırılmış bir coğrafi hedefi hedefliyor. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Bu satır öğesinde, desteği sonlandı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 mobil uygulama.
JSON gösterimi |
---|
{
"appId": string,
"platform": enum ( |
Alanlar | |
---|---|
appId |
Zorunlu. Platform mağazası tarafından sağlanan uygulamanın kimliği. Android uygulamaları, Android'in Play Store tarafından 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ış. Uygulamanın 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ürleri arasında satır öğesinin atanan hedefleme seçeneklerini listeler. |
|
Yeni bir satır öğesi oluşturur. |
|
Bir satır öğesini siler. |
|
Kampanya siparişinden devralınan ayarlara (hedefleme dahil) sahip yeni bir satır öğesi ve bir ENTITY_STATUS_DRAFT entity_status oluşturur. |
|
Bir satır öğesi alır. |
|
Bir reklamverendeki satır öğelerini listeler. |
|
Mevcut bir satır öğesini günceller. |