- 資源:InventorySource
- BuyerStatus
- SellerStatus
- InventorySourceVolumeForecast
- DailyVolume
- DayOfWeek
- CreativeApprovalConfig
- PublisherConfig
- 方法
資源:InventorySource
DV360 廣告空間來源的執行模式。
JSON 表示法 |
---|
{ "name": string, "buyerStatus": enum ( |
欄位 | |
---|---|
name |
僅供輸出。訂單的相對資源名稱。由伺服器產生。例如:「exchanges/1234/inventorySources/5678」。 |
buyerStatus |
僅供輸出。買方狀態。 |
sellerStatus |
賣家狀態。 |
transactionType |
僅供輸出。產品交易類型。 |
pricingType |
僅供輸出。產品的定價類型。 |
rateDetails |
僅供輸出。費率詳細資料。 |
startTime |
僅供輸出。這項產品啟用的時間。必須早於 endTime。開始時間不得超過 1 年。 使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
endTime |
僅供輸出。這項產品停用時的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
exchangeVolumeForecast |
廣告交易平台提供每日流量預測資料。用於決定節奏並讓買方選擇。這個欄位已不適用。 |
audienceMatchRate |
僅供輸出。針對含有目標對象指定功能的程式輔助保證交易,預測的目標對象比對率,用於交換方判斷應傳送多少額外要求。這個值是介於 0 和 1 之間的小數,其倒數應做為曝光調節係數。0 表示欄位未設定,因此沒有指定目標對象。例如:「0.125」。這表示 12.5% 的請求與目標對象相符,且傳送的要求數量應為協商曝光次數的 8 倍。 |
makegoodRequested |
僅供輸出。指出是否已向買方提出補償項要求。 |
makegoodRequestedReason |
僅供輸出。買方提供的補償項要求原因。 |
percentFrequencyCapExcludedTraffic |
程式輔助保證交易的展示頻率上限中排除的流量百分比。這項屬性是介於 0 和 100 之間的整數。值為 0 (也是預設值) 表示沒有排除條件,因此所有流量都符合展示頻率上限的資格。值為 100 表示完全排除,因此不會套用展示頻率上限。值介於 0 到 100 之間會導致部分排除。舉例來說,如果值為 20,表示系統會將 20% 的流量排除在展示頻率上限之外。 |
dv360WseatId[] |
僅供輸出。目前對廣告空間來源擁有權限的 wseat。 |
lastModifiedTime |
僅供輸出。廣告空間來源上次更新的時間。請注意,部分 DV3 內部更新會變更上次修改時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
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 ( |
欄位 | |
---|---|
dailyVolumes[] |
每日預測銷量。 |
timeZoneId |
用於每日銷量資料的 IANA 時區資料庫時區,例如「America/New_York」。 |
DailyVolume
指定日期的廣告空間來源要求量。
JSON 表示法 |
---|
{
"day": enum ( |
欄位 | |
---|---|
day |
要求數量適用的星期幾。 |
volume |
特定星期幾的預估要求量。 |
DayOfWeek
代表星期幾。
列舉 | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
未指定星期幾。 |
MONDAY |
星期一 |
TUESDAY |
週二 |
WEDNESDAY |
週三 |
THURSDAY |
週四 |
FRIDAY |
Friday (週五) |
SATURDAY |
Saturday (週六) |
SUNDAY |
星期日 |
CreativeApprovalConfig
廣告素材核准的設定。
JSON 表示法 |
---|
{
"requiresExchangeApproval": boolean,
"publisherConfigs": [
{
object ( |
欄位 | |
---|---|
requiresExchangeApproval |
必要欄位。指出廣告素材是否需要在廣告交易平台層級獲得預先攝入核准。 |
publisherConfigs[] |
(非必要) 發布商的設定。 |
PublisherConfig
發布商的設定 (publisher_config)。如果已設定 publisher_config,則廣告素材必須在發布商層級獲得預先攝入核准。
JSON 表示法 |
---|
{ "publisherId": string, "publisherDisplayName": string } |
欄位 | |
---|---|
publisherId |
必要欄位。發布商 ID。 |
publisherDisplayName |
必要欄位。發布商名稱。 |
方法 |
|
---|---|
|
取得廣告空間來源。 |
|
列出廣告空間來源。 |
|
更新廣告空間來源。 |