結構化資料 - v4 - 廣告訂單

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

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

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

注意：系統會保留附加費率千次曝光出價費用，且無法變更。系統會在變動期間保留付費功能費用的基數，並視需要插入預設千次曝光出價費用。

費用類別費用類型月結選項
公關/媒體預設不允許 (留空)
公關/媒體第三方廣告伺服器不允許 (留空)
公關/媒體DoubleVerify已獲允許 (True/False)
公關/媒體ADsafe不允許 (留空)
公關/媒體Adxpose不允許 (留空)
公關/媒體Vizu不允許 (留空)
公關/媒體Aggregate Knowledge不允許 (留空)
公關/媒體Teracent不允許 (留空)
公關/媒體Evidon不允許 (留空)
公關/媒體代理商交易平台費用不允許 (留空)
公關/媒體Adloox已獲允許 (True/False)
千次曝光出價ShopLocal必要 (True)
千次曝光出價TrustMetrics不允許 (留空)
千次曝光出價Integral Ad Science 影片已獲允許 (True/False)
千次曝光出價MOAT 影片不允許 (留空)
媒體Bid Manager 費用必要 (True)
媒體媒體費用資料不允許 (留空)
千次曝光出價付費功能費用不允許 (留空)
整合代碼否字串是用於追蹤的選用代碼。
詳細資料否字串是字串格式的項目詳細資料。
使用速度是字串是支出速度金額所用的時間範圍。
  • 每日
  • 每月
  • 檔期
放送速度是字串是這個項目的節奏率。
  • 盡快
  • 平均
  • 超前
使用速度金額是float是根據節奏類型設定的時間範圍，預計支出的金額。
已啟用展示頻率是字串是啟用/停用廣告訂單中以曝光為準的展示頻率上限。
  • TRUE
  • FALSE
頻率曝光次數「Frequency Enabled」為「TRUE」時為必填整數是特定頻率金額的曝光次數，須為正整數，也就是「在 y 期間內顯示 x 次曝光」中的 x。
頻率週期「Frequency Enabled」為「TRUE」時為必填字串是指定展示頻率上限的時間範圍單位。
  • 分鐘
  • 小時
  • 天
  • 週
  • 月
  • 效期
頻率金額「Frequency Enabled」為「TRUE」時為必填整數是頻率週期類型的正整數值，也就是「在 y 週期內顯示 x 次曝光」中的 y。
成效目標類型是字串是廣告訂單的目標單位
  • 千次曝光出價
  • 單次轉換出價
  • 單次點擊出價
  • 單次收視出價
  • 單次有聲播放且看完的曝光出價
  • 點閱率
  • 可視度百分比
  • 無
  • 其他
成效目標價值是字串是目標值，以貨幣 (千次曝光出價、單次動作出價、單次點擊出價、單次收視出價、單次安裝出價)、百分比 (可視度、點閱率) 或字串 (其他) 表示。
評估 DAR是字串是啟用/停用使用 Nielsen Digital Ad Ratings 進行的目標對象評估
  • TRUE
  • FALSE
評估 DAR 頻道「Measure 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;etc.)。
指定地理區域 - 排除否字串、清單是要從指定目標中排除的地理位置清單。清單格式 = (GeoLocation.id;GeoLocation.id; 等)。
指定語言 - 納入否字串、清單是要納入指定目標的語言清單。清單格式 = (Language.id;Language.id;etc.)。
指定語言 - 排除否字串、清單是要從指定目標中排除的語言清單。清單格式 = (Language.id;Language.id;etc.)。
指定裝置 - 納入否字串、清單是要納入指定目標的裝置清單。清單格式 = (DeviceCriteria.id;DeviceCriteria.id;etc.)。
指定裝置 - 排除否字串、清單是要從指定目標中排除的裝置清單。清單格式 = (DeviceCriteria.id;DeviceCriteria.id;etc.)。
指定瀏覽器 - 納入否字串、清單是要納入指定目標的瀏覽器清單。清單格式 = (Browser.id;Browser.id;etc.)。
指定瀏覽器 - 排除否字串、清單是要從指定目標中排除的瀏覽器清單。清單格式 = (Browser.id;Browser.id;etc.)。
品牌安全標籤否字串、清單是要指定的數位內容標籤清單。清單格式 = (G；PG；等等)。
  • G
  • PG
  • T
  • MA
  • ？
品牌安全敏感度設定否字串是選擇敏感度設定，根據周邊內容的主題封鎖廣告空間。
  • 不要封鎖
  • 使用 DoubleClick Verification
  • 使用自訂溫度
