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

如需格式說明，請參閱總覽。

欄位	必要	類型	可寫入	說明
廣告活動 ID	僅在編輯現有廣告活動時提供	整數	否	廣告活動的數字 ID 值。如果留空，系統會建立新的廣告活動 ID 並指派專屬 ID。建立新廣告活動時，您也可以選擇使用自訂 ID，以便將廣告訂單指派給新的廣告活動。自訂 ID 的格式為「ext <自訂 ID>」，例如 ext123。檔案上傳並處理完畢後，系統會將所有自訂 ID 替換成 DBM 指派的 ID，並根據自訂 ID 將物件 (例如廣告訂單至廣告活動) 建立關聯。
廣告主 ID	是	整數	否	廣告客戶的數字 ID 值。這必須是有效的現有廣告客戶 ID
名稱	是	字串	是	項目的名稱。
時間戳記	編輯現有項目時的必要項目	整數	否	項目的時間戳記，可讓系統確認該項目下載和上傳之間的期間沒有任何變更。
狀態	是	字串	是	項目的狀態設定。 線上 已暫停 已封存
廣告活動目標	是	字串	是	選取其中一個適用的廣告活動目標： 提高品牌或產品知名度 吸引顧客在線上採取動作或造訪網站 提高實體或店內銷售 提升應用程式安裝或參與次數
廣告活動目標 KPI	是	字串	是	選取其中一個適用的廣告活動目標 KPI： 千次曝光出價 可視 % 單次有聲播放且看完的曝光出價 單次轉換出價 單次點擊出價 點閱率 其他
廣告活動目標 KPI 價值	是	float	是	廣告活動目標 KPI 的正數。如果是廣告活動目標 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。
廣告活動預算區隔	否	字串, 清單清單	是	廣告活動的預算區隔組合。名單格式 = (ID；名稱；類型；金額；開始日期；結束日期；外部預算來源；外部預算 ID；Psma 客戶代碼； Prisma 客戶代碼； Prisma 預估代碼； Prisma 類型；供應商)；)。 範例：「(; My Budget; Impression; 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。未設定的結束日期會以空白欄位值表示。 外部預算來源 是 預算區隔的來源。可接受的值為： 無 媒體 外部預算 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 預算區隔。分配給此預算的實體 (需求端平台、網站等)
指定客層性別	否	字串，清單	是	要指定的性別清單。選取一或多個可接受的值： 女性 男性 不明
指定客層年齡	否	字串，清單	是	指定使用者年齡層。您可以選取單一「從年齡」搭配單一「至年齡」，並選擇是否要納入不明年齡的「是/否」，藉此指定此範圍。請參閱接受的「寄件者/年齡」清單。 範例 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;加入未知的家庭 True/False} = 只指定較低家庭收入的前 10%； 前 10% 11-20% 21-30% 31-40% 41-50% 降低 50%
指定客層指定家長狀態	是	字串，清單	是	要指定的家長狀態清單。選取一或多個可接受的值。 有子女 無子女 不明
指定地理區域 - 包含	否	字串，清單	是	要納入指定目標的地理區域清單。 此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_GEO_REGION。 名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。
指定地理區域 - 排除	否	字串，清單	是	要在指定目標中排除的地理區域清單。 此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_GEO_REGION。 名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。
指定語言 - 包含	否	字串，清單	是	要納入指定目標的語言清單。 此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_LANGUAGE。 名單格式 = (指定 Option.targetingOptionId、 TargetingOption.targetingOptionId 等))。這份清單是依數字遞增順序產生。
指定語言 - 排除	否	字串，清單	是	要在指定目標中排除的語言清單。 此欄使用 Display & Video 360 API TargetingOption 資源 ID 做為指定類型 TARGETING_TYPE_LANGUAGE。 名單格式 = (指定 Option.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} 其中之一
指定位置 - 顯示在螢幕上	否	字串，清單	是	指定螢幕上的多媒體廣告位置。選取一或多個可接受的值： 不需捲動位置 需捲動位置 不明
指定位置 - 畫面上的影片	否	字串，清單	是	在螢幕上指定影片廣告位置。選取一或多個可接受的值： 不需捲動位置 需捲動位置 不明
指定位置 - 內容中多媒體廣告位置	否	字串，清單	是	要指定的多媒體廣告內容位置。選取一或多個可接受的值： 文章內 動態內廣告 橫幅內 插頁式 不明
指定位置 - 內容中的影片位置	否	字串，清單	是	要指定的影片廣告內容位置。選取一或多個可接受的值： 文章內 動態內廣告 橫幅內 插頁式 不明的串流外廣告 片頭廣告 片中廣告 片尾廣告 不明的串流內廣告
指定廣告空間來源 - 授權賣方選項	當「類型」為「多媒體」、「影片」或「音訊」時必須提供	字串	是	此設定可指定授權直接賣方、授權直接賣方和經銷商，或授權賣方 + 不明。「授權直接交易」則只會指定授權賣方。「授權直接賣方和經銷商」是指指定授權賣方和經銷商為目標。「授權賣方」和「未參與此計劃的發布商」是指指定授權賣方、經銷商和不明賣方。 授權直接賣方 授權直接賣方和經銷商 授權發布商和未參與計畫的發布商
指定廣告空間來源 - 包含	否	字串，清單	是	要納入指定目標的廣告空間來源、廣告交易平台和子廣告交易平台清單。 此欄會使用指定類型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID 和 Display & Video 360 API TargetingOption 資源 ID。 清單格式 = (InventorySource.inventorySourceId;exchangeId; TargetingOption.targetingOptionId; ))
指定廣告空間來源 - 排除	否	字串，清單	是	要在指定條件中排除的廣告空間來源、廣告交易平台和子廣告交易平台清單。 此欄會使用指定類型 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API InventorySource 資源 ID、已發布的廣告交易平台 ID 和 Display & Video 360 API TargetingOption 資源 ID。 清單格式 = (InventorySource.inventorySourceId;exchangeId; TargetingOption.targetingOptionId; ))
指定廣告空間來源 - 指定新的廣告交易平台	否	字串	是	設定為指定新的廣告交易平台。 對 錯
指定環境	否	字串，清單	是	要指定的環境清單。選取一或多個可接受的值。請注意，您必須先選取「網路」，才能選取「網頁未最佳化」。 網站 未最佳化的網站 應用程式