結構化資料 - 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 或「與廣告訂單相同」使用與上層廣告訂單相同的結束日期。
預算類型字串指定預算是以金額或曝光為基礎。如果這個項目的 IO 已啟用自動預算分配功能,您可以將其設為「自動」允許 DBM 自動為這個項目預算。
  • 金額
  • 曝光
  • 無限制
  • 自動
  • TrueView 預算
預算金額「類型」時必填是「Display」或「影片」或「音訊」float這個預算類型的預算金額為正值。這可以是簡單的整數曝光值,也可以是貨幣金額的浮點值。貨幣會以廣告客戶的貨幣單位顯示,而不是以 1/1,000,000s 的貨幣單位顯示。若為「自動」預算分配功能已設定所需項目,您可以指定最低支出金額 (例如「支出至少」這個金額)。
使用速度字串用於支出使用速度金額的時間範圍。
  • 每日
  • 每月
  • 檔期
TrueView 委刊項只能設為「每日」或「Flight」
使用速度字串這個項目的使用速度速率。
  • 盡快
  • 平均
  • 向前
TrueView 委刊項只能設為「盡快」或「平均」
使用速度金額「類型」時必填是「Display」或「影片」或「音訊」「類型」時必填為「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與合作夥伴收益模式對應的正浮點值。只有在已指定「夥伴收益模式」欄的情況下才適用。
轉換計算方式類型「類型」時必填是「Display」或「影片」或「音訊」或「TrueView」字串選擇要納入計算的轉換類型。
  • 全部計入
  • 計算點擊後轉換
  • 計數百分比
轉換計數位置「類型」時必填是「Display」或「影片」或「音訊」或「TrueView」float指定「計數 %」的百分比轉換計數類型。將 % 的格式設定為一個浮點值 (3.123% = 3.123),且精度設有千位數 (小數點後 3 位)。
轉換 Floodlight 活動 IDstring, 清單清單

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

此欄使用「多媒體和」Video 360 API FloodlightActivity 資源 ID 和評估作業,單位為瀏覽後和點擊後回溯期的分鐘數。

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

主要歸因模式 ID整數相關委刊項使用的歸因模式 ID。
費用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 費用必填 (是)
整合代碼字串用於追蹤的選用程式碼。
詳細資料字串以字串格式輸入項目詳細資料。
出價策略類型「類型」時必填是「Display」或「影片」或「音訊」字串 選取其中一個適用的出價策略:
  • 最小化: 用完預算,同時將單次獲得費用/單次點擊出價降到最低
  • 最大化:使用整筆預算,同時盡量提高展示值或品質展示次數
  • 突破:達成或超越單次轉換出價/單次點擊出價目標
  • 最佳化千次可視曝光出價:最佳化 X 的千次可視曝光出價
  • 固定:指定 X 的固定出價
出價策略價值除非「出價策略類型」為必填欄位是「最小化」、「最大化」或「類型」為「TrueView」float請選擇「最佳化千次可視曝光出價」或「固定策略」類型做為目標出價。
請注意,「最小化」出價策略類型不需要出價策略值或「最大化」
出價策略單位「出價策略類型」為必填欄位是「Beat」「最小化」或「最大化」字串為「節奏」、「最小化」或「最大化」策略類型選取相應的單元:
  • 單次轉換出價
  • 單次點擊出價
  • 自訂曝光次數值/費用
  • 完整影音
  • IVO_TEN
  • AV_VIEWED
出價策略數量限制「類型」時必填是「Display」或「影片」或「音訊」float設定「不要超過」千次曝光出價金額。如果值為 0,則「請勿超過」尚未啟用。只有在出價策略為「最小化」、「最大」時才能使用或「Beat」。
套用交易底價「出價策略類型」為必填欄位是「最小化」或「最大化」字串是否優先處理交易,而非公開競價廣告空間
  • TRUE
  • FALSE
演算法 ID「出價策略單位」為必填欄位自訂曝光次數價值/費用。整數將出價策略單元設為自訂曝光次數時,必須使用這個對應的演算法 ID。成本/費用。
廣告素材分配string, list

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

此欄使用「多媒體和」Video 360 API Creative 資源 ID。

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

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

例如:(123;CM789;)

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

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_GEO_REGION 的資源 ID。

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

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

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_GEO_REGION 的資源 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」或「公里」;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

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_LANGUAGE 的資源 ID。

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

指定語言 - 排除string, list

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_LANGUAGE 的資源 ID。

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

指定裝置 - 包含string, list

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

此欄使用「多媒體和」以下指定類型的 Video 360 API TargetingOption 資源 ID:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

指定裝置 - 排除string, list

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

此欄使用「多媒體和」以下指定類型的 Video 360 API TargetingOption 資源 ID:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

指定瀏覽器 - 包含string, list

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_BROWSER 的資源 ID。

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

指定瀏覽器 - 排除string, list

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_BROWSER 的資源 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

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

此欄使用「多媒體和」Video 360 API Channel 資源 ID。

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

指定頻道 - 排除string, list

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

此欄使用「多媒體和」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

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_APP_CATEGORY 的資源 ID。

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

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

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_APP_CATEGORY 的資源 ID。

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

指定類別 - 包含string, list

要納入指定目標的類別清單。此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_CATEGORY 的資源 ID。

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

