結構化資料檔案 (SDF) 是採用特殊格式的 CSV 檔案。可讓您在 Display & Video 360 中大量擷取、建立及編輯資源。下載、編輯及重新上傳 SDF，即可大量更新資源。
Display & Video 360 使用者介面支援下載及上傳結構化資料檔案。Display & Video 360 API 支援下載結構化資料檔案。
格式
SDF 使用兩種基本格式之一，分別是「標準」和「QA」：
- 你可以下載及上傳標準格式的檔案。這些檔案中的資料可能會使用數字 ID，確保上傳時的準確度。您可能需要參考資訊才能解讀資料。
- 你可以下載 QA 格式的檔案。這些檔案提供的資料與標準格式檔案相同，但使用更易於解讀的值。舉例來說，部分資料欄可能會使用顯示名稱取代 ID。這個格式專用的資料欄會使用「Qa」後置字元。
檔案類型
SDF 支援七種資源類型。每種資源類型都有專屬檔案類型和欄結構。支援的資源類型包括：
- 廣告活動
- 廣告訂單
- 委刊項
- 廣告群組
- 廣告
- 廣告空間來源
- 媒體產品
只有「委刊項」和「廣告群組」檔案類型支援「問答」格式。
我們會定期發布新的 SDF 版本，並淘汰舊版。新版本會更新檔案類型欄結構。如有必要，新版結構化資料檔案會在推出時附上遷移指南。
下載錯誤
下載 SDF 時可能會發生兩種錯誤：檔案產生錯誤和略過的資源。
檔案產生錯誤
SDF 生成作業可能會因錯誤而終止。如果使用 Display & Video 360 API 時產生失敗，完成的工作會使用 Status 物件設定 error 欄位。Status 物件會包含詳述錯誤原因的訊息。
如要進一步瞭解這些錯誤，請參閱錯誤和警告指南頁面。
略過的錯誤
SDF 不支援所有資源子類型。如果資源無法納入 SDF，下載內容會包含「已略過」檔案 (例如 SDF-LineItems-Skipped.csv)。這個檔案的結構為兩欄。第一欄會指出遭略過的資源。第二欄則說明排除原因。
上傳檔案
使用 Display & Video 360 使用者介面上傳結構化資料檔案，建立新資源或更新現有資源。
如要盡量減少使用 SDF 更新或建立資源時發生的錯誤，請按照下列步驟操作：
- 使用 Display & Video 360 API 或使用者介面下載結構化資料檔案。
- 修改現有檔案項目，更新現有資源。
- 新增檔案項目，建立新資源。
- 移除所有非新項目或更新項目的項目。這樣做可縮減檔案大小，並避免無意間更新。
- 在 Display & Video 360 使用者介面上傳檔案。
上傳並處理 SDF 後，即可下載 SDF-ResultFile.zip 檔案。這個 ZIP 檔案可能包含下列兩種檔案：
SDF-{ResourceType}-Updated-ResultFile.csv，其中列出成功更新或建立的資源。SDF-{ResourceType}-Failed-ResultFile.csv，其中列出失敗的作業和相關錯誤訊息。
ZIP 檔案可能包含一或兩個檔案。