上次更新日期：2023 年 10 月 18 日
本指南逐步介绍了从先前版本迁移到结构化数据文件 (SDF) v7 的过程，以及为了更好地优化集成而必须做出的更改以及建议的更改。
如需 v6 和 v7 之间差异的详尽列表，请参阅版本说明。
迁移结构化数据文件版本
若要从先前版本迁移到结构化数据文件 v7，您需要指定新版本、更新部分现有列的 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
在 v7 中，部分列使用的 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 以来添加的列的集成
如果要从 v6 迁移到 v7，您需要将以下列添加到相关文件中：
| 文件类型 | 列 |
|---|---|
| 订单项 | TrueView 目标频次计数 |
| 订单项 | TrueView 目标频次时间范围 |
| YouTube 广告组 | 优化型定位 |
如果您要从结构化数据文件之前的版本进行迁移，请参阅结构化数据文件版本说明，了解有关当前版本与 SDF v6 之间添加的其他列的信息。
其他更改
在 v7 中，我们还进行了一些浅层变更，以帮助您简化集成，并放弃使用已废弃的实体读取文件作为参考。
某些列采用新的列表排序方式
SDF v7 可保证在文件生成时某些列表列的稳定顺序。这样可以实现行为更加一致，并使审核更加轻松。此排序在文件上传时不会强制执行，但随后在生成更新文件时会应用。
如需了解现在按升序数字或字母顺序生成的列的完整列表，请参阅 v7 版本说明。
关于新 ID 参考文件的建议
我们更新了一些列的定义，移除对已弃用的实体读取文件的引用，改为建议采用其他 ID 查找方式。
以下列返回的值与 SDF v6 中返回的值没有区别，但我们建议您更新集成，以使用新推荐的方法检索 ID（可在相应列说明中找到）。
| 文件类型及其列 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 宣传活动 |
|
|||||||||||||||||||||
| 广告订单 |
|
|||||||||||||||||||||
| 订单项 |
|
|||||||||||||||||||||
| 媒体产品 |
|
|||||||||||||||||||||
| YouTube 广告组 |
|
|||||||||||||||||||||