結構化資料 - 3.1 版 - 廣告訂單

如要進一步瞭解格式，請參閱總覽。

欄位必填類型可寫入說明
Io ID只有在編輯現有廣告訂單時才需要整數否廣告訂單的數字 ID 值。如果留空，系統會建立新的廣告訂單 ID 並指派專屬 ID。建立新的廣告訂單時，您可以選擇使用自訂 ID，將委刊項指派給新的廣告訂單。自訂 ID 的格式為「ext <自訂 ID>」，例如 ext123。檔案上傳並處理完畢後，系統會將所有自訂 ID 替換成 DBM 指派的 ID，並根據自訂 ID 將物件建立關聯 (例如委刊項與廣告訂單)。
廣告活動 ID否整數否廣告活動的數字 ID 值。如果您在建立這個廣告訂單的同時也建立了廣告活動，可以為廣告活動指定自訂 ID (例如「ext[自訂廣告活動 ID]」)。
名稱是字串是項目名稱。
時間戳記編輯現有項目時必須提供整數否項目的時間戳記，系統會使用這項資訊，確認該項目從下載後到上傳前的這段期間沒有任何異動。
狀態是字串是項目的狀態設定。
  • 有效
  • 已暫停
  • 草稿
  • 已封存
  • 已刪除
IO 類型是字串是廣告訂單類型。只能在建立時設定。
  • standard
費用否字串、清單清單是這筆交易的所有費用。清單格式 = (費用類別; 費用金額; 費用類型; 已開立月結單)。
  • 費用類別
    • 千次曝光出價
    • 媒體
  • 費用金額
    • 浮點值
    • 以浮點數表示的射門成功率
  • 費用類型
    • (字串，請參閱「費用」一節中的表格)
  • 已開立月結單
    • 是
    • 否
    • 空白

範例：「(CPM; 2; Bid Manager Fee; False) ; (Media; 13; Default; True)」
下表列出可接受的值：

注意：系統會保留附加費率千次曝光出價費用，無法變更。系統會視需要插入預設千次曝光出價費用，藉此在各個 mutation 中保留付費功能費用的基數。

費用類別費用類型月結選項
CPM/媒體預設禁止 (請留空白)
CPM/媒體第三方廣告伺服器禁止 (請留空白)
CPM/媒體DoubleVerify是否允許 (是/否)
CPM/媒體ADsafe禁止 (請留空白)
CPM/媒體Adxpose禁止 (請留空白)
CPM/媒體Vizu禁止 (請留空白)
CPM/媒體Aggregate Knowledge禁止 (請留空白)
CPM/媒體Teracent禁止 (請留空白)
CPM/媒體Evidon禁止 (請留空白)
CPM/媒體代理商交易平台費用禁止 (請留空白)
CPM/媒體Adloox是否允許 (是/否)
千次曝光出價ShopLocal必要 (是)
千次曝光出價TrustMetrics禁止 (請留空白)
千次曝光出價Integral Ad Science 影片是否允許 (是/否)
千次曝光出價MOAT 影片禁止 (請留空白)
媒體Bid Manager 費用必要 (是)
媒體媒體費用資料禁止 (請留空白)
千次曝光出價進階版費用禁止 (請留空白)
整合代碼否字串是用於追蹤的選用代碼。
詳細資料否字串是以字串格式輸入詳細資料。
使用速度是字串是用於支出使用速度金額的時間範圍。
  • 每日
  • 每月
  • 檔期
使用速度是字串是這個項目的節奏速率。
  • 盡快
  • 平均
  • 超前
使用速度金額是float是每個時間間隔的支出金額，由節奏類型設定。
已啟用展示頻率是字串是啟用/停用廣告訂單的曝光展示頻率上限。
  • TRUE
  • FALSE
展示頻率當「啟用展示頻率」為「TRUE」時，此屬性為必填整數是指定展示頻率金額中的曝光次數正整數，也就是「在 y 期間內顯示 x 次曝光」中的 x。
展示頻率週期當「啟用展示頻率」為「TRUE」時，此屬性為必填字串是指定展示頻率上限的時間單位。
  • 分鐘
  • 小時
  • 天
  • 週
  • 月
  • 效期
