迁移到结构化数据文件 v7

上次更新日期: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 列迁移说明

应用定位 - 排除

应用定位 - 包含

这些列已更新为使用遵循“App Platform:App ID”格式的应用标识符。示例包括:“APP:com.google.android.gm”“APP:422689480”“ANDROID_TV_APP:com.google.android.youtube.tvunplugged

应用平台由字符串值标识。应用 ID 是相关平台提供的 ID,例如 Android Play 商店中的软件包 ID 或 Apple App Store 中的应用 ID。

浏览器定位 - 排除

浏览器定位 - 包含

此列已更新为使用定位类型 TARGETING_TYPE_BROWSER 下的 Display & Video 360 API TargetingOption 资源的 targetingOptionId 值。

使用 targetingTypes.targetingOptions 服务逐个检索 TargetingOption 资源或在分页列表中检索资源。

运营商定位 - 排除

运营商定位 - 包含

此列已更新为使用定位类型 TARGETING_TYPE_CARRIER_AND_ISP 下的 Display & Video 360 API TargetingOption 资源的 targetingOptionId 值。

使用 targetingTypes.targetingOptions 服务逐个检索 TargetingOption 资源或在分页列表中检索资源。

渠道定位 - 排除

渠道定位 - 包含

此列已更新为使用 Display & Video 360 API Channel 资源的 channelId 值。

使用 advertisers.channelspartners.channels 服务分别检索或分页列表中的 Channel 资源。

设备定位 - 排除

设备定位 - 包含

此列已更新为使用以下定位类型下的 Display & Video 360 API TargetingOption 资源的 targetingOptionId 值:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

使用 targetingTypes.targetingOptions 服务逐个检索 TargetingOption 资源或在分页列表中检索资源。

衡量 DAR 渠道

此列已更新为使用 Display & Video 360 API Channel 资源的 channelId 值。

使用 advertisers.channelspartners.channels 服务分别检索或分页列表中的 Channel 资源。

网站定位 - 排除

网站定位 - 包含

此列已更新,可通过网址字符串识别网站。

订单项

v7 列迁移说明

应用定位 - 排除

应用定位 - 包含

这些列已更新为使用遵循“App Platform:App ID”格式的应用标识符。示例包括:“APP:com.google.android.gm”“APP:422689480”“ANDROID_TV_APP:com.google.android.youtube.tvunplugged

应用平台由字符串值标识。应用 ID 是相关平台提供的 ID,例如 Android Play 商店中的软件包 ID 或 Apple App Store 中的应用 ID。

出价调节系数

此列已更新,以便为 appsite 行类型使用新的条件 ID。

app 行类型已更新,以便使用应用平台和应用平台 ID 的串联字符串值(以英文冒号分隔)作为条件 ID。应用平台由字符串值标识。应用 ID 是相关平台提供的 ID,例如 Android Play 商店中的软件包 ID 或 Apple App Store 中的应用 ID。

site 行类型已更新为使用网址字符串作为条件 ID。

浏览器定位 - 排除

浏览器定位 - 包含

此列已更新为使用定位类型 TARGETING_TYPE_BROWSER 下的 Display & Video 360 API TargetingOption 资源的 targetingOptionId 值。

使用 targetingTypes.targetingOptions 服务逐个检索 TargetingOption 资源或在分页列表中检索资源。

运营商定位 - 排除

运营商定位 - 包含

此列已更新为使用定位类型 TARGETING_TYPE_CARRIER_AND_ISP 下的 Display & Video 360 API TargetingOption 资源的 targetingOptionId 值。

使用 targetingTypes.targetingOptions 服务逐个检索 TargetingOption 资源或在分页列表中检索资源。

渠道定位 - 排除

渠道定位 - 包含

此列已更新为使用 Display & Video 360 API Channel 资源的 channelId 值。

使用 advertisers.channelspartners.channels 服务分别检索或分页列表中的 Channel 资源。

设备定位 - 排除

设备定位 - 包含

