迁移到结构化数据文件 v8

上次更新日期:2024 年 11 月 7 日

本指南将引导您完成从使用结构化数据文件 v7.1 迁移到 v8 的过程,并说明这两个版本之间可能影响集成的更改。

如需详细了解 v7.1 与 v8 之间的差异,请参阅版本说明

迁移结构化数据文件版本

如需从旧版迁移到结构化数据文件 (SDF) v8,请执行以下操作:

  1. 更新您的资源和 SDF 生成操作以使用 v8。
  2. 更新了广告资源逻辑,以便在创建时识别类型。
  3. 添加了用于读取、创建和更新需求开发广告系列资源的新逻辑。

更新结构化数据文件版本

若要使用新的结构化数据文件版本,请更新父级合作伙伴和广告客户资源中的指定版本,并在 Display &Video 360 API 中创建各项下载任务时使用新版本。

更新父级资源设置

默认的结构化数据文件版本是在合作伙伴和广告客户资源级设置的。通过接口或 API 下载结构化数据文件时,此版本将用作默认版本。

在界面中设置

在合作伙伴级别

  1. 前往目标合作伙伴。
  2. 展开左侧导航栏中的合作伙伴设置菜单,然后前往基本详情页面。
  3. 结构化数据文件部分中的 SDF 版本配置更新为 v8

在广告客户一级

  1. 前往相应的广告客户页面。
  2. 展开左侧导航栏中的广告客户设置菜单,然后进入基本详情页面。
  3. 结构化数据文件部分中的 SDF 版本配置更新为 v8。如果默认版本是在合作伙伴级别设置的,则可能无法修改此设置。
在 API 中设置
在合作伙伴级别
您无法在 API 的合作伙伴级别设置默认 SDF 版本。
在广告客户一级
发出 advertisers.patch 请求,将 dataAccessConfig.sdfConfig.sdfConfig.version 更新为 SDF_VERSION_8,并根据需要将 dataAccessConfig.sdfConfig.overridePartnerSdfConfig 更新为 True

更新 API 中的 sdfdownloadtasks.create 请求

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

在广告资源中指定类型

v8 会向广告文件添加 Ad Type 列,该列会显示每行代表的广告类型。此新列为必填列,系统会在下载 v8 广告文件时为现有资源填充此列。

更新现有广告时,不应更改此列的值。

制作新广告时,您必须使用列说明中列出的某个值填充此列。

更新需求开发资源的逻辑

v8 支持使用订单项广告组广告文件创建、检索和更新需求开发广告系列。需求生成资源使用不同的逻辑进行时间戳验证,需要填充额外的列,并且受这三种文件类型的新限制的约束。

时间戳验证

对于所有非需求开发广告订单项,订单项文件的 Timestamp 列在下载时会填充订单项上次修改的时间。使用 SDF 更新订单项时,系统会使用此值来验证订单项自下载原始文件后是否未更新。如果是,更新将失败。

对于需求开发订单项,Timestamp 列及其随附的验证方式有所不同。对于需求开发广告订单项条目,系统会在下载时将此列填充为当前时间。上传时,Display & Video 360 会检查自给定时间戳起是否已超过 24 小时。如果超过 24 小时,系统会将原始文件条目视为过时,并且更新会失败。如果发生这种情况,请重新下载该文件,然后根据较新版本进行更新。这种新的验证方法不会阻止您覆盖过去 24 小时内所做的更改。为避免意外覆盖,请仅在您上传的文件中添加要更新的需求开发订单项。

必需列

除了某些文件类型的所有实体都需要的列之外,以下文件类型现在还需要为某些需求生成资源提供一些列。

订单项
以下 订单项 Type”列值的必需列
需求开发
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
以下 广告 Ad Type”列值的必需列
需求开发轮播界面
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
需求开发图片
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
需求开发产品
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
需求开发视频
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

更新后的限制

除了针对某些需求开发订单项和广告新增的必填列外,订单项广告组广告文件类型的多个列也新增了适用于需求开发资源的使用限制。

这些限制非常多,并且因相关列而异,因此本指南未提供详尽的限制列表。建议您先仔细阅读 Line ItemAd GroupAd 文件类型的 v8 参考文档,然后再使用 SDF 上传功能创建或更新需求开发资源。