結構化資料 - 7.1 版 - 廣告活動

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

欄位必填類型可寫入說明
廣告活動 ID只有在編輯現有廣告活動時才需要整數否廣告活動的數字 ID 值。如果留空，系統會建立新廣告活動 ID 並指派專屬 ID。建立新廣告活動時，您也可以選擇使用自訂 ID，將廣告訂單指派給新廣告活動。自訂 ID 的格式為「ext <自訂 ID>」，例如 ext123。檔案上傳並處理完畢後，系統會將所有自訂 ID 替換成 DBM 指派的 ID，並根據自訂 ID 建立物件關聯 (例如廣告訂單與廣告活動)。
廣告主 ID是整數否廣告主的數字 ID 值。必須是現有的有效廣告主 ID
名稱是字串是項目的名稱。
時間戳記編輯現有項目時必須提供整數否項目的時間戳記。系統會使用這項資訊，確認該項目從下載後到上傳前的這段期間沒有任何異動。
狀態是字串是項目的狀態設定。
  • 有效
  • 已暫停
  • 已封存
廣告活動目標是字串是選取適用的廣告活動目標：
  • 提高品牌或產品知名度
  • 吸引客戶在線上採取動作或造訪網站
  • 提高實體或店內銷售
  • 提升應用程式安裝或參與次數
廣告活動目標主要成效指標是字串是選取適用的廣告活動目標主要成效指標：
  • 千次曝光出價
  • 可視百分比
  • 單次有聲播放且看完的曝光出價
  • 單次轉換出價
  • 單次點擊出價
  • 點閱率
  • 其他
廣告活動目標主要成效指標價值是float是廣告活動目標主要成效指標的正數。如果是廣告活動目標的「可視百分比」和「點擊率」KPI，請以百分比形式輸入這個欄位的值，例如 80% 請輸入「80」。如果是「其他」KPI，這個欄位是目標的簡短說明。
廣告素材類型是字串、清單是預計使用的廣告素材類型清單。
  • 多媒體
  • 影片
  • 音訊
廣告活動預算否float是廣告活動的正數預算金額。由於一律是貨幣預算，因此一律為貨幣金額的浮點數。貨幣會以廣告主的貨幣顯示，並以標準單位表示 (而非以貨幣單位的 1/1,000,000 表示)
廣告活動開始日期是字串是廣告活動的開始日期，格式為 MM/DD/YYYY HH:mm
廣告活動結束日期否字串是廣告活動的結束日期，格式為 MM/DD/YYYY HH:mm
已啟用頻率是字串是啟用/停用廣告活動的曝光次數展示頻率上限。
  • TRUE
  • FALSE
頻率曝光「啟用頻率」為「TRUE」時為必填整數是正整數值，代表特定頻率金額的曝光次數，也就是「在 y 期間內顯示 x 次曝光」中的 x。
頻率週期「啟用頻率」為「TRUE」時為必填字串是指定展示頻率上限的時間範圍單位。
  • 分鐘
  • 小時
  • 天
  • 週
  • 月
頻率金額「啟用頻率」為「TRUE」時為必填整數是展示頻率週期類型必須為正整數，也就是「在 y 週期內顯示 x 次曝光」中的 y。

展示頻率上限時間週期不得超過 30 天。
廣告活動預算區隔否字串、清單清單是廣告活動的預算區隔組合。清單格式 = (ID；名稱；類型；金額；開始日期；結束日期；外部預算來源；外部預算 ID；月結單分組 ID；Prisma 客戶代碼；Prisma 產品代碼；Prisma 預估代碼；Prisma 類型；供應商)。

    範例「(; My Budget; IMPRESSIONS; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)」，其中未提供 ID 和結束日期。
    下表列出可接受的值：

    資料欄名稱必填說明
    ID否廣告活動預算區隔的專屬 ID。編輯預算區隔時，必須提供這項資訊。如果留空，預算區隔會寫入為新區隔。
    名稱是廣告活動預算區隔的顯示名稱。
    類型是預算金額的類型。可接受的值如下：
    • 金額
    • 曝光
    金額是預算類型為正數的預算金額。這可以是簡單的整數曝光值，也可以是貨幣金額的浮點數。系統會以廣告主的貨幣顯示幣別，並以標準單位表示 (而非以 1/1,000,000 的貨幣單位表示)。
    開始日期否預算區隔檔期開始日期的時間戳記，格式為 MM/DD/YYYY HH:mm。如果未設定開始日期，欄位值會空白。
    結束日期否預算區隔檔期結束日期的時間戳記，格式為 MM/DD/YYYY HH:mm。如果未設定結束日期，欄位值會空白。
    外部預算來源是預算區隔的來源。可接受的值如下：
    • 無
    • Mediaocean
    外部預算 ID僅適用於 Mediaocean 預算區隔如果已設定，且客戶選擇在預算區隔層級結算，則系統會將這個 ID 加入所有根據這個預算區隔放送的曝光月結單。
    月結單分組 ID否如果設定了這項 ID，且客戶選擇採用預算區隔層級的帳單，系統就會將所有具有相同外部預算 ID 和月結單分組 ID 的預算區隔，彙整成一份月結單。
    Prisma 客戶代碼僅適用於 Mediaocean 預算區隔只能為 Mediaocean 預算區隔設定。Google 付款中心支援搜尋及篩選這個欄位。
    Prisma 產品代碼僅適用於 Mediaocean 預算區隔只能為 Mediaocean 預算區隔設定。Google 付款中心支援搜尋及篩選這個欄位。
    Prisma 預估代碼僅適用於 Mediaocean 預算區隔只能為 Mediaocean 預算區隔設定。Google 付款中心支援搜尋及篩選這個欄位。
    Prisma 類型僅適用於 Mediaocean 預算區隔只能為 Mediaocean 預算區隔設定。區隔的 Prisma 類型。可接受的值如下：
    • 多媒體
    • 搜尋
    • 影片
    • 音訊
    • 社群媒體
    • 費用
    Prisma 供應商僅適用於 Mediaocean 預算區隔只能為 Mediaocean 預算區隔設定。分配給這筆預算的實體 (需求端平台、網站等)