此列已更新为使用以下定位类型下的 Display & Video 360 API TargetingOption 资源的 targetingOptionId 值:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

使用 targetingTypes.targetingOptions 服务逐个检索 TargetingOption 资源或在分页列表中检索资源。

网站定位 - 排除

网站定位 - 包含

此列已更新,可通过网址字符串识别网站。

媒体产品

v7 列迁移说明

渠道定位 - 排除

渠道定位 - 包含

此列已更新为使用 Display & Video 360 API Channel 资源的 channelId 值。

使用 advertisers.channelspartners.channels 服务分别检索或分页列表中的 Channel 资源。

设备定位 - 包含

此列已更新为使用以下定位类型下的 Display & Video 360 API TargetingOption 资源的 targetingOptionId 值:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

使用 targetingTypes.targetingOptions 服务逐个检索 TargetingOption 资源或在分页列表中检索资源。

添加与自 v6 以来添加的列的集成

如果要从 v6 迁移到 v7,您需要将以下列添加到相关文件中:

文件类型
订单项 TrueView 目标频次计数
订单项 TrueView 目标频次时间范围
YouTube 广告组 优化型定位

如果您要从之前的结构化数据文件版本进行迁移,请参阅结构化数据文件版本说明,了解现行版本与 SDF v6 之间添加的其他列。

其他更改

在 v7 中,我们还进行了一些表面更改,可帮助您简化集成并停止使用已废弃的实体读取文件作为参考。

为列的子集采用新的列表排序

SDF v7 可保证在生成文件时能够稳定地对某些列表列进行排序。这样可使操作更加一致,并且更易于审核。此排序在文件上传时不会强制执行,但之后会在生成更新后的文件时应用。

如需查看现在按升序数字或字母顺序生成的列的完整列表,请参阅 v7 版本说明

新的 ID 参考建议

我们更新了多个列的定义,移除了对已废弃的实体读取文件的引用,改为建议采用其他 ID 查找方法。

以下列返回的值与 SDF v6 中一样,但我们建议您更新集成,以便使用推荐的新方法检索 ID(可在 v7 列说明中找到)。

文件类型及其列
宣传活动
按地理位置定位 - 排除
按地理位置定位 - 包含
广告资源来源定位 - 排除
广告资源来源定位 - 包含
语言定位 - 排除
语言定位 - 包含
广告订单
兴趣相似和有购买意向的定位 - 排除
兴趣相似和有购买意向的定位 - 包含
应用合集定位 - 排除
应用合集定位 - 包含
受众群体定位 - 排除
受众群体定位 - 包含
类别定位 - 排除
类别定位 - 包含
内容类型定位 - 排除
内容类型定位 - 包含
自定义名单定位
按地理位置定位 - 排除
按地理位置定位 - 包含
广告资源来源定位 - 排除
广告资源来源定位 - 包含
关键字列表定位 - 排除
语言定位 - 排除
语言定位 - 包含
订单项
兴趣相似和有购买意向的定位 - 排除
兴趣相似和有购买意向的定位 - 包含
应用合集定位 - 排除
应用合集定位 - 包含
受众群体定位 - 排除
受众群体定位 - 包含
类别定位 - 排除
类别定位 - 包含
组合的受众群体定位条件
内容类型定位 - 排除
内容类型定位 - 包含
转化 Floodlight 活动 ID
广告素材分配
自定义名单定位
按地理位置定位 - 排除
按地理位置定位 - 包含
广告资源来源定位 - 排除
广告资源来源定位 - 包含
关键字列表定位 - 排除
语言定位 - 排除
语言定位 - 包含
媒体产品
受众群体定位 - 排除
受众群体定位 - 包含
类别定位 - 排除
类别定位 - 包含
按地理位置定位 - 包含
语言定位 - 排除
语言定位 - 包含
YouTube 广告组
兴趣相似和有购买意向的定位 - 排除
兴趣相似和有购买意向的定位 - 包含
受众群体定位 - 排除
受众群体定位 - 包含
类别定位 - 排除
类别定位 - 包含
自定义名单定位