結構化資料 - v7.1 - 委刊項

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

欄位需要類型可寫入說明
委刊項 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
  • 行動應用程式安裝
  • 購買行動應用程式
  • 簡易至上
  • 不可略過的廣告比頂端
  • 最上層的觸及率
  • 目標頻率
名稱可字串可項目名稱。
時間戳記編輯現有項目時必填整數否項目的時間戳記，由系統用於驗證該項目從下載和上傳期間的未變更。
狀態可字串可項目的狀態設定。
  • 運作中
  • 已暫停
  • 草稿
  • 已封存
開始日期可字串可項目檔期開始日期的時間戳記，格式為 MM/DD/YYYY 或「與廣告訂單相同」，表示使用與上層廣告訂單相同的開始日期。
結束日期可字串可項目檔期結束日期的時間戳記，格式為 MM/DD/YYYY 或「與廣告訂單相同」，表示使用與上層廣告訂單相同的結束日期。
預算類型可字串可指定預算是以金額或曝光為基礎。如果這個項目的廣告訂單已啟用自動預算分配功能，您可以將這個項目設為「自動」，允許 DBM 自動為這個項目預算。
  • 金額
  • 曝光次數
  • 無上限
  • 自動
  • TrueView 預算
預算金額「類型」為「多媒體」、「影片」或「音訊」時為必填float可這個預算類型的預算金額為正值。這可以是簡單的整數曝光值，或是貨幣金額的浮點值。貨幣會以廣告客戶的貨幣單位顯示，而不是以 1/1,000,000s 的貨幣單位顯示。如果該項目設為「自動」預算分配方式，您可以指定最低支出金額 (例如「支出至少」這個金額)。
使用速度可字串可用於支出使用速度金額的時間範圍。
  • 每天
  • 每月
  • 檔期
TrueView 委刊項只能設為「每日」或「檔期」
使用速度可字串可這個項目的使用速度速率。
  • 盡快
  • 平均
  • 向前
TrueView 委刊項只能設為「盡快」或「平均」
使用速度金額當「類型」為「多媒體」、「影片」或「音訊」時，此為必要項目。如果「類型」為「TrueView」，且「使用速度」為「每日」，則為必填欄位。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可與合作夥伴收益模式對應的正浮點值。只有在已指定「夥伴收益模式」欄的情況下才適用。
轉換計算方式類型當「類型」為「多媒體」、「影片」、「音訊」或「TrueView」時為必要字串可選擇要納入計算的轉換類型。
  • 全部計入
  • 計算點擊後轉換
  • 計數百分比
轉換計數位置當「類型」為「多媒體」、「影片」、「音訊」或「TrueView」時為必要float可指定「計數百分比」轉換計數類型的百分比。將 % 的格式設定為一個浮點值 (3.123% = 3.123)，且精度設有千位數 (小數點後 3 位)。
轉換 Floodlight 活動 ID否string, 清單清單可

用於轉換及相關設定的 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。
費用否string, 清單清單可這個項目的所有費用。清單格式 = (費用類別；費用金額；費用類型；開立發票)；
  • 費用類別
    • 千次曝光出價
    • 媒體
  • 費用金額
    • 浮點值
    • 以浮點值放置
  • 費用類型
    • (字串，請參閱費用表)
  • 發票
    • 是
    • 否
    • 空白

例如「(CPM; 2; Display & Video 360 費用; False)」；(媒體；13；預設；True)；
下表提供可接受的值：

費用類別手續費類型月結選項
千次曝光出價/媒體預設不允許 (留空)
千次曝光出價/媒體第三方廣告伺服器不允許 (留空)
千次曝光出價/媒體DoubleVerify允許 (是/否)
千次曝光出價/媒體ADsafe不允許 (留空)
千次曝光出價/媒體Adxpose不允許 (留空)
千次曝光出價/媒體Vizu不允許 (留空)
千次曝光出價/媒體Aggregate Knowledge不允許 (留空)
千次曝光出價/媒體Teracent不允許 (留空)
千次曝光出價/媒體Evidon不允許 (留空)
千次曝光出價/媒體代理商交易平台費用不允許 (留空)
千次曝光出價/媒體Adloox允許 (是/否)
千次曝光出價ShopLocal必填 (是)
千次曝光出價TrustMetrics不允許 (留空)
千次曝光出價Integral Ad Science 影片允許 (是/否)
千次曝光出價MOAT 影片不允許 (留空)
媒體Display & Video 360 費用必填 (是)
媒體媒體費用資料不允許 (留空)
媒體Scibids 費用必填 (是)
整合代碼否字串可用於追蹤的選用程式碼。
詳細說明否字串可以字串格式輸入項目詳細資料。
出價策略類型「類型」為「多媒體」、「影片」或「音訊」時為必填字串可 選取其中一個適用的出價策略：
  • 最小化： 用完預算，同時將單次獲得費用/單次點擊出價降到最低
  • 最大化：使用整筆預算，同時盡量提高展示值或品質展示次數
  • 突破：達成或超越單次轉換出價/單次點擊出價目標
  • 最佳化千次可視曝光出價：最佳化 X 的千次可視曝光出價
  • 固定：指定 X 的固定出價