指定客層性別否字串、清單是要指定的性別清單。選取一或多個可接受的值：
  • 女性
  • 男性
  • 不明

指定客層年齡否字串、清單是指定使用者年齡範圍。選取單一年齡範圍的「從」和「到」，並指定是否要納入不明年齡 (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
  • +

指定客層：家庭收入否字串、清單是指定家庭收入範圍。選取單一「Top_of_Range」收入範圍和單一「Bottom_of_Range」收入範圍，並指定是否要納入收入不明的家庭 (true/false)，即可指定起/迄範圍。請參閱可接受的 Top_of_Range/Bottom_of_Range 範圍清單。
範例 1：如要指定家庭收入排行前 10% 至 50% 的家庭，並納入家庭收入不明的家庭，請指定以下格式：{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true;
範例 2：如要只指定家庭收入排行後 50% 的家庭，並排除家庭收入不明的家庭，請指定以下格式：{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true;
Top_of_Range/Bottom_of_Range 的可接受值：
  • 前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 後 50%

指定客層：家長狀態是字串、清單是要指定的家長狀態清單。選取一或多個可接受的值。
  • 父項
  • 無子女
  • 不明

指定地理區域 - 納入否字串、清單是

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

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

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

指定地理區域 - 排除否字串、清單是

要從指定目標中排除的地理區域清單。

這個資料欄會使用 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.)。這份清單會依遞增數字順序產生。

數位內容標籤 - 排除否字串、清單是要排除的數位內容標籤清單。清單格式 = (G；PG；等等)。
  • G
  • PG
  • T
  • MA
  • ？

品牌安全敏感度設定否字串是選擇敏感度設定，根據周邊內容的主題封鎖廣告空間。
  • 不要封鎖
  • 使用 Campaign Manager 360 驗證功能
  • 使用自訂溫度

品牌安全自訂設定如果「品牌安全自訂設定」為「使用自訂」，則必須填寫此欄位字串、清單是如果品牌安全感應設定為「使用自訂」，請指定標準內容分類器清單。例如 (Sexual;Alcohol;Tobacco;etc.)。
  • 色情內容
  • 詆毀
  • 下載及分享
  • 武器
  • 賭博
  • 暴力
  • 性暗示
  • 不雅用語
  • 酒精飲料
  • 毒品
  • 菸草
  • 政治
  • 宗教
  • 悲劇
  • 交通事故
  • 敏感的社會議題
  • 駭人的內容

第三方驗證服務否字串是第三方驗證服務供應商。
  • 無
  • Integral Ad Science
  • DoubleVerify
  • Adloox

第三方驗證服務供應商標籤否字串、清單是如果「第三方驗證服務」不是「無」，請指定所選供應商支援的標籤清單。

指定可視度 Active View否字串是指定預期可視度百分比。百分比會以浮點數表示。{0.1、0.2、0.3、0.4、0.5、0.6、0.7、0.8、0.9} 其中之一

位置指定目標 - 顯示在畫面上否字串、清單是指定畫面上的廣告顯示位置。選取一或多個可接受的值：
  • 不需捲動位置
  • 需捲動位置
  • 不明

位置指定目標 - 畫面上的影片否字串、清單是指定畫面上的影片廣告位置。選取一或多個可接受的值：
  • 不需捲動位置
  • 需捲動位置
  • 不明

指定位置 - 內容中的顯示位置否字串、清單是要指定的多媒體廣告內容位置。選取一或多個可接受的值：
  • 文章內
  • 動態內廣告
  • 橫幅內
  • 插頁式廣告
  • 不明

指定位置 - 影片在內容中的位置否字串、清單是要指定的影片廣告內容位置。選取一或多個可接受的值：
  • 文章內
  • 動態內廣告
  • 橫幅內
  • 插頁式廣告
  • 不明串流外
  • 片頭廣告
  • 片中廣告
  • 片尾
  • 不明串流內廣告

指定廣告空間來源 - 授權賣方選項「類型」為「多媒體」、「影片」或「音訊」時為必填字串是設定指定授權直接賣方、授權直接賣方和經銷商，或是授權賣方 + 未知。「授權直接」是指只指定授權賣方。「授權直接賣方和經銷商」是指指定授權賣方和經銷商。「授權和未參與計畫的發布商」：指定授權賣方、經銷商和不明賣方。
  • 授權直接賣方
  • 授權直接賣方和經銷商
  • 授權發布商和未參與計畫的發布商

指定廣告空間來源 - 包含否字串、清單是

要納入指定目標的廣告空間來源、廣告交易平台和子廣告交易平台清單。

這個資料欄會使用 Display & Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID，以及指定目標類型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

指定廣告空間來源 - 排除否字串、清單是

要排除在指定目標中的廣告空間來源、廣告交易平台和子廣告交易平台清單。

這個資料欄會使用 Display & Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID，以及指定目標類型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 資源 ID。

清單格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

指定廣告空間來源 - 指定新廣告交易平台否字串是設定指定新的廣告交易平台。
  • 是
  • 否

指定環境否字串、清單是要指定的環境清單。選取一或多個可接受的值。請注意，您必須先選取「網頁」，才能選取「未進行最佳化的網頁」。
  • 網頁
  • 未進行最佳化
  • 應用程式