REST Resource: advertisers.lineItems

Kaynak: LineItem

Tek bir satır öğesi.

JSON gösterimi 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
Alanlar
name

string

Yalnızca çıkış. Satır öğesinin kaynak adı.
advertiserId

string (int64 format)

Yalnızca çıkış. Satır öğesinin ait olduğu reklamverenin benzersiz kimliği.
campaignId

string (int64 format)

Yalnızca çıkış. Satır öğesinin ait olduğu kampanyanın benzersiz kimliği.
insertionOrderId

string (int64 format)

Zorunlu. Değiştirilemez. Satır öğesinin ait olduğu kampanya siparişinin benzersiz kimliği.
lineItemId

string (int64 format)

Yalnızca çıkış. Satır öğesinin benzersiz kimliği. Sistem tarafından atanır.
displayName

string

Zorunlu. Satır öğesinin görünen adı.

UTF-8 olarak kodlanmış ve maksimum 240 bayt boyutunda olmalıdır.
lineItemType

enum (LineItemType)

Zorunlu. Değiştirilemez. Satır öğesinin türü.
entityStatus

enum (EntityStatus)

Zorunlu. Satır öğesinin bütçesini harcayıp harcayamayacağını ve envanter için teklif verip veremeyeceğini kontrol eder.

  • lineItems.create yöntemi için yalnızca ENTITY_STATUS_DRAFT değerine izin verilir. Bir satır öğesini etkinleştirmek için lineItems.patch yöntemini kullanın ve oluşturduktan sonra durumu ENTITY_STATUS_ACTIVE olarak güncelleyin.
  • Bir satır öğesi, başka bir durumdan tekrar ENTITY_STATUS_DRAFT durumuna değiştirilemez.
  • Satır öğesinin üst kampanya siparişi etkin değilse satır öğesi, kendi durumu ENTITY_STATUS_ACTIVE olsa bile bütçesini harcayamaz.
updateTime

string (Timestamp format)

Yalnızca çıkış. Satır öğesinin en son güncellendiği zaman damgası. Sistem tarafından atanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
partnerCosts[]

object (PartnerCost)

Satır öğesiyle ilişkili iş ortağı maliyetleri.

lineItems.create yönteminde yoksa veya boşsa yeni oluşturulan satır öğesi, iş ortağı maliyetlerini üst kampanya siparişinden devralır.
flight

object (LineItemFlight)

Zorunlu. Satır öğesinin yayınlanma aralığının başlangıç ve bitiş zamanı.
budget

object (LineItemBudget)

Zorunlu. Satır öğesinin bütçe ayırma ayarı.
pacing

object (Pacing)

Zorunlu. Satır öğesinin bütçe harcama hızı ayarı.
frequencyCap

object (FrequencyCap)

İsteğe bağlıdır. Satır öğesi türü LINE_ITEM_TYPE_DEMAND_GEN değilse zorunludur. Satır öğesinin gösterim sıklığı sınırı ayarları.

Sınırlı bir üst sınır atanıyorsa bu ayarlar nesnesindeki maxImpressions alanı kullanılmalıdır.
partnerRevenueModel

object (PartnerRevenueModel)

Zorunlu. Satır öğesinin iş ortağı gelir modeli ayarı.
conversionCounting

object (ConversionCountingConfig)

Satır öğesinin dönüşüm izleme ayarı.
creativeIds[]

string (int64 format)

Satır öğesiyle ilişkili reklam öğelerinin kimlikleri.
bidStrategy

object (BiddingStrategy)

Zorunlu. Satır öğesinin teklif stratejisi.
integrationDetails

object (IntegrationDetails)

Satır öğesinin entegrasyon ayrıntıları.
targetingExpansion

object (TargetingExpansionConfig)

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[]

enum (LineItemWarningMessage)

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

object (MobileApp)

Satır öğesi tarafından tanıtılan mobil uygulama.

Bu, yalnızca lineItemType, LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL veya LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL olduğunda geçerlidir.
reservationType

enum (ReservationType)

Yalnızca çıkış. Satır öğesinin rezervasyon türü.
excludeNewExchanges

