上次更新日期：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。 |
| 出价调节系数 |
此列已更新，以便为应用和网站行类型使用新的条件 ID。 应用行类型已更新为使用应用平台和应用平台 ID 的串联字符串值（以英文冒号分隔）作为条件 ID。应用平台由字符串值标识。应用 ID 是相关平台提供的 ID，例如 Android 的 Play 商店中的软件包 ID 或 Apple 的 App Store 中的应用 ID。 网站行类型已更新为使用网址字符串作为条件 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 广告组 |
|
|||||||||||||||||||||