REST Resource: exchanges.inventorySources

資源:InventorySource

DV360 廣告空間來源的執行模式。

JSON 表示法
{
  "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)
  }
}
欄位
name

string

僅供輸出。訂單的相對資源名稱。由伺服器產生。例如:「exchanges/1234/inventorySources/5678」。

buyerStatus

enum (BuyerStatus)

僅供輸出。買方狀態。

sellerStatus

enum (SellerStatus)

賣家狀態。

transactionType

enum (TransactionType)

僅供輸出。產品交易類型。

pricingType

enum (PricingType)

僅供輸出。產品的定價類型。

rateDetails

object (RateDetails)

僅供輸出。費率詳細資料。

startTime

string (Timestamp format)

僅供輸出。這項產品啟用的時間。必須早於 endTime。開始時間不得超過 1 年。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

endTime

string (Timestamp format)

僅供輸出。這項產品停用時的時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

廣告交易平台提供每日流量預測資料。用於決定節奏並讓買方選擇。這個欄位已不適用。

audienceMatchRate

number

僅供輸出。針對含有目標對象指定功能的程式輔助保證交易,預測的目標對象比對率,用於交換方判斷應傳送多少額外要求。這個值是介於 0 和 1 之間的小數,其倒數應做為曝光調節係數。0 表示欄位未設定,因此沒有指定目標對象。例如:「0.125」。這表示 12.5% 的請求與目標對象相符,且傳送的要求數量應為協商曝光次數的 8 倍。

makegoodRequested

boolean

僅供輸出。指出是否已向買方提出補償項要求。

makegoodRequestedReason

string

僅供輸出。買方提供的補償項要求原因。

percentFrequencyCapExcludedTraffic

string (int64 format)

程式輔助保證交易的展示頻率上限中排除的流量百分比。這項屬性是介於 0 和 100 之間的整數。值為 0 (也是預設值) 表示沒有排除條件,因此所有流量都符合展示頻率上限的資格。值為 100 表示完全排除,因此不會套用展示頻率上限。值介於 0 到 100 之間會導致部分排除。舉例來說,如果值為 20,表示系統會將 20% 的流量排除在展示頻率上限之外。

dv360WseatId[]

string (int64 format)

僅供輸出。目前對廣告空間來源擁有權限的 wseat。

lastModifiedTime

string (Timestamp format)

僅供輸出。廣告空間來源上次更新的時間。請注意,部分 DV3 內部更新會變更上次修改時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

creativeApprovalConfig

object (CreativeApprovalConfig)

(非必要) 廣告素材核准的設定。可能需要在廣告交易平台層級或發布商層級核准。

BuyerStatus

買方狀態。

列舉
BUYER_STATUS_UNSPECIFIED 未指定買方狀態。輸入值無效。
BUYER_STATUS_ACTIVE 買方狀態為有效。已指派委刊項和有效廣告素材。
BUYER_STATUS_PENDING 買方狀態處於待處理狀態。這個狀態表示交易尚未生效,買方需要採取特定行動。
BUYER_STATUS_PAUSED 買方狀態為由買方暫停。

SellerStatus

賣家狀態。

列舉
SELLER_STATUS_UNSPECIFIED 未指定賣方狀態。非預期狀態,表示協商狀態不明。輸入值無效。
SELLER_STATUS_ACTIVE 賣方狀態為有效。廣告交易平台端的廣告空間來源已啟用。
SELLER_STATUS_PAUSED 賣家狀態已暫停。

InventorySourceVolumeForecast

廣告空間來源的每日要求量預測。適用下列驗證規則:- 必須為每個星期幾提供項目 - 音量必須為非負值 - timeZoneId 為必填欄位,且必須有效

JSON 表示法
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
欄位
dailyVolumes[]

object (DailyVolume)

每日預測銷量。

timeZoneId

string

用於每日銷量資料的 IANA 時區資料庫時區,例如「America/New_York」。

DailyVolume

指定日期的廣告空間來源要求量。

JSON 表示法
{
  "day": enum (DayOfWeek),
  "volume": string
}
欄位
day

enum (DayOfWeek)

要求數量適用的星期幾。

volume

string (int64 format)

特定星期幾的預估要求量。

DayOfWeek

代表星期幾。

列舉
DAY_OF_WEEK_UNSPECIFIED 未指定星期幾。
MONDAY 星期一
TUESDAY 週二
WEDNESDAY 週三
THURSDAY 週四
FRIDAY Friday (週五)
SATURDAY Saturday (週六)
SUNDAY 星期日

CreativeApprovalConfig

廣告素材核准的設定。

JSON 表示法
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
欄位
requiresExchangeApproval

boolean

必要欄位。指出廣告素材是否需要在廣告交易平台層級獲得預先攝入核准。

publisherConfigs[]

object (PublisherConfig)

(非必要) 發布商的設定。

PublisherConfig

發布商的設定 (publisher_config)。如果已設定 publisher_config,則廣告素材必須在發布商層級獲得預先攝入核准。

JSON 表示法
{
  "publisherId": string,
  "publisherDisplayName": string
}
欄位
publisherId

string

必要欄位。發布商 ID。

publisherDisplayName

string

必要欄位。發布商名稱。

方法

get

取得廣告空間來源。

list

列出廣告空間來源。

patch

更新廣告空間來源。