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

如需格式的相關說明，請參閱總覽。

欄位必填類型可寫入說明
Io ID只有在編輯現有廣告訂單時才需要填寫整數否廣告訂單的數字 ID 值。如果留空，系統會建立新的廣告訂單 ID，並指派專屬 ID。建立新的廣告訂單時，您可以視需要使用自訂 ID，將委刊項指派給新的廣告訂單。自訂 ID 的格式為「ext[自訂 ID]」，例如 ext123。檔案上傳並處理完畢後，系統會將所有自訂 ID 替換成 DBM 指派的 ID，並根據自訂 ID 為物件建立關聯 (例如，將委刊項連結到廣告訂單)。
廣告活動 ID否整數否廣告活動的數字 ID 值。在建立這個廣告訂單的同時，您可以為廣告活動指定自訂 ID (例如「ext<自訂廣告活動 ID>」)。
名稱是字串是項目名稱。
時間戳記編輯現有項目時必填整數否項目的時間戳記，由系統用於驗證該項目從下載和上傳期間的未變更。
狀態是字串是項目的狀態設定。
  • 有效
  • 已暫停
  • 草稿
  • 已封存
Io 類型是字串是廣告訂單的類型。只能在建立時設定。
  • standard
Io 子類型是字串是廣告訂單的必填欄位，用於區分不同格式。如果這個欄位留空的「default」值」
  • 預設
  • 一般超越頂層
可結算結果是字串是可結算結果。

依據結果採購已淘汰。「曝光」是唯一有效的值。

  • 曝光
費用否string, 清單清單是這個項目的所有費用。清單格式 = (費用類別；費用金額；費用類型；開立發票)；
  • 費用類別
    • 千次曝光出價
    • 媒體
  • 費用金額
    • 浮點值
    • 以浮點值放置
  • 費用類型
    • (字串，請參閱費用表)
  • 發票
    • 是
    • 否
    • 空白

例如「(千次曝光出價；2；Display & Video 360 費用；錯誤)」；(Media；13；Default；True)；
請參閱下表，瞭解可接受的值：

費用類別手續費類型月結選項
千次曝光出價/媒體預設不允許 (留空)
千次曝光出價/媒體第三方廣告伺服器不允許 (留空)
千次曝光出價/媒體DoubleVerify允許 (是/否)
千次曝光出價/媒體ADsafe不允許 (留空)
千次曝光出價/媒體Adxpose不允許 (留空)
千次曝光出價/媒體Vizu不允許 (留空)
千次曝光出價/媒體Aggregate Knowledge不允許 (留空)
千次曝光出價/媒體Teracent不允許 (留空)
千次曝光出價/媒體Evidon不允許 (留空)
千次曝光出價/媒體代理商交易平台費用不允許 (留空)
千次曝光出價/媒體Adloox允許 (是/否)
千次曝光出價ShopLocal必填 (是)
千次曝光出價TrustMetrics不允許 (留空)
千次曝光出價Integral Ad Science 影片允許 (是/否)
千次曝光出價MOAT 影片不允許 (留空)
媒體多媒體和影片 360 費用必填 (是)
媒體媒體費用資料不允許 (留空)
媒體Scibids 費用必填 (是)
整合代碼否字串是用於追蹤的選用程式碼。
詳細資料否字串是以字串格式輸入項目詳細資料。
使用速度是字串是用於支出使用速度金額的時間範圍。
  • 每日
  • 每月
  • 檔期
使用速度是字串是這個項目的使用速度速率。
  • 盡快
  • 平均
  • 向前
使用速度金額是float是每個使用速度類型所設時間範圍內可支出的金額。
已啟用頻率是字串是針對廣告訂單啟用/停用以曝光為準的展示頻率上限。
  • TRUE
  • FALSE
頻率曝光「已啟用頻率」時為必填為「TRUE」整數是指定展示頻率金額中，以正整數表示的曝光次數，也就是「顯示 Y 期間的 x 次曝光次數」。
頻率週期「已啟用頻率」時為必填為「TRUE」字串是指定展示頻率上限的時間範圍單位。
  • 分鐘
  • 小時
  • 天
  • 週
  • 月
  • 效期
