v1 到 v2 目录迁移

v1 目录是 JSON-LD 格式的 Feed 实体的层次结构。通过此架构,抢先体验计划合作伙伴可以使用此架构与端到端订购功能集成。v1 目录架构现已废弃。

最新版本的数据 Feed 规范 v2 目录采用平面结构,并使用关系型架构模型。这样,合作伙伴就能以更直接的方式从其关系型数据库中提取和转换实体,以创建数据 Feed。v2 目录采用 NDJSON,这是一种以换行符分隔的 JSON 格式。

为什么应从 v1 迁移到 v2

虽然我们会继续为通过订购端到端 v1 目录架构集成的合作伙伴提供维护支持,但所有新的合作伙伴集成都必须使用 v2 目录。

v2 清单中的新功能可能无法在 v1 清单中使用。如需查看示例,请参阅交易

迁移步骤

使用 v2 广告资源需要单独的订购端到端项目和新的集成。以下流程介绍了如何将 v1 目录迁移到 v2 目录。

  1. 如需创建新的 v2 项目,请先完成集成步骤
    1. 如需实现数据 Feed,请使用关系型产品目录架构
    2. 如果适用,请重复使用 v1 项目中的 fulfillment 端点
  2. 当您的 v2 项目准备好发布时,请按以下步骤操作:
  3. 确保您的 v2 项目符合发布准备情况核对清单
    1. 为防止同时向最终用户提供 v1 和 v2 目录架构,请从 v1 项目中取消部署正式版。在此步骤之后的几分钟内,您的 v1 项目目录将停止在生产环境中投放。
    2. 为您的 v2 项目创建正式版本,并通知您的 Google 顾问。

回滚步骤

如果您希望在生产环境中部署 v2 项目后回滚到 v1,则可以在 v2 项目中取消部署生产版本,然后重新部署 v1 项目的正式版。

对合作伙伴数据和提供商排名的影响

以下是对合作伙伴数据和提供商排名的潜在影响。

  • v1 项目中的事务日志和分析数据不会转移到 v2 项目。
  • 性能指标(例如来自 v1 项目的转化率和 API 指标)不会移植到 v2 项目中。这会重置您的提供商在端到端订购中的排名。