結構化資料 - v8 - 委刊項

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

欄位必填類型可寫入說明
委刊項 ID只有在編輯現有委刊項時才需要整數否商品項目的數字 ID 值。如果留空，系統會建立新委刊項並指派專屬 ID。建立新的委刊項時，您可以選擇使用自訂 ID，將 TrueView 廣告群組指派給新的委刊項。自訂 ID 的格式為「ext <自訂 ID>」，例如 ext123。檔案上傳並處理完畢後，系統會將所有自訂 ID 替換成 DBM 指派的 ID，並根據自訂 ID 將物件 (例如廣告群組與委刊項) 建立關聯。
Io ID是整數否廣告訂單的數字 ID 值。如果您在建立這個委刊項的同時也建立了廣告訂單，可以為該廣告訂單指定自訂 ID (例如「ext[自訂廣告訂單 ID]」)。
Io 名稱否字串否廣告訂單名稱
類型是字串是項目類型。

僅可在建立時寫入，無法在編輯時寫入。

請選取下列其中一個值：
  • 多媒體
  • 影片
  • TrueView
  • 音訊
  • 需求開發
子類型是字串是委刊項必須使用這個欄位來區分不同格式。

請選取下列其中一個值：
  • 簡潔
  • 不可略過
  • 動作
  • 觸及率
  • 查看
  • 音訊
  • Over The Top
  • 行動應用程式安裝
  • 行動應用程式購買
  • Simple Over The Top
  • 不可略過的 OTT
  • 觸及率超越預期
  • 目標頻率
  • 需求開發
名稱是字串是項目名稱。
時間戳記編輯現有項目時必須提供整數否項目的時間戳記。
  • 對於非需求產生委刊項，系統會使用這項「上次修改」時間戳記，確認該項目從下載後到上傳前的這段期間沒有任何異動。
  • 對於需求開發委刊項，這項資訊是檔案產生的時間戳記，可用於確認委刊項是否最近才下載，但無法保證委刊項自首次下載後就沒有更新。
狀態是字串是項目的狀態設定。
  • 有效
  • 已暫停
  • 草稿
  • 已封存
開始日期是字串是記錄檔案開始日期的時間戳記，格式為 MM/DD/YYYY，或「與廣告訂單相同」，以便使用與上層廣告訂單相同的開始日期。
結束日期是字串是廣告活動結束日期的時間戳記，格式為 MM/DD/YYYY，或「與廣告訂單相同」，以便使用與上層廣告訂單相同的結束日期。
預算類型是字串是指定預算是依據金額還是曝光來計算。如果這個項目的廣告訂單已啟用自動預算分配功能，您可以將這個值設為「自動」，讓 DBM 自動為這個項目分配預算。
  • 金額
  • 曝光
  • 無限制
  • 自動
  • TrueView 預算
預算金額如果「類型」為「多媒體」或「影片」或「音訊」，則必須提供float是預算類型的正數預算金額。這可以是簡單的整數曝光值，或是貨幣金額的浮點值。貨幣會以廣告主的貨幣和標準單位顯示 (而非貨幣單位的 1/1,000,000)。如果在項目上設定「自動」預算分配，您可以指定最低支出金額 (例如「至少支出」這筆金額)。
使用速度是字串是用於達到使用速度金額的時間範圍。TrueView 和需求開發委刊項只能是「每日」或「檔期」。
使用速度是字串是此項目的節奏率。

請選取下列其中一個值：
  • 盡快
  • 平均
  • 超前
TrueView 和需求開發委刊項只能設定為「ASAP」或「Even」
使用速度金額如果「類型」是「多媒體廣告聯播網」或「影片」或「音訊」，則必須提供此參數。如果「類型」是「TrueView」或「需求開發」，且「放送頻率」是「每日」，則為必要屬性。float是每個以配速類型設定的時間範圍內可支出的金額。
已啟用展示頻率當「子類型」不是「需求產生」時，就必須提供字串是為委刊項啟用/停用曝光次數展示頻率上限。

請選取下列其中一個值：
  • TRUE
  • FALSE
展示頻率如果「啟用展示頻率」為「TRUE」，則為必填整數是指定展示頻率金額中的曝光次數正整數，也就是「在 y 期間內顯示 x 次曝光」中的 x。
展示頻率週期如果「啟用展示頻率」為「TRUE」，則為必填字串是指定展示頻率上限的時間週期單位。

請選取下列其中一個值：
  • 分鐘
  • 小時
  • 天
  • 週
  • 月
  • 效期
如果是 TrueView 和需求開發委刊項，系統支援的期間為「天」、「週」、「月」。
展示頻率如果「啟用展示頻率」為「TRUE」，則為必填整數是頻率週期類型 (即「在 y 期間內顯示 x 次曝光」中的 y) 的時間長度正整數值。TrueView 或需求開發委刊項不支援這個值。
已啟用 TrueView 觀看頻率當「Type」為「TrueView」時，此為必要欄位字串是啟用/停用 TrueView 委刊項的以觀看次數為準的展示頻率上限
  • TRUE
  • FALSE
