REST Resource: advertisers.lineItems

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 (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)
  }
}
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. Sabit. 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ı.

Maksimum 240 bayt boyutta UTF-8 olarak kodlanmış olmalıdır.
lineItemType

enum (LineItemType)

Zorunlu. Sabit. Satır öğesinin türü.
entityStatus

enum (EntityStatus)

Zorunlu. Satır öğesinin, bütçesini harcayıp envantere teklif verilip 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şturulduktan sonra durumu ENTITY_STATUS_ACTIVE olarak güncelleyin.
  • Bir satır öğesi, başka bir durumdan tekrar ENTITY_STATUS_DRAFT durumuna döndürülemez.
  • 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.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
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 öğesi yayını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)

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 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şkilendirilen 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 hedeflenmemesi için hariç tutulup tutulmayacağı. Bu alan varsayılan olarak yanlıştır.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Yalnızca çıkış. YouTube ve İş Ortakları satır öğelerine özel ayarlar.

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

Dönüşümleri teşvik eden YouTube video reklamları.

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

Atlanamayan YouTube video reklamları (15 saniyeye kadar).

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

Bir hikayeyi farklı biçimlerin karışımıyla belirli bir sırada gösteren YouTube video reklamları.

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

YouTube işitsel reklamları.

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

Daha düşük maliyetle daha fazla benzersiz kullanıcıya ulaşmayı optimize eden YouTube video reklamları. Bumper reklamlar, atlanabilir yayın içi reklamlar veya çeşitli türleri içerebilir.

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

Varsayılan YouTube video reklamları.

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

Atlanamayan bağlı TV YouTube video reklamları (15 saniyeye kadar).

Bu tür satır öğeleri ve bunların 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 benzersiz kullanıcıya ulaşmayı optimize eden, bağlı TV YouTube video reklamları. Bumper reklamlar, atlanabilir yayın içi reklamlar veya çeşitli türleri içerebilir.

Bu tür satır öğeleri ve bunların 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ür satır öğeleri ve bunların 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ın hedef sayısını belirli bir dönemde aynı kişiye kaç kez göstermektir.

Bu tür satır öğeleri ve bunların 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 almayı amaçlayan YouTube video reklamları.

Bu tür satır öğeleri ve bunların 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ür satır öğeleri ve bunların 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ür satır öğeleri ve bunların hedeflemeleri, API kullanılarak oluşturulamaz veya güncellenemez.

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 olduğunda gereklidir. Yalnızca aksi takdirde çıkış yap.
  • Yeni bir yayın oluştururken hem startDate hem de endDate gelecekte olmalıdır.
  • Geçmişte startDate içeren mevcut bir uçuşta değişken endDate ancak sabit startDate var.
  • endDate, startDate veya sonraki bir tarih olmalı ve her ikisi de 2037 yılından önce olmalıdır.

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.

LineItemBudget

Bütçenin nasıl ayrılacağını kontrol eden ayarlar.

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

enum (LineItemBudgetAllocationType)

Zorunlu. Ayrılan bütçe 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 kullanılabilir.
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ındı.
maxAmount

string (int64 format)

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

budgetAllocationType şöyle olduğunda:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, bu alan sabittir ve sistem tarafından ayarlanır.
  • budgetUnit için geçerliyse LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED:
    • BUDGET_UNIT_CURRENCY değeri için bu alan, reklamverenin para biriminin mikro cinsinden harcanacak maksimum bütçe tutarını gösterir. Örneğin, 1500000, para biriminin 1,5 standart birimini temsil eder.
    • BUDGET_UNIT_IMPRESSIONS ise bu alan, sunulacak maksimum gösterim sayısını temsil eder.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, bu alan geçerli değil ve sistem tarafından yoksayılacak.

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 (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Alanlar
markupType

enum (PartnerRevenueModelMarkupType)

Zorunlu. İş ortağı gelir modelinin kâr marjı tü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 değeri PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM olarak ayarlandığında bu alan, reklamverenin para biriminin mikro cinsinden BGBM kârını gösterir. Örneğin, 1500000, para biriminin 1,5 standart birimini temsil eder.
  • markupType değeri PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP olarak ayarlandığında bu alan, milisaniye cinsinden medya maliyeti yüzde kârını gösterir. Örneğin, 100, %0,1'i (ondalık 0,001) temsil eder.
  • markupType değeri PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP olarak ayarlandığında bu alan, milisaniye cinsinden toplam medya maliyeti yüzde kârını gösterir. Örneğin, 100, %0,1'i (ondalık 0,001) temsil eder.

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 (TrackingFloodlightActivityConfig)
    }
  ]
}
Alanlar
postViewCountPercentageMillis

string (int64 format)

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

object (TrackingFloodlightActivityConfig)

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

string (int64 format)

Zorunlu. Floodlight etkinliğinin kimliği.
postClickLookbackWindowDays

integer

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

integer

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.

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.
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 excludeFirstPartyAudience ayarı kullanılıyor.

excludeFirstPartyAudience alanının kullanımdan kaldırılmasıyla ilgili olarak 25 Mart 2023'ten önce API entegrasyonunuzu, kitle hedeflemeyi kullanarak birinci taraf kitleleri doğrudan hariç tutacak şekilde güncelleyin.

MobileApp

Mobil uygulama yükleme satır öğesi tarafından tanıtılan 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 tarafından kullanılan paket kimliğiyle (ör. com.google.android.gm) tanımlanır.

iOS uygulamaları, Apple'ın App Store'u 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 İş Ortakları satır öğesi ayarları.

