如要進一步瞭解格式,請參閱總覽。
欄位 | 必填 | 類型 | 可寫入 | 說明 | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
廣告活動 ID | 僅在編輯現有廣告活動時需要 | 整數 | 否 | 廣告活動的數字 ID 值。如果留空,系統會建立新的廣告活動 ID 並指派專屬 ID。建立新的廣告活動時,您可以選擇使用自訂 ID,將廣告訂單指派給新的廣告活動。自訂 ID 的格式為「ext <自訂 ID>」,例如 ext123。檔案上傳並處理完畢後,系統會將所有自訂 ID 替換成 DBM 指派的 ID,並根據自訂 ID 將物件 (例如廣告訂單與廣告活動) 建立關聯。 | |||||||||||||||||||||||||||||||||||||||||||||
廣告主 ID | 是 | 整數 | 否 | 廣告主的數字 ID 值。必須是有效的現有廣告主 ID | |||||||||||||||||||||||||||||||||||||||||||||
名稱 | 是 | 字串 | 是 | 項目名稱。 | |||||||||||||||||||||||||||||||||||||||||||||
時間戳記 | 編輯現有項目時必須提供 | 整數 | 否 | 項目的時間戳記,系統會使用這項資訊,確認該項目從下載後到上傳前的這段期間沒有任何異動。 | |||||||||||||||||||||||||||||||||||||||||||||
狀態 | 是 | 字串 | 是 | 項目的狀態設定。
| |||||||||||||||||||||||||||||||||||||||||||||
廣告活動目標 | 是 | 字串 | 是 | 選取其中一個適用的廣告活動目標:
| |||||||||||||||||||||||||||||||||||||||||||||
廣告活動目標主要成效指標 | 是 | 字串 | 是 | 選取適用的廣告活動目標主要成效指標:
| |||||||||||||||||||||||||||||||||||||||||||||
廣告活動目標主要成效指標值 | 是 | float | 是 | 廣告活動目標 KPI 的正整數。針對廣告活動目標 KPI「可視度百分比」和「點擊率」,請輸入這個欄位的百分比值,例如 80% 可輸入為「80」。如果 KPI 是「其他」,這個欄位則是目標的簡短說明。 | |||||||||||||||||||||||||||||||||||||||||||||
廣告素材類型 | 是 | 字串、清單 | 是 | 預計使用的廣告素材類型清單。
| |||||||||||||||||||||||||||||||||||||||||||||
廣告活動預算 | 否 | float | 是 | 廣告活動的正數預算金額。由於預算一律以貨幣表示,因此金額一律為浮點值。貨幣會以廣告主的貨幣和標準單位顯示 (而非貨幣單位的 1/1,000,000) | |||||||||||||||||||||||||||||||||||||||||||||
廣告活動開始日期 | 是 | 字串 | 是 | 廣告活動的開始日期,格式為 MM/DD/YYYY HH:mm | |||||||||||||||||||||||||||||||||||||||||||||
廣告活動結束日期 | 否 | 字串 | 是 | 廣告活動結束日期,格式為 MM/DD/YYYY HH:mm | |||||||||||||||||||||||||||||||||||||||||||||
已啟用展示頻率 | 是 | 字串 | 是 | 啟用/停用廣告活動的曝光展示頻率上限。
| |||||||||||||||||||||||||||||||||||||||||||||
展示頻率 | 如果「啟用展示頻率」為「TRUE」,則為必填 | 整數 | 是 | 指定展示頻率金額中的曝光次數正整數,也就是「在 y 期間內顯示 x 次曝光」中的 x。 | |||||||||||||||||||||||||||||||||||||||||||||
展示頻率週期 | 如果「啟用展示頻率」為「TRUE」,則為必填 | 字串 | 是 | 指定展示頻率上限的時間單位。
| |||||||||||||||||||||||||||||||||||||||||||||
展示頻率 | 如果「啟用展示頻率」為「TRUE」,則為必填 | 整數 | 是 | 展示頻率期間類型 (即「在 y 期間內顯示 x 次曝光」中的 y) 的時間長度,以正整數表示。 | |||||||||||||||||||||||||||||||||||||||||||||
廣告活動預算區隔 | 否 | 字串、清單清單 | 是 | 廣告活動的預算區隔組合。清單格式 = (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 和 End Date 未提供。
| |||||||||||||||||||||||||||||||||||||||||||||
指定客層:性別 | 否 | 字串、清單 | 是 | 要指定的性別清單。請選取一或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||
指定客層:年齡 | 否 | 字串、清單 | 是 | 指定使用者年齡範圍。選取單一「從」年齡和單一「至」年齡,並指定是否要納入不明確年齡 (true/false),即可指定從/至年齡範圍。請參閱可接受的「從/到」年齡範圍清單。 範例 1:如要指定 18 到 55 歲,並納入不明年齡,請指定以下格式:{從/到; 納入不明年齡 (是/否)} = 18;55;true; 範例 2:如要只指定 35 歲以上,並排除不明年齡,請指定以下格式:= 35;+;false;。 「從」年齡範圍可接受的值:
可接受的「To」值:
| |||||||||||||||||||||||||||||||||||||||||||||
指定客層:家庭收入 | 否 | 字串、清單 | 是 | 指定家庭收入範圍。選取單一 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} = 前 10%;41-50%;true; 範例 2:如要只指定家庭收入排行後 50%,並排除收入不明確的家庭,請指定格式 {Top_of_Range; Bottom_of_Range; Include unknown True/False} = 後 50%;後 50%;true; Top_of_Range/Bottom_of_Range 可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||
指定客層:家長狀態 | 是 | 字串、清單 | 是 | 要指定的家長狀態清單。選取一或多個可接受的值。
| |||||||||||||||||||||||||||||||||||||||||||||
指定地理區域 - 納入 | 否 | 字串、清單 | 是 | 要納入指定目標的地理區域清單。清單格式 = (GeoLocation.id; GeoLocation.id; 等等)。 | |||||||||||||||||||||||||||||||||||||||||||||
指定地理區域 - 排除 | 否 | 字串、清單 | 是 | 指定要排除的地理區域清單。清單格式 = (GeoLocation.id; GeoLocation.id; 等等)。 | |||||||||||||||||||||||||||||||||||||||||||||
指定語言 - 納入 | 否 | 字串、清單 | 是 | 指定要納入指定目標的語言清單。清單格式 = (Language.id;Language.id;等)。 | |||||||||||||||||||||||||||||||||||||||||||||
指定語言 - 排除 | 否 | 字串、清單 | 是 | 指定要排除的語言清單。清單格式 = (Language.id;Language.id;等)。 | |||||||||||||||||||||||||||||||||||||||||||||
數位內容標籤 - 排除 | 否 | 字串、清單 | 是 | 要排除的數位內容標籤清單。清單格式 = (G;PG; 等等)。
| |||||||||||||||||||||||||||||||||||||||||||||
品牌安全敏感度設定 | 否 | 字串 | 是 | 選擇敏感度設定,根據周邊內容的主題封鎖廣告空間。
| |||||||||||||||||||||||||||||||||||||||||||||
品牌安全自訂設定 | 如果「品牌安全性自訂設定」為「使用自訂設定」,則必須填寫 | 字串、清單 | 是 | 如果品牌安全防護敏感度設定為「使用自訂設定」,請指定標準內容分類器清單。例如:性行為、酒精、菸草等。
| |||||||||||||||||||||||||||||||||||||||||||||
第三方驗證服務 | 否 | 字串 | 是 | 第三方驗證服務供應商。
| |||||||||||||||||||||||||||||||||||||||||||||
第三方驗證標籤 | 否 | 字串、清單 | 是 | 如果「第三方驗證服務」不是「無」,請指定所選供應商支援的標籤清單。 | |||||||||||||||||||||||||||||||||||||||||||||
指定可視度 Active View | 否 | 字串 | 是 | 指定預測可視度百分比。百分比以浮點數表示。下列其中一個值:{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} | |||||||||||||||||||||||||||||||||||||||||||||
指定位置 - 畫面上顯示 | 否 | 字串、清單 | 是 | 指定螢幕上廣告位置。請選取一或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||
指定位置 - 畫面上的影片 | 否 | 字串、清單 | 是 | 指定畫面上影片廣告的排序。請選取一或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||
指定位置 - 在內容中顯示 | 否 | 字串、清單 | 是 | 指定要放送的多媒體廣告內容位置。請選取一或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||
指定位置 - 影片內容中的影片位置 | 否 | 字串、清單 | 是 | 指定影片廣告內容位置。請選取一或多個可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||
指定廣告空間來源 - 授權賣方選項 | 如果「類型」為「多媒體」或「影片」或「音訊」,則必須提供 | 字串 | 是 | 指定目標為授權直接賣方、授權直接賣方和經銷商,或是授權賣方和不明來源。「授權直接」表示只會指定授權賣方。「授權直接賣方和經銷商」是指指定目標為授權賣方和經銷商。「授權和未參與計畫的發布商」表示會指定授權賣方、經銷商和不明賣方。
| |||||||||||||||||||||||||||||||||||||||||||||
指定廣告空間來源 - 包含 | 否 | 字串、清單 | 是 | 要納入指定目標的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。 | |||||||||||||||||||||||||||||||||||||||||||||
指定廣告空間來源 - 排除 | 否 | 字串、清單 | 是 | 在指定目標中排除的廣告空間清單。清單格式 = (InventorySource.id; InventorySource.id;)。 | |||||||||||||||||||||||||||||||||||||||||||||
指定廣告空間來源 - 指定新廣告交易平台 | 否 | 字串 | 是 | 設定指定新的廣告交易平台。
| |||||||||||||||||||||||||||||||||||||||||||||
指定環境 | 否 | 字串、清單 | 是 | 要指定的環境清單。選取一或多個可接受的值。請注意,您必須先選取「網頁」,才能選取「未進行最佳化的網頁」。
|