boolean

Yeni exchange'lerin satır öğesi tarafından otomatik olarak hedeflenmesinin engellenip engellenmeyeceği. Bu alan varsayılan olarak yanlıştır.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

İsteğe bağlıdır. YouTube ve iş ortakları satır öğelerine özel ayarlar.
demandGenSettings

object (DemandGenSettings)

İsteğe bağlıdır. Talep Yaratma satır öğelerine özgü ayarlar.

Yalnızca Talep Yaratma satır öğeleri için geçerlidir.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Bu satır öğesinin Avrupa Birliği siyasi reklamları yayınlayıp yayınlamayacağı.

Üst reklamverende containsEuPoliticalAds, DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING olarak ayarlanmışsa aksi belirtilmediği sürece bu alana DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING atanır. Bu alan daha sonra kullanıcı arayüzü, API veya Yapılandırılmış Veri Dosyaları kullanılarak güncellenebilir.

Yeni bir satır öğesi oluşturulurken bu alanın atanması gerekir. Aksi takdirde advertisers.lineItems.create isteği başarısız olur.
optimizeFixedBidding

boolean

İsteğe bağlıdır. Sabit teklif verme satır öğeleri için DV360'ın teklif optimizasyonunun etkinleştirilip etkinleştirilmeyeceği.

DV360, varsayılan olarak iyi performans gösterme olasılığı daha düşük olan gösterimler için teklifleri otomatik olarak düşürerek sabit teklifinizi optimize eder. Bu optimizasyon varsayılan olarak etkindir (değer "true"dur).

Bu alan false olarak ayarlandığında bu optimizasyon devre dışı bırakılır ve teklif hiçbir nedenle düşürülmez.

Bu ayar yalnızca FIXED_BID türünde biddingStrategy içeren satır öğeleri için geçerlidir.

LineItemType

Bir satır öğesinin olası türleri.

Satır öğesinin türü, reklamların biçimi veya hedefleme seçenekleri gibi hangi ayarların ve seçeneklerin geçerli olduğunu belirler.

Sıralamalar
LINE_ITEM_TYPE_UNSPECIFIED

Tür değeri belirtilmemiş 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 sağlayan görüntülü reklamlar.
LINE_ITEM_TYPE_VIDEO_DEFAULT Çeşitli ortamlar için BGBM temelli olarak satılan video reklamlar.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Bir uygulamanın yüklenme sayısını artıran 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 Çeşitli ortamlar için satılan GZT işitsel reklamlar.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP OTT kampanya siparişlerinde bulunan OTT reklamlar. Bu tür yalnızca kampanya siparişi insertionOrderType OVER_THE_TOP olan satır öğeleri için geçerlidir.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Dönüşümleri artıran YouTube video reklamları.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Atlanamayan YouTube video reklamları (en fazla 15 saniye).

Bu türdeki satır öğeleri ve hedeflemeleri API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Farklı biçimlerin bir arada kullanıldığı belirli bir sırayla hikaye anlatan YouTube video reklamları.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

YouTube işitsel reklamları

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Daha düşük maliyetle daha fazla tekil kullanıcıya ulaşmak için optimize edilen YouTube video reklamları. Bumper reklamlar, atlanabilir yayın içi reklamlar veya farklı türlerin bir karışımını içerebilir.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Varsayılan YouTube video reklamları.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Bağlı TV'de gösterilen ve atlanamayan YouTube video reklamları (en fazla 15 saniye).

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Daha düşük maliyetle daha fazla tekil kullanıcıya ulaşmak için optimize edilen bağlı TV YouTube video reklamları. Bumper reklamlar, atlanabilir yayın içi reklamlar veya farklı türlerin bir karışımını içerebilir.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Bağlı TV varsayılan YouTube video reklamları. Yalnızca yayın içi reklam biçimini dahil edin.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

Bu satır öğesi türünün amacı, YouTube reklamlarını belirli bir süre içinde aynı kullanıcıya hedef sayıda göstermektir.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Çeşitli reklam biçimleriyle daha fazla görüntüleme elde etmeyi amaçlayan YouTube video reklamları.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Dijital ev dışı envanterde 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_OUT_OF_HOME