TrueView 觀看頻率曝光次數如果「啟用 TrueView 觀看頻率」為「TRUE」，則必須使用整數是TrueView 觀看次數的正整數，也就是「在期間內顯示 x 次觀看」中的 x
TrueView 查看展示頻率期間如果「啟用 TrueView 觀看頻率」為「TRUE」，則為必要屬性字串是指定 TrueView 以觀看次數為依據的展示頻率上限的時間單位
  • 天
  • 週
  • 月
合作夥伴收益模式否字串是夥伴收益模式是控制出價管理工具如何計算收益的機制。您可以使用夥伴收益模式追蹤服務費的成本加價金額。加入夥伴收益模式欄時，請一併指定夥伴收益金額欄。
  • TMCM - 媒體費用總額加成
  • MCM - Media Cost Markup
  • CPM - 千次曝光出價
合作夥伴收益金額只有在指定「合作夥伴收益模式」欄時才需要。float是與夥伴收益模式相對應的正浮點值。只有在指定「夥伴收益模式」欄時才適用。
轉換計算類型如果「類型」為「多媒體」或「影片」或「音訊」或「TrueView」，則必須提供字串是選擇要計算的轉換類型。
  • 全部計入
  • 計算點擊後轉換
  • 數量百分比
轉換計算百分比如果「類型」為「多媒體」或「影片」或「音訊」或「TrueView」，則必須提供float是指定「Count %」轉換計數類型的百分比。將 % 格式設為浮點 (3.123% = 3.123)，精確度限制為千分之一 (小數點後 3 位)。
轉換 Floodlight 活動 ID否字串、清單清單是

用於轉換和相關設定的 Floodlight 活動。

這個資料欄會使用 Display & Video 360 API FloodlightActivity 資源 ID，以及後觀看和後點擊時間窗的時間長度 (以分鐘為單位)。

清單清單格式 = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);)。

主要歸因模式 ID否整數是用於相關委刊項目的歸因模式 ID。
費用否字串、清單清單是這筆交易的所有費用。清單格式 = (費用類別; 費用金額; 費用類型; 已開立月結單)。
  • 費用類別
    • 千次曝光出價
    • 媒體
  • 費用金額
    • 浮點值
    • 以浮點數表示的 Pct
  • 費用類型
    • (字串，請參閱「費用」一節的表格)
  • 已開立月結單
    • 是
    • 否
    • 空白

範例：'(千次曝光出價；2；Display & Video 360 費用；False) ; (媒體；13；預設；True)'
可接受的值請參閱下表：

費用類別費用類型月結帳單選項
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 影片禁止 (請留空白)
媒體Display & Video 360 費用必要 (是)
媒體媒體費用資料禁止 (請留空白)
媒體Scibids 費用必要 (是)
整合代碼否字串是用於追蹤的選用代碼。
詳細資料否字串是以字串格式輸入詳細資料。
出價策略類型如果「類型」為「多媒體」或「影片」或「音訊」，則必須提供字串是 選取其中一個適用的出價策略：
  • 盡量降低：在花完預算的同時，盡量降低單次轉換出價/單次點擊出價
  • 盡量提高：用完預算，同時盡量提高曝光價值或品質曝光
  • 超越：達成或超越 X 美元的單次轉換出價/單次點擊出價目標
  • 最佳化千次可視曝光出價：最佳化 X 美元的千次可視曝光出價
  • 固定：指定 X 的固定出價
出價策略價值除非「出價策略類型」為「盡量降低」、「盡量提高」或「類型」為「TrueView」，否則為必填欄位float是針對「Beat」、「Optimize VCPM」和「Fixed」策略類型，請選擇目標出價的值。
請注意，出價策略類型為「Minimize」或「Maximize」時，不需設定出價策略值。
出價策略單位當「出價策略類型」為「超越目標」、「盡可能降低」或「盡可能提高」時，此為必填屬性字串是針對「超越目標」、「盡量減少」或「盡量提高」策略類型，請選取對應的單位：
  • 單次轉換出價
  • 單次點擊出價
  • 自訂曝光次數值/費用
  • CIVA
  • IVO_TEN
  • AV_VIEWED
出價策略「不超過」如果「類型」為「多媒體」或「影片」或「音訊」，則必須提供float是設定「不超過」千次曝光出價值。如果為 0，系統就不會啟用「不超過」設定。只有在出價策略為「最小化」、「最大化」或「超越」時，才能使用這項功能。
套用交易底價當「出價策略類型」為「最小化」或「最大化」時，此為必填屬性字串是是否優先用於交易，而非公開競價廣告空間
  • TRUE
  • FALSE
演算法 ID當您使用「出價策略單位」自訂曝光次數值/費用時，此為必要項目。整數是將出價策略單位設為自訂曝光次數值/費用時，必須使用這個對應的演算法 ID。
廣告素材分配否字串、清單是

要指派給項目的廣告素材 ID 清單。

這個欄位會使用 Display & Video 360 API Creative 資源 ID。

清單格式 = (Creative.creativeId; Creative.creativeId; 等等)。這個清單會依遞增的數字順序產生。

