与结构化数据文件和 API 集成

结构化数据文件 (SDF)Display & Video 360 API 均支持批量管理 Display & Video 360 资源配置。每种工具都有其独特的限制。本指南建议使用这两种工具来优化现有实现。

如果您已在使用结构化数据文件

使用 Display & Video 360 API 通过程序化检索文件和相关元数据来支持您的 SDF 集成。

使用 API 生成和下载文件

默认情况下,您可以使用 Display & Video 360 界面手动下载结构化数据文件。这些下载通常仅限于单个广告客户,并且必须从特定资源页面发起。通过界面下载大量 SDF 数据可能非常复杂且耗时。

使用 Display & Video 360 API 以编程方式生成和下载结构化数据文件,从而简化此流程。如需查看有关如何实现此功能的分步说明,请参阅我们的指南

使用 API 查找参考 ID

结构化数据文件反映了 Display & Video 360 资源的配置。 大多数 SDF 列都使用数字 ID 来标识其他资源或定位配置。在读取和修改 SDF 数据时,您通常需要参考信息来了解这些 ID。

使用 Display & Video 360 API 批量检索参考信息。您可以使用相关资源的 GETLIST 函数检索大多数 SDF 列使用的可用 ID。

以编程方式检索和缓存参考信息,以便在解析和修改结构化数据文件时使用该缓存信息。您可以定期更新缓存,并在解析 SDF 时实时查找未知 ID,以检索有关新资源的信息。

如需查看可用 API 服务和方法的完整列表,请参阅 API 参考文档

现有例外情况

结构化数据文件使用的一小部分参考 ID 无法通过 Display & Video 360 API 进行检索:

  • 兴趣相似和有购买意向的受众群体定位:从 Display & Video 360 界面检索这些列中使用的受众群体 ID。
  • 转化 Floodlight 活动 ID:从 Display & Video 360 界面检索这些列中使用的 Floodlight 活动 ID。
  • 广告资源来源定位:从已发布的 SDF 广告交易平台参考中检索这些列中使用的广告交易平台 ID。使用 Display & Video 360 API 检索这些列中使用的广告资源来源 ID 和子交易平台 ID。
  • 应用定位:从相关应用平台检索这些列中使用的应用 ID。

如果您已在使用 Display & Video 360 API

通过批量创建和更新 YouTube 及合作伙伴资源,使用 SDF 支持 Display & Video 360 API 集成。

使用 SDF 上传功能更新 YouTube 及合作伙伴资源

您无法使用 Display & Video 360 API 创建或更新 YouTube 及合作伙伴资源,例如特定类型的订单项、广告组和广告。您可以检索这些资源的配置和分配的定位条件,但任何更新都必须通过 Display & Video 360 界面完成。这会限制批量操作,并限制您更新这些资源的速率。

使用结构化数据文件上传功能,通过 Display & Video 360 界面批量创建或更新 YouTube 和合作伙伴资源。虽然您必须手动上传结构化数据文件,但可以以编程方式完成大部分流程,即检索和修改文件。

如需了解详情,请参阅有关下载 SDF 的 API 指南有关上传 SDF 的文档