Dijital ev dışı envanterde yayınlanan video reklamlar.

Bu türdeki satır öğeleri ve hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.
LINE_ITEM_TYPE_DEMAND_GEN Talep Yaratma reklamları.

LineItemFlight

Bir satır öğesinin etkin süresini kontrol eden ayarlar.

JSON gösterimi 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
Alanlar
flightDateType

enum (LineItemFlightDateType)

Zorunlu. Satır öğesinin yayın tarihlerinin türü.
dateRange

object (DateRange)

Satır öğesinin yayın başlangıç ve bitiş tarihleri. Üst reklamverenin saat dilimine göre çözümlenirler.

  • flightDateType, LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM ise zorunludur. Aksi takdirde yalnızca çıkış.
  • Yeni bir uçuş oluştururken hem startDate hem de endDate gelecekte olmalıdır.
  • Geçmişte startDate olan mevcut bir uçuşun endDate değeri değiştirilebilir ancak startDate değeri değiştirilemez.
  • endDate, startDate veya daha sonraki bir tarih olmalı ve 2037'den önce olmalıdır.

LineItemFlightDateType

Satır öğesinin yayın tarihlerinin olası türleri.

Sıralamalar
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED Tür değeri belirtilmemiş 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.

LineItemBudget

Bütçenin nasıl tahsis edileceğini kontrol eden ayarlar.

JSON gösterimi 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Alanlar
budgetAllocationType

enum (LineItemBudgetAllocationType)

Zorunlu. Bütçe tahsisinin türü.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC yalnızca üst kampanya siparişi için otomatik bütçe ayırma etkinleştirildiğinde geçerlidir.

Talep Yaratma satır öğeleri için bu alan LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED olarak ayarlanmalıdır.
budgetUnit

