結構化資料 - 第 7 版 - 媒體產品

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

欄位必要類型可寫入說明
產品 ID否整數否媒體產品的數字 ID 值。
企劃書 ID否整數否媒體提案的數字 ID 值。
廣告活動 ID否整數否
名稱是字串是項目的名稱。
類型否字串否媒體產品類型。
  • 公開競價多媒體
  • 公開競價音訊
  • 公開競價影片
  • 影片觀看廣告活動
  • YouTube TrueView 串流內廣告
  • YouTube TrueView 探索
  • YouTube TrueView 串場廣告
  • YouTube TrueView 觸及
  • YouTube 音訊
  • 目標頻率串場廣告可略過
  • 目標頻率不可略過
  • 目標頻率可略過
  • 目標頻率串場廣告
  • Google 首選串場廣告
  • Google 首選 Shorts
  • Google 首選長
  • 標準預訂 Shorts
  • 標準預訂 (長版)
  • 不可略過的串流內廣告
  • 私人 (發布商)
  • 私人 (廣告空間來源)
  • 私人 (協商)
開始日期否字串否媒體產品的開始日期，格式為 MM/DD/YYYY HH:mm
結束日期否字串否媒體產品的結束日期，格式為 MM/DD/YYYY HH:mm
預算否float否媒體產品的正預算金額。由於一定是貨幣預算，因此一律以貨幣金額表示。貨幣會以廣告客戶的貨幣單位顯示 (而非採用 1/1,000,000 秒的貨幣單位)
已啟用展示頻率是字串是
展示頻率「已啟用展示頻率」為「TRUE」時必填整數是指定頻率金額中曝光次數的正整數金額，也就是「在 y 期間顯示 x 次曝光」中的 x。
頻率週期「已啟用展示頻率」為「TRUE」時必填字串是
  • 分鐘
  • 小時
  • 天數
  • 週
  • 月
  • 效期
頻率金額「已啟用展示頻率」為「TRUE」時必填整數是
指定地理區域 - 包含否字串，清單是

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

此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_GEO_REGION。

名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。

指定語言 - 包含否字串，清單是

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

此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_LANGUAGE。

名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。

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

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

此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_LANGUAGE。

名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。

指定頻道 - 包含否字串，清單是

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

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

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

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

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

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

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

指定類別 - 包含否字串，清單是

要納入指定目標的類別清單。此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_CATEGORY。

名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。

指定類別 - 排除否字串，清單是要在指定目標中排除的類別清單。此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_CATEGORY。

名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。

指定目標對象 - 包含否字串，配對清單是

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

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

對於第一方目標對象名單，每個目標對像都會以 一對 FirstAnd 第三方 Audience.firstAndthirdPartyAudienceId 和回訪率設定列出。組合為 (1;1d;)，其中 1d 是代表 1 天回訪率的回訪率範例。第三方目標對象無法使用回訪率，因此名單格式為 (3;)；(4;)；如要以「AND」和「OR」一組目標對象提供，請參考以下範例：如要結合使用及不含回訪率：'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。換句話說 (名單 1 包含回訪率 1 天「或」名單 2，回訪率為 365 天) AND (名單 3 未指定回訪率，或名單 4 包含 5 分鐘的回訪率「或」名單 5，所有使用者)。

有效的回訪率值如下：

  • 全部
  • 1m
  • 5 分鐘
  • 10 分鐘
  • 15 分鐘
  • 30 分鐘
  • 1 小時
  • 2 小時
  • 3 小時
  • 6 小時
  • 12 小時
  • 1 天
  • 2 天前
  • 3D
  • 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;);".

有效的回訪率值如下：

  • 全部
  • 1m
  • 5 分鐘
  • 10 分鐘
  • 15 分鐘
  • 30 分鐘
  • 1 小時
  • 2 小時
  • 3 小時
  • 6 小時
  • 12 小時
  • 1 天
  • 2 天前
  • 3D
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28 天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
指定興趣相似目標對象和潛在目標消費者 - 包含否字串，清單是
指定興趣相似目標對象和潛在目標消費者 - 排除否字串，清單是
指定客層性別否字串，清單是要指定的性別清單。選取一或多個可接受的值：
  • 女性
  • 男性
  • 不明
指定客層年齡否字串，清單是指定使用者年齡層。您可以選取單一「從年齡」搭配單一「至年齡」，並選擇是否要納入不明年齡的「是/否」，藉此指定此範圍。請參閱接受的「寄件者/年齡」清單。
範例 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
  • +
指定客層指定家長狀態是字串，清單是要指定的家長狀態清單。選取一或多個可接受的值。
  • 有子女
  • 無子女
  • 不明
指定裝置 - 包含否字串，清單是

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

這一欄會根據以下指定類型採用 Display & Video 360 API TargetingOption 資源 ID：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。

影片播放器大小指定否字串，清單是要指定的影片廣告播放器大小清單。選取一或多個可接受的值：
  • 不明
  • small
  • large
  • HD 高畫質
不公開 - 賣方名稱否字串否交易中的發布商名稱。這個欄位僅適用於私人媒體產品。
不公開 - 訂單 ID否字串否保證交易的訂單 ID。這個欄位僅適用於私人媒體產品。
私人 - 廣告空間來源 ID否字串否廣告空間來源的 DBM ID。這個欄位僅適用於私人媒體產品。