遷移至結構化資料檔案 v8

上次更新時間：2024 年 11 月 12 日

本指南將逐步說明如何從使用結構化資料檔案 7.1 版遷移至 8 版，並說明兩個版本之間可能會影響整合作業的變更。

如需 v7.1 與 v8 之間的差異完整清單，請參閱版本資訊。

遷移結構化資料檔案版本

如要從舊版遷移至結構化資料檔案 (SDF) 8.0 版，請按照下列步驟操作：

  1. 請更新資源和 SDF 產生動作，以便使用 v8。
  2. 更新廣告資源邏輯，以便在建立時識別類型。
  3. 新增邏輯，用於讀取、建立及更新需求開發廣告活動資源。

更新結構化資料檔案版本

如要使用新的結構化資料檔案版本，請在父項合作夥伴和廣告客戶資源中更新已指派的版本，並在 Display & Video 360 API 中建立個別下載工作時使用新版本。

更新上層資源設定

預設的結構化資料檔案版本會在夥伴和廣告主資源層級設定。透過介面或 API 下載結構化資料檔案時，系統會使用這個版本做為預設版本。

在介面中設定

合作夥伴層級

  1. 前往所需合作夥伴。
  2. 展開左側導覽面板中的「夥伴設定」選單，然後前往「基本資料」頁面。
  3. 將「結構化資料檔案」部分中的「SDF 版本」設定更新為「v8」。

在廣告主層級

  1. 前往所需廣告主頁面。
  2. 展開左側導覽面板中的「廣告主設定」選單，然後前往「基本資料」頁面。
  3. 將「結構化資料檔案」部分中的「SDF 版本」設定更新為「v8」。如果預設版本是在合作夥伴層級設定，則可能無法編輯這項設定。
在 API 中設定
在合作夥伴層級
您無法在 API 的夥伴層級設定預設 SDF 版本。
在廣告主層級
提出 advertisers.patch 要求，將 dataAccessConfig.sdfConfig.sdfConfig.version 更新為 SDF_VERSION_8，並視需要將 dataAccessConfig.sdfConfig.overridePartnerSdfConfig 更新為 True。

更新 API 中的 sdfdownloadtasks.create 要求

使用 Display & Video 360 API 提出 sdfdownloadtasks.create 要求時，請將要求主體的 version 欄位設為 SDF_VERSION_8。

在廣告資源中指定類型

v8 會在 Ad 檔案中新增 Ad Type 欄，顯示每個資料列所代表的廣告類型。這個新欄為必填欄，下載 v8 廣告檔案時，系統會為現有資源填入這個欄的資料。

更新現有廣告時，請勿變更這個欄的值。

建立新廣告時，您必須在這個欄中填入資料欄說明中列出的其中一個值。

更新需求開發資源的邏輯

v8 支援使用委刊項、廣告群組和廣告檔案建立、擷取及更新需求開發廣告活動。Demand Gen 資源會使用不同的時間戳記驗證邏輯、需要填入額外的資料欄，並受到三種檔案類型的新限制。

時間戳記驗證

對於所有非需求開發委刊項，系統會在下載時為 Line Item 檔案的 Timestamp 欄填入上次修改委刊項的時間。使用 SDF 更新委刊項時，系統會使用這個值來驗證下載原始檔案後，委刊項是否未經過更新。否則更新會失敗。

對於需求開發委刊項，Timestamp 欄和隨附的驗證機制運作方式有所不同。對於需求開發委刊項項目，系統會在下載時將目前的時間填入資料欄。上傳時，Display & Video 360 會檢查指定時間戳記是否已過 24 小時。如果超過 24 小時，系統會將原始檔案項目視為過時，更新作業也會失敗。如果發生這種情況，請再次下載檔案，並根據較新的版本進行更新。這項新驗證方法不會阻止您覆寫過去 24 小時內所做的變更。為避免意外覆寫，請只在要上傳的檔案中加入要更新的需求開發委刊項。

必要欄

除了該檔案類型的所有實體所需的資料欄外，下列檔案類型現在也針對特定 Demand Gen 資源，要求使用特定資料欄。

委刊項
下列 Line Item Type 欄值的必要欄
需求開發
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
下列 Ad Ad Type 欄值的必要欄
需求開發輪轉廣告
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
需求開發圖片
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
需求開發產品
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
需求開發影片
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

更新限制

除了針對特定需求開發委刊項和廣告新增必要欄位外，委刊項、廣告群組和廣告檔案類型中的多個欄位，也設有適用於需求開發資源的新用途限制。

這些限制條件非常多，且各自適用於相關欄，因此本指南無法提供完整的限制條件清單。建議您在使用 SDF 上傳功能建立或更新需求開發資源前，仔細閱讀 委刊項、廣告群組和廣告檔案類型的 v8 參考文件。