頻率金額「已啟用頻率」時為必填為「TRUE」整數是展示頻率週期類型時間長度的正整數值，亦即「顯示 Y 期間的 x 次曝光次數」中的 y。
成效目標類型是字串是廣告訂單的目標單位
  • 千次曝光出價
  • 單次轉換出價
  • 單次點擊出價
  • 單次收視出價
  • 單次有聲播放且看完的曝光出價
  • 點閱率
  • 可視度百分比
  • 單次參與出價
  • Click CVR
  • Impression CVR
  • 千次曝光收視出價
  • 瀏覽率
  • 音訊播放完成率
  • 影片播放完成率
  • 完整收聽出價
  • 單次完整收視出價
  • 畫面停留時間達 10 秒以上
  • 盡可能提高使用速度
  • 自訂曝光次數值/費用
  • 無
  • 其他
成效目標價值是字串是以幣別 (千次曝光出價、單次轉換出價、單次點擊出價、單次收視出價、單次收視出價、單次參與出價、單次參與出價、千次可視曝光出價)、百分比 (可視度百分比、點閱率、點擊轉換率、曝光轉換率、影片觀看率、音訊罐頭回應、影片罐頭回應、CPCL、CPCA、TOS10)、無單元 (自訂曝光值 / 費用) 或字串 (其他) 等值。如果提供的目標類型為「盡量提高使用速度」或「無」則這個資料欄會遭到忽略
成效目標演算法 ID「成效目標類型」時為必填為「自訂曝光值 / 費用」整數是如果目標類型為 CUSTOM_BIDDING_VALUE_COST，則與目標相關聯的自訂出價演算法 ID。否則，這個資料欄會遭到忽略。
測量 DAR是字串是使用 Nielsen Digital Ad Ratings 啟用/停用目標對象評估功能
  • TRUE
  • FALSE
評估 DAR 管道「測量 DAR」時為必填為「TRUE」整數是使用 Nielsen Digital Ad Ratings 進行評估的管道。格式 = UniversalChannel.id
預算類型是字串是根據「收益」金額指定預算類型支出 (金額) 或指定曝光次數 (曝光)。
  • 金額
  • 曝光
預算區隔是string, 清單清單是指定特定的預算區隔。清單格式 = (預算、開始日期、結束日期、廣告活動預算 ID、說明)。預算採用貨幣浮動格式。日期格式為 MM/DD/YYYY。若未指定，廣告活動預算 ID 會留空。所有預算區隔的說明不得留空。如果現有預算區隔的說明空白，您必須提供說明，待上傳資料列。例如：「(100.50;01/01/2016;03/31/2016;12345;budget 區隔 1;);(200.00;04/01/2016;06/30/2016;;updated budget 區隔 1;);」
自動預算分配是字串是啟用/停用自動預算分配功能
  • TRUE
  • FALSE
