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

這個 SDF 版本仍處於 Beta 版階段，且僅有部分使用者提供此功能。至於未宣布的 Beta 版變更，則可能會變更至 Beta 版。

SDF v8 支援需求開發資源 (Beta 版)。需求開發委刊項、廣告群組和廣告僅供註冊 Beta 版的使用者使用。

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

欄位	必填	類型	可寫入	說明
廣告活動 ID	只有在編輯現有廣告活動時才需要填寫	整數	否	廣告活動的數字 ID 值。如果留空，系統會建立新的廣告活動 ID，並指派專屬 ID。建立新廣告活動時，您可以視需要使用自訂 ID，將廣告訂單指派給新的廣告活動。自訂 ID 的格式為「ext[自訂 ID]」，例如 ext123。檔案上傳並處理完畢後，系統會將所有自訂 ID 替換成 DBM 指派的 ID，並根據自訂 ID 將物件 (例如廣告訂單與廣告活動) 建立關聯。
廣告主 ID	是	整數	否	廣告主的數字 ID 值。必須是有效的現有廣告主 ID
名稱	是	字串	是	項目名稱。
時間戳記	編輯現有項目時必填	整數	否	項目的時間戳記，由系統用於驗證該項目從下載和上傳期間的未變更。
狀態	是	字串	是	項目的狀態設定。 有效 已暫停 已封存
廣告活動目標	是	字串	是	選取其中一個適用的廣告活動目標： 提高品牌或產品知名度 吸引客戶在線上採取動作或造訪網站 提高實體或店內銷售 提升應用程式安裝或參與次數
廣告活動目標主要成效指標	是	字串	是	選取其中一個適用的廣告活動目標 KPI： 千次曝光出價 可視度百分比 單次有聲播放且看完的曝光出價 單次轉換出價 單次點擊出價 點閱率 其他
廣告活動目標 KPI 值	是	float	是	廣告活動目標 KPI 的正整數。廣告活動目標 KPI「可視百分比」和「點閱率」請以百分比輸入這個欄位的值，例如80% 則應輸入「80」。以 KPI「其他」來說，這個欄位是目標的簡短說明。
廣告素材類型	是	string, list	是	預計使用的廣告素材類型清單。 多媒體 影片 音訊
廣告活動預算	否	float	是	廣告活動的預算金額為正值。它一定採用金額做為預算，因此一定是以浮動值表示。貨幣會以廣告客戶的貨幣單位顯示 (而非 1/1,000,000s 的貨幣單位)
廣告活動開始日期	是	字串	是	廣告活動的開始日期，格式為 MM/DD/YYYY HH:mm
廣告活動結束日期	否	字串	是	廣告活動的結束日期，格式為 MM/DD/YYYY HH:mm
已啟用頻率	是	字串	是	啟用/停用廣告活動的曝光展示頻率上限。 TRUE FALSE
頻率曝光	如果「啟用展示頻率」為「TRUE」，則為必填屬性	整數	是	指定展示頻率金額中的曝光次數正整數，也就是「在 y 期間內顯示 x 次曝光」中的 x。
頻率週期	「已啟用頻率」時為必填為「TRUE」	字串	是	指定展示頻率上限的時間範圍單位。 分鐘 小時 天 週 月 效期
頻率	如果「啟用展示頻率」為「TRUE」，則為必填	整數	是	展示頻率週期類型時間長度的正整數值，即「顯示 Y 期間的 x 次曝光次數」中的 y。
廣告活動預算區隔	否	string, 清單清單	是	廣告活動的預算區隔組合。清單格式 = (ID；名稱；類型；金額；開始日期；結束日期；外部預算來源；外部預算 ID；發票分組 ID；Prist 客戶代碼；Prisma 產品代碼； Prisma 評估代碼；Prisma 類型；供應商)；)。 例如「(; MyBudget; ImpressionS; 234; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId」、「Client; Product; Estimate; DISPLAY; MySupplier;)」其中未提供 ID 和結束日期。 請參閱下表，瞭解可接受的值： 資料欄名稱 必填 說明 ID 否 廣告活動預算區隔的專屬 ID。編輯預算區隔時，必須提供這個欄位。如果留空，系統會將預算區隔寫入為新區隔。 名稱 是 廣告活動預算區隔的顯示名稱。 類型 是 預算金額的類型。可接受的值為： 金額 曝光 金額 是 這個預算類型的預算金額為正值。這可以是簡單的整數曝光值，也可以是貨幣金額的浮點值。貨幣會以廣告客戶的貨幣單位顯示，而不是以 1/1,000,000s 的貨幣單位顯示。 開始日期 否 預算區隔的檔期開始日期時間戳記，格式為 MM/DD/YYYY HH:mm。未設定的開始日期會以空白欄位值表示。 結束日期 否 預算區隔的檔期結束日期時間戳記，格式為 MM/DD/YYYY HH:mm。未設定的結束日期會以空白欄位值表示。 外部預算來源 是 預算區隔的來源。可接受的值如下： 無 Mediaocean 外部預算 ID 僅適用於 Mediaocean 預算區隔 設定後，如果客戶選擇採用預算區隔層級的帳單，則使用此預算區隔放送的所有曝光都會納入這個 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;收件者：包含 Unknown True/False} = 18;55;true； 範例 2：如果只指定年滿 35 歲的使用者，但排除不明的年齡層，請指定下列 = 35;+;false;。 可接受的「寄件者」值： 18 25 35 45 55 65 可接受的「To」值： 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;包含不明 True/False 值} = 前 10%；41-50%;true； 範例 2：如果只指定低收入的 50% 家庭，並排除收入不明的家庭，請指定 {Top_of_Range;Bottom_of_Range;包含不明 True/False 值} = 低於 50%；低於 50%;true； Top_of_Range/Bottom_of_Range 的值： 前 10% 11-20% 21-30% 31-40% 41-50% 後 50%
指定客層家長狀態	是	string, list	是	要指定的家長狀態清單。選取一個或多個可接受的值。 有子女 無子女 不明
指定地理區域 - 包含	否	字串、清單	是	要納入指定目標的地理區域清單。 此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_GEO_REGION 的資源 ID。 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。
指定地理區域 - 排除	否	字串、清單	是	要在指定目標中排除的地理位置清單。 此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_GEO_REGION 的資源 ID。 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這個清單會依遞增的數字順序產生。
指定語言 - 包含	否	字串、清單	是	要納入指定目標的語言清單。 這個欄位會使用 Display & Video 360 API TargetingOption 資源 ID 來指定目標類型 TARGETING_TYPE_LANGUAGE。 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這份清單會依遞增順序產生。
指定語言 - 排除	否	字串、清單	是	要在指定目標中排除的語言清單。 此欄使用「多媒體和」Video 360 API TargetingOption 指定類型為 TARGETING_TYPE_LANGUAGE 的資源 ID。 名單格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。這個清單會依遞增的數字順序產生。
數位內容標籤 - 排除	否	字串、清單	是	要排除的數位內容標籤清單。名單格式 = (G;PG 等)。 G PG T MA ？
品牌安全敏感度設定	否	字串	是	選擇靈敏度設定，即可根據周圍內容的主題封鎖廣告空間。 不要封鎖 使用 Campaign Manager 360 驗證功能 使用自訂選項
品牌安全自訂設定	「品牌安全自訂設定」時為必填是「使用自訂」	字串、清單	是	如果「品牌安全敏感度」設定設為「使用自訂」，請指定標準內容分類項清單。例如 (情色；酒精飲料；菸草等)。 色情內容 貶抑用語 下載和分享 武器 賭博 暴力 性暗示 不雅用語 酒精飲料 藥物 菸草 政治 宗教 悲劇 交通事故 敏感的社會議題 駭人的內容
第三方驗證服務	否	字串	是	第三方驗證服務供應商。 無 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，以及 Display &Video 360 API TargetingOption 指定類型的「TARGETING_TYPE_SUB_EXCHANGE」資源 ID。 清單格式 = (InventorySource.inventorySourceId; ExchangeId; TargetingOption.targetingOptionId; 等)
指定廣告空間來源 - 排除	否	字串、清單	是	指定要在指定目標中排除的廣告空間來源、廣告交易平台和子廣告交易平台清單。 此欄使用「多媒體和」Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID，以及 Display &Video 360 API TargetingOption 指定類型的「TARGETING_TYPE_SUB_EXCHANGE」資源 ID。 清單格式 = (InventorySource.inventorySourceId; ExchangeId; TargetingOption.targetingOptionId; 等)
廣告空間來源指定目標 - 指定新廣告交易平台	否	字串	是	設定指定新廣告交易平台。 是 否
指定環境	否	字串、清單	是	要指定的環境清單。請選取一或多個可接受的值。請注意，「未最佳化網頁」您必須先選取 [網頁] 才能選取。 網路 網站未進行最佳化 應用程式