結構化資料 - 3.1 版 - 委刊項

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

欄位必填類型可寫入說明
委刊項 ID只有在編輯現有委刊項時才需要整數委刊項的數字 ID 值。如果留空,系統會建立新委刊項並指派專屬 ID。必要時,您可以在建立新委刊項時使用自訂 ID,將 TrueView 廣告群組指派給新的委刊項。自訂 ID 的格式為「ext[自訂 ID]」,例如 ext123。檔案上傳並處理完畢後,系統就會將所有自訂 ID 替換成 DBM 指派的 ID,並根據自訂 ID 為物件建立關聯 (例如,從廣告群組至委刊項)。
Io ID整數廣告訂單的數字 ID 值。如果您建立的是這個委刊項,而且建立的是廣告訂單,您可以為該廣告訂單指定自訂 ID (例如「ext[自訂 IO ID]」)。
類型字串項目類型。只能在建立時寫入,而非編輯。
  • 多媒體
  • 影片
  • TrueView
  • 音訊
子類型字串用於區分標準和行動應用程式安裝 TrueView 格式的 TrueView 委刊項欄位
  • 簡潔
  • 行動應用程式安裝
名稱字串項目名稱。
時間戳記編輯現有項目時必填整數項目的時間戳記,由系統用於驗證該項目從下載和上傳期間的未變更。
狀態字串項目的狀態設定。
  • 有效
  • 已暫停
  • 草稿
  • 已封存
  • 已刪除
開始日期字串項目檔期開始日期的時間戳記,格式為 MM/DD/YYYY HH:mm。
結束日期字串項目檔期結束日期的時間戳記,格式為 MM/DD/YYYY HH:mm。
預算類型字串指定預算是以金額或曝光為基礎。如果這個項目的 IO 已啟用自動預算分配功能,您可以將其設為「自動」允許 DBM 自動為這個項目預算。
  • 金額
  • 曝光
  • 無限制
  • 自動
  • TrueView 每日預算
預算金額「類型」時必填是「Display」或「影片」或「音訊」float這個預算類型的預算金額為正值。這可以是簡單的整數曝光值,或是貨幣金額的浮點值。貨幣會以廣告客戶的貨幣單位顯示,而不是以 1/1,000,000s 的貨幣單位顯示。若為「自動」預算分配功能已設定所需項目,您可以指定最低支出金額 (例如「支出至少」這個金額)。
使用速度字串用於支出使用速度金額的時間範圍。
  • 每日
  • 每月
  • 檔期
使用速度字串這個項目的使用速度速率。
  • 盡快
  • 平均
  • 向前
使用速度金額float每個使用速度類型所設時間範圍內可支出的金額。
已啟用頻率字串為委刊項啟用/停用以曝光次數為準的展示頻率上限。
  • TRUE
  • FALSE
頻率曝光「已啟用頻率」時為必填為「TRUE」整數指定展示頻率金額中,以正整數表示的曝光次數,也就是「顯示 Y 期間的 x 次曝光次數」。
頻率週期「已啟用頻率」時為必填為「TRUE」字串指定展示頻率上限的時間範圍單位。TrueView 委刊項的支援時段為「天」、「週」、「月」。
  • 分鐘
  • 小時
  • 效期
頻率金額「已啟用頻率」時為必填為「TRUE」整數展示頻率週期類型時間長度的正整數值,亦即「顯示 Y 期間的 x 次曝光次數」中的 y。TrueView 委刊項不支援這個金額。
TrueView 觀看頻率已啟用「類型」時必填為「TrueView」字串針對 TrueView 委刊項啟用/停用以觀看為準的展示頻率上限
  • TRUE
  • FALSE
