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

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

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