enum (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

string (int64 format)

Satır öğesinin harcayacağı maksimum bütçe tutarı. 0'dan büyük olmalıdır.

budgetAllocationType şu olduğunda:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, bu alan sabittir ve sistem tarafından ayarlanır.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, budgetUnit şu ise:
    • BUDGET_UNIT_CURRENCY, bu alan, reklamverenin para biriminin mikro birimi cinsinden harcanacak maksimum bütçe tutarını temsil eder. Örneğin, 1500000, para biriminin 1,5 standart birimini temsil eder.
    • BUDGET_UNIT_IMPRESSIONS, bu alan yayınlanacak maksimum gösterim sayısını temsil eder.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, bu alan geçerli değildir ve sistem tarafından yoksayılır.

LineItemBudgetAllocationType

Bütçe ayırmanın olası türleri.

Sıralamalar
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED Tür değeri belirtilmemiş veya bu sürümde bilinmiyor.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC Satır öğesi için otomatik bütçe ayırma etkinleştirilmiştir.
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 hesaplanacağını kontrol eden ayarlar.

JSON gösterimi 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Alanlar
markupType

enum (PartnerRevenueModelMarkupType)

Zorunlu. İş ortağı gelir modelinin kâr marjı türü.

Talep Yaratma satır öğeleri için bu alan PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP olarak ayarlanmalıdır.
markupAmount

string (int64 format)

Zorunlu. İş ortağı gelir modelinin kâr marjı tutarı. 0'dan büyük veya 0'a eşit olmalıdır.

  • markupType, PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM olarak ayarlandığında bu alan, reklamverenin para biriminin mikro birimi cinsinden BGBM fiyatlandırmasını temsil eder. Örneğin, 1500000, para biriminin 1,5 standart birimini temsil eder.
  • markupType, PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP olarak ayarlandığında bu alan, medya maliyeti kâr marjı yüzdesini milisaniye cinsinden temsil eder. Örneğin, 100 değeri %0,1'i (ondalık olarak 0,001) temsil eder.
  • markupType, PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP olarak ayarlandığında bu alan, milisaniye cinsinden toplam medya maliyeti kâr marjı yüzdesini temsil eder. Örneğin, 100 değeri %0,1'i (ondalık olarak 0,001) temsil eder.

PartnerRevenueModelMarkupType

İş ortağı gelir modelinin olası kâr marjı türleri.

Sıralamalar
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED Tür değeri belirtilmemiş veya bu sürümde bilinmiyor.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM İş ortağı gelirini sabit bir BGBM'ye göre hesaplayın.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

İş ortağı gelirini, medya maliyetinin ek yüzde ücretine 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 ek yüzde ücretine göre hesaplayın.

ConversionCountingConfig

Dönüşümlerin nasıl sayılacağını kontrol eden ayarlar.

Tüm tıklama sonrası dönüşümler sayılır. Görüntüleme sonrası dönüşüm sayımı için bir yüzde değeri ayarlanabilir.

JSON gösterimi 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
Alanlar
postViewCountPercentageMillis

string (int64 format)

Sayılacak görüntüleme sonrası dönüşümlerin yüzdesi, milisaniye cinsinden (yüzde 1/1000). 0 ile 100.000 (her iki değer de dahil) arasında olmalıdır.

Örneğin, tıklama sonrası dönüşümlerin% 50'sini izlemek için 50000 değerini ayarlayın.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Dönüşümleri izlemek için kullanılan Floodlight etkinliği yapılandırmaları.

Sayılan dönüşüm sayısı, bu alanda belirtilen tüm Floodlight etkinlik kimlikleri tarafından sayılan tüm dönüşümlerin toplamıdır.

Satır öğesine özel teklif verme algoritması atanmışsa bu alan güncellenemez. Bu alanı ayarlayıp aynı istekte özel teklif verme algoritması atarsanız Floodlight etkinlikleri, özel teklif verme algoritması tarafından kullanılanlarla eşleşmelidir.
primaryAttributionModelId

string (int64 format)

İsteğe bağlıdır. Dönüşüm ölçümü için kullanılacak ilişkilendirme modeli. Bu ilişkilendirme modeli, dönüşümlerin nasıl sayılacağını belirler. Birincil model, bir Floodlight yapılandırması veya grubu için sizin tarafınızdan ayarlanabilir. Daha fazla bilgiyi burada bulabilirsiniz.

Yalnızca Talep Yaratma satır öğeleri için geçerlidir.

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

string (int64 format)

Zorunlu. Floodlight etkinliğinin kimliği.
postClickLookbackWindowDays

integer

Zorunlu. Bir reklam tıklandıktan sonra dönüşümün sayılabileceği gün sayısı. 0 ile 90 (her iki değer de dahil) arasında olmalıdır.
postViewLookbackWindowDays

integer

Zorunlu. Bir reklamın görüntülenmesinden sonra dönüşümün sayılabileceği gün sayısı. 0 ile 90 (her iki değer de dahil) arasında olmalıdır.

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 Belirtilmemiş veya bilinmiyor.
INVALID_FLIGHT_DATES Bu satır öğesinin yayın tarihleri geçersiz. Satır öğesi yayınlanmaz.
EXPIRED Bu satır öğesinin bitiş tarihi geçmişte.
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ınlanmaz.
INVALID_INVENTORY_SOURCE Hedeflenen etkin envanter kaynağı yok. Satır öğesi yayınlanmaz.
APP_INVENTORY_INVALID_SITE_TARGETING Bu satır öğesinin uygulamalar ve URL'ler hedeflemesi herhangi bir mobil uygulama içermiyor. Bu satır öğesinin türü, kanal, site listesi veya uygulama hedeflemenize mobil uygulamaları dahil etmenizi gerektirir. Satır öğesi yayınlanmaz.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Bu satır öğesi hiçbir mobil kullanıcıyı hedeflemiyor. Bu satır öğesinin türü, mobil kullanıcıların bulunduğu bir kullanıcı listesini hedeflemenizi gerektiriyor. Satır öğesi yayınlanmaz.
NO_VALID_CREATIVE Bu satır öğesi geçerli bir reklam öğesi içermiyor. Satır öğesi yayınlanmaz.
PARENT_INSERTION_ORDER_PAUSED Bu satır öğesinin ekleme talimatı duraklatıldı. Satır öğesi yayınlanmaz.
PARENT_INSERTION_ORDER_EXPIRED Bu satır öğesinin kampanya siparişinin bitiş tarihi geçmişte ayarlanmış. Satır öğesi yayınlanmaz.

MobileApp

Mobil uygulama yükleme satır öğesi tarafından tanıtılan bir mobil uygulama.

JSON gösterimi 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Alanlar
appId

string

Zorunlu. Platform mağazası tarafından sağlanan uygulamanın kimliği.

Android uygulamaları, Android'in Play Store'u tarafından kullanılan paket kimliğiyle (ör. com.google.android.gm) tanımlanır.

iOS uygulamaları, Apple'ın uygulama mağazası tarafından kullanılan dokuz haneli bir uygulama kimliğiyle (ör. 422689480) tanımlanır.
platform

enum (Platform)

Yalnızca çıkış. Uygulama platformu.
displayName

string

Yalnızca çıkış. Uygulamanın adı.
publisher

string

Yalnızca çıkış. Uygulama yayıncısı.

Platform

Olası mobil uygulama platformları.

Sıralamalar
PLATFORM_UNSPECIFIED Platform belirtilmedi.
IOS iOS platformu.
ANDROID Android platformu.

YoutubeAndPartnersSettings

YouTube ve iş ortakları satır öğeleri için ayarlar.

JSON gösterimi 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Alanlar
viewFrequencyCap

object (FrequencyCap)

Satır öğesinin görüntüleme sıklığı sınırı ayarları.

Sınırlı bir üst sınır atanıyorsa bu ayarlar nesnesindeki maxViews alanı kullanılmalıdır.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

İsteğe bağlıdır. Satır öğesinin üçüncü taraf ölçüm yapılandırmaları.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Satır öğesinin hangi YouTube ve iş ortakları envanterlerini hedefleyeceğini kontrol eden ayarlar.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Yalnızca çıkış. YouTube ve İş Ortakları reklamlarının gösterileceği içerik türü.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Yalnızca çıkış. Satır öğesi yayınlanırken geçerli olan içerik kategorisi. İçerik kategorisi hem satır öğesinde hem de reklamverende ayarlandığında satır öğesi yayınlanırken daha katı olan kategori geçerli olur.

Yeni satır öğeleri yalnızca reklamveren düzeyindeki ayarı devralır.
targetFrequency

object (TargetFrequency)

İsteğe bağlıdır. Bu satır öğesindeki reklamların belirli bir süre boyunca aynı kişiye ortalama kaç kez gösterilmesini istediğinizi belirten sayı.
linkedMerchantId

string (int64 format)

İsteğe bağlıdır. Ürün feed'i sağlamak için kullanılan Merchant Center hesabının kimliği.

Bu Merchant Center hesabı reklamverene zaten bağlı olmalıdır.
relatedVideos[]

object (RelatedVideo)

İsteğe bağlıdır. Satır öğesiyle ilgili videolar. Bu videolar, mobil cihazlardaki YouTube uygulamasında oynatılırken birincil video reklamın altında görünür.
leadFormId

string (int64 format)

İsteğe bağlıdır. Potansiyel müşteri kazanmak için kullanılacak formun kimliği.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

İsteğe bağlıdır. VideoAdSequence ile ilgili ayarlar.
videoAdInventoryControl

object (VideoAdInventoryControl)

İsteğe bağlıdır. Bu satır öğesi için hangi envantere izin verileceğini kontrol eden ayarlar.

ThirdPartyMeasurementConfigs

Belirli satır öğesi metriklerini hangi üçüncü taraf satıcıların ölçeceğini kontrol eden ayarlar.

JSON gösterimi 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Alanlar
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

İsteğe bağlıdır. Görüntülenebilirliği ölçen üçüncü taraf satıcılar.

Aşağıdaki üçüncü taraf satıcılar geçerlidir:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

İsteğe bağlıdır. Marka güvenliğini ölçen üçüncü taraf satıcılar.

Aşağıdaki üçüncü taraf satıcılar geçerlidir:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

İsteğe bağlıdır. Erişimi ölçen üçüncü taraf satıcılar.

Aşağıdaki üçüncü taraf satıcılar geçerlidir:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

İsteğe bağlıdır. Brand Lift'i ölçen üçüncü taraf satıcılar.

Aşağıdaki üçüncü taraf satıcılar geçerlidir:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

Üçüncü taraf ölçüm tedarikçilerinin nasıl yapılandırılacağını kontrol eden ayarlar.

JSON gösterimi 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Alanlar
vendor

enum (ThirdPartyVendor)

Üçüncü taraf ölçüm tedarikçisi.
placementId

string

Satır öğesini tanımlamak için üçüncü taraf satıcının platformu tarafından kullanılan kimlik.

ThirdPartyVendor

Üçüncü taraf ölçümü gerçekleştiren tedarikçiler.

Sıralamalar
THIRD_PARTY_VENDOR_UNSPECIFIED Bilinmeyen üçüncü taraf satıcı.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Telemetri.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN Kaynağınıza aitmiş gibi ele almasını sağlayan teknoloji.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV Ispot TV.
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

YouTube ve iş ortakları satır öğesinin hedefleyeceği YouTube ile ilgili envanterleri kontrol eden ayarlar.

JSON gösterimi 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Alanlar
includeYoutube

boolean

İsteğe bağlıdır. YouTube'daki envanterin hedeflenip hedeflenmeyeceği. Buna hem arama hem de kanallar ve videolar dahildir.
includeGoogleTv

boolean

İsteğe bağlıdır. Google TV ile kullanılabilen video uygulamalarındaki envanterin hedeflenip hedeflenmeyeceğini belirler.
includeYoutubeVideoPartners

boolean

YouTube ile aynı marka güvenliği standartlarını uygulayan iş ortağı siteleri ve uygulamalar koleksiyonundaki envanterin hedeflenip hedeflenmeyeceğini belirler.

YoutubeAndPartnersContentCategory

YouTube ve İş Ortakları içeriği için marka güvenliği kategorileri.

Sıralamalar
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED İçerik kategorisi belirtilmemiş veya bu sürümde bilinmiyor.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Çoğu marka için uygun olan geniş bir içerik yelpazesinden oluşan kategori. İçerik, YouTube'un reklamverenlere uygun içerik kurallarına göre belirlenir.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED YouTube ve video iş ortaklarında bulunan ve para kazanma standartlarını karşılayan tüm içerikleri kapsayan bir kategori.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Özellikle uygunsuz dil ve müstehcen cinsel içerikle ilgili daha katı şartları karşılayan, daha dar bir içerik yelpazesinden oluşan kategori.

TargetFrequency

Reklamların belirli bir süre içinde aynı kullanıcıya ortalama kaç kez gösterileceğini kontrol eden ayar.

JSON gösterimi 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Alanlar
targetCount

string (int64 format)

Reklamların timeUnit ve timeUnitCount tarafından belirlenen zaman aralığında aynı kullanıcıya ortalama olarak gösterilme sayısı için hedef.
timeUnit

enum (TimeUnit)

Hedef sıklığın uygulanacağı zaman birimi.

Aşağıdaki zaman birimi geçerlidir:

  • TIME_UNIT_WEEKS
  • TIME_UNIT_MONTHS
timeUnitCount

integer

Hedef sıklığın süreceği timeUnit sayısı.

timeUnit değerine göre aşağıdaki kısıtlamalar geçerlidir:

  • TIME_UNIT_WEEKS - 1 olmalıdır
  • TIME_UNIT_MONTHS - 1 olmalıdır

RelatedVideo

İlgili video girişini temsil eder.

JSON gösterimi 
{
  "videoId": string,
  "videoAssetId": string
}
Alanlar
videoId

string

Yalnızca çıkış. İlgili videonun YouTube video kimliği.
videoAssetId

string (int64 format)

Zorunlu. YouTube videosu için AdAsset kaynağının adAssetId.

VideoAdSequenceSettings

VideoAdSequence ile ilgili ayarlar.

JSON gösterimi 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Alanlar
minimumDuration

enum (VideoAdSequenceMinimumDuration)

Aynı kullanıcının bu diziyi tekrar görmesi için geçmesi gereken minimum süre.
steps[]

object (VideoAdSequenceStep)

Sıranın oluştuğu adımlar.

VideoAdSequenceMinimumDuration

Aynı kullanıcının VideoAdSequence'i tekrar görmesinden önce geçebilecek olası minimum aralık süresi için enum.

Sıralamalar
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Belirtilmemiş veya bilinmiyor.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 gün.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 gün.

VideoAdSequenceStep

VideoAdSequence'taki tek bir adımın ayrıntıları.

JSON gösterimi 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Alanlar
stepId

string (int64 format)

Adımın kimliği.
adGroupId

string (int64 format)

Adımın karşılık gelen reklam grubunun kimliği.
previousStepId

string (int64 format)

Önceki adımın kimliği. İlk adımın önceki bir adımı yoktur.
interactionType

enum (InteractionType)

İzleyiciyi bu adıma yönlendirecek olan önceki adımdaki etkileşim. İlk adımda interactionType yok.

InteractionType

Bir adımdaki etkileşim türleri.

Sıralamalar
INTERACTION_TYPE_UNSPECIFIED Belirtilmemiş veya bilinmiyor
INTERACTION_TYPE_PAID_VIEW Ücretli görüntüleme.
INTERACTION_TYPE_SKIP İzleyici tarafından atlanmış.
INTERACTION_TYPE_IMPRESSION (Görüntülenen) reklam gösterimi.
INTERACTION_TYPE_ENGAGED_IMPRESSION İzleyici tarafından hemen atlanmayan ancak faturalandırılabilir etkinliğe de ulaşmayan bir reklam gösterimi.

VideoAdInventoryControl

Belirli YouTube satır öğesi türlerinde kullanılan video reklam envanteri kontrolü.

JSON gösterimi 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
Alanlar
allowInStream

boolean

İsteğe bağlıdır. Reklamların yayın içi biçimde yayınlanıp yayınlanamayacağı.
allowInFeed

boolean

İsteğe bağlıdır. Reklamların feed içi biçimde yayınlanıp yayınlanamayacağı.
allowShorts

boolean

İsteğe bağlıdır. Reklamların Shorts biçiminde yayınlanıp yayınlanamayacağı.
allowNonSkippableInStream

boolean

İsteğe bağlıdır. Reklamların atlanamayan yayın içi biçimde yayınlanıp yayınlanamayacağını gösterir.

DemandGenSettings

Talep Yaratma satır öğeleri için ayarlar.

JSON gösterimi 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
Alanlar
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

İsteğe bağlıdır. Talep Yaratma satır öğesi için üçüncü taraf ölçüm ayarları.
linkedMerchantId

string (int64 format)

İsteğe bağlıdır. Ürün feed'i sağlamak için kullanılan Merchant Center hesabının kimliği.

Bu Merchant Center hesabı reklamverene zaten bağlı olmalıdır.
geoLanguageTargetingEnabled

boolean

İsteğe bağlıdır. Değiştirilemez. Konum ve dil hedeflemenin satır öğesi düzeyinde ayarlanıp ayarlanamayacağı. Aksi takdirde, alakalı hedefleme türleri doğrudan reklam gruplarına atanmalıdır.

Yöntemler

bulkEditAssignedTargetingOptions

 Birden fazla satır öğesi altındaki hedefleme seçeneklerini toplu olarak düzenler.

bulkListAssignedTargetingOptions

 Hedefleme türleri genelinde birden fazla satır öğesi için atanmış hedefleme seçeneklerini listeler.

bulkUpdate

 Birden fazla satır öğesini günceller.

create

 Yeni bir satır öğesi oluşturur.

delete

 Bir satır öğesini siler.

duplicate

 Satır öğesini kopyalar.

get

 Bir satır öğesi alır.

list

 Bir reklamverendeki satır öğelerini listeler.

patch

 Mevcut bir satır öğesini günceller.