TrueView 觀看頻率曝光「已啟用 TrueView 觀看頻率」時為必填為「TRUE」整數TrueView 觀看次數的正整數金額,也就是「顯示期間顯示 x 次觀看」的 x 號
TrueView 觀看頻率期間「已啟用 TrueView 觀看頻率」時為必填為「TRUE」字串指定以 TrueView 觀看為準展示頻率上限的時間範圍單位
合作夥伴收益模式字串夥伴收益模式是控制出價管理工具如何計算收益的機制。您可以使用夥伴收益模式追蹤服務費的成本加價情況。
  • TMCM - 媒體費用總額加成
  • MCM - 媒體費用加成
  • CPM:每千次曝光費用
合作夥伴收益金額float與合作夥伴收益模式對應的正浮點值。
轉換計算方式類型「類型」時必填是「Display」或「影片」或「音訊」字串選擇要納入計算的轉換類型。
  • 全部計入
  • 計算點擊後轉換
  • 計數百分比
轉換計數位置「類型」時必填是「Display」或「影片」或「音訊」float指定「計數 %」的百分比轉換計數類型。將 % 的格式設定為一個浮點值 (3.123% = 3.123),且精度設有千位數 (小數點後 3 位)。
轉換像素 IDstring, 清單清單以清單的形式指定轉換像素。每個像素都會指定為像素 ID、瀏覽後回溯期 (以分鐘為單位) 和點擊後回溯期 (以分鐘為單位)。清單格式 = (Pixel.common_data.id; view_window_minutes; click_window_minutes;)。
費用string, 清單清單這個項目的所有費用。清單格式 = (費用類別;費用金額;費用類型;開立發票);
  • 費用類別
    • 千次曝光出價
    • 媒體
  • 費用金額
    • 浮點值
    • 以浮點值放置
  • 費用類型
    • (字串,請參閱費用表)
  • 發票
    • 空白

例如「(千次曝光出價;2;Bid Manager 費用;錯誤)」;(Media;13;Default;True);
請參閱下表,瞭解可接受的值:

注意:附加費率千次曝光出價費用由系統保留,且無法變更。視需要插入預設千次曝光出價費用,在變更時保留付費費用的基數。

費用類別手續費類型月結選項
千次曝光出價/媒體預設不允許 (留空)
千次曝光出價/媒體第三方廣告伺服器不允許 (留空)
千次曝光出價/媒體DoubleVerify允許 (是/否)
千次曝光出價/媒體ADsafe不允許 (留空)
千次曝光出價/媒體Adxpose不允許 (留空)
千次曝光出價/媒體Vizu不允許 (留空)
千次曝光出價/媒體Aggregate Knowledge不允許 (留空)
千次曝光出價/媒體Teracent不允許 (留空)
千次曝光出價/媒體Evidon不允許 (留空)
千次曝光出價/媒體代理商交易平台費用不允許 (留空)
千次曝光出價/媒體Adloox允許 (是/否)
千次曝光出價ShopLocal必填 (是)
千次曝光出價TrustMetrics不允許 (留空)
千次曝光出價Integral Ad Science 影片允許 (是/否)
千次曝光出價MOAT 影片不允許 (留空)
媒體Bid Manager 費用必填 (是)
媒體媒體費用資料不允許 (留空)
千次曝光出價付費功能費用不允許 (留空)
整合代碼字串用於追蹤的選用程式碼。
詳細資料字串以字串格式輸入項目詳細資料。
出價策略類型「類型」時必填是「Display」或「影片」或「音訊」字串 選取其中一個適用的出價策略:
  • 最小化: 用完預算,同時將單次獲得費用/單次點擊出價降到最低
  • 最大化:使用整筆預算,同時盡量提高展示值或品質展示次數
  • 突破:達成或超越單次轉換出價/單次點擊出價目標
  • 最佳化千次可視曝光出價:最佳化 X 的千次可視曝光出價
  • 固定:指定 X 的固定出價