上傳時，使用者也可以加入 Campaign Manager 360 刊登位置 ID。刊登位置 ID 的開頭應為字母「CM」，例如「CM789」。

例：(123;CM789;)。

指定地理區域 - 納入否字串、清單是

要納入指定目標的地理區域清單。

這個欄位會使用指定類型 TARGETING_TYPE_GEO_REGION 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定地理區域 - 排除否字串、清單是

指定目標中要排除的地理區域清單。

這個欄位會使用指定類型 TARGETING_TYPE_GEO_REGION 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定地理區域地點清單 - 包含否字串、清單是要納入的地理區域地點清單 ID 清單。清單格式 = (11; 22; 33;)。
指定地理區域地點清單 - 排除否字串、清單是要排除的地理區域地點清單 ID 清單。清單格式 = (11; 22; 33;)。
指定鄰近目標否字串、清單清單是列出鄰近目標，每個目標的格式為「(Latitude; Longitude; Radius; Unit; FullAddress;)」緯度介於 -90 和 90 度之間 (含首尾)；經度介於 -180 和 180 度之間 (含首尾)；半徑是指單位中 1 到 500 之間的距離 (含首尾)；單位可以是「mi」或「km」；FullAddress 為選填。例如："(38.907192; -77.03687; 1.0; mi; Washington D.C., DC, USA;); (40.712775; -74.005972; 20.5; km; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; mi; ;);"。
指定鄰近地點清單否字串、清單清單是廣告訂單或非 TrueView 委刊項的鄰近區域清單目標，每個項目的格式為「(ProximityListId; Radius; Unit; );」。ProximityListId 是廣告主資源下的地點清單 ID。半徑是指單位中 1 到 500 (含) 之間的距離；單位可以是「mi」或「km」；每個實體最多只能指定兩份地區清單，以及地理區域地區清單。例如：「(10041691678; 20.0; mi;); (10038858567; 20.5; km;)」。
指定語言 - 納入否字串、清單是

指定要納入指定目標的語言清單。

這個欄位會使用指定類型 TARGETING_TYPE_LANGUAGE 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定語言 - 排除否字串、清單是

指定要排除的語言清單。

這個欄位會使用指定類型 TARGETING_TYPE_LANGUAGE 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定裝置 - 納入否字串、清單是

要納入指定目標的裝置清單。

這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 來指定下列指定目標類型：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定裝置 - 排除否字串、清單是

指定目標中要排除的裝置清單。

這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 來指定下列指定目標類型：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定瀏覽器 - 納入否字串、清單是

要納入指定目標的瀏覽器清單。

這個欄位會使用指定類型 TARGETING_TYPE_BROWSER 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定瀏覽器 - 排除否字串、清單是

指定要排除的瀏覽器清單。

這個欄位會使用指定類型 TARGETING_TYPE_BROWSER 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

數位內容標籤 - 排除否字串、清單是要排除的數位內容標籤清單。清單格式 = (G;PG; 等等)。
  • G
  • PG
  • T
  • MA
  • ？
品牌安全敏感度設定否字串是選擇敏感度設定，根據周邊內容的主題封鎖廣告空間。
  • 不要封鎖
  • 使用 Campaign Manager 360 驗證
  • 使用自訂
品牌安全自訂設定如果「品牌安全性自訂設定」為「使用自訂設定」，則必須填寫字串、清單是如果品牌安全防護敏感度設定為「使用自訂設定」，請指定標準內容分類器清單。例如：性行為、酒精、菸草等。
  • 色情內容
  • 詆毀
  • 下載和分享
  • 武器
  • 賭博
  • 暴力
  • 性暗示
  • 不雅用語
  • 酒精飲料
  • 藥物
  • 菸草
  • 政治
  • 宗教
  • 悲劇
  • 交通事故
  • 敏感的社會議題
  • 駭人的內容
第三方驗證服務否字串是第三方驗證服務供應商。
  • 無
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方驗證標籤否字串、清單是如果「第三方驗證服務」不是「無」，請指定所選供應商支援的標籤清單。
管道指定目標 - 納入否字串、清單是

要納入指定目標的頻道清單。

這個欄位會使用 Display & Video 360 API Channel 資源 ID。

清單格式 = (Channel.channelId; Channel.channelId; 等等)。

指定頻道 - 排除否字串、清單是

指定目標中要排除的管道清單。

這個欄位會使用 Display & Video 360 API Channel 資源 ID。

清單格式 = (Channel.channelId; Channel.channelId; 等等)。

網站指定目標 - 納入否字串、清單是

要納入指定目標的網站清單。清單是網址的字串。

清單格式 = (someurl.com; someurltwo.com; 等等)。這份清單會依字母順序產生。

指定網站 - 排除否字串、清單是

指定要排除的網站清單。清單是網址的字串。

清單格式 = (someurl.com; someurltwo.com; 等等)。這份清單會依字母順序產生。

應用程式指定目標 - 納入否字串、清單是

要納入指定目標的應用程式清單。清單會將應用程式平台和應用程式平台 ID 的字串連接起來。

