上次更新時間：2023 年 10 月 18 日
本指南將逐步說明從舊版遷移至結構化資料檔案 (SDF) v7 的流程，以及必要和建議的調整，您可以進行這些修正，進一步最佳化整合作業。
如需 v6 和 v7 差異的詳細清單，請參閱版本資訊。
遷移結構化資料檔案版本
如要從舊版遷移至結構化資料檔案 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
在 v7 版中，部分資料欄使用的 ID 空間已更新，以便將結構化資料檔案與已淘汰的實體讀取檔案產品區分開來，並進一步與支援的工具 (例如 Display & Video 360 API) 保持一致。
本節列出每個資料欄使用與 v6 不同的 ID，以及如何擷取新值參照資訊的操作說明。
廣告訂單
| 欄 v7 遷移操作說明 | |
|---|---|
|
指定應用程式 - 排除 指定應用程式 - 包含 |
這些資料欄已更新為使用應用程式 ID，並採用「 應用程式平台是透過字串值識別。應用程式 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 是相關平台提供的 ID，例如 Android Play 商店的軟體包 ID 或 Apple App Store 的應用程式 ID。 |
| 出價調節係數 |
這個資料欄已更新，為「應用程式」和「網站」資料列類型使用新的條件 ID。 「app」資料列類型已更新，針對條件 ID 使用應用程式平台 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
使用 |
整合自 v6 以來新增的資料欄
如要從 v6 遷移至第 7 版，必須在相關檔案中加入下列資料欄：
| 檔案類型 | 資料欄 |
|---|---|
| 委刊項 | TrueView 目標頻率計數 |
| 委刊項 | TrueView 目標頻率時間範圍 |
| YouTube 廣告群組 | 最佳化指定目標對象 |
如要從先前的結構化資料檔案版本進行遷移，請參閱結構化資料檔案版本資訊，瞭解目前版本與 SDF 第 6 版之間新增的其他資料欄。
其他異動
在第 7 版中，我們也進行了幾項重大變更，這些異動應可協助您簡化整合作業，並停止使用已淘汰的實體讀取檔案做為參考。
部分資料欄的新清單排序
SDF 第 7 版保證檔案產生時，特定清單欄的固定順序。這樣不但能使行為更加一致，審查也更容易。系統不會在上傳檔案時強制執行這個順序，但之後產生更新後的檔案時就會套用此順序。
如需現在以遞增數字或字母順序產生的資料欄清單，請參閱 v7 版本資訊。
新增 ID 參考建議
我們已更新多個資料欄的定義，移除參照已淘汰的實體讀取檔案，並改用其他 ID 查詢方式。
下列資料欄傳回的值與 SDF 第 6 版相同，但我們建議您更新整合項目，使用新的建議方法擷取 ID，您可以在相關 v7 資料欄說明中找到。
| 檔案類型及其資料欄 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| 廣告訂單 |
|
|||||||||||||||||||||
| 委刊項 |
|
|||||||||||||||||||||
| 媒體產品 |
|
|||||||||||||||||||||
| YouTube 廣告群組 |
|
|||||||||||||||||||||