結構化資料 - v7 - 委刊項

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

欄位必要類型可寫入說明
委刊項 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 預算
預算金額「類型」為「多媒體」、「影片」或「音訊」時為必填float預算類型的正預算金額。可以是單純的整數曝光值,也可以是貨幣金額的浮點值。貨幣會以標準單位顯示 (而非貨幣單位的 1/1,000,000s)。如果項目已設定「自動」預算分配,您可以指定支出下限 (例如「至少支出」這個金額)。
使用速度字串支出使用速度金額的時間範圍。
  • 每天
  • 每月
  • 檔期
TrueView 委刊項只能設為「每日」或「檔期」
放送速度字串此項目的使用速度速率。
  • 盡快
  • 平均
  • 向前
TrueView 委刊項只能設為「盡快」或「平均」
使用速度金額「類型」為「多媒體」、「影片」或「音訊」時為必填。如果「類型」為「TrueView」且「使用速度」為「每日」,則為必填。float使用速度類型所設時間範圍的支出金額。
已啟用頻率字串啟用/停用委刊項的曝光型展示頻率上限。
  • TRUE
  • FALSE
頻率曝光「啟用頻率」為「TRUE」時為必填整數指定頻率金額中曝光次數的正整數,也就是「在 y 期間顯示 x 次曝光」中的 x。
頻率週期「啟用頻率」為「TRUE」時為必填字串指定展示頻率上限的時間範圍單位。對於 TrueView 委刊項,系統支援的時段為「天」、「週」、「月」。
  • 分鐘
  • 小時
  • 天數
  • 個月
  • 發布至今
頻率金額「啟用頻率」為「TRUE」時為必填整數頻率時段類型時間長度的正整數,也就是「顯示 x 期間的曝光次數 x 曝光次數」中的 y。TrueView 委刊項不支援此金額。
已啟用 TrueView 觀看頻率「類型」為「TrueView」時為必填字串啟用/停用 TrueView 委刊項的觀看式展示頻率上限
  • TRUE
  • FALSE
TrueView 觀看頻率曝光「已啟用 TrueView 觀看頻率」為「TRUE」時,必填整數TrueView 觀看次數的正整數,也就是「顯示這段期間的 x 觀看次數」中的 x
TrueView 觀看頻率期間「已啟用 TrueView 觀看頻率」為「TRUE」時,必填字串為 TrueView 觀看的展示頻率上限指定時間範圍單位
  • 天數
  • 個月
合作夥伴收益模式字串夥伴收益模式是控制出價管理工具如何計算收益的機制。您可以使用夥伴收益模式追蹤服務費的成本加價金額。加入「合作夥伴收益模式」欄時,必須指定「合作夥伴收益金額」欄。
  • TMCM - 媒體費用總額加成
  • MCM - 媒體費用加成
  • 千次曝光出價 - 千次曝光出價
合作夥伴收益金額只有在已指定「合作夥伴收益模式」欄時,才需要填寫。float與夥伴收益模式相對應的正浮點值。只有在已指定「合作夥伴收益模式」欄的情況下,才能使用這個資料欄。
轉換計數類型當「類型」為「多媒體」、「影片」、「音訊」或「TrueView」時為必填字串選擇要計算的轉換類型。
  • 全部計入
  • 點擊後計數
  • 計數 %
轉換計數 Pct當「類型」為「多媒體」、「影片」、「音訊」或「TrueView」時為必填float指定「計數 %」的轉換計數類型 %。將 % 的格式設定為浮點值 (3.123% = 3.123),精確度限制在數千位 (小數點後 3 位)。
轉換 Floodlight 活動 IDstring, 清單

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

這一欄會使用 Display & Video 360 API FloodlightActivity 資源 ID 和評估資料,以分鐘為單位,計算瀏覽後和點擊後回溯期。

