結構化資料 - v9 - 委刊項

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

欄位	必填	類型	可寫入	說明
委刊項 ID	只有在編輯現有委刊項時才需要	整數	否	商品項目的數字 ID 值。如果留空，系統會建立新委刊項並指派專屬 ID。建立新委刊項時，您也可以選擇使用自訂 ID，將 TrueView 廣告群組指派給新委刊項。自訂 ID 的格式為「ext <自訂 ID>」，例如 ext123。檔案上傳並處理完畢後，系統會將所有自訂 ID 替換成 DBM 指派的 ID，並根據自訂 ID 建立物件關聯 (例如廣告群組與委刊項)。
Io ID	是	整數	否	廣告訂單的數字 ID 值。如果您在建立這個委刊項的同時也建立了一個插入單，可以為該插入單指定自訂 ID (例如「ext<自訂 IO ID>」)。
Io 名稱	否	字串	否	廣告訂單名稱
類型	是	字串	是	項目的類型。 只能在建立時寫入，無法編輯。 請選取下列其中一個值： 多媒體 影片 TrueView 音訊 需求開發
子類型	是	字串	是	委刊項必須有這個欄位，才能區分不同格式。 請選取下列其中一個值： 簡潔 不可略過 動作 觸及率 查看 音訊 Over The Top 行動應用程式安裝 購買行動應用程式 Simple Over The Top 不可略過的 Over-the-top 廣告 Reach Over The Top 目標頻率 需求開發 「動作」不適用於 TrueView 委刊項。
名稱	是	字串	是	項目的名稱。
時間戳記	編輯現有項目時必須提供	整數	否	項目的時間戳記。 如果是非需求開發委刊項，這是「上次修改」時間戳記，系統會使用這項資訊，確認該項目從下載後到上傳前的這段期間沒有任何異動。 如果是需求開發委刊項，這是檔案產生時間的時間戳記，可用於確認委刊項是最近下載的，但無法保證委刊項自首次下載後未曾更新。
狀態	是	字串	是	項目的狀態設定。 有效 已暫停 草稿 已封存
開始日期	是	字串	是	項目的檔期開始日期時間戳記，格式為 MM/DD/YYYY，或「與廣告訂單相同」，表示使用與父項廣告訂單相同的開始日期。
結束日期	是	字串	是	項目的檔期結束日期時間戳記，格式為 MM/DD/YYYY，或「與廣告訂單相同」，表示使用與父項廣告訂單相同的結束日期。
預算類型	是	字串	是	指定預算是否以金額或曝光次數為依據。如果這個項目的廣告訂單已啟用自動預算分配功能，您可以將這個項目設為「自動」，讓 DBM 自動為這個項目分配預算。 金額 曝光 無限制 自動 TrueView 預算
預算金額	「類型」為「多媒體」、「影片」或「音訊」時為必填	float	是	預算類型為正數的預算金額。這可以是簡單的整數曝光值，也可以是貨幣金額的浮點數。貨幣會以廣告主的貨幣顯示，並以標準單位表示 (而非以貨幣單位的 1/1,000,000 表示)。如果項目設為「自動」預算分配，您可以指定最低支出金額 (例如「至少支出」這個金額)。
使用速度	是	字串	是	用於支出使用速度金額的時間範圍。TrueView 和需求開發委刊項只能是「每日」或「檔期」
使用速度	是	字串	是	這個項目的放送速度。 請選取下列其中一個值： 盡快 平均 超前 TrueView 和需求開發委刊項只能選擇「盡快」或「平均」
使用速度金額	如果「類型」為「多媒體」、「影片」或「音訊」，則為必填欄位。如果「類型」為「TrueView」或「需求開發」，且「放送速度」為「每日」，則為必填欄位。	float	是	根據節奏類型設定的時間範圍，預計支出的金額。
已啟用展示頻率	「子類型」不是「需求開發」時為必填	字串	是	啟用/停用委刊項的曝光次數展示頻率上限。 請選取下列其中一個值： TRUE FALSE
頻率曝光次數	「Frequency Enabled」為「TRUE」時為必填	整數	是	特定頻率金額的曝光次數，以正整數表示，也就是「在 y 期間內顯示 x 次曝光」中的 x。
頻率週期	「Frequency Enabled」為「TRUE」時為必填	字串	是	指定頻率上限的時間週期單位。 請選取下列其中一個值： 分鐘 小時 天 週 月 如果是 TrueView 和需求開發委刊項，支援的期間為天、週、月。
頻率金額	「Frequency Enabled」為「TRUE」時為必填	整數	是	頻率週期類型時間長度的正整數值，也就是「在 y 週期內顯示 x 次曝光」中的 y。TrueView 或需求開發委刊項不支援這個值。 展示頻率上限時間範圍不得超過 30 天。
已啟用 TrueView 觀看頻率	「類型」為「TrueView」時為必填	字串	是	啟用/停用 TrueView 委刊項的觀看次數展示頻率上限 TRUE FALSE
TrueView 觀看頻率曝光次數	「TrueView 瀏覽頻率已啟用」為「TRUE」時，此為必填欄位	整數	是	TrueView 觀看次數的正整數值，也就是「在期間內顯示 x 次觀看」中的 x
TrueView 觀看頻率週期	「TrueView 瀏覽頻率已啟用」為「TRUE」時，此為必填欄位	字串	是	指定 TrueView 觀看次數展示頻率上限的時間單位 天 週 月
合作夥伴收益模式	否	字串	是	夥伴收益模式是控制出價管理工具如何計算收益的機制。您可以使用合作夥伴收益模式追蹤服務費的成本加價金額。如果包含「合作夥伴收益模式」欄，請務必指定「合作夥伴收益金額」欄。 TMCM - 媒體費用總額加成 MCM - 媒體費用加成 千次曝光出價
合作夥伴收益金額	只有在指定「合作夥伴收益模式」欄時才需要。	float	是	與夥伴收益模式對應的正浮點數值。只有在指定「合作夥伴收益模式」欄時才適用。
轉換計算類型	如果「類型」為「多媒體」、「影片」、「音訊」或「TrueView」，則為必填	字串	是	選擇要計算的轉換類型。 全部計入 計算點擊後轉換 數量百分比
轉換計數百分比	如果「類型」為「多媒體」、「影片」、「音訊」或「TrueView」，則為必填	float	是	為「計數百分比」轉換計數類型指定百分比。將百分比格式設為浮點數 (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	否	整數	是	用於相關聯委刊項的歸因模式 ID。
費用	否	字串、清單清單	是	這項項目的所有費用。清單格式 = (費用類別；費用金額；費用類型；已開立月結單)。 費用類別 千次曝光出價 媒體 費用金額 浮點值 以浮點數表示的百分比 費用類型 (字串，請參閱費用表) 月結帳戶 是 否 空白 範例：(CPM; 2; Display & Video 360 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 影片 不允許 (留空) 媒體 Display & Video 360 費用 必要 (True) 媒體 媒體費用資料 不允許 (留空) 媒體 Scibids 費用 必要 (True) 注意：Adloox 是供應商的舊名，現在稱為 Scope3。
整合代碼	否	字串	是	用於追蹤的可選用代碼。
詳細資料	否	字串	是	字串格式的項目詳細資料。
出價策略類型	「類型」為「多媒體」、「影片」或「音訊」時為必填	字串	是	選取適用的出價策略： 盡量降低：用完預算，同時盡量降低單次動作出價/單次點擊出價 盡量提高：用完預算，同時盡量提高曝光價值或品質曝光 超越：達成或超越單次動作出價/單次點擊出價目標 最佳化千次可視曝光出價：最佳化千次可視曝光出價 X 固定：指定固定出價 X
出價策略價值	除非「出價策略類型」為「盡量減少」、「盡量爭取」或「類型」為「TrueView」，否則為必填	float	是	如果是「超越」、「最佳化千次曝光出價」和「固定」策略類型，請選擇目標出價的值。 請注意，出價策略類型為「盡量減少」或「盡量爭取」時，不需要出價策略值。
出價策略單元	「出價策略類型」為「擊敗」、「盡量減少」或「盡量爭取」時為必填	字串	是	如果是「擊敗」、「盡量減少」或「盡量爭取」策略類型，請選取對應的單位： 單次轉換出價 單次點擊出價 自訂曝光次數值/費用 CIVA IVO_TEN AV_VIEWED
出價策略不得超過	「類型」為「多媒體」、「影片」或「音訊」時為必填	float	是	設定「不得超過」的千次曝光出價值。如果為 0，則不會啟用「請勿超過」功能。只有在出價策略為「盡量減少」、「盡量爭取」或「擊敗」時，才能使用這項功能。
為交易套用底價	如果「出價策略類型」為「盡量減少」或「盡量爭取」，則為必填	字串	是	是否優先用於交易，而非公開競價廣告空間 TRUE FALSE
演算法 ID	如果「出價策略單元」是自訂曝光次數值/費用，則必須提供這項資訊。	整數	是	如果出價策略單元設為自訂曝光次數值/費用，就必須使用這個對應的演算法 ID。 凡是演算法用於指派給這個資料欄的 Floodlight 活動，都必須納入「轉換 Floodlight 活動 ID」資料欄。如果未正確更新「轉換 Floodlight 活動 ID」欄，嘗試指派演算法時就會發生錯誤。
廣告素材分配	否	字串、清單	是	要指派給項目的廣告素材 ID 清單。 這個資料欄會使用 Display & Video 360 API Creative 資源 ID。 清單格式 = (Creative.creativeId; Creative.creativeId; etc.)。這份清單會依遞增數字順序產生。 上傳時，使用者也可以加入 Campaign Manager 360 刊登位置 ID。刊登位置 ID 前面應加上字母「CM」，例如「CM789」。 例如：(123;CM789;)。
含有歐盟政治廣告	必填	字串	是	這個委刊項是否放送歐盟政治廣告。 是 否 未設定
指定地理區域 - 納入	否	字串、清單	是	要納入指定目標的地理區域清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_GEO_REGION。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定地理區域 - 排除	否	字串、清單	是	要從指定目標中排除的地理區域清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_GEO_REGION。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定地理區域地點清單 - 包含	否	字串、清單	是	要納入的地理區域地點清單 ID 清單。清單格式 = (11; 22; 33;)。
指定地理區域地點清單 - 排除	否	字串、清單	是	要排除的地理區域地點清單 ID 清單。清單格式 = (11; 22; 33;)。
指定鄰近目標	否	字串、清單清單	是	每個鄰近地區目標的格式為「(緯度；經度；半徑；單位；完整地址)；」。緯度介於 -90 到 90 度 (含首尾)；經度介於 -180 到 180 度 (含首尾)；半徑介於 1 到 500 (含首尾) 之間，單位為「英里」或「公里」；完整地址為選填。例如：「(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 (含) 之間的距離，單位可以是「英里」或「公里」；每個實體最多可指定兩個位置清單，以及地理區域位置清單。例如：「(10041691678; 20.0; mi;); (10038858567; 20.5; km;);」。
指定語言 - 納入	否	字串、清單	是	要納入指定目標的語言清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_LANGUAGE。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定語言 - 排除	否	字串、清單	是	要從指定目標中排除的語言清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_LANGUAGE。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定裝置 - 納入	否	字串、清單	是	要納入指定目標的裝置清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，適用於下列指定目標類型： TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定裝置 - 排除	否	字串、清單	是	要從指定目標中排除的裝置清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，適用於下列指定目標類型： TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定瀏覽器 - 納入	否	字串、清單	是	要納入指定目標的瀏覽器清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_BROWSER。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定瀏覽器 - 排除	否	字串、清單	是	要從指定目標中排除的瀏覽器清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_BROWSER。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
數位內容標籤 - 排除	否	字串、清單	是	要排除的數位內容標籤清單。清單格式 = (G；PG；等等)。 G PG T MA ？
品牌安全敏感度設定	否	字串	是	選擇敏感度設定，根據周邊內容的主題封鎖廣告空間。 不要封鎖 使用 Campaign Manager 360 驗證 使用自訂溫度
品牌安全自訂設定	如果「品牌安全自訂設定」為「使用自訂」，則必須提供這項資訊	字串、清單	是	如果品牌安全感應設定為「使用自訂」，請指定標準內容分類器清單。例如 (Sexual;Alcohol;Tobacco;etc.)。 色情內容 詆毀 下載及分享 武器 賭博 暴力 性暗示 不雅用語 酒精飲料 毒品 菸草 政治 宗教 悲劇 交通事故 敏感的社會議題 駭人的內容
第三方驗證服務	否	字串	是	第三方驗證服務供應商。 無 Integral Ad Science DoubleVerify Adloox 注意：Adloox 是供應商的舊名，現在稱為 Scope3。
第三方驗證服務供應商標籤	否	字串、清單	是	如果「第三方驗證服務」不是「無」，請指定所選供應商支援的標籤清單。
指定頻道 - 納入	否	字串、清單	是	要納入指定目標的頻道清單。 這個資料欄會使用 Display & Video 360 API Channel 資源 ID。 清單格式 = (Channel.channelId; Channel.channelId; etc.)。
頻道指定目標 - 排除	否	字串、清單	是	要從指定目標中排除的頻道清單。 這個資料欄會使用 Display & Video 360 API Channel 資源 ID。 清單格式 = (Channel.channelId; Channel.channelId; etc.)。
指定網站 - 納入	否	字串、清單	是	要納入指定目標的網站清單。清單是網址字串。 清單格式 = (someurl.com; someurltwo.com; etc.)。這份清單會依字母遞增排序。
指定網站 - 排除	否	字串、清單	是	要在指定目標中排除的網站清單。清單是網址字串。 清單格式 = (someurl.com; someurltwo.com; etc.)。這份清單會依字母遞增排序。
指定應用程式 - 納入	否	字串、清單	是	要納入指定目標的應用程式清單。這份清單會串連應用程式平台和應用程式平台 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; etc.)。這份清單會依字母遞增排序。
指定應用程式 - 排除	否	字串、清單	是	要從指定目標中排除的應用程式清單。這份清單會串連應用程式平台和應用程式平台 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; etc.)。這份清單會依字母遞增排序。
指定應用程式組合 - 納入	否	字串、清單	是	要納入指定目標的應用程式集合清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_APP_CATEGORY。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。
指定應用程式集合 - 排除	否	字串、清單	是	要在指定目標中排除的應用程式集合清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_APP_CATEGORY。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。
指定類別 - 納入	否	字串、清單	是	要納入指定目標的類別清單。這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_CATEGORY。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定類別 - 排除	否	字串、清單	是	要從指定目標中排除的類別清單。這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_CATEGORY。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定內容類型 - 納入	否	字串、清單	是	要納入指定目標的內容類型清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_CONTENT_GENRE 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定內容類型 - 排除	否	字串、清單	是	指定目標中要排除的內容類型清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_CONTENT_GENRE 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定關鍵字 - 納入	否	字串、清單	是	要納入指定目標的關鍵字字串清單。 這份清單會依字母遞增排序。
指定關鍵字 - 排除	否	字串、清單	是	要在指定目標中排除的關鍵字字串清單。 這份清單會依字母遞增排序。
指定關鍵字清單 - 排除	否	字串、清單	是	要排除的排除關鍵字清單。 這個資料欄會使用 Display & Video 360 API NegativeKeywordList 資源 ID。 清單格式 = (NegativeKeywordList.negativeKeywordListId; NegativeKeywordList.negativeKeywordListId; etc.)。這份清單會依遞增數字順序產生。
最佳化指定目標對象	否	字串	是	啟用最佳化指定目標對象。 TRUE FALSE 最佳化指定目標不適用於所有出價策略。如果符合下列條件，這個資料欄必須為「FALSE」： 「出價策略類型」為「固定」 「出價策略類型」為「已最佳化的千次可視曝光出價」 「出價策略類型」為「最高」，且「出價策略單位」為「CIVA」、「IVO_TEN」或「AV_VIEWED」
指定目標對象 - 納入	否	字串、成對清單的清單	是	要納入指定目標的目標對象名單清單。 這個資料欄會使用 Display & Video 360 API FirstPartyAndPartnerAudience 資源 ID。 如果是第一方目標對象名單，每個目標對象都會列為一組 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和回訪率設定。一對是 (1;1d;)，其中 1d 是代表 1 天近期的樣本近期。第三方目標對象無法使用近期搜尋，因此名單格式為 (3;);(4;);。如要「AND」和「OR」目標對象群組，請按照下列範例操作：如要合併有和沒有近期性限制的配對，請使用「((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));」。也就是說，(名單 1 的近期性為 1 天「或」名單 2 的近期性為 365 天)「且」(名單 3 未指定近期性「或」名單 4 的近期性為 5 分鐘「或」名單 5 包含所有使用者)。 有效近來性值如下： 全部 1 個月 5 分鐘 10 分鐘 15 分鐘 30 分鐘 1 小時 2 小時 3h 6 小時 12 小時 1 天 2 天前 3 天 5 天 7 天 10d 14 天 15 天 21 天 28 天 30 天 45 天 60 天 90 天 120d 180d 270 天 365 天
指定目標對象 - 排除	否	字串、成對清單的清單	是	要在指定目標中排除的目標對象名單。 這個資料欄會使用 Display & Video 360 API FirstPartyAndPartnerAudience 資源 ID。 如果目標對象名單是第一方目標對象名單，則每個目標對象都會列為 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和回訪率設定的配對。一對是 (1;1d;)，其中 1d 是代表 1 天近期的樣本近期。不過，第三方目標對象無法使用回訪率，因此名單格式為 (3;);(4;);。 名單格式 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);) 範例：「(1;1d;);(2;);」。 有效近來性值如下： 全部 1 個月 5 分鐘 10 分鐘 15 分鐘 30 分鐘 1 小時 2 小時 3h 6 小時 12 小時 1 天 2 天前 3 天 5 天 7 天 10d 14 天 15 天 21 天 28 天 30 天 45 天 60 天 90 天 120d 180d 270 天 365 天
興趣相似目標對象和潛在目標消費者指定目標 - 納入	否	字串、清單	是	要納入的興趣相似目標對象和/或潛在目標消費者名單。 目標對象名單 ID 可從 Display & Video 360 介面擷取。 清單格式 = (目標對象 ID；目標對象 ID；等等)。這份清單會依遞增數字順序產生。
興趣相似目標對象和潛在目標消費者指定目標 - 排除	否	字串、清單	是	要排除的興趣相似目標對象和/或潛在目標消費者名單。 目標對象名單 ID 可從 Display & Video 360 介面擷取。 清單格式 = (目標對象 ID；目標對象 ID；等等)。這份清單會依遞增數字順序產生。
合併目標對象指定	否	字串、清單	是	要指定目標的已合併目標對象名單清單。 這個資料欄會使用 Display & Video 360 API CombinedAudience 資源 ID。 清單格式 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; etc.)。這份清單會依遞增數字順序產生。
自訂名單指定目標	否	字串、清單	是	要指定目標的自訂名單清單。 這個資料欄會使用 Display & Video 360 API CustomList 資源 ID。 名單格式 = (CustomList.customListId; CustomList.customListId; etc.)。這份清單會依遞增數字順序產生。
指定廣告空間來源 - 授權賣方選項	「類型」為「多媒體」、「影片」或「音訊」時為必填	字串	是	設定指定授權直接賣方、授權直接賣方和經銷商，或是授權賣方 + 未知。「授權直接」是指只指定授權賣方。「授權直接賣方和經銷商」是指指定授權賣方和經銷商。「授權和未參與計畫的發布商」：指定授權賣方、經銷商和不明賣方。 授權直接賣方 授權直接賣方和經銷商 授權發布商和未參與計畫的發布商
指定廣告空間來源 - 包含	「類型」為「多媒體」、「影片」或「音訊」時為必填	字串、清單	是	要納入指定目標的廣告空間來源、廣告交易平台和子廣告交易平台清單。 這個資料欄會使用 Display & Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID，以及指定目標類型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 資源 ID。 清單格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)
指定廣告空間來源 - 排除	否	字串、清單	是	要排除在指定目標中的廣告空間來源、廣告交易平台和子廣告交易平台清單。 這個資料欄會使用 Display & Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID，以及指定目標類型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 資源 ID。 清單格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)
指定廣告空間來源 - 指定新廣告交易平台	否	字串	是	設定指定新的廣告交易平台。 是 否
私下交易群組指定目標 (納入)	否	字串、清單	是	要納入指定目標的已分組交易 ID 清單。您可以在「我的廣告空間」的「已分組的交易」部分，以及委刊項、廣告訂單和廣告活動的「廣告空間來源設定」的「群組」部分，找到已分組的交易 ID。 清單格式 = (DealGroupId; DealGroupId; etc.)。這份清單會依遞增數字順序產生。
時段指定目標	否	字串、清單	是	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 指定目標	否	字串	是	啟用後，系統只會指定可透過 Open Measurement 標準評估的曝光。如果實體不支援 OMID 指定目標，請將此欄留空。 TRUE FALSE 如果廣告主層級已啟用 OMID 指定目標，且實體支援這項功能，則無法將此欄設為「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 歲的使用者，並納入不明年齡，請指定格式 {From; To ; Include unknown 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
指定電信業者 - 納入	否	字串、清單	是	要指定的網際網路服務供應商或電信業者清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_CARRIER_AND_ISP。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
指定電信業者 - 排除	否	字串、清單	是	要排除的網際網路服務供應商或電信業者清單。 這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID，指定目標類型為 TARGETING_TYPE_CARRIER_AND_ISP。 清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。這份清單會依遞增數字順序產生。
出價調節係數	否	字串、清單清單	否	新委刊項不再支援出價調節係數。這個資料欄已無法寫入資料。 這個項目的所有出價調節係數。清單格式 = (資料列類型；條件 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 客層 年齡範圍，以「From-To」分隔。可接受的值如下： 18-24 25-34 歲 35-44 歲 45-54 歲 55-64 65+ 不明 例如：(age_range;55-64;1.0);(age_range;65+;2.5); gender 客層 性別。可接受的值如下： 男性 女性 不明 例如：(gender;Male;1.0);(gender;Female;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;Top 10%;1.0);(household_income;Unknown;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 未分類的交易所 未分類的廣告交易平台指定目標 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 出價策略價值	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 廣告空間來源清單 YouTube Google TV 影片合作夥伴 需求開發委刊項必須包含「影片合作夥伴」。
TrueView 第三方可視度廠商	只有在更新現有的「TrueView」或「需求開發」委刊項時才需要提供	字串、清單清單	是	第三方廠商會評估 TrueView 和需求開發廣告委刊項的可視度。如果在建立 TrueView 或需求開發委刊項時將此欄位留空，且廣告主層級已啟用預設可視度供應商，系統會建立委刊項，並啟用廣告主層級的預設供應商。 請選取下列其中一個值： 無 Moat DoubleVerify Integral Ad Science
TrueView 第三方可視度報表 ID	如果第三方可視度供應商不是「無」，則為「是」。	字串	是	第三方可視度供應商用來識別特定報表事件的 ID。這個資料欄可填入空字串，將報表 ID 設為空白。
TrueView 第三方品牌安全供應商	僅在更新現有 TrueView 或需求開發委刊項時需要	字串、清單清單	是	第三方供應商會評估 TrueView 和需求開發委刊項的品牌安全。如果在建立 TrueView 或需求開發委刊項時將此欄位留空，且廣告主層級已啟用預設品牌安全供應商，系統就會建立委刊項，並啟用廣告主層級的預設供應商。 請選取下列其中一個值： 無 DoubleVerify Integral Ad Science Zefr
TrueView 第三方品牌安全報表 ID	如果第三方品牌安全供應商不是「無」，則為「是」。	字串	是	第三方品牌安全供應商用來識別特定報表事件的 ID。這個資料欄可填入空字串，將報表 ID 設為空白。
TrueView 第三方觸及率供應商	僅在更新現有 TrueView 或需求開發委刊項時需要	字串、清單清單	是	第三方供應商會評估 TrueView 和需求開發委刊項的觸及率。如果在建立 TrueView 或需求開發委刊項時將此欄位留空，且廣告主層級已啟用預設觸及供應商，系統就會建立委刊項，並啟用廣告主層級的預設供應商。 請選取下列其中一個值： 無 Nielsen Comscore Kantar Gemius Video Research 媒體範圍 AudienceProject iSpot TV VideoAmp
TrueView 第三方觸及報表 ID	如果第三方觸及率供應商不是「無」，則為「是」。	字串	是	第三方觸及供應商用來識別特定報表事件的 ID。這個資料欄可填入空字串，將報表 ID 設為空白。
TrueView 第三方品牌提升供應商	只有在更新現有的「TrueView」或「需求開發」委刊項時才需要提供	字串、清單清單	是	第三方供應商，負責評估 TrueView 和需求開發委刊項的品牌提升成效。如果在建立 TrueView 或需求開發委刊項時將此欄位留空，且廣告主層級已啟用預設品牌提升供應商，系統就會建立委刊項並啟用廣告主層級的預設供應商。 請選取下列其中一個值： 無 Kantar Dynata Intage Nielsen Macromill
TrueView 第三方品牌提升報表 ID	如果第三方品牌提升供應商不是「無」，則為「是」。	字串	是	第三方品牌提升供應商用來識別特定報表事件的 ID。這個資料欄可填入空字串，將報表 ID 設為空白。
TrueView 目標頻率次數	是，當委刊項子類型為「目標頻率」時	整數	是	為 YouTube 目標頻率類型委刊項設定的目標頻率次數。這個欄位只能根據時間範圍設定不同的值。如果 YouTube 委刊項不是目標頻率類型，這個欄位應留空。
TrueView 目標頻率時間範圍	是，當委刊項子類型為「目標頻率」時	字串	是	YouTube 目標頻率類型委刊項的目標頻率時間範圍。目前此欄位可以設為「每週」或「每月」。如果 YouTube 委刊項不是目標頻率類型，這個欄位應為空白。 每週、每月
控管 TrueView 影片廣告空間	是，如果委刊項子類型為「觸及」	字串、清單	是	放送觸及或觀看次數委刊項時，可控管的影片廣告空間。 選取一或多個可接受的廣告格式值： 串流內廣告 動態內廣告 Shorts