結構化資料 - 7.1 版 - 媒體產品

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

欄位必填類型可寫入說明
產品 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」整數
指定地理區域 - 包含string, list

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

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

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

指定語言 - 包含string, list

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

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

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

指定語言 - 排除string, list

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

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

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

指定頻道 - 包含string, list

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

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

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

指定頻道 - 排除string, list

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

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

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

指定類別 - 包含string, list

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

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

指定類別 - 排除string, list要在指定目標中排除的類別清單。此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_CATEGORY 的資源 ID。

名單格式 = (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 天
指定目標對象 - 排除字串,配對清單

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

此欄使用「多媒體和」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 天
興趣相似 &潛在目標消費者定位 - 包含string, list
興趣相似 &潛在目標消費者指定目標 - 排除string, list
指定客層性別string, list要指定的性別清單。選取一個或多個可接受的值:
  • 女性
  • 男性
  • 不明
指定客層年齡層string, list指定使用者年齡層。選取一個「從年齡」和「從年齡」一個「到年齡」,並選擇是否要納入未知年齡的 true/false,藉此指定介於/寄送範圍。查看可接受的年齡範圍清單。
範例 1:如要指定 18 到 55 歲並納入未知年齡,請指定以下格式:{From;收件者:包含 Unknown True/False} = 18;55;true;
範例 2:如果只指定年滿 35 歲的使用者,但排除不明的年齡層,請指定下列 = 35;+;false;。
可接受的「寄件者」值:
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

以下為可接受的值:
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
指定客層家長狀態string, list要指定的家長狀態清單。選取一個或多個可接受的值。
  • 有子女
  • 無子女
  • 不明
指定裝置 - 包含string, list

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

此欄使用「多媒體和」以下指定類型的 Video 360 API TargetingOption 資源 ID:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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