下列值可用於定義應用程式平台：

  • APP (涵蓋 Android Play 商店和 Apple App Store 平台)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
ID 由相關平台提供，例如 Android 的 Play 商店中的軟體包 ID (例如：com.google.android.gm)，或是 Apple 的 App Store 中的應用程式 ID (例如：422689480)。

應用程式平台和 ID 的連接字串以半形冒號分隔，例如：APP:com.google.android.gm。

清單格式 = (APP:com.google.android.gm; APP:422689480; 等等)。這份清單會依字母順序產生。

指定應用程式 - 排除否字串、清單是

指定目標時要排除的應用程式清單。清單會將應用程式平台和應用程式平台 ID 的字串連接起來。

下列值可用於定義應用程式平台：

  • APP (涵蓋 Android Play 商店和 Apple App Store 平台)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
ID 由相關平台提供，例如 Android 的 Play 商店中的軟體包 ID (例如：com.google.android.gm)，或是 Apple 的 App Store 中的應用程式 ID (例如：422689480)。

應用程式平台和 ID 的連接字串以半形冒號分隔，例如：APP:com.google.android.gm。

清單格式 = (APP:com.google.android.gm; APP:422689480; 等等)。這份清單會依字母順序產生。

應用程式組合指定目標 - 納入否字串、清單是

要納入指定目標的應用程式集合清單。

這個欄位會使用指定類型 TARGETING_TYPE_APP_CATEGORY 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。

指定應用程式集合 - 排除否字串、清單是

在指定目標中排除的應用程式集合清單。

這個欄位會使用指定類型 TARGETING_TYPE_APP_CATEGORY 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。

指定類別 - 納入否字串、清單是

要納入指定目標的類別清單。這個欄位會使用指定類型 TARGETING_TYPE_CATEGORY 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定類別 - 排除否字串、清單是指定排除類別的清單。這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 指定目標類型 TARGETING_TYPE_CATEGORY。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定內容類型 - 包含否字串、清單是

要納入指定目標的內容類型清單。

這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 指定指定類型 TARGETING_TYPE_CONTENT_GENRE

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定內容類型 - 排除否字串、清單是

指定目標中要排除的內容類型清單。

這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 指定指定類型 TARGETING_TYPE_CONTENT_GENRE

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定關鍵字 - 納入否字串、清單是

要納入指定目標的關鍵字字串清單。

這份清單會依字母順序產生。

指定關鍵字 - 排除否字串、清單是

在指定目標中排除的關鍵字字串清單。

這份清單會依字母順序產生。

指定關鍵字清單 - 排除否字串、清單是

指定目標中要排除的排除關鍵字清單。

這個欄位會使用 Display & Video 360 API NegativeKeywordList 資源 ID。

清單格式 = (NegativeKeywordList.negativeKeywordListId; NegativeKeywordList.negativeKeywordListId; 等等)。這個清單會依遞增的數字順序產生。

最佳化指定目標對象否字串是啟用最佳化指定目標對象功能
  • TRUE
  • FALSE

最佳化指定目標對象功能不支援所有出價策略。如有下列情況，此欄必須設為「FALSE」：
  • 「出價策略類型」為「最佳化千次可視曝光出價」
  • 「出價策略類型」為「Maximum」，「出價策略單位」為「CIVA」、「IVO_TEN」或「AV_VIEWED」
指定目標對象 - 包含否字串、組合清單的清單是

要納入指定目標的目標對象名單清單。

這個欄位會使用 Display & Video 360 API FirstAndThirdPartyAudience 資源 ID。

對於第一方目標對象名單，每個目標對象都會列為 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和回訪率設定的組合。組合為 (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 的所有使用者)。

有效的近期值包括：

  • 全部
  • 1 分鐘
  • 5 分鐘
  • 10 分鐘
  • 15 分鐘
  • 30 分鐘
  • 1 小時
  • 2 小時
  • 3 小時
  • 6 小時
  • 12 小時
  • 1 天
  • 2 天前
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28 天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120d
  • 180 天
  • 270 天
  • 365 天
指定目標對象 - 排除否字串、組合清單的清單是

指定目標對象名單排除清單。

這個欄位會使用 Display & Video 360 API FirstAndThirdPartyAudience 資源 ID。

如果目標對象名單是第一方目標對象名單，系統會將每個目標對象列為一組 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和回訪率設定。組合為 (1;1d;)，其中 1d 是代表 1 天近期性的樣本近期性。不過，第三方目標對象無法使用回訪率，因此名單格式為 (3;);(4;)。

清單格式 = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;);)
範例："(1;1d;);(2;);"。

有效的近期值包括：

  • 全部
  • 1 分鐘
  • 5 分鐘
  • 10 分鐘
  • 15 分鐘
  • 30 分鐘
  • 1 小時
  • 2 小時
  • 3 小時
  • 6 小時
  • 12 小時
  • 1 天
  • 2 天前
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28 天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120d
  • 180 天
  • 270 天
  • 365 天
興趣相似目標對象和潛在目標消費者指定目標 - 納入否字串、清單是

