結構化資料 - v7 - 廣告活動

這個 SDF 版本已淘汰，如要繼續使用結構化資料檔案，請在 2025 年 11 月 4 日前遷移至 SDF v9。

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

欄位	必填	類型	可寫入	說明
廣告活動 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
頻率曝光次數	「Frequency Enabled」為「TRUE」時為必填	整數	是	特定頻率金額的曝光次數，以正整數表示，也就是「在 y 期間內顯示 x 次曝光」中的 x。
頻率週期	「Frequency Enabled」為「TRUE」時為必填	字串	是	指定展示頻率上限的時間範圍單位。 分鐘 小時 天 週 月
頻率金額	「Frequency Enabled」為「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 注意：Adloox 是供應商的舊名，現在稱為 Scope3。
第三方驗證服務供應商標籤	否	字串、清單	是	如果「第三方驗證服務」不是「無」，請指定所選供應商支援的標籤清單。
指定可視度 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.)
指定廣告空間來源 - 指定新廣告交易平台	否	字串	是	設定指定新的廣告交易平台。 是 否
指定環境	否	字串、清單	是	要指定的環境清單。選取一或多個可接受的值。請注意，您必須先選取「網頁」，才能選取「未進行最佳化的網頁」。 網頁 未進行最佳化的網頁 應用程式