REST Resource: exchanges.inventorySources

Kaynak: InventorySource

DV360 envanter kaynağının yürütme modeli.

JSON gösterimi 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
Alanlar
name

string

Yalnızca çıkış. Siparişin göreli kaynak adı. Sunucu tarafından oluşturulur. Örnek: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Yalnızca çıkış. Alıcı durumu.
sellerStatus

enum (SellerStatus)

Satıcı durumu.
transactionType

enum (TransactionType)

Yalnızca çıkış. Ürün işlem türü.
pricingType

enum (PricingType)

Yalnızca çıkış. Ürünün fiyatlandırma türü.
rateDetails

object (RateDetails)

Yalnızca çıkış. Fiyat ayrıntıları.
startTime

string (Timestamp format)

Yalnızca çıkış. Bu ürünün etkinleşeceği zaman. endTime değerinden önce olmalıdır. Başlangıç zamanı, şu anki tarihten en fazla 1 yıl sonrası olabilir.

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

string (Timestamp format)

Yalnızca çıkış. Bu ürünün devre dışı kalacağı zaman.

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".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Exchange tarafından sağlanan günlük hacim tahmini. Hızı belirlemek ve alıcı seçeneğini etkinleştirmek için kullanılır. Bu alan kullanımdan kaldırılmıştır.
audienceMatchRate

number

Yalnızca çıkış. Kitle hedefleme içeren Programatik Garantili anlaşmalar için tahmin edilen kitle eşleşme oranı. Exchange tarafından kaç ek isteğin gönderilmesi gerektiğini belirlemek için kullanılır. Bu, 0 ile 1 arasında bir ondalık sayıdır. Bunun tersi, gösterimler için çarpan olarak kullanılmalıdır. 0, alanın ayarlanmadığını ve bu nedenle kitle hedefleme içermediğini gösterir. Örnek: "0,125". Bu, isteklerin% 12,5'inin kitle hedeflemeyle eşleştiğini ve gönderilen istek sayısının, üzerinde anlaşmaya varılan gösterim sayısının 8 katı olması gerektiğini gösterir.
makegoodRequested

boolean

Yalnızca çıkış. Alıcıdan İyileştirme isteğinde bulunulup bulunulmadığını gösterir.
makegoodRequestedReason

string

Yalnızca çıkış. Alıcı tarafından sağlanan, İyileştirme isteğinde bulunma nedeni.
percentFrequencyCapExcludedTraffic

string (int64 format)

Programatik Garantili anlaşmada sıklık sınırının dışında tutulan trafik yüzdesi. Bu, 0 ile 100 arasında bir tam sayıdır. 0 değeri (varsayılan değerdir) hariç tutma olmadığını gösterir. Bu nedenle, tüm trafik sıklık sınırı için uygundur. 100 değeri, tam hariç tutma olduğunu gösterir. Bu nedenle, sıklık sınırı uygulanmaz. 0 ile 100 arasındaki değerler kısmi hariç tutmaya neden olur. Örneğin, 20 değeri, trafiğin% 20'sinin sıklık sınırının dışında bırakılmasına neden olur.
dv360WseatId[]

string (int64 format)

Yalnızca çıkış. Şu anda envanter kaynağına izin verilen iş istasyonları.
lastModifiedTime

string (Timestamp format)

Yalnızca çıkış. Envanter kaynağının son güncellenme tarihi. Bazı DV3 dahili güncellemelerinin son değiştirilme zamanını değiştireceğini unutmayın.

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

object (CreativeApprovalConfig)

İsteğe bağlı. Reklam öğesi onayı için yapılandırma. Borsa düzeyinde veya yayıncı düzeyinde onay gerekebilir.

BuyerStatus

Alıcı durumu.

Sıralamalar
BUYER_STATUS_UNSPECIFIED Alıcı durumu belirtilmemiş. Geçerli giriş değeri değil.
BUYER_STATUS_ACTIVE Alıcı durumu etkin olmalıdır. Satır öğesi atanmış, geçerli reklam öğesi atanmış.
BUYER_STATUS_PENDING Alıcı durumu beklemede. Bu durum, anlaşmanın etkin olmadığı ve alıcının belirli işlemler yapması gerektiği anlamına gelir.
BUYER_STATUS_PAUSED Alıcı tarafından duraklatılan alıcının durumu.

SellerStatus

Satıcı durumu.

Sıralamalar
SELLER_STATUS_UNSPECIFIED Satıcı durumu belirtilmemiş. Beklenmedik. Pazarlık durumunun bilinmediğini gösterir. Geçerli giriş değeri değil.
SELLER_STATUS_ACTIVE Satıcı durumu etkin olmalıdır. Envanter kaynağı, exchange tarafında etkin olmalıdır.
SELLER_STATUS_PAUSED Satıcı durumu duraklatıldı.

InventorySourceVolumeForecast

Bir envanter kaynağı için günlük istek hacmi tahmini. Aşağıdaki doğrulama kuralları geçerlidir: - Haftanın her günü için bir giriş sağlanmalıdır. - Hacim negatif olmamalıdır. - timeZoneId gereklidir ve geçerli olmalıdır.

JSON gösterimi 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Alanlar
dailyVolumes[]

object (DailyVolume)

Günlük hacim tahmini.
timeZoneId

string

Günlük hacimler için kullanılan IANA Saat Dilimi Veritabanı saat dilimi (ör. "America/New_York").

DailyVolume

Belirli bir günde bir envanter kaynağı için istek hacmi.

JSON gösterimi 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Alanlar
day

enum (DayOfWeek)

İstek hacminin geçerli olduğu haftanın günü.
volume

string (int64 format)

Haftanın belirli bir günü için öngörülen istek hacmi.

HaftanınGünü

Haftanın bir gününü temsil eder.

Sıralamalar
DAY_OF_WEEK_UNSPECIFIED Haftanın günü belirtilmemiş.
MONDAY Pazartesi
TUESDAY Salı
WEDNESDAY Çarşamba
THURSDAY Perşembe
FRIDAY Cuma
SATURDAY Cumartesi
SUNDAY Pazar

CreativeApprovalConfig

Reklam öğesi onayı için yapılandırma.

JSON gösterimi 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Alanlar
requiresExchangeApproval

boolean

Zorunlu. Reklam öğesinin borsa düzeyinde önceden alım onayı gerektirip gerektirmediğini belirtir.
publisherConfigs[]

object (PublisherConfig)

İsteğe bağlı. Yayıncı için yapılandırma.

PublisherConfig

Yayıncı yapılandırması (publisher_config). publisher_config ayarlanmışsa reklam öğesi için yayıncı düzeyinde önceden alma onayı gerekir.

JSON gösterimi 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Alanlar
publisherId

string

Zorunlu. Yayıncı kimliği.
publisherDisplayName

string

Zorunlu. Yayıncı adı.

Yöntemler

get

 Envanter kaynağını alır.

list

 Envanter kaynaklarını listeler.

patch

 Bir envanter kaynağını günceller.