頻率當「啟用展示頻率」為「TRUE」時，此屬性為必填整數是展示頻率期間類型 (即「在 y 期間內顯示 x 次曝光」中的 y) 的時間長度，以正整數表示。
成效目標類型是字串是廣告訂單的目標單位
  • 千次曝光出價
  • 單次轉換出價
  • 單次點擊出價
  • 單次收視出價
  • 單次有聲播放且看完的曝光出價
  • 點閱率
  • 可視百分比
  • 無
  • 其他
成效目標價值是字串是目標值以貨幣 (千次曝光出價、單次動作出價、單次點擊出價、單次收視出價、單次轉換出價)、百分比 (可視度百分比、點閱率) 或字串 (其他) 表示。
評估 DAR是字串是啟用/停用 Nielsen Digital Ad Ratings 目標對象評估功能
  • TRUE
  • FALSE
評估 DAR 管道如果「評估 DAR」為「TRUE」，則為必要參數整數是使用 Nielsen Digital Ad Ratings 評估的管道。格式 = UniversalChannel.id
預算類型是字串是指定預算類型，以要支出的「收益」金額 (金額) 或要購買的曝光次數 (曝光次數) 為準
    。
  • 金額
  • 曝光
預算區隔是字串、清單清單是指定特定預算區隔。清單格式 = (預算、開始日期、結束日期)。預算以浮動貨幣格式顯示。日期格式為 MM/DD/YYYY。示例：「(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);」
自動預算分配是字串是啟用/停用自動預算分配功能
  • TRUE
  • FALSE
指定地理區域 - 包含否字串、清單是要納入指定目標的地理區域清單。清單格式 = (GeoLocation.id; GeoLocation.id; 等等)。
指定地理區域 - 排除否字串、清單是指定要排除的地理區域清單。清單格式 = (GeoLocation.id;GeoLocation.id; 等等)。
指定語言 - 納入否字串、清單是指定要納入指定目標的語言清單。清單格式 = (Language.id;Language.id;等)。
指定語言 - 排除否字串、清單是指定要排除的語言清單。清單格式 = (Language.id;Language.id;等)。
指定裝置 - 納入否字串、清單是指定要納入指定目標的裝置清單。清單格式 = (DeviceCriteria.id;DeviceCriteria.id; 等等)。
指定裝置 - 排除否字串、清單是指定要排除的裝置清單。清單格式 = (DeviceCriteria.id;DeviceCriteria.id; 等等)。
指定瀏覽器 - 納入否字串、清單是要納入指定目標的瀏覽器清單。清單格式 = (Browser.id;Browser.id; 等等)。
指定瀏覽器 - 排除否字串、清單是指定目標中要排除的瀏覽器清單。清單格式 = (Browser.id;Browser.id; 等等)。
品牌安全標籤否字串、清單是要指定的數位內容標籤清單。清單格式 = (G;PG; 等等)。
  • G
  • PG
  • T
  • MA
  • ？
品牌安全敏感度設定否字串是選擇敏感度設定，根據周邊內容的主題封鎖廣告空間。
  • 不要封鎖
  • 使用 DoubleClick 驗證
  • 使用自訂
品牌安全自訂設定如果「品牌安全性自訂設定」為「使用自訂設定」，則必須填寫字串、清單是如果品牌安全防護敏感度設定為「使用自訂設定」，請指定標準內容分類器清單。例如：(成人；酒精；菸草；等等)。
  • 成人
  • 詆毀
  • 下載和分享
  • 武器
  • 賭博
  • 暴力
  • 性暗示
  • 不雅用語
  • 酒精飲料
  • 毒品
  • 菸草
  • 政治
  • 宗教
  • 悲劇
  • 交通事故
  • 敏感的社會議題
  • 駭人的內容