出價策略價值除非「出價策略類型」為「最小化」、「最大」或「類型」為「TrueView」，否則為必要欄位float可請為「最佳化千次可視曝光出價」、「最佳化千次可視曝光出價」或「固定策略」類型選擇目標出價。
請注意，如果出價策略類型為「最小化」或「盡量提高」，則不必提供出價策略值
出價策略單位當「出價策略類型」為「排除」、「最小化」或「最大化」時，此為必填欄位字串可為「節奏」、「最小化」或「最大化」策略類型選取相應的單元：
  • 單次轉換出價
  • 單次點擊出價
  • 自訂曝光次數值/費用
  • 完整影音
  • IVO_TEN
  • AV_VIEWED
出價策略數量限制「類型」為「多媒體」、「影片」或「音訊」時為必填float可設定「不要超過」千次曝光出價值。如果值為 0，則不會啟用「不要超過」；只有在出價策略為「最小化」、「最大化」或「Beat」時，才能使用此選項。
套用交易底價「出價策略類型」為「最小化」或「最大化」時為必填字串可是否優先處理交易，而非公開競價廣告空間
  • TRUE
  • FALSE
演算法 ID「出價策略單元」自訂曝光次數值/費用為必填欄位。整數可將出價策略單元設為自訂曝光次數值/費用時，必須使用這個對應的演算法 ID。
廣告素材分配否string, list可

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

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

清單格式 = (Creative.creativeId、Creative.creativeId 等)。這份清單會依遞增順序產生。

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

例如：(123；CM789；)

指定地理區域 - 包含否string, list可

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

這一欄會針對「TARGETING_TYPE_GEO_REGION」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定地理區域 - 排除否string, list可

要在指定目標中排除的地理位置清單。

這一欄會針對「TARGETING_TYPE_GEO_REGION」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定地理區域地區位置清單 - 包含否string, list可要納入的地理區域地區清單 ID 清單。清單格式 = (11; 22; 33;)。
指定地理位置區域清單 - 排除否string, list可要排除的地理區域位置清單 ID 清單。清單格式 = (11; 22; 33;)。
指定鄰近目標否string, 清單清單可鄰近目標清單，格式為「(Latitude; Longitude; Radius; Unit; FullAddress;);」。緯度介於 -90 到 90 度 (含) 之間；經度介於 -180 到 180 度 (含) 之間；半徑是指單位中的 1 到 500 (含) 之間的距離；單位可以是「mi」或「km」；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; .);
指定鄰近地區清單否string, 清單清單可插入委刊單或非 TrueView 委刊項的鄰近清單目標清單，格式為「(ProximityListId; Radius; Unit; );」。ProximityListId 是廣告客戶資源下的一個地區清單編號。半徑是指單位中的 1 到 500 (含) 之間的距離；單位可以是「mi」或「km」。每個實體可同時指定兩個地點清單以及地理位置清單。例如：「(10041691678; 20.0; mi;); (10038858567; 20.5; km;);」。
指定語言 - 包含否string, list可

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

這一欄會針對「TARGETING_TYPE_LANGUAGE」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定語言 - 排除否string, list可

要在指定目標中排除的語言清單。

這一欄會針對「TARGETING_TYPE_LANGUAGE」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定裝置 - 包含否string, list可

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

這一欄會針對下列指定類型使用 Display & Video 360 API TargetingOption 資源 ID：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定裝置 - 排除否string, list可

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

這一欄會針對下列指定類型使用 Display & Video 360 API TargetingOption 資源 ID：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定瀏覽器 - 包含否string, list可

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

這一欄會針對「TARGETING_TYPE_BROWSER」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定瀏覽器 - 排除否string, list可

要在指定目標中排除的瀏覽器清單。