出價策略價值除非「出價策略類型」為必填欄位是「最小化」、「最大化」或「類型」為「TrueView」float請選擇「最佳化千次可視曝光出價」或「固定策略」類型做為目標出價。
請注意,「最小化」出價策略類型不需要出價策略值或「最大化」
出價策略單位「出價策略類型」為必填欄位是「Beat」「最小化」或「最大化」字串為「節奏」、「最小化」或「最大化」策略類型選取相應的單元:
  • 單次轉換出價
  • 單次點擊出價
  • 自訂曝光次數值/費用
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • INCREMENTAL_CONVERSIONS
出價策略數量限制「類型」時必填是「Display」或「影片」或「音訊」float設定「不要超過」千次曝光出價金額。如果值為 0,則「請勿超過」尚未啟用。只有在出價策略為「最小化」、「最大」時才能使用或「Beat」。
廣告素材分配string, list要指派給項目的廣告素材 ID 清單。清單格式 = (Creative.common_data.id;Creative.common_data_id;etc.)。
指定地理區域 - 包含string, list要納入指定目標的地理區域清單。清單格式 = (GeoLocation.id、GeoLocation.id;等等)。
指定地理區域 - 排除string, list要在指定目標中排除的地理區域清單。清單格式 = (GeoLocation.id;GeoLocation.id 等)。
指定語言 - 包含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
品牌安全敏感度設定字串選擇靈敏度設定,即可根據周圍內容的主題封鎖廣告空間。
  • 不要封鎖
  • 使用 DoubleClick 驗證
  • 使用自訂選項
品牌安全自訂設定「品牌安全自訂設定」時為必填是「使用自訂」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';etc.)。
指定網站 - 排除string, list要在指定目標中排除的網站清單。如果在「通用網站」表格中找不到,清單可包含一組網站 ID 或網址字串。清單格式 = (UniversalSite.Id;'http://someurl.com';etc.)。
應用程式指定目標 - 包含string, list要納入指定目標的應用程式清單。如果「通用網站」表格中沒有找到這組 ID,清單則可包含一組 UniversalSite ID 或應用程式套件的字串。清單格式 = (UniversalSite.Id; 'some.app.package';etc.)。
應用程式指定目標 - 排除string, list要在指定目標中排除的應用程式清單。如果「通用網站」表格中沒有找到這組 ID,清單則可包含一組 UniversalSite ID 或應用程式套件的字串。清單格式 = (UniversalSite.Id; 'some.app.package';etc.)。
指定類別 - 包含string, list來自「AdX 產業 ID」的指定目標類別清單。清單格式 = (Verticals.Id;Verticals.Id;etc.)。
指定類別 - 排除string, list要從「AdX 產業 ID」中排除的類別清單。清單格式 = (Verticals.Id;Verticals.Id;etc.)。
指定關鍵字 - 包含string, list要納入指定目標的關鍵字字串清單。
指定關鍵字 - 排除string, list要在指定目標中排除的關鍵字字串清單。
指定目標對象 - 類似目標對象「類型」時必填是「Display」或「影片」或「音訊」字串 針對明確指定的第一方名單啟用類似目標對象。
  • TRUE
  • FALSE
指定目標對象 - 包含字串,配對清單要納入指定目標的目標對象名單。對於第一方目標對象名單,每個目標對像都會列為一組 UserList ID 和回訪率設定。組合為 (1;1d;),其中 1d 是代表 1 天回訪率的取樣率範例。第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。收件者和「或」請根據以下這個例子找出目標對象群組,如要合併與未回訪率的組合,請按照下列步驟操作:'((1;1d;);(2;365d;));(3;);(4;5m;);(5;all;));'。

