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

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

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

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

這個欄位會使用指定類型 TARGETING_TYPE_GEO_REGION 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定語言 - 納入否字串、清單是

指定要納入指定條件的語言清單。

這個欄位會使用指定類型 TARGETING_TYPE_LANGUAGE 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

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

指定要排除的語言清單。

這個欄位會使用指定類型 TARGETING_TYPE_LANGUAGE 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

管道指定目標 - 納入否字串、清單是

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

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

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

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

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

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

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

指定類別 - 納入否字串、清單是

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

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定類別 - 排除否字串、清單是指定排除類別的清單。這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 指定目標類型 TARGETING_TYPE_CATEGORY。

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

指定目標對象 - 包含否字串、組合清單的清單是

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

這個欄位會使用 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 天最近活動時間 OR 名單 2 的 365 天最近活動時間) 和 (名單 3 的未指定最近活動時間 OR 名單 4 的 5 分鐘最近活動時間 OR 名單 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 天
興趣相似目標對象和潛在目標消費者指定目標 - 納入否字串、清單是
興趣相似目標對象和潛在目標消費者指定目標 - 排除否字串、清單是
指定客層：性別否字串、清單是要指定的性別清單。請選取一或多個可接受的值：
  • 女性
  • 男性
  • 不明
指定客層：年齡否字串、清單是指定使用者年齡範圍。選取單一「從」年齡和單一「至」年齡，並指定是否要納入不明確年齡 (true/false)，即可指定從/至年齡範圍。請參閱可接受的「從/到」年齡範圍清單。
範例 1：如要指定 18 到 55 歲，並納入不明年齡，請指定以下格式：{From; To ; Include unknown True/False} = 18;55;true;
範例 2：如要只指定 35 歲以上，並排除不明年齡，請指定以下格式：= 35;+;false;。
「從」年齡範圍可接受的值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

可接受的「To」值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
指定客層：家長狀態是字串、清單是要指定的家長狀態清單。選取一或多個可接受的值。
  • 有子女
  • 無子女
  • 不明
指定裝置 - 納入否字串、清單是

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

這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 來指定下列指定目標類型：

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

清單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等等)。這個清單會依遞增的數字順序產生。

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