要納入的興趣相似目標對象和/或潛在目標消費者名單。

您可以透過 Display & Video 360 介面擷取目標對象名單 ID。

清單格式 = (目標對象 ID; 目標對象 ID; 等等)。這個清單會依遞增的數字順序產生。

興趣相似目標對象和潛在目標消費者指定目標 - 排除否字串、清單是

要排除的興趣相似目標對象和/或潛在目標消費者名單。

您可以透過 Display & Video 360 介面擷取目標對象名單 ID。

清單格式 = (目標對象 ID; 目標對象 ID; 等等)。這個清單會依遞增的數字順序產生。

合併指定目標對象否字串、清單是

要指定的已合併目標對象名單清單。

這個欄位會使用 Display & Video 360 API CombinedAudience 資源 ID。

清單格式 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; 等等)。這個清單會依遞增的數字順序產生。

自訂目標對象名單否字串、清單是

要指定的自訂名單清單。

這個欄位會使用 Display & Video 360 API CustomList 資源 ID。

清單格式 = (CustomList.customListId; CustomList.customListId; 等等)。這個清單會依遞增的數字順序產生。

指定廣告空間來源 - 授權賣方選項如果「類型」為「多媒體」或「影片」或「音訊」，則必須提供字串是指定目標為授權直接賣方、授權直接賣方和經銷商，或是授權賣方和不明來源。「授權直接」表示只會指定授權賣方。「授權直接賣方和經銷商」是指指定目標為授權賣方和經銷商。「授權和未參與計畫的發布商」表示會指定授權賣方、經銷商和不明賣方。
  • 授權直接賣方
  • 授權直接賣方和經銷商
  • 授權發布商和未參與計畫的發布商
指定廣告空間來源 - 包含如果「類型」為「多媒體」或「影片」或「音訊」，則必須提供字串、清單是

要納入指定目標的廣告空間來源、廣告交易平台和子廣告交易平台清單。

這個欄位會使用 Display & Video 360 API InventorySource 資源 ID、已發布廣告交易平台 ID，以及指定目標類型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; 等等)

指定廣告空間來源 - 排除否字串、清單是

指定廣告空間來源、廣告交易平台和子廣告交易平台的清單，用於排除指定目標。

這個欄位會使用 Display & Video 360 API InventorySource 資源 ID、已發布廣告交易平台 ID，以及指定目標類型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; 等等)

指定廣告空間來源 - 指定新廣告交易平台否字串是設定指定新的廣告交易平台。
  • 是
  • 否
私下交易群組指定目標納入否字串、清單是

要納入指定目標的群組交易 ID 清單。您可以在「我的廣告空間」的「已分組的交易」部分，以及委刊項、廣告訂單和廣告活動的「廣告空間來源」設定中找到「已分組的交易」ID。

清單格式 = (DealGroupId; DealGroupId; 等等)。這個清單會依遞增的數字順序產生。

時段指定目標否字串、清單是

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」)。現有實體的時區不會變更。

這個清單會依遞增的數字順序產生。

時段指定目標時區加入「時段指定目標」時，此為必要項目。字串是用於指定時段的區域時區。

請選取下列其中一個值：
  • 局部
  • 廣告主
TrueView 和需求開發委刊項只能是「廣告主」。
指定環境否字串、清單是要指定的環境清單。選取一或多個可接受的值。請注意，您必須先選取「網頁」，才能選取「未進行最佳化的網頁」。
  • 網路
  • 未最佳化的網頁
  • 應用程式
已啟用可視度 Omid 指定目標功能否字串是只指定可透過公開評估標準評估的曝光次數。
  • TRUE
  • FALSE
指定可視度 Active View否字串是指定預測可視度百分比。百分比以浮點數表示。下列其中一個值：{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
指定位置 - 畫面上否字串、清單是指定廣告位置。請選取一或多個可接受的值：
  • 不需捲動位置
  • 需捲動位置
  • 不明
指定位置 - 在內容中顯示否字串、清單是指定要放送的多媒體廣告內容位置。請選取一或多個可接受的值：
  • 文章內
  • 動態內廣告
  • 橫幅內
  • 插頁式
  • 不明
指定位置 - 影片內容中的影片位置否字串、清單是指定影片廣告內容位置。請選取一或多個可接受的值：
  • 文章內
  • 動態內廣告
  • 橫幅內
  • 插頁式
  • 不明的串流外廣告
  • 片頭廣告
  • 片中廣告
  • 片尾
  • 不明的串流內廣告
指定位置 - 內容中的音訊位置否字串、清單是要指定的音訊廣告內容位置。請選取一或多個可接受的值：
  • 片頭廣告
  • 片中廣告
  • 片尾
  • 不明
指定影片播放器大小否字串、清單是要指定的影片廣告播放器大小清單。請選取一或多個可接受的值：
  • 不明
  • small
  • large
  • HD 高畫質
指定內容時間長度否字串、清單是要指定的內容時間長度清單。單位值為分鐘。請選取一或多個可接受的值：
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • 不明
指定內容串流類型否字串、清單是要指定的內容串流類型清單。請選取一或多個可接受的值：
  • 直播
  • 隨選
音訊內容類型指定目標否字串、清單是指定的音訊內容類型清單。請選取一或多個可接受的值：
  • 不明
  • 網路電台
  • 串流音樂
  • Podcast
指定客層：性別否字串、清單是要指定的性別清單。請選取一或多個可接受的值：
  • 女性
  • 男性
  • 不明
指定客層：年齡否字串、清單是指定使用者年齡範圍。選取單一「從」年齡和單一「至」年齡，並指定是否要納入不明確年齡 (true/false)，即可指定從/至年齡範圍。請參閱可接受的「從/到」年齡範圍清單。
範例 1：如要指定 18 到 55 歲，並納入不明年齡，請指定以下格式：{從/到; 納入不明年齡 (是/否)} = 18;55;true;
範例 2：如要只指定 35 歲以上，並排除不明年齡，請指定以下格式：= 35;+;false;。
「從」年齡範圍可接受的值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

可接受的「To」值：
  • 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} = 前 10%;41-50%;true;
