迁移到结构化数据文件 v9

上次更新日期：2025 年 8 月 21 日

本指南将引导您完成以下流程：

  • 使用 Display & Video 360 界面或 API 将所选结构化数据文件的版本更新为 v9。
  • 将您的集成从已弃用的结构化数据文件版本（v7、v7.1、v8 或 v8.1）迁移到 v9。它会引导您前往详细说明当前版本与 v9 之间可能影响集成情况的变更的页面。在某些情况下，您必须从 2025 年 9 月 8 日开始使用 v9 上传 SDF。

如需详细了解您的版本与 v9 之间的所有差异，请参阅针对每个版本的特定迁移页面。

更新结构化数据文件版本

如需使用 v9，您必须更新资源和 SDF 生成操作，以便在下载和上传结构化数据文件时使用 v9。

更新了结构化数据文件版本

如需使用新的结构化数据文件版本，请更新父合作伙伴资源和广告客户资源中分配的版本，并在 Display & Video 360 API 中创建各个下载任务时使用新版本。

更新父资源设置

您可以在合作伙伴和广告客户资源级别设置默认的结构化数据文件版本。通过界面或 API 下载结构化数据文件时，系统会默认使用此版本。

在界面中设置

在合作伙伴级别：

  1. 前往所需合作伙伴的页面。
  2. 在左侧导航菜单中，前往合作伙伴设置菜单下的基本详情页面。
  3. 将“结构化数据文件”部分中的 SDF 版本配置更新为 v9。

在广告客户一级：

  1. 前往所需广告客户的页面。
  2. 在左侧导航栏中，前往广告客户设置菜单下的基本详情页面。
  3. 将结构化数据文件部分中的 SDF 版本配置更新为 v9。如果默认版本是在合作伙伴级别设置的，则此设置可能无法修改。

在 API 中设置

在合作伙伴一级：您无法在 API 中设置合作伙伴级的默认 SDF 版本。

在广告客户层级：发出 advertisers.patch 请求，将 dataAccessConfig.sdfConfig.sdfConfig.version 更新为 SDF_VERSION_9，并根据需要将 dataAccessConfig.sdfConfig.overridePartnerSdfConfig 更新为 True。

更新了 API 中的 sdfdownloadtasks.create 请求

使用 Display & Video 360 API 发出 sdfdownloadtasks.create 请求时，请将请求正文的 version 字段设置为 SDF_VERSION_9。

从当前 SDF 版本迁移

以下页面将引导您完成从当前版本迁移到 v9 时需要对集成进行的必要更新，并提供版本之间所有变更的完整列表：