上次更新日期：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（可在 v7 列说明中找到）。
| 文件类型及其列 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 宣传活动 |
|
|||||||||||||||||||||
| 广告订单 |
|
|||||||||||||||||||||
| 订单项 |
|
|||||||||||||||||||||
| 媒体产品 |
|
|||||||||||||||||||||
| YouTube 广告组 |
|
|||||||||||||||||||||