指定類別 - 排除string, list要在指定目標中排除的類別清單。此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_CATEGORY 的資源 ID。

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

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

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為「TARGETING_TYPE_CONTENT_GENRE」的資源 ID

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

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

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為「TARGETING_TYPE_CONTENT_GENRE」的資源 ID

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

指定關鍵字 - 包含string, list

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

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

指定關鍵字 - 排除string, list

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

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

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

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

此欄使用「多媒體和」Video 360 API NegativeKeywordList 資源 ID。

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

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

自 2024 年 9 月 30 日起,最佳化指定目標對像功能將不再支援特定出價策略。這個值將從「TRUE」更新設為「FALSE」如果:
  • 出價策略類型是「最佳化千次可視曝光出價」
  • 出價策略類型為「上限」和「出價策略單元」是「CIVA」、「IVO_TEN」或「AV_VIEWED」
指定目標對象 - 包含字串,配對清單

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

此欄使用「多媒體和」Video 360 API FirstAndThirdPartyAudience 資源 ID。

如果是第一方目標對象名單,每個目標對像都會列為一組第一方目標對象。firstAndThirdPartyAudienceId 和回訪率設定。組合為 (1;1d;),其中 1d 是代表 1 天回訪率的取樣率範例。第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。收件者和「或」目標對象群組,請按照以下範例操作:如要合併與/不含回訪率的組合:'(1;1d;);(2;365d;));(3;);(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 天
指定目標對象 - 排除字串,配對清單

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

此欄使用「多媒體和」Video 360 API FirstAndThirdPartyAudience 資源 ID。

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

名單格式 = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; Recency optional;); (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

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

您可以從多媒體廣告和Video 360 介面。

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

興趣相似 &潛在目標消費者指定目標 - 排除string, list

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

您可以從多媒體廣告和Video 360 介面。

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

合併指定目標對象string, list

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

此欄使用「多媒體和」Video 360 API CombinedAudience 資源 ID。

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

指定自訂名單string, list

要指定的自訂名單清單。

此欄使用「多媒體和」Video 360 API CustomList 資源 ID。

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

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

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

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

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

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

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

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

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

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

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

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

指定時段string, list










介於 0 到 95 之間的整數,代表 15 分鐘
start <end
如果是新實體,時間則會以使用者的時區(即「當地」)。現有實體的時區不會變更。

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

時段指定時區「指定時段」時為必填已包含在內。字串指定時段時使用的時區。
  • 局部
  • 廣告主
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;收件者:包含 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) 或通訊業者清單。

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_CARRIER_AND_ISP 的資源 ID。

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

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

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

此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_CARRIER_AND_ISP 的資源 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私人交易私人交易指定目標 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)。例如:(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 出價策略類型為「目標單次轉換出價」或 100%,則可用出價調整幅度為「提高」的出價調整幅度:0;而「減少」:100%
TrueView 桌機出價調整幅度選項字串可以是「提高」或「調低」
  • 增加
  • 縮短
TrueView 桌機出價調整幅度百分比如果 TrueView 出價策略類型為「目標單次轉換出價」或「盡量爭取轉換」時為「是」整數出價調整幅度,提高廣告在桌機上顯示的機率。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「減少」:[0;90%] 或 100%。
如果 TrueView 出價策略類型為「目標單次轉換出價」或 100%,則可用出價調整幅度為「提高」的出價調整幅度:0;而「減少」:100%
TrueView 平板電腦出價調整幅度選項字串可以是「提高」或「調低」
  • 增加
  • 縮短
TrueView 平板電腦出價調整幅度百分比如果 TrueView 出價策略類型為「目標單次轉換出價」或「盡量爭取轉換」時為「是」整數出價調整幅度,提高廣告在平板電腦上顯示的機會。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「減少」:[0;90%] 或 100%。
如果 TrueView 出價策略類型為「目標單次轉換出價」或 100%,則可用出價調整幅度為「提高」的出價調整幅度:0;而「減少」:100%
TrueView 連網電視出價調整幅度選項字串可以是「提高」或「調低」
  • 增加
  • 縮短
TrueView 連網電視出價調整幅度百分比如果 TrueView 出價策略類型為「目標單次轉換出價」或「盡量爭取轉換」時為「是」整數出價調整幅度,可提高廣告在連網電視上放送的機率。出價調整幅度選項為「提高」可採用的調整幅度:[0;900%];以及「減少」:[0;90%] 或 100%。
如果 TrueView 出價策略類型為「目標單次轉換出價」或 100%,則可用出價調整幅度為「提高」的出價調整幅度:0;而「減少」:100%
TrueView 排除類別指定目標string, list要排除的類別清單。名單格式 = 遊戲;悲劇和衝突;等。

自 2024 年 9 月 30 日起,這個資料欄將不再提供下列選項:「內嵌影片」、「直播」、「所有觀眾」、「學齡前兒童」、「青少年」、「成人」和「未分級」。
  • 內嵌影片
  • 直播
  • 遊戲
  • 多個家庭
  • 所有目標對象
  • 低齡學童
  • 青少年
  • 成人
  • 尚未分級
TrueView 內容篩選器字串TrueView 內容篩選器。
  • 有限制
  • 標準
  • 已展開
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