品牌安全自訂設定如果「品牌安全自訂設定」為「使用自訂」，則必須填寫此欄位字串、清單是如果品牌安全感應設定為「使用自訂」，請指定標準內容分類器清單。例如：(Adult;Alcohol;Tobacco;etc.)。
  • 成人
  • 詆毀
  • 下載及分享
  • 武器
  • 賭博
  • 暴力
  • 性暗示
  • 不雅用語
  • 酒精飲料
  • 毒品
  • 菸草
  • 政治
  • 宗教
  • 悲劇
  • 交通事故
  • 敏感的社會議題
  • 駭人的內容
第三方驗證服務否字串是第三方驗證服務供應商。
  • 無
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方驗證服務供應商標籤否字串、清單是如果「第三方驗證服務」不是「無」，請指定所選供應商支援的標籤清單。
指定頻道 - 納入否字串、清單是要納入指定目標的管道清單。清單格式 = (UniversalChannel.id;UniversalChannel.id; etc.)。
頻道指定目標 - 排除否字串、清單是要納入指定目標的管道清單。清單格式 = (UniversalChannel.id;UniversalChannel.id; etc.)。
指定網站 - 納入否字串、清單是要納入指定目標的網站清單。如果通用網站表格中沒有，清單可以包含一組網站 ID 或網址字串。清單格式 = (UniversalSite.Id;'http://someurl.com'; etc.)。
指定網站 - 排除否字串、清單是要從指定目標中排除的網站清單。如果通用網站表格中沒有，清單可以包含一組網站 ID 或網址字串。清單格式 = (UniversalSite.Id;'http://someurl.com'; etc.)。
指定應用程式 - 納入否字串、清單是要納入指定目標的應用程式清單。如果通用網站表格中沒有，清單可以包含一組通用網站 ID 或應用程式套件字串。清單格式 = (UniversalSite.Id; 'some.app.package';etc.)。
指定應用程式 - 排除否字串、清單是要從指定目標中排除的應用程式清單。如果通用網站表格中沒有，清單可以包含一組通用網站 ID 或應用程式套件字串。清單格式 = (UniversalSite.Id; 'some.app.package';etc.)。
指定應用程式組合 - 納入否字串、清單是要納入指定目標的應用程式集合清單。清單格式= 應用程式集合 ID；應用程式集合 ID；
指定應用程式集合 - 排除否字串、清單是指定目標時要排除的應用程式集合清單。清單格式= 應用程式集合 ID；應用程式集合 ID；
指定類別 - 納入否字串、清單是要納入指定目標的類別清單，來自 AdX 垂直 ID。清單格式 = (Verticals.Id;Verticals.Id;etc.)。
指定類別 - 排除否字串、清單是要排除的指定目標類別清單，來自 AdX 產業 ID。清單格式 = (Verticals.Id;Verticals.Id;etc.)。
指定關鍵字 - 納入否字串、清單是要納入指定目標的關鍵字字串清單。
指定關鍵字 - 排除否字串、清單是要在指定目標中排除的關鍵字字串清單。
指定關鍵字清單 - 排除否字串、清單是要排除的排除關鍵字清單。清單格式= 排除關鍵字清單 ID；排除關鍵字清單 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 天內) AND (名單 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;);」。
有效近來值：
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 歲的使用者，並納入不明年齡，請指定格式 {起始; 結束; 納入不明 True/False} = 18;55;true;
範例 2：如要只指定 35 歲以上的使用者，並排除不明年齡，請指定以下內容 = 35;+;false;。
「起始」可接受的值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

「收件者」可接受的值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
指定客層：家庭收入否字串、清單是指定家庭收入範圍。選取單一「Top_of_Range」收入範圍和單一「Bottom_of_Range」收入範圍，並指定是否要納入收入不明的家庭 (true/false)，即可指定「從/到」範圍。請參閱可接受的 Top_of_Range/Bottom_of_Range 範圍清單。
範例 1：如要指定家庭收入前 10% 至 50% 的目標對象，並納入家庭收入不明的家庭，請指定以下格式：{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true;
範例 2：如要僅指定家庭收入後 50% 的目標對象，並排除家庭收入不明的家庭，請指定以下格式：{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true;
Top_of_Range/Bottom_of_Range 的可接受值：
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 後 50%

指定客層：家長狀態是字串、清單是要指定的家長狀態清單。選取一或多個可接受的值。
  • 父項
  • 無子女
  • 不明
指定連線速度否字串是指定特定連線速度。選取其中一個可接受的值：
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
指定電信業者 - 納入否字串、清單是要指定的網際網路服務供應商 (ISP) 或電信業者清單。清單格式 = {ISP.id; ISP.id;}
指定電信業者 - 排除否字串、清單是要排除的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id; ISP.id;}