上次更新時間：2023 年 10 月 18 日
本指南將逐步說明從舊版遷移至結構化資料檔案 (SDF) v7 的程序，以及必要和建議進行的變更，協助您改善整合作業。
請參閱版本資訊一文，瞭解 v6 與 7 版的差異完整清單。
遷移結構化資料檔案版本
如要從舊版遷移至結構化資料檔案 v7，您必須指定新版本、更新部分現有資料欄的 ID 空間，以及新增與新資料欄的整合功能。
更新結構化資料檔案版本
如要更新至新的結構化資料檔案版本，您需要更新 Display & Video 360 API 中指派給上層合作夥伴和廣告客戶資源的版本，以及個別下載工作。
更新父項資源設定
預設的結構化資料檔案版本是在合作夥伴和廣告客戶資源層級設定。透過介面或 API 下載結構化資料檔案時，系統會使用這個版本做為預設版本。
在介面中設定
- 夥伴層級
- 前往所需的合作夥伴。前往左側導覽面板的「Partner Settings」選單，然後前往「Basic Details」頁面。將「結構化資料檔案」部分中的 SDF 版本設定更新為 v7。
- 廣告主層級
- 前往所需的廣告客戶頁面。前往左側導覽面板的「廣告客戶設定」選單下方的「基本詳細資料」頁面。將「結構化資料檔案」部分中的 SDF 版本設定更新為 v7。如果預設版本是在夥伴層級設定，可能無法編輯這項設定。
在 API 中設定
- 廣告主層級
- 發出
advertisers.patch要求，將dataAccessConfig.sdfConfig.sdfConfig.version更新為SDF_VERSION_7，並視需要將dataAccessConfig.sdfConfig.overridePartnerSdfConfig更新為True。
在 API 中更新 sdfdownloadtasks.create 要求
使用 Display & Video 360 API 提出 sdfdownloadtasks.create 要求時，請將要求主體的 version 欄位設為 SDF_VERSION_7。
更新必要欄中的 ID
在第 7 版中，部分資料欄使用的 ID 空間已更新，可從已淘汰的「實體讀取檔案」產品中分離結構化資料檔案，並且進一步與支援的工具 (例如 Display & Video 360 API) 保持一致。
本節列出使用與 v6 不同 ID 的每一欄，以及如何擷取新值參照資訊的操作說明。
廣告訂單
| v7 資料欄遷移操作說明 | |
|---|---|
|
應用程式指定目標 - 排除 應用程式指定目標 - 包含 |
這些欄已更新，採用格式為「 應用程式平台可透過字串值識別。應用程式 ID 是由相關平台提供的 ID，例如 Android Play 商店的軟體包 ID，或 Apple App Store 中的應用程式 ID。 |
|
指定瀏覽器 - 排除 指定瀏覽器 - 包含 |
這個資料欄已更新，現在會使用指定類型
使用 |
|
指定通訊業者 - 排除 指定通訊業者 - 包含 |
這個資料欄已更新，現在會使用指定類型
使用 |
|
指定頻道 - 排除 指定頻道 - 包含 |
此欄已更新為使用 Display & Video 360 API
使用 |
|
指定裝置 - 排除 指定裝置 - 包含 |
這個資料欄已更新，採用下列指定類型中 Display & Video 360 API
使用 |
| 評估 DAR 管道 |
此欄已更新為使用 Display & Video 360 API
使用 |
指定網站 - 排除 指定網站 - 包含 |
這個資料欄已更新，可透過網址字串辨識網站。 |
委刊項
| v7 資料欄遷移操作說明 | |
|---|---|
|
應用程式指定目標 - 排除 應用程式指定目標 - 包含 |
這些欄已更新，採用格式為「 應用程式平台可透過字串值識別。應用程式 ID 是由相關平台提供的 ID，例如 Android Play 商店的軟體包 ID，或 Apple App Store 中的應用程式 ID。 |
| 出價調節係數 |
這個資料欄已更新，現在會針對app 和 site 資料列類型使用新的條件 ID。 app 列類型已更新，針對條件 ID，使用應用程式平台和應用程式平台 ID 的串連字串值 (以冒號分隔)。應用程式平台可透過字串值識別。應用程式 ID 是由相關平台提供的 ID，例如 Android Play 商店的軟體包 ID，或 Apple App Store 中的應用程式 ID。 site 資料列類型已更新，現在會使用網址字串做為條件 ID。 |
|
指定瀏覽器 - 排除 指定瀏覽器 - 包含 |
這個資料欄已更新，現在會使用指定類型
使用 |
|
指定通訊業者 - 排除 指定通訊業者 - 包含 |
這個資料欄已更新，現在會使用指定類型
使用 |
|
指定頻道 - 排除 指定頻道 - 包含 |
此欄已更新為使用 Display & Video 360 API
使用 |
|
指定裝置 - 排除 指定裝置 - 包含 |
這個資料欄已更新，採用下列指定類型中 Display & Video 360 API
使用 |
指定網站 - 排除 指定網站 - 包含 |
這個資料欄已更新，可透過網址字串辨識網站。 |
媒體產品
| v7 資料欄遷移操作說明 | |
|---|---|
|
指定頻道 - 排除 指定頻道 - 包含 |
此欄已更新為使用 Display & Video 360 API
使用 |
| 指定裝置 - 包含 |
這個資料欄已更新，採用下列指定類型中 Display & Video 360 API
使用 |
新增與自 v6 版起新增的資料欄整合
如要從第 6 版遷移至第 7 版，您必須在相關檔案中加入下列資料欄：
| 檔案類型 | 欄 |
|---|---|
| 委刊項 | TrueView 目標頻率計數 |
| 委刊項 | TrueView 目標頻率時間範圍 |
| YouTube 廣告群組 | 最佳化指定目標對象 |
如果是從舊版結構化資料檔案版本遷移，請參閱結構化資料檔案版本資訊，瞭解目前版本與 SDF v6 版之間新增的其他資料欄。
其他異動
在第 7 版中，我們還進行了一些重大變更，可協助您簡化整合流程，並且不再使用已淘汰的實體讀取檔案做為參考。
新資料欄排序方式
SDF 第 7 版會在檔案產生時，保證特定清單資料欄可保持穩定排序。藉此提升行為的一致性和審查便利性。系統不會在檔案上傳時強制執行這種排序，但會在產生更新後的檔案時套用。
請參閱 v7 版本資訊，查看目前以遞增數值或字母順序產生的完整資料欄清單。
新的 ID 參考建議
我們已更新一或多個資料欄的定義，以移除對已淘汰實體讀取檔案的參照，並建議改用 ID 查詢的其他方式。
下列資料欄傳回的值與 SDF 第 6 版不同，但我們建議您更新整合項目，使用新的建議方法擷取 ID，您可以在 v7 欄說明中找到這項資訊。
| 檔案類型及其資料欄 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| 廣告訂單 |
|
|||||||||||||||||||||
| 委刊項 |
|
|||||||||||||||||||||
| 媒體產品 |
|
|||||||||||||||||||||
| YouTube 廣告群組 |
|
|||||||||||||||||||||