範例 2：如要只指定家庭收入排行後 50%，並排除收入不明確的家庭，請指定格式 {Top_of_Range; Bottom_of_Range; Include unknown True/False} = 後 50%;後 50%;true;
Top_of_Range/Bottom_of_Range 可接受的值：
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 後 50%

指定客層：家長狀態是字串、清單是要指定的家長狀態清單。選取一或多個可接受的值。
  • 有子女
  • 無子女
  • 不明
指定連線速度否字串是指定特定連線速度。請選取其中一個可接受值：
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
指定電信業者 - 納入否字串、清單是

要指定的網際網路服務供應商 (ISP) 或電信業者清單。

這個欄位會使用指定類型 TARGETING_TYPE_CARRIER_AND_ISP 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定電信業者 - 排除否字串、清單是

要排除的網際網路服務供應商 (ISP) 或電信業者清單。

這個欄位會使用指定類型 TARGETING_TYPE_CARRIER_AND_ISP 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

出價調節係數否字串、清單清單是此項目的所有出價調節係數。清單格式 = (資料列類型;條件 ID;出價加權係數值); (資料列類型;條件 ID;出價加權係數值);出價加權係數值介於 0.1 和 10.0 之間。下表列出可接受的資料列類型及其對應的條件 ID：
列類型維度條件 ID
應用程式應用程式應用程式平台和應用程式平台 ID 的連接字串。應用程式平台和 ID 的連接字串以半形冒號分隔，例如：APP:com.google.android.gm。以下值可用來定義應用程式平台：
  • APP (涵蓋 Android Play 商店和 Apple App Store 平台)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
應用程式平台和 ID 的連接字串以半形冒號分隔，例如：(app;APP:com.google.android.gm;1.0);(app;APP:422689480;2.5);
網站網址網站網址字串，例如(site;'someurl.com';1.0);(site;'someurltwo.com';2.5);
user_list目標對象名單使用者名單 ID，例如(user_list;UserList.id;1.0);(user_list;UserList.id;2.5);
user_interest目標對象名單使用者興趣 ID，例如(user_interest;UserList.id;1.0);(user_interest;UserList.id;2.5);
custom_affinity目標對象名單自訂興趣相似 ID，例如(custom_affinity;CustomAffinity.id;1.0);(custom_affinity;CustomAffinity.id;2.5);
day_part廣告時段時段 ID 會在「時段指定目標」欄中定義，例如 314159 代表「星期二上午 10 點 15 分至下午 2 點 45 分」。(day_part;314159;1.0);(day_part;302312;2.5);
age_range客層年齡層，以「從-到」的格式分隔。可接受的值如下：
  • 18-24
  • 25-34 歲
  • 35-44 歲
  • 45-54 歲
  • 55-64
  • 65+
  • 不明
例如：(age_range;55-64;1.0);(age_range;65+;2.5);
gender客層性別。可接受的值如下：
  • 男性
  • 女性
  • 不明
例如：(gender;男性;1.0);(gender;女性;2.5);
parental_status客層家長狀態。可接受的值如下：
  • 有子女
  • 無子女
  • 不明
例如：(parental_status;Not a parent;1.0);
household_income客層家庭收入百分位數範圍。可接受的值如下：
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 後 50%
  • 不明
例如：(household_income;前 10%;1.0);(household_income;不明;2.5);
device_type裝置類型裝置類型。可接受的值如下：
  • 電腦
  • 智慧型手機
  • 平板電腦
  • 連網電視
  • 連接的裝置
例如：(device_type;Computer;1.0);(device_type;Tablet;2.5);
geo地理位置地理位置 ID，例如：(geo;2840;1.0);
private_deal私下交易私下交易指定 ID，例如(private_deal;1016301;1.0);
private_deal私下交易私下交易指定 ID，例如(private_deal;1016301;1.0);
public_exchange公開廣告交易平台公開廣告交易平台 ID，例如：(public_exchange;17;1.0);
unclassified_exchange未分類的 Exchange未分類的廣告交易平台指定目標 ID (= 5000 + exchange_id)，例如(unclassified_exchange;5017;1.0);
sub_exchange子廣告交易平台格式為 [exchange_id]-[sub_exchange_targeting_id]，例如(sub_exchange;38-4515403;1.0);
TrueView 影片廣告格式TrueView 委刊項：是字串是委刊項的影片廣告格式。

