上次更新時間：2023 年 10 月 18 日
本指南將逐步說明如何從舊版遷移至 結構化資料檔案 (SDF) 7 版，以及您可以進行的必要和建議變更，以便進一步改善整合作業。
如需 v6 和 v7 之間的差異完整清單，請參閱版本資訊。
遷移結構化資料檔案版本
從舊版遷移至結構化資料檔案 7.0 版時，您必須指定新版、更新部分現有欄位的 ID 空間，並新增與新欄位的整合。
更新結構化資料檔案版本
如要更新至新的結構化資料檔案版本，您需要更新指派給上層合作夥伴和廣告客戶資源的版本，以及 Display & Video 360 API 中的個別下載工作。
更新上層資源設定
預設的結構化資料檔案版本會在夥伴和廣告主資源層級設定。透過介面或 API 下載結構化資料檔案時，系統會使用這個版本做為預設版本。
在介面中設定
- 合作夥伴層級
- 前往所需合作夥伴。前往左側導覽面板中的「夥伴設定」選單，然後點選「基本資料」頁面。將「結構化資料檔案」部分中的「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
使用 |
|
指定頻道 - 排除 管道指定目標 - 納入 |
這個欄已更新為使用 Display & Video 360 API
使用 |
|
指定裝置 - 排除 指定裝置 - 納入 |
這個資料欄已更新為使用 Display & Video 360 API
使用 |
| 評估 DAR 管道 |
這個欄已更新為使用 Display & Video 360 API
使用 |
指定網站 - 排除 網站指定目標 - 納入 |
這個資料欄已更新，可透過網址字串識別網站。 |
委刊項
| 資料欄的 v7 遷移操作說明 | |
|---|---|
|
指定應用程式 - 排除 應用程式指定目標 - 納入 |
這些欄已更新為使用「 應用程式平台會以字串值標示。應用程式 ID 是指相關平台提供的 ID，例如 Android 的 Play 商店的軟體包 ID，或 Apple 的 App Store 中的應用程式 ID。 |
| 出價調節係數 |
這個欄已更新，以便使用新的條件 ID 來表示「應用程式」和「網站」資料列類型。 app 資料列類型已更新，以便使用應用程式平台和應用程式平台 ID 的串連字串值 (以冒號分隔) 做為條件 ID。應用程式平台會以字串值標示。應用程式 ID 是指相關平台提供的 ID，例如 Android 的 Play 商店中的軟體包 ID，或 Apple 的 App Store 中的應用程式 ID。 site 資料列類型已更新為使用網址字串做為條件 ID。 |
|
指定瀏覽器 - 排除 指定瀏覽器 - 納入 |
這個欄已更新為使用 Display & Video 360 API
使用 |
|
指定電信業者 - 排除 指定電信業者 - 納入 |
這個欄已更新為使用 Display & Video 360 API
使用 |
|
指定頻道 - 排除 管道指定目標 - 納入 |
這個欄已更新為使用 Display & Video 360 API
使用 |
|
指定裝置 - 排除 指定裝置 - 納入 |
這個資料欄已更新為使用 Display & Video 360 API
使用 |
指定網站 - 排除 網站指定目標 - 納入 |
這個資料欄已更新，可透過網址字串識別網站。 |
媒體產品
| 資料欄的 v7 遷移操作說明 | |
|---|---|
|
指定頻道 - 排除 管道指定目標 - 納入 |
這個欄已更新為使用 Display & Video 360 API
使用 |
| 指定裝置 - 納入 |
這個資料欄已更新為使用 Display & Video 360 API
使用 |
新增自第 6 版起新增的資料欄
如果您要從 v6 遷移至 v7，請在相關檔案中新增下列資料欄：
| 檔案類型 | 欄 |
|---|---|
| 委刊項 | TrueView 目標頻率計數 |
| 委刊項 | TrueView 目標頻率時間範圍 |
| YouTube 廣告群組 | 最佳化指定目標對象 |
如果您要從先前的結構化資料檔案版本遷移，請參閱結構化資料檔案發布說明，瞭解在目前版本和 SDF 6 之間新增的其他欄。
其他異動
在第 7 版中，我們也導入了一些表面上的變更，這應該有助於簡化整合作業，並避免使用已淘汰的實體讀取檔案做為參考。
部分資料欄的新清單排序
SDF 7.0 可保證在產生檔案時，特定清單欄的排序穩定性。這麼做可讓行為更一致，也更容易進行審查。這項排序不會在檔案上傳時強制執行，而是會在產生更新檔案時套用。
請參閱 v7 版本資訊，查看現在以遞增數字或字母順序產生的完整資料欄清單。
新 ID 參照建議
我們已更新多個資料欄的定義，移除對已淘汰的實體讀取檔案的參照，並建議使用其他 ID 查詢方式。
下列欄所傳回的值與 SDF 第 6 版相同，但建議您更新整合作業，以便使用新的建議方法擷取 ID。您可以在第 7 版的欄說明中找到該方法。
| 檔案類型及其欄 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 廣告活動 |
|
|||||||||||||||||||||
| 廣告訂單 |
|
|||||||||||||||||||||
| 委刊項 |
|
|||||||||||||||||||||
| 媒體產品 |
|
|||||||||||||||||||||
| YouTube 廣告群組 |
|
|||||||||||||||||||||