這一欄會針對「TARGETING_TYPE_BROWSER」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

數位內容標籤 - 排除否string, list可要排除的數位內容標籤清單。名單格式 = (G;PG 等)。
  • G
  • PG
  • T
  • MA
  • ?
品牌安全敏感度設定否字串可選擇靈敏度設定，即可根據周圍內容的主題封鎖廣告空間。
  • 不要封鎖
  • 使用 Campaign Manager 360 驗證功能
  • 使用自訂選項
品牌安全自訂設定如果「品牌安全自訂設定」為「使用自訂設定」，則為必要欄位string, list可如果「品牌安全敏感度」設定設為「使用自訂」，請指定標準內容分類項清單。例如 (情色；酒精飲料；菸草等)。
  • 色情內容
  • 貶抑用語
  • 下載與分享
  • 武器
  • 賭博
  • 暴力內容
  • 性暗示
  • 不雅用語
  • 酒精飲料
  • 藥物
  • 菸草
  • 政治
  • 宗教
  • 悲劇
  • 交通事故
  • 敏感的社會議題
  • 駭人的內容
第三方驗證服務否字串可第三方驗證服務供應商。
  • 無
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方驗證標籤否string, list可如果第三方驗證服務不是「無」，請指定所選供應商支援的標籤清單。
指定頻道 - 包含否string, list可

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

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

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

指定頻道 - 排除否string, list可

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

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

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

指定網站 - 包含否string, list可

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

清單格式 = (someurl.com、someurltwo.com 等)。這份清單會依字母順序遞增。

指定網站 - 排除否string, list可

要在指定目標中排除的網站清單。這份清單是網址字串。

清單格式 = (someurl.com、someurltwo.com 等)。這份清單會依字母順序遞增。

應用程式指定目標 - 包含否string, list可

要納入指定目標的應用程式清單。這份清單包含應用程式平台和應用程式平台 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; 等等)。這份清單會依字母順序遞增。

應用程式指定目標 - 排除否string, list可

要在指定目標中排除的應用程式清單。這份清單包含應用程式平台和應用程式平台 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; 等等)。這份清單會依字母順序遞增。

應用程式組合指定目標 - 包含否string, list可

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

這一欄會針對「TARGETING_TYPE_APP_CATEGORY」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

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

應用程式組合指定目標 - 排除否string, list可

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

這一欄會針對「TARGETING_TYPE_APP_CATEGORY」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

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

指定類別 - 包含否string, list可

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

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定類別 - 排除否string, list可要在指定目標中排除的類別清單。這一欄會針對「TARGETING_TYPE_CATEGORY」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定內容類型 - 包含否string, list可

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

這一欄會針對「TARGETING_TYPE_CONTENT_GENRE」指定類型使用 Display & Video 360 API TargetingOption 資源 ID

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定內容類型 - 排除否string, list可

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

這一欄會針對「TARGETING_TYPE_CONTENT_GENRE」指定類型使用 Display & Video 360 API TargetingOption 資源 ID

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定關鍵字 - 包含否string, list可

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

這份清單會依字母順序遞增。

指定關鍵字 - 排除否string, list可

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

這份清單會依字母順序遞增。

指定關鍵字清單 - 排除否string, list可

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

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

清單格式 = (negativeKeywordList. negativeKeywordListId; ExcludeKeywordList. negativeKeywordListId; 等等)。這份清單會依遞增順序產生。

最佳化指定目標對象否字串可啟用最佳化指定目標對像功能。
  • TRUE
  • FALSE
指定目標對象 - 包含否字串，配對清單可

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

這一欄會使用 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 或名單 2，回訪率為 365 天。

有效的回訪率值如下：

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

要在指定目標中排除的目標對象名單。

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

如果目標對象名單為第一方目標對象名單，則每個目標對像都會採用一組 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和回訪率設定。組合為 (1;1d;)，其中 1d 是代表 1 天回訪率的取樣率範例。然而，第三方目標對象無法使用回訪率，因此名單格式為 (3;);(4;);。

名單格式 = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; Recencyoptional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; Recencyoptional;);)
範例：「(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 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
興趣相似和潛在目標消費者指定目標 - 包含否string, list可

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

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

名單格式 = (目標對象 ID、目標對象 ID 等)。這份清單會依遞增順序產生。

指定興趣相似目標對象和潛在目標消費者 - 排除否string, list可

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

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

名單格式 = (目標對象 ID、目標對象 ID 等)。這份清單會依遞增順序產生。

合併指定目標對象否string, list可

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

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

名單格式 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; 等)。這份清單會依遞增順序產生。