串流內 / 動態內影片是指以單次收視出價為銷售依據的 TrueView 影片廣告類型。串流內廣告 / 串場廣告是按千次曝光出價銷售的 TrueView 影片廣告類型。串場廣告是長度不超過 6 秒的影片廣告，以千次曝光出價為依據銷售。不可略過的串流內影片廣告是指長度介於 6 到 15 秒的串流內廣告，以千次曝光出價為依據銷售。串流內廣告 / 串場廣告 / 不可略過影片廣告：適用於以千次曝光出價為依據的目標頻率委刊項。回應式影片廣告是可以多種格式放送的廣告類型
    。
  • 串流內廣告
  • 串流內 / 動態內影片
  • 串流內 / 串場
  • 串場廣告
  • 不可略過
  • 串流內廣告 / 串場廣告 / 不可略過的廣告
  • 回應式
TrueView 出價策略類型TrueView 和需求開發委刊項必須使用字串是TrueView 或需求開發委刊項使用的出價策略。

請選取下列任一值：
  • 手動單次收視出價：以每次收視付費的手動觀看出價。
  • 手動千次曝光出價：以曝光次數為依據的手動出價方式，以每千次曝光出價計費。新版 TrueView 或需求開發委刊項不支援這個值。
  • 目標千次曝光出價：自動出價策略，可根據您願意為每千次廣告曝光支付的金額，設定最佳出價，盡可能爭取曝光。
  • 盡量爭取轉換：自動出價策略，可調整出價，盡可能爭取最多轉換。
  • 目標單次轉換出價：自動出價策略，可根據您願意為每項轉換支付的目標金額，調整出價，盡可能爭取轉換。
  • 盡量提高轉換價值：自動以價值為準出價策略，盡量爭取價值較高的轉換。
  • 目標廣告投資報酬率：以價值為準出價策略，可提高轉換價值。
  • 盡量爭取點擊：自動出價策略，可根據預算調整出價，盡量爭取點擊
TrueView 出價策略價值TrueView 和需求開發委刊項必須使用float是針對目標單次轉換出價或目標廣告投資報酬率出價策略類型，選擇目標出價的值。如果是其他「TrueView 出價策略類型」值或其他委刊項類型，則上傳時，這個欄應為 0。針對目標廣告投資報酬率，這個欄應以百分比表示，例如如果您希望目標廣告投資報酬率為 150%，請在這個欄中輸入 1.5。
TrueView 行動出價調整幅度選項否字串是可選「調高」或「調低」
  • 調高
  • 縮短
TrueView 行動出價調整幅度百分比如果「TrueView 出價策略類型」是「目標單次轉換出價」或「盡量爭取轉換」，就必須填寫整數是出價調整幅度，以增加行動裝置上顯示廣告的機會。可接受的調整幅度為：出價調整幅度選項「增加」：[0;900%]；「減少」：[0;90%] 或 100%。
如果「TrueView 出價策略類型」是「目標單次轉換出價」或「盡量爭取轉換」，或是廣告群組為需求開發廣告群組，可接受的調整幅度為：出價調整幅度選項「增加」：0；「減少」：100%。
TrueView 電腦版出價調整幅度選項否字串是可選「調高」或「調低」
  • 調高
  • 縮短
TrueView 電腦版出價調整幅度百分比當「TrueView 出價策略類型」為「目標單次轉換出價」或「盡量爭取轉換」時，此為必要屬性整數是出價調整幅度，以增加行動裝置上顯示廣告的機會。可接受的調整幅度為：出價調整幅度選項「增加」：[0;900%]；「減少」：[0;90%] 或 100%。
「TrueView 出價策略類型」是「目標單次轉換出價」或「盡量爭取轉換」，或是需求開發廣告群組，可接受的調整幅度為：出價調整幅度選項「增加」：0；「減少」：100%。
TrueView 平板電腦出價調整幅度選項否字串是可選「調高」或「調低」
  • 調高
  • 縮短
TrueView 平板電腦出價調整幅度百分比當「TrueView 出價策略類型」為「目標單次轉換出價」或「盡量爭取轉換」時，此為必要屬性整數是出價調整幅度，以增加行動裝置上顯示廣告的機會。可接受的調整幅度為：出價調整幅度選項「增加」：[0;900%]；「減少」：[0;90%] 或 100%。
如果「TrueView 出價策略類型」是「目標單次轉換出價」或「盡量爭取轉換」，或是廣告群組為需求開發廣告群組，可接受的調整幅度為：出價調整幅度選項「增加」：0；「減少」：100%。
TrueView 連網電視出價調整幅度選項否字串是可選「調高」或「調低」
  • 調高
  • 縮短
