随着推荐活动不断发展,我们会持续改进开发者文档。请参阅下文,了解近期对文档所做的重要更改。
2024 年 9 月 19 日 - 不再需要自助导览和导览
我们不再要求为每个商品选项设置自助游和导览商品类别。我们现在会利用商品名和说明来了解商品,并据此分配类别。
2024 年 7 月 28 日 - TTD Center 迁移到 Action Center
我们已改用新的合作伙伴门户 - Action Center。这样一来,推荐活动合作伙伴门户体验将与其他业务板块更加一致。
2024 年 7 月 22 日 - 网址模板更新和 src 模板弃用
我们添加了两个新的网址模板参数:funnel 和 surface,以帮助合作伙伴更好地了解引荐来源。同时,src 参数现已弃用,并且支持将随着时间的推移而移除。
2024 年 2 月 9 日 - 非结构化 address 字段将于 5 月 1 日弃用
自 2024 年 5 月 1 日起,Google 将不再支持现有的单行 address 字段。请更新您的 Feed,改用地点 ID、新引入的 PlaceInfo 或商家资料 ID 格式。
如需查看详细说明,请参阅迁移指南。
2024 年 2 月 7 日 - 改进了对结构化和非结构化地址的支持
我们更新了 Feed 规范,弃用了用于非结构化地址的现有 address 字段,并将其替换为支持结构化和非结构化地址的新 place_info 字段。
使用新字段会带来更准确的匹配,因为系统还会考虑电话号码和网站等其他信息。
此外,Feed 规范现在还支持将 Google 商家资料 ID 作为营业地点输入,以便更好地帮助合作伙伴将供应商商家映射到正确的 Google 商家。
2024 年 2 月 1 日 - 添加了 Feed 优化指南和核对清单
我们更新了开发者网站,并添加了 Feed 优化指南,其中包含发布核对清单,可帮助您充分利用 Feed 集成。
2023 年 5 月 24 日 - 新增了对以下错误的支持:无法匹配运营商营业地点
我们新增了错误“无法匹配运营商营业地点”。此错误将使合作伙伴能够识别 Google 无法解析的运营商位置。
2023 年 5 月 20 日 - 更新了文档,添加了 TTD Center 中的出错提示
我们添加了一个新的 devsite 页面,其中列出了 TTD Center 中报告的所有产品问题及其详细说明。
2023 年 2 月 15 日 -“需要注意的问题”部分
我们在 Things To Do Center 中添加了“需要注意的问题”部分,以帮助您找出商品目录中的问题。
2023 年 2 月 6 日 - 添加了 JSON 架构,以帮助进行商品验证
我们现在已提供 Feed 规范的 JSON 架构供下载。该架构可用于在开发期间验证您的 Feed 集成。
2023 年 2 月 6 日 - 添加了新的商品参数,用于提示图片顺序
我们引入了一个新的布尔值参数 products/use_media_order,设置该参数后,Google 会根据 related_media 图片顺序来确定向用户显示哪张图片。
2023 年 1 月 17 日 - 运营商预订模块发布和新 src 模板
我们在 Feed 中引入了 operator/google_business_profile_name,以支持运营商预订模块。新参数与新的 brand_name 参数结合使用,可让合作伙伴准确指定新模块指向的 Google 商家资料,并独立配置在推荐活动中显示的品牌。
以下文档已更新:
- 概览指南现在包含有关各种 TTD 界面的更多信息。
- 必填字段文档现已更新。
- 在商品 Feed 参考文档中,operator 和 inventory_types 部分现在包含更多实现说明和示例。
2023 年 1 月 17 日 - operator/name 字段替换为 brand_name
我们已弃用 operator/name 字段,并将其替换为商品下名为 brand_name 的新字段。name 字段与新的 brand_name 字段互斥。
2022 年 11 月 3 日 - 新增了商品没有符合条件的地图注点时的错误
为了让商品在 Google 上展示,您需要将其与符合条件的地图注点相关联。如果您提供的所有营业地点都不符合条件,则商品不会展示。为了让您更清楚地了解哪些商品存在此问题,Google 引入了一个新错误 -“相关地图注点均不符合计划要求”。您可以通过添加符合此计划条件的相关地图注点来解决此问题。使用地点匹配工具可以查看地图注点是否符合计划条件。
2022 年 10 月 28 日 - 新增了包含产品问题列表的新闻报道
您的商品可能会出现哪些问题?现在,您可以查看产品问题列表,了解完整列表。
2022 年 10 月 13 日 - 产品问题概览
我们更新了 TTD Center 中的产品问题概览。现在,商品概览表格新增了三列,用于显示每件商品存在的问题。
2022 年 9 月 13 日 - 图片准则已更新
我们更新了图片准则,添加了更多建议。
2022 年 8 月 5 日 - Feed 规范现已扩展,支持本地化着陆页网址
我们扩展了 Feed 规范,现在除了 url 和 mobile_url 之外,您还可以使用 localized_url 和 localized_mobile_url 为不同语言指定不同的着陆页。
2022 年 7 月 12 日 - 添加了“查找匹配地点”工具文档
我们添加了有关新推出的推荐活动中心功能(“查找匹配地点”工具)的文档。
2022 年 7 月 1 日 - 在商品 Feed 文档中添加了实现说明和其他示例
我们已在商品 Feed 文档中添加了实现说明和其他示例 JSON。
2022 年 5 月 13 日 - 着陆页和标题准则更新
我们在着陆页指南中添加了更多详细信息,详细说明了应如何使用列表视图和商品视图。“标题指南”页面已重命名为标题和说明指南,现在包含有关如何使用标题和说明的说明和示例。
2021 年 12 月 15 日 - 重要商品类别和地图注点地址格式
我们更新了商品类别,添加了应尽可能包含的类别列表。我们还修订了位置和地图注点指南,其中详细说明了应如何提供字符串地址。
2021 年 11 月 12 日 - 阐明了相关营业地点的使用方式
我们在位置和地图注点中添加了更多详细信息和示例,以阐明应如何使用相关位置。
2021 年 10 月 19 日 - 添加了 v0 到 v1 迁移指南
我们最近为从旧版规范迁移的合作伙伴添加了推荐活动迁移指南。