指定地理區域 - 包含否string, list是要納入指定目標的地理區域清單。清單格式 = (GeoLocation.id、GeoLocation.id;等等)。
指定地理區域 - 排除否string, list是要在指定目標中排除的地理區域清單。清單格式 = (GeoLocation.id、GeoLocation.id 等)。
指定鄰近目標否string, 清單清單是鄰近目標清單，格式為「(Latitude; Longitude; Radius; Unit; FullAddress;);」。緯度介於 -90 到 90 度 (含) 之間；經度介於 -180 度到 180 度 (含) 之間。半徑是指單位中的 1 到 500 (含) 之間的距離；單位可以是「mi」或「公里」；FullAddress 為選用項目。例如：「(38.907192; -77.03687; 1.0; mi; Washington D.C.,美國哥倫比亞特區；(40.712775; -74.005972; 20.5; km; 40.712775, -74.005972;)；(20.000234; -56.675423; 5.0; mi; ;);。
指定鄰近地區清單否string, 清單清單是廣告訂單或非 TrueView 委刊項的鄰近清單目標清單，格式為「(ProximityListId; Radius; Unit; );」。ProximityListId 是廣告客戶資源下的一個位置清單編號。半徑是指單位中的 1 到 500 (含) 之間的距離；單位可以是「mi」或「公里」；每個實體都不能指定兩個地點清單，此外還有地理位置地區清單。例如：「(10041691678; 20.0; mi;);(10038858567; 20.5; km;);"。
指定語言 - 包含否string, list是要納入指定目標的語言清單。清單格式 = (Language.id;Language.id;等等)。
指定語言 - 排除否string, list是要在指定目標中排除的語言清單。清單格式 = (Language.id;Language.id;等等)。
指定裝置 - 包含否string, list是要納入指定目標的裝置清單。清單格式 = (Device 條件.id、Device 條件.id 等)。
指定裝置 - 排除否string, list是要在指定目標中排除的裝置清單。清單格式 = (Device 條件.id、Device 條件.id 等)。
指定瀏覽器 - 包含否string, list是要納入指定目標的瀏覽器清單。清單格式 = (Browser.id、Browser.id 等)。
指定瀏覽器 - 排除否string, list是要在指定目標中排除的瀏覽器清單。清單格式 = (Browser.id、Browser.id 等)。
數位內容標籤 - 排除否string, list是要排除的數位內容標籤清單。名單格式 = (G;PG 等)。
  • G
  • PG
  • T
  • MA
  • ？
品牌安全敏感度設定否字串是選擇靈敏度設定，即可根據周圍內容的主題封鎖廣告空間。
  • 不要封鎖
  • 使用 Campaign Manager 360 驗證功能
  • 使用自訂選項
品牌安全自訂設定「品牌安全自訂設定」時為必填是「使用自訂」string, list是如果「品牌安全敏感度」設定設為「使用自訂」，請指定標準內容分類項清單。例如 (情色；酒精飲料；菸草等)。
  • 色情內容
  • 貶抑用語
  • 下載和共享
  • 武器
  • 賭博
  • 暴力
  • 性暗示
  • 不雅用語
  • 酒精飲料
  • 藥物
  • 菸草
  • 政治
  • 宗教
  • 悲劇
  • 交通事故
  • 敏感的社會議題
  • 駭人的內容
第三方驗證服務否字串是第三方驗證服務供應商。
  • 無
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方驗證標籤否string, list是如果第三方驗證服務不是「無」，請指定所選供應商支援的標籤清單。
指定頻道 - 包含否string, list是要納入指定目標的管道清單。清單格式 = (UniversalChannel.id、UniversalChannel.id 等等)。
指定頻道 - 排除否string, list是要在指定目標中排除的管道清單。清單格式 = (UniversalChannel.id、UniversalChannel.id 等等)。
指定網站 - 包含否string, list是要納入指定目標的網站清單。如果在「通用網站」表格中找不到，清單可包含一組網站 ID 或網址字串。清單格式 = (UniversalSite.Id; 'http://someurl.com'; 等)。
指定網站 - 排除否string, list是要在指定目標中排除的網站清單。如果在「通用網站」表格中找不到，清單可包含一組網站 ID 或網址字串。清單格式 = (UniversalSite.Id;'http://someurl.com';etc.)。
應用程式指定目標 - 包含否string, list是要納入指定目標的應用程式清單。如果「通用網站」表格中沒有找到這組 ID，清單則可包含一組 UniversalSite ID 或應用程式套件的字串。清單格式 = (UniversalSite.Id、some.app.package'; 等)。
應用程式指定目標 - 排除否string, list是要在指定目標中排除的應用程式清單。如果「通用網站」表格中沒有找到這組 ID，清單則可包含一組 UniversalSite ID 或應用程式套件的字串。清單格式 = (UniversalSite.Id、some.app.package'; 等)。
應用程式組合指定目標 - 包含否string, list是要納入指定目標的應用程式組合清單。清單格式= 應用程式集合 ID；應用程式集合 ID；
應用程式組合指定目標 - 排除否string, list是要排除在指定目標中的應用程式組合清單。清單格式= 應用程式集合 ID；應用程式集合 ID；
指定類別 - 包含否string, list是來自「AdX 產業 ID」的指定目標類別清單。清單格式 = (Verticals.Id;Verticals.Id;etc.)。
指定類別 - 排除否string, list是要從「AdX 產業 ID」中排除的類別清單。清單格式 = (Verticals.Id;Verticals.Id;etc.)。
指定內容類型 - 包含否string, list是要納入指定目標的內容類型清單 (來自 API 或中繼資料下載)。清單格式 = (ContentGenre.Id、ContentGenre.Id;etc.)。
指定內容類型 - 排除否string, list是要從指定目標中排除的內容類型清單 (從 API 或中繼資料下載)。清單格式 = (ContentGenre.Id、ContentGenre.Id;etc.)。
指定關鍵字 - 包含否string, list是要納入指定目標的關鍵字字串清單。
指定關鍵字 - 排除否string, list是要在指定目標中排除的關鍵字字串清單。
指定關鍵字清單 - 排除否string, list是要在指定目標中排除的排除關鍵字清單清單。清單格式 = (排除關鍵字清單 ID；排除關鍵字清單 ID；)
指定目標對象 - 包含否字串，配對清單是要納入指定目標的目標對象名單。對於第一方目標對象名單，每個目標對像都會列為一組 UserList ID 和回訪率設定。組合為 (1;1d;)，其中 1d 是代表 1 天回訪率的取樣率範例。第三方目標對象無法使用回訪率，因此名單格式為 (3;);(4;);。收件者和「或」目標對象群組，請按照以下範例操作：如要合併與/不含回訪率的組合：'(1;1d;);(2;365d;));(3;);(3;);(4;5m;);(5;all;));'。

指定目標對象 - 排除否字串，配對清單是要在指定目標中排除的目標對象名單。如果目標對象名單為第一方目標對象名單，則每個目標對像都會採用一對 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、265d、265
興趣相似 &潛在目標消費者定位 - 包含否string, list是要納入的興趣相似目標對象和/或潛在目標消費者名單清單。名單格式= 使用者清單 ID；使用者名單 ID；
興趣相似 &潛在目標消費者指定目標 - 排除否string, list是要排除的興趣相似目標對象和/或潛在目標消費者名單清單。名單格式= 使用者清單 ID；使用者名單 ID；
指定自訂名單否string, list是要指定的自訂名單清單。名單格式 = (UserList ID、UserList ID 等)。
廣告空間來源指定目標 - 授權賣方選項「類型」時必填是「Display」或「影片」或「音訊」字串是設為指定授權直接賣方、授權直接賣方和經銷商，或是授權賣方 + 未知。「授權直接交易」這表示系統只會指定授權賣方「授權直接賣方和經銷商」意即指定授權賣方和經銷商。「授權發布商和未參與計畫的發布商」因此會指定授權賣方、經銷商和不明賣方。
  • 授權直接賣方
  • 授權直接賣方和經銷商
  • 授權和未參與計畫的發布商
廣告空間來源指定目標 - 包含否string, list是要納入指定目標的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。
指定廣告空間來源 - 排除否string, list是要在指定目標中排除的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。
廣告空間來源指定目標 - 指定新廣告交易平台否字串是設定指定新廣告交易平台。
  • 是
  • 否
指定時段否string, list是








介於 0 到 95 之間的整數，代表 15 分鐘
start <end
如果是新實體，時間則會以使用者的時區 (即「當地」)。現有實體的時區不會變更。
時段指定時區「指定時段」時為必填已包含在內。字串是指定時段時使用的時區。
  • 局部
  • 廣告主
指定環境否string, list是要指定的環境清單。請選取一或多個可接受的值。請注意，「未最佳化網頁」您必須先選取 [網頁] 才能選取。
  • 網路
  • 網站未進行最佳化
  • 應用程式
已啟用可視度指定功能否字串是僅指定可透過開放評估標準評估的曝光。
  • TRUE
  • FALSE
指定 Active View 的可視度否字串是指定預測可視度百分比。百分比會以浮點值表示。可能是 {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
指定位置 - 顯示在畫面上否string, list是指定畫面上的多媒體廣告位置：選取一個或多個可接受的值：
  • 不需捲動位置
  • 需捲動位置
  • 不明
指定位置 - 在畫面上播放影片否string, list是畫面上影片廣告位置指定目標。選取一個或多個可接受的值：
  • 不需捲動位置
  • 需捲動位置
  • 不明
指定位置 - 內容中的顯示位置否string, list是要指定的多媒體廣告內容位置。選取一個或多個可接受的值：
  • 文章內
  • 動態內廣告
  • 橫幅內
  • 插頁式
  • 不明
指定位置 - 內容中的影片位置否string, list是要指定的影片內容位置。選取一個或多個可接受的值：
  • 文章內
  • 動態內廣告
  • 橫幅內
  • 插頁式
  • 不明的串流外
  • 片頭廣告
  • 片中
  • 片尾廣告
  • 串流內廣告不明
指定位置 - 內容中的音訊位置否string, list是要指定的音訊廣告素材位置。選取一個或多個可接受的值：
  • 片頭廣告
  • 片中
  • 片尾廣告
  • 不明
影片播放器大小指定目標否string, list是要指定的影片廣告播放器大小清單。選取一個或多個可接受的值：
  • 不明
  • small
  • large
  • HD 高畫質
指定內容時間長度否string, list是要指定的內容時間長度清單。單位值為分鐘。選取一個或多個可接受的值：
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • 不明
指定內容串流類型否string, list是要指定的內容串流類型清單。選取一個或多個可接受的值：
  • 直播
  • 以量計價
音訊內容類型指定目標否string, list是要指定的音訊內容類型清單。選取一個或多個可接受的值：
  • 不明
  • 線上電台
  • 串流音樂
  • Podcast
指定客層性別否string, list是要指定的性別清單。選取一個或多個可接受的值：
  • 女性
  • 男性
  • 不明
指定客層年齡層否string, list是指定使用者年齡層。選取一個「從年齡」和「從年齡」一個「到年齡」，並選擇是否要納入未知年齡的 true/false，藉此指定介於/寄送範圍。查看可接受的年齡範圍清單。
範例 1：如要指定 18 到 55 歲並納入未知年齡，請指定以下格式：{From;收件者：包含 Unknown True/False} = 18;55;true；
範例 2：如果只指定年滿 35 歲的使用者，但排除不明的年齡層，請指定下列 = 35;+;false;。
可接受的「寄件者」值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

以下為可接受的值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
指定客層家庭收入否string, list是指定家庭收入範圍。您可以選取一個「Top_of_Range 收入範圍」和一個 Bottom_of_Range 收入範圍，藉此指定「介於/到」範圍，以及是否納入收入不明為 true/false 的家庭。請查看可接受的 Top_of_Range/Bottom_of_Range 範圍清單。
範例 1：指定收益前 10% 到 50% 的家庭，並納入收入不明的家庭；請指定 {Top_of_Range;Bottom_of_Range;包含不明 True/False 值} = 前 10%；41-50%;true；
範例 2：如果只指定低收入的 50% 家庭，並排除收入不明的家庭，請指定 {Top_of_Range;Bottom_of_Range;包含不明 True/False 值} = 低於 50%；低於 50%;true；
Top_of_Range/Bottom_of_Range 的值：
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 後 50%

指定客層家長狀態是string, list是要指定的家長狀態清單。選取一個或多個可接受的值。
  • 有子女
  • 無子女
  • 不明
連線速度指定否字串是指定特定連線速度。選取下列其中一個可接受的值：
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
指定通訊業者 - 包含否string, list是要指定的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id;ISP.id;}
指定通訊業者 - 排除否string, list是要排除的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id;ISP.id;}
廣告訂單最佳化是字串是啟用/停用廣告訂單最佳化功能
  • TRUE
  • FALSE
出價策略單位「廣告訂單最佳化」為必要欄位為「True」字串是選取要用於最佳化出價的出價策略單位：
  • 單次轉換出價
  • 單次點擊出價
  • 自訂曝光次數值/費用
  • CIVA
  • IVO_TEN
  • AV_VIEWED
出價策略數量限制「廣告訂單最佳化」為必要欄位為「True」float是設定「不要超過」千次曝光出價金額。如果值為 0，則「請勿超過」尚未啟用。
套用交易底價「廣告訂單最佳化」為必要欄位為「True」字串是是否優先處理交易，而非公開競價廣告空間
  • TRUE
  • FALSE
演算法 ID「出價策略單位」為必填欄位自訂曝光次數價值/費用。整數是將出價策略單元設為自訂曝光次數時，必須使用這個對應的演算法 ID。成本/費用。