如要瞭解格式,請參閱總覽。
欄位 | 必填 | 類型 | 可寫入 | 說明 |
---|---|---|---|---|
Exchange | 無代碼保證交易的必填欄位 | 字串 | 是 | 廣告空間來源的廣告交易平台。 |
產品 ID | 建立或編輯非代碼保證交易,或編輯代碼保證交易時,必須填寫這項資訊。 | 字串 | 是 | 廣告空間來源的廣告交易平台專屬交易 ID。建立代碼保證交易時,無法寫入這個值。 |
廣告空間來源 ID | 只有在編輯現有廣告空間來源時才需要 | 字串 | 否 | 廣告空間來源的 DBM ID。如果留空,系統會建立新的廣告空間來源,並提供 Exchange 和交易 ID。 |
產品名稱 | 是 | 字串 | 是 | 廣告空間來源名稱。 |
承諾類型 | 是 | 字串 | 是 | 廣告空間來源的合約類型。只能在建立時編輯。有效值為「有保障」、「無保障」
|
費率類型 | 是 | 字串 | 是 | 廣告空間來源的費率類型。只能在建立時編輯。只能使用「Auction」和「Fixed」。
|
內容傳遞方式 | 是 | 字串 | 是 | 廣告空間來源的放送方式。只能在建立時編輯。只能使用「Tag」和「Programmatic」。
|
發布商/賣方 | 僅限代碼保證交易 | 字串 | 是 | 交易發布者的名稱 |
費率 | 是 | float | 是 | 交易的千次曝光出價,必須為正數。這可以是簡單的整數曝光值,也可以是貨幣金額的浮點數。系統會以「幣別」欄中提供的幣別顯示貨幣。如果是非標記保證交易,或是已完整設定標記的保證交易,則無法編輯這個值。 |
貨幣代碼 | 是 | 字串 | 是 | 交易千次曝光出價所用的幣別
|
開始日期 | 僅限代碼保證交易 | 字串 | 是 | 交易開始日期的時間戳記,格式為 MM/DD/YYYY HH:mm。如果交易是無代碼保證交易,或是已完整設定代碼的保證交易,則無法編輯這個值。 |
結束日期 | 僅限代碼保證交易 | 字串 | 是 | 交易結束日期的時間戳記,格式為 MM/DD/YYYY HH:mm。如果代碼保證以外的交易類型未指定結束日期,交易就會無限期放送。 |
取得日期 | 否 | 字串 | 否 | 交易取得日期的時間戳記,格式為 MM/DD/YYYY HH:mm。 |
狀態 | 是 | 字串 | 是 | 項目的狀態設定。
|
暫停原因 | 暫停非代碼保證交易時必須提供。 | 字串 | 是 | 買方提供交易暫停的原因。這個欄位不適用於首選交易或私下競價。 |
具備權限的合作夥伴 | 如果「已授權廣告主」欄位空白,則為必要欄位。 | 字串、清單 | 是 | 這筆交易的授權合作夥伴 ID 清單。清單格式 = (10; 20; 30;) |
Permissioned Advertisers (擁有權限的廣告主) | 如果「已授權合作夥伴」欄位空白,則為必要欄位。 | 字串、清單 | 是 | 這筆交易的獲准廣告主 ID 清單。清單格式 = (11; 22; 33;) |
Order Id | 否 | 字串 | 否 | 保證交易的訂單 ID。這個欄位不適用於首選交易或私下競價 |
委刊單名稱 | 僅限代碼保證交易。 | 字串 | 是 | 保證交易的訂單名稱。這個欄位不適用於首選交易或私下競價。 |
單位已購買 | 僅限代碼保證交易 | 整數 | 是 | 預訂產品的保證曝光次數。只有代碼保證交易可寫入這個值。這個欄位不適用於首選交易或私下競價。 |
格式 | 僅限代碼保證交易 | 字串 | 是 | 交易的廣告素材類型,例如多媒體或影片。只有在建立代碼保證交易時,以及針對未設定的代碼保證交易,才能寫入這個值。這個欄位不適用於首選交易或私下競價。
|
大小 | 僅限代碼保證交易 | 字串、清單 | 是 | 交易所需的廣告素材尺寸。只有在建立代碼保證交易時,以及針對未設定的代碼保證交易,才能寫入這個值。如果廣告素材類型為「DISPLAY」,內容會以 <寬度>x<高度> 的形式列出,例如「300x250; 728x90;」。如果廣告素材類型為 VIDEO,則內容會以秒為單位列出時間長度,例如「15; 20;」。這個欄位不適用於首選交易或私下競價 |