指定目標對象 - 排除字串,配對清單要在指定目標中排除的目標對象名單。如果目標對象名單為第一方目標對象名單,則每個目標對像都會採用一對 UserList ID 和回訪率設定。組合為 (1;1d;),其中 1d 是代表 1 天回訪率的取樣率範例。然而,第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。清單格式= (UserList.id;回訪率選用;);(UserList.id; recency 選用;);
例如:「(1;1d;);(2;);".
有效的回訪率值如下:
all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 6h, 12h, 1d, 1d, 5d, 2d, 4d, 2d, 4d, 2d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 4d, 2;);(2;);"
興趣相似 &潛在目標消費者定位 - 包含string, list要納入的興趣相似目標對象和/或潛在目標消費者名單清單。名單格式= 使用者清單 ID;使用者名單 ID;
興趣相似 &潛在目標消費者指定目標 - 排除string, list要排除的興趣相似目標對象和/或潛在目標消費者名單清單。名單格式= 使用者清單 ID;使用者名單 ID;
自訂興趣相似目標對象指定string, list要指定的自訂名單清單。名單格式= 使用者清單 ID;使用者名單 ID;
廣告空間來源指定目標 - 包含「類型」時必填是「Display」或「影片」或「音訊」string, list要納入指定目標的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。
指定廣告空間來源 - 排除string, list要在指定目標中排除的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。
指定時段string, list








介於 0 到 95 之間的整數,代表 15 分鐘
start <end
如果是新實體,時間則會以使用者的時區 (即「當地」)。現有實體的時區不會變更。
指定環境「類型」時必填是「Display」或「影片」或「音訊」string, list要指定的環境清單。清單格式 = (電腦版網站、行動應用程式等)。
多媒體廣告環境:
  • 電腦版網站
  • 行動版網站
  • 行動應用程式
  • 行動應用程式插頁式廣告
  • 行動裝置上的電腦版網頁
影片廣告:
  • 電腦版網頁影片
  • 電腦版網頁遊戲
  • 電腦版網頁文章內
  • 電腦版網頁動態內
  • 行動版網站影片
  • 行動應用程式影片
  • 行動應用程式影片插頁式廣告
音訊:
  • 電腦版網路音訊
  • 行動網路音訊
  • 行動應用程式音訊
指定 Active View 的可視度字串指定預測可視度百分比。百分比會以浮點值表示。可能是 {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
指定可視度 - 包含字串指定廣告排序。選取下列其中一個值,或完全不選取任何值:
  • 全部
  • ATF
  • BTF
  • 不明
指定可視度 - 排除字串在指定目標中排除廣告位置。選取下列其中一個值,或完全不選取任何值:
  • ATF
  • BTF
  • 不明
影片廣告位置指定目標string, list要指定的影片廣告位置清單。選取一個或多個可接受的值:
  • 不明
  • 片頭廣告
  • 片中廣告
  • 片尾廣告
影片播放器大小指定目標string, list要指定的影片廣告播放器大小清單。選取一個或多個可接受的值:
  • 不明
  • small
  • large
  • HD 高畫質
指定客層性別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
  • +
連線速度指定字串指定特定連線速度。選取下列其中一個可接受的值:
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
指定通訊業者 - 包含string, list要指定的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id;ISP.id;}
指定通訊業者 - 排除string, list要排除的網際網路服務供應商或電信業者清單。清單格式 = {ISP.id;ISP.id;}
TrueView 行動出價調整幅度選項字串可以是「提高」或「調低」
  • 增加
  • 縮短
TrueView 行動出價調整幅度百分比整數出價調整幅度,可提高廣告在行動裝置上放送的機率。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「降低」的值:[0;90%] 或 100%
TrueView 排除類別指定目標string, list要排除的類別清單。名單格式 = 遊戲;悲劇和衝突;其他
  • 內嵌影片
  • 直播
  • 遊戲
  • 悲劇和衝突
  • 敏感社會議題
  • 多個家庭
  • 所有目標對象
  • 低齡學童
  • 青少年
  • 成人
  • 尚未分級
  • 性暗示內容
  • 具煽動性且駭人聽聞
  • 褻瀆及不雅用語
TrueView 廣告空間來源指定目標string, list要納入的 TrueView 廣告空間來源清單
  • YouTube 搜尋
  • YouTube 影片
  • 影片合作夥伴