清單格式清單 = ((FloodlightActivity.FlolightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.FloodActivityId; 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必要 (True)
千次曝光出價TrustMetrics不允許 (留白)
千次曝光出價Integral Ad Science 影片許可 (是/否)
千次曝光出價MOAT 影片不允許 (留白)
媒體Display & Video 360 費用必要 (True)
媒體媒體費用資料不允許 (留白)
媒體Scibids 費用必要 (True)
整合代碼字串用於追蹤的選用程式碼。
詳細說明字串字串格式的項目詳細資料。
出價策略類型「類型」為「多媒體」、「影片」或「音訊」時為必填字串 選取其中一個適用的出價策略:
  • 最小化:用完預算,同時降低單次轉換出價/單次點擊出價
  • 盡量提高:用完預算,同時盡量提高曝光值或品質
  • 贏過:達成或超越單次動作出價/單次點擊出價目標
  • 最佳化千次可視曝光出價:針對 X 的千次可視曝光出價進行最佳化
  • 固定出價:指定 X 的固定出價
出價策略價值除非「出價策略類型」為「最小化」、「最大化」或「類型」為「TrueView」,否則必須提供必要項目float選取「最佳化千次可視曝光出價」、「固定策略類型」:選擇目標出價的值。
請注意,「最小化」或「最大」出價策略類型不需要出價策略價值
出價策略單元「出價策略類型」為「Beat」、「最小化」或「最大」時必填字串針對「 Beat」、「最小化」或「最大化」策略類型,請選取對應的單位:
  • 單次轉換出價
  • 單次點擊出價
  • 自訂曝光次數值/費用
  • 持續整合 (CIVA)
  • IVO_TEN
  • AV_VIEWED
出價策略數量不超出上限「類型」為「多媒體」、「影片」或「音訊」時為必填float設定「不要超過」千次曝光出價。如果為 0,則未啟用「不要超過」。只有在「出價策略」為「最小化」、「最大化」或「Beat」時,才能使用這項功能。
套用交易底價「出價策略類型」為「最小化」或「最大化」時為必填字串是否要優先用於交易,而非公開競價廣告空間
  • TRUE
  • FALSE
演算法 ID如為「出價策略單元」自訂曝光次數值/費用,則為必填。整數如果您將出價策略單元設為自訂曝光次數值/費用,就必須使用這個對應的演算法 ID。
廣告素材分配字串,清單

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

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

清單格式 = (Creative.creativeId; Creative.creativeId 等)。這份清單是按數字遞增順序產生。

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

例如:(123;CM789;)。

指定地理區域 - 包含字串,清單

要納入指定目標的地理位置清單。

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

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這份清單是按數字遞增順序產生。

指定地理區域 - 排除字串,清單

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

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

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這份清單是按數字遞增順序產生。

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

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

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

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這份清單是按數字遞增順序產生。

指定語言 - 排除字串,清單

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

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

清單格式 = (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; 等等)。這份清單是按數字遞增順序產生。

指定瀏覽器 - 包含字串,清單

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

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

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這份清單是按數字遞增順序產生。

指定瀏覽器 - 排除字串,清單

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

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

清單格式 = (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 等)。這份清單是按字母順序遞增產生。

應用程式組合指定目標 - 包含字串,清單

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

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

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

指定應用程式集合 - 排除字串,清單

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

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

清單格式 = (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_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
指定目標對象 - 包含字串,配對清單

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

這一欄使用 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 天)「且」(名單 3 未指定回訪率)「或」名單 4 表示回訪率為 5 分鐘,或名單 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 天
  • 120 天
  • 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 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
興趣相似和潛在目標消費者指定目標 - 包含字串,清單

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

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

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

興趣相似和潛在目標消費者 - 排除字串,清單

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

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

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

合併指定目標對象字串,清單

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

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

清單格式 = (MergedAudience.combinedAudienceId、MergedAudience.combinedAudienceId; 等等)。這份清單是按數字遞增順序產生。

自訂名單指定字串,清單

要指定的自訂名單清單。

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

清單格式 = (CustomList.customListId、CustomList.customListId; 等)。這份清單是按數字遞增順序產生。

指定廣告空間來源 - 授權賣方選項「類型」為「多媒體」、「影片」或「音訊」時為必填字串設定可指定授權直接賣方、授權直接賣方和經銷商,或授權賣方和不明。「授權直接」表示只會指定授權賣方。「授權直接賣方和經銷商」是指指定授權賣方和經銷商。「授權賣方和未參與此計畫的發布商」是指將指定授權賣方、經銷商和不明賣方。
  • 授權直接賣方
  • 授權直接賣方和經銷商
  • 授權發布商和未參與此計畫的發布商
指定廣告空間來源 - 包含「類型」為「多媒體」、「影片」或「音訊」時為必填字串,清單

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

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

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

指定廣告空間來源 - 排除字串,清單

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

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

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

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

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

清單格式 = (DealGroupId、DealGroupId 等)。這份清單是按數字遞增順序產生。

時段指定目標字串,清單

ID 清單,其中每個時段 ID 的結尾為 5.0 的整數 (以 090 為單位,從 0 開始的整數,如 0.0 開始的整數:
daypart_id = base_dayparting_id,以 0 為 5;如為 0,則以 008 到 60% 表示):
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ 開始 * 100
+ 結束

base_dayparting_id = 300000
days_since_monday: 0=星期一


「當地」)。如果是現有實體,時區將維持不變。

這份清單是按數字遞增順序產生。

時段指定時區加入「時段指定」時必須提供。字串指定時段時要使用的時區。
  • 地區性
  • 廣告客戶
TrueView 委刊項只能設為「廣告主」。
指定環境字串,清單要指定的環境清單。請選取一或多個可接受的值。請注意,您必須先選取 [網站],才能選取 [網站未最佳化]。
  • Web
  • 網站未進行最佳化
  • 應用程式
已啟用可視度 Omid 指定目標字串只能指定可透過開放 Measurement 標準評估的曝光。
  • 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
指定客層性別字串,清單要指定的性別清單。請選取一或多個可接受的值:
  • 女性
  • 男性
  • 不明
指定客層年齡字串,清單指定使用者年齡層。指定「出發」/「出發」範圍時,請選取一個「開始」和「單一年齡」,並選擇是否要納入「是」或「否」這個未知年齡。請參閱可接受的出發/年齡清單。
範例 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 收入範圍,並指定「來源」/「目標」範圍。請參閱可接受的 Top_of_Range/Bottom_of_Range 清單;範例 1:如要指定前 10% 到 50% 的家庭,並納入收入不明的家庭,請指定 {Top_of_Range; Bottom_of_Range;納入不明 True/False} = 前 10%/41-50% 的未知家庭數;True_5


  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 降低 50%

指定客層家長狀態字串,清單要指定的家長狀態清單。請選取一或多個可接受的值。
  • 有子女
  • 無子女
  • 不明
指定連線速度字串指定特定連線速度。請選取一個可接受的值:
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
指定通訊業者 - 包含字串,清單

要指定的 ISP 或電信業者清單。

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

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這份清單是按數字遞增順序產生。

指定通訊業者 - 排除字串,清單

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

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

清單格式 = (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;Male;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;不明;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)。例如(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 排除類別字串,清單要排除的類別清單。名單格式 = 遊戲、悲劇和衝突等
  • 內嵌影片
  • 直播
  • 遊戲
  • 多個家庭
  • 所有目標對象
  • 青少年
  • 青少年
  • 成人
  • 尚未分級
TrueView 內容篩選器字串TrueView 內容篩選器。
  • 有限制
  • Standard
  • 已展開
TrueView 廣告空間來源指定字串,清單要納入的 TrueView 廣告空間來源清單
  • YouTube
  • 影片合作夥伴
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 委刊項,這個欄位應留空。
  • 每週