結構化資料 - v9.1 - 媒體產品

如要瞭解格式,請參閱總覽

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

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

這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID,指定目標類型為 TARGETING_TYPE_GEO_REGION

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

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

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

這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID,指定目標類型為 TARGETING_TYPE_LANGUAGE

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

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

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

這個資料欄會使用 Display & Video 360 API TargetingOption 資源 ID,指定目標類型為 TARGETING_TYPE_LANGUAGE

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

指定頻道 - 納入字串、清單

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

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

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

頻道指定目標 - 排除字串、清單

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

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

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

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

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

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

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

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

指定目標對象 - 納入字串、成對清單的清單

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

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

如果是第一方目標對象名單,每個目標對象都會列為一組 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和回訪率設定。一對是 (1;1d;),其中 1d 是代表 1 天近期的樣本近期。第三方目標對象無法使用近期搜尋,因此名單格式為 (3;);(4;);。如要「AND」和「OR」目標對象群組,請參考以下範例:如要合併有和沒有近期性限制的配對,請使用「((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));」。也就是說,(名單 1,近期 1 天內曾造訪網站的使用者 OR 名單 2,近期 365 天內曾造訪網站的使用者) AND (名單 3,未指定近期造訪網站的使用者 OR 名單 4,近期 5 分鐘內曾造訪網站的使用者 OR 名單 5,所有使用者)。

有效近來性值如下:

  • 全部
  • 1 個月
  • 5 分鐘
  • 10 分鐘
  • 15 分鐘
  • 30 分鐘
  • 1 小時
  • 2 小時
  • 3h
  • 6 小時
  • 12 小時
  • 1 天
  • 2 天前
  • 3 天
  • 5 天
  • 7 天
  • 10d
  • 14 天
  • 15 天
  • 21 天
  • 28 天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120d
  • 180d
  • 270 天
  • 365 天
指定目標對象 - 排除字串、成對清單的清單

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

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

如果目標對象名單是第一方目標對象名單,則每個目標對象都會列為 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和回訪率設定的配對。一對是 (1;1d;),其中 1d 是代表 1 天近期的樣本近期。不過,第三方目標對象無法使用回訪率,因此名單格式為 (3;);(4;);。

名單格式 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)
範例:「(1;1d;);(2;);」。

有效近來性值如下:

  • 全部
  • 1 個月
  • 5 分鐘
  • 10 分鐘
  • 15 分鐘
  • 30 分鐘
  • 1 小時
  • 2 小時
  • 3h
  • 6 小時
  • 12 小時
  • 1 天
  • 2 天前
  • 3 天
  • 5 天
  • 7 天
  • 10d
  • 14 天
  • 15 天
  • 21 天
  • 28 天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120d
  • 180d
  • 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

「收件者」可接受的值:
  • 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; etc.)。這份清單會依遞增數字順序產生。

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