- 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. |