JSON gösterimi 
{
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementSettings": {
    object (YoutubeAndPartnersThirdPartyMeasurementSettings)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
Alanlar
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Zorunlu. YouTube ve İş Ortakları satır öğesinin teklif stratejisi.
viewFrequencyCap

object (FrequencyCap)

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

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

object (YoutubeAndPartnersThirdPartyMeasurementSettings)

İsteğe bağlı. Satır öğesinin üçüncü taraf ölçüm ayarları.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Satır öğesinin hedefleyeceği YouTube ve İş Ortakları envanterlerini kontrol eden ayarlar.
contentCategory

enum (YoutubeAndPartnersContentCategory)

YouTube ve İş Ortakları reklamlarının gösterileceği içerik türüdü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.
targetFrequency

object (TargetFrequency)

Bu satır öğesindeki reklamların belirli bir süre boyunca aynı kişiye ortalama kaç kez gösterilmesini istediğiniz.
linkedMerchantId

string (int64 format)

Ürün feed'inin satır öğesine bağlı satıcının kimliği.
relatedVideoIds[]

string

Videoların kimlikleri, reklam mobil cihazlardaki YouTube uygulamasında oynatılırken birincil video reklamın altında görünür.
leadFormId

string (int64 format)

Potansiyel müşteri oluşturmak için kullanılacak formun kimliği.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

VideoAdSequence ile ilgili ayarlar.

YoutubeAndPartnersThirdPartyMeasurementSettings

Belirli satır öğesi metriklerini hangi üçüncü taraf tedarikçilerin ölçtüğünü kontrol eden ayarlar.

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

object (ThirdPartyVendorConfig)

Görüntülenebilirliği ölçen üçüncü taraf tedarikçi firmalar.

Aşağıdaki üçüncü taraf tedarikçi firmalar 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)

Marka güvenliğini ölçen üçüncü taraf tedarikçi firmalar.

Aşağıdaki üçüncü taraf tedarikçi firmalar geçerlidir:

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Erişimi ölçen üçüncü taraf tedarikçi firmalar.

Aşağıdaki üçüncü taraf tedarikçi firmalar geçerlidir:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Brand Lift'i ölçen üçüncü taraf tedarikçi firmalar.

Aşağıdaki üçüncü taraf tedarikçi firmalar geçerlidir:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

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çi firması.
placementId

string

Satır öğesini tanımlamak için üçüncü taraf tedarikçi firmanı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 tedarikçi firma.
THIRD_PARTY_VENDOR_MOAT Hendek.
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.

YoutubeAndPartnersInventorySourceConfig

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

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

boolean

YouTube'daki kanal ve video envanterinin ve diğer sitelere yerleştirilmiş YouTube videolarındaki envanterin hedeflenip hedeflenmeyeceğini belirler.
includeGoogleTv

boolean

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

boolean

YouTube ile aynı marka güvenliği standartlarını uygulayan iş ortağı siteleri ve uygulamaları koleksiyonunda envanter hedeflenip hedeflenmeyeceği.

YoutubeAndPartnersContentCategory

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

Sıralamalar
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED Bu sürümde içerik kategorisi belirtilmemiş veya bilinmiyor.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Çoğu markaya uygun, çeşitli içeriklerden oluşan bir kategori. İçerik, YouTube'un reklamverenlere uygun içerik kurallarına göre belirleniyor.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED YouTube ve video iş ortaklarındaki tüm içeriklerin yer aldığı, para kazanma standartlarını karşılayan bir kategori.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Özellikle uygunsuz dil ve müstehcenlik ile ilgili yüksek şartları karşılayan, az sayıda içerik barındıran bir kategori.

TargetFrequency

Reklamların aynı kişiye belirli bir süre içinde 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 aynı kullanıcıya timeUnit ve timeUnitCount tarafından belirtilen zaman aralığında ortalama gösterilme sayısı.
timeUnit

enum (TimeUnit)

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

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

  • TIME_UNIT_WEEKS
timeUnitCount

integer

Hedef sıklığın devam edeceği timeUnit sayısı.

timeUnit değerine bağlı olarak aşağıdaki kısıtlamalar uygulanır:

  • TIME_UNIT_WEEKS - 1 olmalıdır

VideoAdSequenceSettings

VideoAdSequence ile ilgili ayarlar.

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

enum (VideoAdSequenceMinimumDuration)

Aynı kullanıcının bu sırayı tekrar görmesi için gereken minimum zaman aralığı.
steps[]

object (VideoAdSequenceStep)

Dizinin oluşturulduğu adımlar.

VideoAdSequenceMinimumDuration

Aynı kullanıcının VideoAdSequence'ı tekrar görmesinden önceki olası minimum aralık süresinin sıralaması.

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

VideoReklam Dizisi'ndeki tek bir adımın ayrıntısı.

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ımla ilgili ilgili reklam grubunun kimliği.
previousStepId

string (int64 format)

Önceki adımın kimliği. İlk adımda önceki adım yok.
interactionType

enum (InteractionType)

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

InteractionType

Bir adımdaki etkileşim türleri.

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

Yöntemler

bulkEditAssignedTargetingOptions

 Hedefleme seçeneklerini birden fazla satır öğesi altında toplu olarak düzenler.

bulkListAssignedTargetingOptions

 Hedefleme türleri genelinde birden fazla satır öğesi için atanan 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 öğesinin kopyasını oluşturur.

generateDefault

 Kampanya siparişinden devralınan ayarlara (hedefleme dahil) sahip yeni bir satır öğesi ve bir ENTITY_STATUS_DRAFT entity_status oluşturur.

get

 Bir satır öğesi alır.

list

 Bir reklamverendeki satır öğelerini listeler.

patch

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