v1 目录是 JSON-LD 格式的 Feed 实体的层次结构。通过此架构,抢先体验计划合作伙伴可以使用此架构与端到端订购功能集成。v1 目录架构现已废弃。
最新版本的数据 Feed 规范 v2 目录采用平面结构,并使用关系型架构模型。这样,合作伙伴就能以更直接的方式从其关系型数据库中提取和转换实体,以创建数据 Feed。v2 目录采用 NDJSON,这是一种以换行符分隔的 JSON 格式。
为什么应从 v1 迁移到 v2
虽然我们会继续为通过订购端到端 v1 目录架构集成的合作伙伴提供维护支持,但所有新的合作伙伴集成都必须使用 v2 目录。
v2 清单中的新功能可能无法在 v1 清单中使用。如需查看示例,请参阅交易。
迁移步骤
使用 v2 广告资源需要单独的订购端到端项目和新的集成。以下流程介绍了如何将 v1 目录迁移到 v2 目录。
- 如需创建新的 v2 项目,请先完成集成步骤。
- 如需实现数据 Feed,请使用关系型产品目录架构。
- 如果适用,请重复使用 v1 项目中的 fulfillment 端点。
- 当您的 v2 项目准备好发布时,请按以下步骤操作:
- 确保您的 v2 项目符合发布准备情况核对清单。
回滚步骤
如果您希望在生产环境中部署 v2 项目后回滚到 v1,则可以在 v2 项目中取消部署生产版本,然后重新部署 v1 项目的正式版。
对合作伙伴数据和提供商排名的影响
以下是对合作伙伴数据和提供商排名的潜在影响。
- v1 项目中的事务日志和分析数据不会转移到 v2 项目。
- 性能指标(例如来自 v1 项目的转化率和 API 指标)不会移植到 v2 项目中。这会重置您的提供商在端到端订购中的排名。