第三方驗證服務否字串是第三方驗證服務供應商。
  • 無
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方驗證標籤否字串、清單是如果「第三方驗證服務」不是「None」，請指定所選供應商支援的標籤清單。
管道指定目標 - 納入否字串、清單是要納入指定目標的管道清單。清單格式 = (UniversalChannel.id;UniversalChannel.id; 等等)。
指定頻道 - 排除否字串、清單是要納入指定目標的管道清單。清單格式 = (UniversalChannel.id;UniversalChannel.id; 等等)。
網站指定目標 - 納入否字串、清單是要納入指定目標的網站清單。清單可包含一組網站 ID 或網址字串 (如果在通用網站表格中找不到)。清單格式 = (UniversalSite.Id;「http://someurl.com」等)。
指定網站 - 排除否字串、清單是指定目標中要排除的網站清單。清單可包含一組網站 ID 或網址字串 (如果在通用網站表格中找不到)。清單格式 = (UniversalSite.Id;「http://someurl.com」等)。
應用程式指定目標 - 納入否字串、清單是要納入指定目標的應用程式清單。清單可包含一組 UniversalSite ID 或應用程式套件的字串 (如果未在通用網站表格中找到)。清單格式 = (UniversalSite.Id; 'some.app.package'; 等等)。
指定應用程式 - 排除否字串、清單是指定目標中要排除的應用程式清單。清單可包含一組 UniversalSite ID 或應用程式套件的字串 (如果未在通用網站表格中找到)。清單格式 = (UniversalSite.Id; 'some.app.package'; 等等)。
指定類別 - 納入否字串、清單是從 AdX 垂直 ID 中，列出要納入指定目標的類別。清單格式 = (Verticals.Id;Verticals.Id;等)。
指定類別 - 排除否字串、清單是從 AdX 產業 ID 取得的排除類別清單。清單格式 = (Verticals.Id;Verticals.Id;等)。
指定關鍵字 - 納入否字串、清單是要納入指定目標的關鍵字字串清單。
指定關鍵字 - 排除否字串、清單是在指定目標中排除的關鍵字字串清單。
指定目標對象 - 類似目標對象如果「類型」為「多媒體」或「影片」或「音訊」，則必須提供字串是 為指定第一方名單的正向目標對象啟用類似目標對象
    。
  • TRUE
  • FALSE
指定目標對象 - 包含否字串、組合清單的清單是要納入指定目標的目標對象名單清單。對於第一方目標對象名單，每個目標對象都會以一組 UserList ID 和回訪率設定列出。組合為 (1;1d;)，其中 1d 是代表 1 天近期性的樣本近期性。第三方目標對象不支援近期性，因此清單格式為 (3;);(4;);。如要「AND」和「OR」群組目標對象，請按照以下範例操作：如要結合有和沒有最近活動的組合：' ((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。也就是說，您必須同時使用 (清單 1 的 1 天回訪率 OR 清單 2 的 365 天回訪率) 和 (清單 3 的未指定回訪率 OR 清單 4 的 5 分鐘回訪率 OR 清單 5 的所有使用者)。
有效的回訪率值為：
all、1m、5m、10m、15m、30m、1h、2h、3h、6h、12h、1d、2d、3d、5d、7d、10d、14d、15d、21d、28d、30d、45d、60d、90d、120d、180d、270d、365d
指定目標對象 - 排除否字串、組合清單的清單是指定目標中要排除的目標對象名單清單。如果目標對象名單是第一方目標對象名單，則每個目標對象都會列為一組 UserList ID 和回訪率設定。組合為 (1;1d;)，其中 1d 是代表 1 天近期性的樣本近期性。不過，第三方目標對象無法使用回訪率，因此名單格式為 (3;);(4;)。清單格式= (UserList.id; recency optional;); (UserList.id; recency optional;);
範例："(1;1d;);(2;);"。
有效的 recency 值為：
all、1m、5m、10m、15m、30m、1h、2h、3h、6h、12h、1d、2d、3d、5d、7d、10d、14d、15d、21d、28d、30d、45d、60d、90d、120d、180d、270d、365d
興趣相似目標對象和潛在目標消費者指定目標 - 納入否字串、清單是要納入的興趣相似目標對象和/或潛在目標消費者名單。清單格式= 使用者名單 ID; 使用者名單 ID;
興趣相似目標對象和潛在目標消費者指定目標 - 排除否字串、清單是要排除的興趣相似目標對象和/或潛在目標消費者名單。清單格式= 使用者名單 ID; 使用者名單 ID;
自訂興趣相似指定目標否字串、清單是要指定的自訂名單清單。清單格式= 使用者名單 ID; 使用者名單 ID;
指定廣告空間來源 - 包含否字串、清單是要納入指定目標的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。
指定廣告空間來源 - 排除否字串、清單是在指定目標中排除的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。
時段指定目標否字串、清單是ID 清單，其中每個時段 ID 的格式如下：
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ start * 100
+ end

base_dayparting_id = 300000
days_since_monday：0=星期一、1=星期二、...、6=星期日
start：0..95 (00:00--23:45) 是 0 到 95 的整數，代表 15 分鐘的時間間隔
end：1..96 (00:15--24:00)；0 到 95 的整數，代表 15 分鐘的時間間隔
start < end
對於新實體，系統會以使用者的時區設定時間 (例如，「Local」)。現有實體的時區不會變更。
指定環境如果「類型」為「多媒體」或「影片」或「音訊」，則必須提供字串、清單是要指定的環境清單。清單格式 = (電腦版網站、行動應用程式等)。
如為顯示環境：
  • 電腦版網頁
  • 行動版網站
  • 行動應用程式
  • 行動應用程式插頁式廣告
  • 行動裝置上的電腦版網頁
影片：
  • 電腦版網頁影片
  • 電腦版網頁遊戲
  • 電腦版網頁文章內
  • 電腦版網頁動態內
  • 行動版網站影片
  • 行動應用程式影片
  • 行動應用程式影片插頁式廣告
音訊：
  • 電腦版網頁音訊
  • 行動版網站音訊
  • 行動應用程式音訊
指定可視度 Active View否字串是指定預測可視度百分比。百分比會以浮點值表示。下列其中一個值：{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
可視度指定廣告位置 - 納入否字串是指定廣告排序。選取一個或全部可接受值：
  • 全部
  • ATF
  • BTF
  • 不明
可視度指定目標廣告排序 - 排除否字串是排除指定廣告位置。選取一個或全部可接受值：
  • ATF
  • BTF
  • 不明
指定影片廣告排序否字串、清單是要指定的影片廣告排序清單。請選取一或多個可接受的值：
  • 不明
  • 片頭廣告
  • 片中廣告
  • 片尾廣告
指定影片播放器大小否字串、清單是要指定的影片廣告播放器大小清單。請選取一或多個可接受的值：
  • 不明
  • small
  • large
  • HD 高畫質
指定客層：性別否字串、清單是要指定的性別清單。請選取一或多個可接受的值：
  • 女性
  • 男性
  • 不明
指定客層：年齡否字串、清單是指定使用者年齡範圍。選取單一「從」年齡和單一「至」年齡，並指定是否要納入不明確年齡 (true/false)，即可指定從/至年齡範圍。請參閱可接受的「從/到」年齡範圍清單。
範例 1：如要指定 18 到 55 歲，並納入不明年齡，請指定以下格式：{從/到; 納入不明年齡 (是/否)} = 18;55;true;
範例 2：如要只指定 35 歲以上，並排除不明年齡，請指定以下格式：= 35;+;false;。
「從」年齡範圍可接受的值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

可接受的「To」值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
指定連線速度否字串是指定特定連線速度。請選取其中一個可接受值：
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
指定電信業者 - 納入否字串、清單是要指定的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id; ISP.id;}
指定電信業者 - 排除否字串、清單是要排除的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id; ISP.id;}