- 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 insertionOrderTypeOVER_THE_TOPkampanya 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_DRAFTentity_statusoluşturur. | 
| 
 | Bir satır öğesi alır. | 
| 
 | Bir reklamverendeki satır öğelerini listeler. | 
| 
 | Mevcut bir satır öğesini günceller. |