TrueView 連網電視出價調整幅度百分比當「TrueView 出價策略類型」為「目標單次轉換出價」或「盡量爭取轉換」時，此為必要屬性整數是出價調整幅度，以增加行動裝置上顯示廣告的機會。可接受的調整幅度為：出價調整幅度選項「增加」：[0;900%]；「減少」：[0;90%] 或 100%。
如果「TrueView 出價策略類型」是「目標單次轉換出價」或「盡量爭取轉換」，或是廣告群組為需求開發廣告群組，可接受的調整幅度為：出價調整幅度選項「增加」：0；「減少」：100%。
TrueView 類別排除指定目標否字串、清單否要排除的類別清單。清單格式 = 內嵌影片；親子；等等
  • 內嵌影片
  • 直播
  • 遊戲
  • 多個家庭
TrueView 內容篩選器否字串是TrueView 或需求開發內容篩選器。

請選取下列其中一個值：
  • 有限制
  • 標準
  • 已展開
TrueView 指定廣告空間來源否字串、清單是要納入的 TrueView 廣告空間來源清單
  • YouTube
  • Google TV
  • 影片合作夥伴
TrueView 第三方可視度供應商只有在更新現有的「TrueView」或「需求開發」委刊項時才需要字串、清單清單是第三方廠商，可評估 TrueView 和需求開發委刊項的可視度。如果在建立 TrueView 或需求開發委刊項時，這個欄位留空，且廣告主層級已啟用預設可視度供應商，系統會在建立委刊項時啟用廣告主層級的預設供應商。

請選取下列其中一個值：
  • 無
  • Moat
  • DoubleVerify
  • Integral Ad Science
TrueView 第三方可視度報表 ID如果第三方可視度供應商不是「None」，則為是。字串是第三方可視度供應商用來識別特定報表事件的 ID。這個欄位可接受空白字串，這會將報表 ID 設為空白。
TrueView 第三方品牌安全供應商僅在更新現有 TrueView 或需求開發委刊項時需要字串、清單清單是第三方供應商，可評估 TrueView 和需求開發委刊項的品牌安全性。如果在建立 TrueView 或需求開發委刊項時，此欄位留空，且廣告主層級已啟用預設品牌安全供應商，系統會在建立委刊項時啟用廣告主層級的預設供應商。

請選取下列任一值：
  • 無
  • DoubleVerify
  • Integral Ad Science
  • Zefr
TrueView 第三方品牌安全報表 ID如果第三方品牌安全供應商不是「None」，則為是。字串是第三方品牌安全供應商用於識別特定報表事件的 ID。這個欄位可接受空白字串，這會將報表 ID 設為空白。
TrueView 第三方觸及數供應商僅在更新現有 TrueView 或需求開發委刊項時需要字串、清單清單是第三方供應商，可評估 TrueView 和需求開發委刊項的觸及數。如果在建立 TrueView 或需求開發委刊項時，這個值仍為空白，且廣告主層級已啟用預設觸及數供應商，系統會在建立委刊項時啟用廣告主層級的預設供應商。

請選取下列任一值：
  • 無
  • Nielsen
  • Comscore
  • Kantar
  • Gemius
  • Video Research
  • 媒體範圍
  • AudienceProject
  • iSpot TV
  • VideoAmp
TrueView 第三方觸及報表 ID第三方觸及率供應商不是「None」時為是。字串是第三方觸及供應商用於識別特定報表事件的 ID。這個欄位可接受空白字串，這會將報表 ID 設為空白。
TrueView 第三方品牌提升供應商只有在更新現有的「TrueView」或「需求開發」委刊項時才需要字串、清單清單是第三方供應商，可評估 TrueView 和需求開發廣告活動的品牌提升成效。如果在建立 TrueView 或需求開發委刊項時，這個值仍為空白，且廣告主層級已啟用預設品牌提升供應商，系統會在建立委刊項時啟用廣告主層級的預設供應商。

請選取下列其中一個值：
  • 無
  • Kantar
  • Dynata
  • Intage
  • Nielsen
  • Macromill
TrueView 第三方品牌提升報表 ID第三方品牌提升供應商不是「None」時為是。字串是第三方品牌提升供應商用於識別特定報表事件的 ID。這個欄位可接受空白字串，這會將報表 ID 設為空白。
TrueView 目標頻率計數如果委刊項子類型為目標頻率，則為是整數是目標頻率類型 YouTube 委刊項的目標頻率計數。這個欄位只能設為 2、3 或 4。如果 YouTube 委刊項不是目標頻率類型，則這個欄位應留空。
TrueView 目標頻率時間視窗如果委刊項子類型為目標頻率，則為是字串是目標頻率類型 YouTube 委刊項的目標頻率時間範圍。這個欄位目前只能設為「每週」。如果 YouTube 委刊項的類型不是「目標頻率」，則這個欄位應留空。
  • 每週
TrueView 影片廣告廣告空間控管是，如果 TrueView 委刊項子類型是觸及數，且使用動態內廣告和 Shorts 廣告字串、清單是觸及或觀看委刊項的影片廣告空間控制項。

請選取一或多個可接受的廣告格式值：
  • 串流內廣告
  • 動態內廣告
  • Shorts