近期更新

随着推荐活动不断发展,我们会持续改进开发者文档。请参阅下文,了解近期对文档所做的重要更改。

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 商家资料,并独立配置在推荐活动中显示的品牌。

以下文档已更新:

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 年 10 月 19 日 - 添加了 v0 到 v1 迁移指南

我们最近为从旧版规范迁移的合作伙伴添加了推荐活动迁移指南。