指定自訂名單否string, list可

要指定的自訂名單清單。

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

清單格式 = (CustomList.customListId、CustomList.customListId; 等)。這份清單會依遞增順序產生。

廣告空間來源指定目標 - 授權賣方選項「類型」為「多媒體」、「影片」或「音訊」時為必填字串可設為指定授權直接賣方、授權直接賣方和經銷商，或是授權賣方 + 未知。「授權直接交易」代表只能指定授權賣方。「授權直接賣方和經銷商」意指指定授權賣方和經銷商。「授權賣方和未參與此計劃的發布商」是指會指定授權賣方、經銷商和不明賣方。
  • 授權直接賣方
  • 授權直接賣方和經銷商
  • 授權發布商和未參與計畫的發布商
廣告空間來源指定目標 - 包含「類型」為「多媒體」、「影片」或「音訊」時為必填string, list可

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

此欄使用 Display & Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID 和 Display & Video 360 API TargetingOption 指定類型的資源 ID TARGETING_TYPE_SUB_EXCHANGE。

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

指定廣告空間來源 - 排除否string, list可

指定要在指定目標中排除的廣告空間來源、廣告交易平台和子廣告交易平台清單。

此欄使用 Display & Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID 和 Display & Video 360 API TargetingOption 指定類型的資源 ID TARGETING_TYPE_SUB_EXCHANGE。

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

廣告空間來源指定目標 - 指定新廣告交易平台否字串可設定指定新廣告交易平台。
  • 是
  • 否
包含私人交易群組指定目標否string, list可

要納入指定目標的分組交易 ID 清單。如要查看分組交易 ID，請前往「我的廣告空間」頁面的「分組交易」專區，或是委刊項、廣告訂單和廣告活動中的「廣告空間來源」設定「群組」專區。

清單格式 = (DealGroupId、DealGroupId 等)。這份清單會依遞增順序產生。

指定時段否string, list可

ID 清單，其中每個時段 ID 都是以整數格式建立，且每個時段 ID 都採用以下格式：
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ 開始 * 100
+ 結束

base_day-monday: 0=星期一.0, 1=95.0，第 40.05.0 的開始，第 40.0 步，代表整數 5.0，第 19 個實體。




「當地」)。現有實體的時區不會變更。

這份清單會依遞增順序產生。

時段指定時區如果包含「指定時段」，則為必填欄位。字串可指定時段時使用的時區。
  • 局部
  • 廣告客戶
TrueView 委刊項只能設為「廣告主」。
指定環境否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可要指定的影片廣告播放器大小清單。選取一個或多個可接受的值：
  • 不明
  • 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; To ;Include 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; include unknown True/False} = 前 10%;41-50%;true;
5:0%_5:%
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 降低 50%

指定客層家長狀態可string, list可要指定的家長狀態清單。選取一個或多個可接受的值。
  • 父項
  • 無子女
  • 不明
連線速度指定否字串可指定特定連線速度。選取下列其中一個可接受的值：
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
指定通訊業者 - 包含否string, list可

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

這一欄會針對「TARGETING_TYPE_CARRIER_AND_ISP」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

指定通訊業者 - 排除否string, list可

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

這一欄會針對「TARGETING_TYPE_CARRIER_AND_ISP」指定類型使用 Display & Video 360 API TargetingOption 資源 ID。

名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。

出價調節係數否string, 清單清單可這個項目的所有出價調節係數。清單格式 = (列類型;條件 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;非父項;1.0);
household_income客層家庭收入百分位數範圍。可接受的值為：
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 降低 50%
  • 不明
例如：(household_income;前 10%;1.0);(household_income;Unknown;2.5);
device_type裝置類型裝置類型。可接受的值為：
  • 電腦
  • 智慧型手機
  • 平板電腦
  • 連網電視
  • 連接的裝置
