結構化資料 - v8 - 媒體產品

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

此欄使用「多媒體和」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 天
指定目標對象 - 排除否字串，配對清單是

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

這個欄位會使用 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 歲，並納入不明年齡，請指定以下格式：{從/到; 納入不明年齡 (是/否)} = 18;55;true;
範例 2：如要只指定 35 歲以上，並排除不明年齡，請指定以下格式：= 35;+;false;。
「從」年齡範圍可接受的值：
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

以下為可接受的值：
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
指定客層家長狀態是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; 等)。這份清單會依遞增順序產生。

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