例如：(device_type;Computer;1.0);(device_type;平板電腦;2.5);
geo地理位置地理位置位置 ID，例如(geo;2840;1.0)；
private_deal私人交易私人交易指定目標編號，例如：(private_deal;1016301;1.0)；
private_deal私人交易私人交易指定目標編號，例如：(private_deal;1016301;1.0)；
public_exchange公開交換公開廣告交易平台 ID，例如(public_Exchange;17;1.0);
unclassified_exchange未分類廣告交易平台未分類的廣告交易平台目標 ID (= 5000 + Exchange_id)。例如：(unified_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 出價策略類型」值或非 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 排除類別指定目標否string, list可要排除的類別清單。名單格式 = 遊戲、悲劇和衝突等
  • 內嵌影片
  • 直播
  • 遊戲
  • 多個家庭
  • 所有目標對象
  • 低齡學童
  • 青少年
  • 成人
  • 尚未分級
TrueView 內容篩選器否字串可TrueView 內容篩選器。
  • 有限制
  • Standard
  • 已展開
TrueView 廣告空間來源指定目標否string, list可要納入的 TrueView 廣告空間來源清單
  • YouTube
  • Google TV
  • 影片合作夥伴
TrueView 第三方可視度供應商編輯現有 TrueView 委刊項時才需要string, 清單清單可評估 TrueView 委刊項可視度的第三方供應商。如果在建立 TrueView 委刊項時留空，且已在廣告客戶層級啟用預設的可視度供應商，系統將在建立委刊項時啟用廣告客戶層級預設供應商。
  • 無
  • Moat
  • DoubleVerify
  • Integral Ad Science
TrueView 第三方可視度報表 ID如果第三方可視度供應商不是「無」，則為是。字串可第三方可視度供應商使用的 ID，用於識別特定報表的事件。如果此欄顯示空字串，系統就會將報表 ID 設為空白。
TrueView 第三方品牌安全供應商編輯現有 TrueView 委刊項時才需要string, 清單清單可評估 TrueView 委刊項的品牌安全的第三方供應商。如果在建立 TrueView 委刊項時將此欄位留空，且在廣告客戶層級啟用了預設的品牌安全供應商，系統將在建立委刊項時啟用廣告客戶層級的預設供應商。
  • 無
  • DoubleVerify
  • Integral Ad Science
  • Zefr
TrueView 第三方品牌安全報表 ID是，當第三方品牌安全供應商不是「無」時是如此。字串可第三方品牌安全供應商使用的 ID，用來識別特定報表的事件。如果此欄顯示空字串，系統就會將報表 ID 設為空白。
TrueView 第三方觸及率供應商更新現有 TrueView 委刊項時才需要string, 清單清單可評估 TrueView 委刊項的觸及率的第三方供應商。如果在建立 TrueView 委刊項時將此欄位留空，且在廣告客戶層級啟用了預設的觸及率供應商，系統將在建立委刊項時啟用廣告客戶層級預設供應商。
  • 無
  • Nielsen
  • Comscore
  • Kantar
  • Gemius
  • Video Research
  • 媒體範圍
  • AudienceProject
  • iSpot 電視
  • VideoAmp
TrueView 第三方觸及報表 ID是，當第三方觸及供應商不是「無」時是如此。字串可第三方觸及率供應商使用的 ID，用來識別特定報表的事件。如果此欄顯示空字串，系統就會將報表 ID 設為空白。
TrueView 第三方品牌提升供應商更新現有 TrueView 委刊項時才需要string, 清單清單可評估 TrueView 委刊項的品牌提升的第三方供應商。如果在建立 TrueView 委刊項時將此欄位留空，且廣告客戶層級已啟用預設的品牌提升供應商，系統將在建立委刊項時啟用廣告客戶層級預設供應商。
  • 無
  • Kantar
  • Dynata
  • Intage
  • Nielsen
  • Macromill
TrueView 第三方品牌提升報表 ID是，但第三方品牌提升供應商不是「無」時是如此。字串可第三方品牌提升供應商使用的 ID，用來識別特定報表的事件。如果此欄顯示空字串，系統就會將報表 ID 設為空白。
TrueView 目標頻率計數是，當委刊項子類型為「目標頻率」時是整數可針對目標頻率類型 YouTube 委刊項設定的目標頻率計數。這個欄位的值只能設為 2、3 或 4。如果是非目標頻率類型的 YouTube 委刊項，這個欄位必須留空。
TrueView 目標頻率時間範圍是，當委刊項子類型為「目標頻率」時是字串可目標頻率類型 YouTube 委刊項的目標頻率時間範圍。這個欄位目前只能設為「每週」。如果 YouTube 委刊項不是目標頻率類型，則這個欄位應留空。
  • 每週
TrueView 影片廣告空間控管如果 TrueView 委刊項子類型為「觸及」，且使用動態內和 Shorts 廣告，則為「是」string, list可這個委刊項的影片廣告空間控制項。選取一個或多個可接受的廣告格式值：
  • 串流內廣告
  • 動態內廣告
  • Shorts