还有其他难题，或是您的问题未在下面列出？请报告 Bug 或提出功能请求，并在 Google 群组或 Stack Overflow 讨论。
常规
1. 您是否有适用于零售行业的 Vertex AI Search 或其他的客户端库 示例代码？
是。您可以参阅客户端库指南 此处，了解每个库的设置和参考信息。
通过 Google API 发现服务 来代替原始 REST 调用。
2. 所有推荐模型都是个性化推荐模型吗？
“推荐您”、“您可能喜欢的其他人”和“再次购买”模型会在以下情况提供个性化推荐： 随用户历史记录一起提供“经常一起购买”和“类似商品”模型 个性化。
请参阅推荐模型简介。
3. 我会立即收到个性化推荐内容，还是需要 是否期待这些新功能随着时间的推移而不断改进？
随着您收集更多用户历史记录，推荐功能会越来越好。“为你推荐的视频”模型 “您可能会喜欢的其他产品”模型根据 主要是参考其他方的意见这两种模型都会立即考虑用户行为，因此发送实时事件非常重要。请参阅 推荐模型简介。
用户事件需要实时或非常接近实时地发送，以保证其有效性。如果每天只提交一次用户事件，或者每天分批提交用户事件，那么个性化模型可能不会像实时事件那样发送。
4. 您的模型中是否使用了 Google 用户受众特征数据？
这些模型仅使用您提供的目录和用户事件数据。如果您 希望包含受众特征数据，还可以添加其他文字或数字 可能有用的自定义属性的信息。这个 重新调整后，模型将开始使用现有数据。
请勿包含个人身份信息 (PII)，例如电子邮件地址或用户名。我们建议您对受众特征数据进行匿名化处理，例如对值进行哈希处理或使用组 ID。
5. 我能否根据一组用户的事件历史记录提供建议？ 而不是单个用户的历史记录？
目前，系统会根据单个访问者 ID 或用户 ID 生成建议。您需要发出单个请求，然后将结果组合以基于组历史记录提出建议。如果用户具有通用元数据特性，您可以使用组 ID 作为用户 ID 来提供组级别建议。
6. 我发现您可以为商品提交图片网址。这些模型是否会考虑产品图片？
目前不可以。提供这些字段以便您可以检索此元数据以及返回的建议结果，以帮助渲染建议结果。预测预览也会使用图片 当您在 Search for Retail 控制台。
7. 我的公司不是零售电子商务网站。我还可以使用 推荐用于预测 x,y,z？
我们曾有客户使用推荐内容来推荐内容 推荐、视频在线播放和游戏，以及其他用例。但是，我们目前的内容和体验是根据零售电子商务用例设计的，可能尚不适合其他用例。
8. 我可以在网站的任何网页上放置推荐内容吗？
可以，但每个模型都针对特定用例设计，并且可能仅在某些页面上才能实现最佳效果。请参阅推荐模型简介。
“经常一起买”和您可能喜欢的其他商品需要商品 ID，因此应使用商品 ID 使用产品 ID 或购物车中的商品等方式来推荐产品。经常一起购买 通常在“添加到购物车”页面或结账页上效果最好，而您可能会喜欢的其他页面 类似商品在商品详情页面上效果最佳。“为您推荐”：可以放置在任何 因为这个页面只需要一个访问者 ID 作为输入，但它被设计成了一个首页。 页面服务配置。“再次购买”设计可放置在任何页面上。
9. 我可以使用电子邮件中的建议功能吗 简报？
是。可通过使用访问者 ID 或用户 ID 调用 API 并将结果整合到电子邮件模板中来完成。如果您希望在电子邮件读取时动态加载这些项目，则需要使用中间端点，例如Google Cloud Functions 函数，发送预测请求。该 API 仅提供经过排序的商品 ID 和元数据的列表，因此您还需要编写自己的代码来渲染图片结果。
10. 我能否将 Vertex AI Search for Retail 用于其他非 Web 应用场景（移动应用、 自助服务终端）？
是。您可以设置一个端点（例如 Google Cloud Functions 函数）来获取应用的结果。您 则需要类似的机制来发送实时事件。
11. 我没有超过 3 个月的事件数据。我还可以使用 Vertex AI Search for Retail？以后是否可以添加更多数据？
“相似商品”模型不使用用户事件数据，也不使用模型调参。如果您 您仍然可以创建和训练类似商品模型，前提是 是否有目录数据。
如果您可以为实时事件记录足够的流量，则近期数据可用于训练其他模型。如果您日后有额外的数据，可以在初始模型训练后上传。在每日重新训练期间，新回填的数据会合并到模型中。但是，如果数据与用于初始训练的事件明显不同，则可能需要调整模型。
大多数模型在至少三个月的商品页面浏览量（首页）上效果最佳 网页浏览量和“添加到购物车”事件（涵盖所有车型，理想情况下为一到两年） 购买历史记录的一部分。
一到两周的详细浏览量就足以开始培训您可能会喜欢的其他人 和“推荐”等车型，而“经常一起购买”和“再次购买”这样的车型通常需要更多，因为 每天的购买次数通常少于网页浏览量。模型质量 可以借助更多数据实现显著提升；最低数量可能无法生成 最佳结果。例如，一年的购买量可让模型更好地掌握季节性和流行趋势。
12. 我可以在商品的同时推荐类别吗？
“推荐”功能目前仅返回商品推荐信息， 但您可以获取返回结果中返回的每件商品的类别。
13. 您是否有用于从 SQL 数据库或其他数据库上传数据的集成 系统？
可以。对于事件，可以从 BigQuery 中读取示例代码。请参阅适用于 BigQuery 的 Google Analytics 示例数据集。
14. 零售业 Vertex AI Search 是否使用 Cookie？
不，它不使用 Cookie。不过，发送到 Vertex AI Search for Retail 必须指定访问者 ID，该 ID 通常为 来自 Cookie 的会话标识符。
15. 我需要专用的 Google Cloud 项目吗？
您可以创建新的专用项目，也可以 在现有项目中为零售企业启用 Vertex AI Search。
16. 使用 Cloud Shell 时，为什么我的凭据无效？
检查您是否已完成以下服务的身份验证设置步骤： Vertex AI Search for Retail。您应该使用已在环境中可用的服务账号。否则，您可能会收到如下错误：“您的应用已使用不受支持的 Google Cloud SDK 或 Google Cloud Shell 中的最终用户凭据进行身份验证”。
如需详细了解服务账号，请参阅 Google Cloud 文档的身份验证部分。
17. 如何将适用于零售的 Vertex AI Search 与类似解决方案进行比较？
您可以执行 A/B 测试来比较 适用于零售行业的 Vertex AI Search。
18. 我认为特征 x,y,z 会很棒。您能否添加此内容？
我们希望倾听您的宝贵意见！您可以通过客户支持团队、Google 支持或问题跟踪器提交功能请求。
19. 我是否仍然可以使用旧版 API 来提供推荐内容？
Recommendations 已从 Recommendations Engine API 迁移
Vertex AI Search for Retail。如果您在使用 Recommendations Engine API 的
我们建议您将推荐内容迁移到
Vertex AI Search for Retail（服务端点 https://retail.googleapis.com）、
也就是 GA
先前的 API（服务端点 https://recommendationengine.googleapis.com）及其文档仍然可用，但它们不再更新。
目录和商品
1. “建议”功能如何处理新产品的冷启动？
对于没有任何交易记录的商品，我们会根据类似商品进行推荐。在这些情况下，请务必在目录中定义恰当的商品标题、类别和说明。
对于冷启动用户（没有历史记录的访问者），模型会从最热门的常规商品开始，并随着接收到更多用户事件而实时提高个性化程度。
2. 我可以使用 Merchant Center 目录来获取建议吗？
可以，您可以使用 Merchant Center Data Transfer Service 将 Merchant Center 目录导出到 BigQuery。然后，我们可以直接从 BigQuery 读取目录。请参阅 从 Merchant Center 导入目录数据。
3. 还有什么方法可以导入我的目录？
- Merchant Center：使用 Merchant Center 导入。如果您使用搜索功能，您可以 使用控制台关联 Merchant Center，以便其目录 自动同步。
- BigQuery：直接从表或视图导入。
- Cloud Storage：使用文本文件（每行一个 JSON 目录项）导入。
- 内嵌导入：通过 API 调用导入（使用每行一个 JSON 目录项的文本文件）。
- 创建商品项：使用
Products创建方法。
4. 如何及时更新我的目录？目录的更新频率是多少？
请参阅及时更新目录。
我们建议您每天更新目录。您可以从 Cloud Storage 或 BigQuery 进行全面更新，也可以执行增量更新（即，仅新建和更改的项目）。
如果可能，请实时更新价格和库存状况。这会影响 可通过搜索快速找到新条目。
如果您有一种简单的方式来接收目录更改通知（例如通过 Pub/Sub、消息队列、事件等），则您可以使用导入或创建 API 方法。
例如，Cloud Scheduler 可用于进行每天 BigQuery 导入调用。
5. 是否有最小和最大目录大小？
没有最低大小要求，但非常小的产品目录大小（少于 100 个项目）可能会不利于推荐，因为推荐的商品数量非常少。
目录最多包含 4000 万项。
请参阅关于默认配额和限制以及如何请求更改配额的文档。
6. 我的公司在多个国家/地区运营网站。我应该使用 所有数据？
通常情况下，最好只使用一个包含所有项的目录。所有事件都必须使用单一币种提交。目前，您无法 多个目录，但如果您使用实体， 您可以为特定对象指定搜索、推荐和自动补全行为， 。
如果不同网站的目录差异很大，我们建议您 为每个网站分别创建一个项目此外，如果不同国家/地区有不同的 我们建议您针对每种语言分别创建项目。
如果有类似网站与主网站相比流量较低， 如果没有足够的事件来生成，则最好使用单个目录 高质量的模型。
如需使用单一目录，目录项 ID 应保持一致，即 同一商品在所有网站上都应该只有一个商品 ID，这样就不会有 在目录中重复出现产品。
仅针对建议，使用实体的替代方案是过滤出
过滤器过滤特定网站的数据。不过，过滤条件可能会占用
最长 8 小时才会更新，因此，如果 Google Play 商店中
库存）要求，它们通常需要由一个业务规则来处理，
过滤掉预测响应后的结果。这适用于 v1 filter_tag 过滤和 v2 基于属性的过滤。
7. 适用于零售的 Vertex AI Search 是否支持每个目录采用多种货币？
不可以，每个目录仅支持一种货币类型。活动 必须使用单一币种进行上传。
如果您打算使用 Search for Retail 控制台以获取收入 指标，请确保您的事件都使用单一币种，或将所有事件都换算为 使用相同的币种。
8. 我有多个包含共享目录或类似商品的网站。罐形 是否提供跨网站推荐？
我们通常建议只在网站存在明显重叠时使用单个目录；他们应该共享很多或所有相同产品。然后，与多区域网站一样，您可以使用实体或 过滤代码可仅返回特定网页 预测调用。
如果这些网站没有共享很多（甚至没有）目录项 那么应使用多个目录使用多个目录需要为每个目录使用单独的 Google Cloud 项目。
9. 包含更多元数据是否会改进模型？模型是否会考虑字段 x,y,z 吗？
如需了解必填字段，请参阅必需的目录项信息。
其他元数据字段则是可选的（例如 images 和 itemAttributes）。它们可用于预测预览、结果分析、训练和调节。建议添加颜色、大小、材质等有用的属性。您可以通过指定 returnProduct:true 将这些字段作为预测结果的一部分返回，因此这些字段对呈现结果很有帮助。图片和项属性用于预测预览
。
10. 目录项的哪些属性会用作模型训练的输入？
结合使用用户行为和商品属性。所使用的主要字段包括 ID、标题、类别层次结构、价格和网址。您可以添加在 Product.attributes[] 中可能有用的其他自定义键值对特性。
图片网址更便捷，您可以通过指定 returnProduct:true 来将此元数据作为预测结果的一部分返回，这样可以节省额外的调用以检索此信息。包含图片网址还可实现预测预览
当您在 Vertex AI Workbench 中
Search for Retail 控制台。
11. 我的产品支持哪些语言？
建议：支持大多数语言。模型 会自动检测文本语言。如需了解可以支持哪些语言 请参阅 Compact Language Detector GitHub 自述文件。
search：支持以下语言：阿拉伯语、 荷兰语、英语、法语、德语、意大利语、日语、韩语、波兰语、葡萄牙语 西班牙语和土耳其语您可以在上传目录时设置语言。通过 目录应仅使用一种语言，并且查询应在 同一语言。目录中包含多种语言会导致模型性能下降 性能例如，如果目录是西班牙语，但搜索查询内容却是 查询不会将其翻译成西班牙语。
<ph type="x-smartling-placeholder"></ph>
12. 我的目录包含主 SKU/变体 SKU 或父/子 SKU。是否支持这些格式？
可以。这与 Merchant Center 中的 item_group_id 类似。您需要确定希望重新获得建议的方式（父级或子级），以及事件是父级还是子级级别的。
如需详细了解产品级别，请参阅产品级别。
在发送任何项或事件之前，先确定并设置了正确的商品级别。您可以更改商品级别，但需要重新加入项并重新调整模型。
13. 当商品不再可用时，我可以从清单中删除吗？
如果商品不再是最新状态，我们建议您将其状态设置为 OUT_OF_STOCK，而不是删除它，这样，引用该项目的先前用户事件就不会失效。
用户事件
1. 我需要收集哪些用户事件？
如需查看用户事件类型列表，请参阅用户事件简介 以及用户事件要求和最佳实践
2. 如何排查模型创建过程中的数据质量问题？
在 Search for Retail 控制台中，前往数据质量页面以查看数据 关于提取的目录和用户事件的质量指标
3. 我可以与 Google Analytics 360 集成吗？
您可以使用 Google Analytics 360 (GA360) 中的历史数据。类似于 Merchant Center 数据，GA360 数据可以导出到 BigQuery 和零售专用 Vertex AI Search 可以读取这些事件 从 BigQuery 中直接查询。
对于实时事件，我们建议将跟踪像素与 Google 跟踪代码管理器集成，因为事件会从 GA360 延迟。
4. 我想从 Google Analytics 360 导入用户事件。它是否提供全部 所需的用户事件？
Google Analytics 360 原生支持 适用于零售行业的 Vertex AI Search（搜索事件除外）。您仍然可以导入搜索 来自 Analytics 360 的用户事件，但请注意， 适用于零售业的 Vertex AI Search 会根据搜索查询构建搜索用户事件， 产品展示次数（如果有）。
5. 如何将事件馈送到 Recommendations AI？
用户通常使用 Cloud Storage 或 API 导入功能导入历史事件，然后使用 JavaScript Pixel 或跟踪代码管理器代码中的实时事件或后端的写入方法流式传输实时事件。
6. 如果我无法发送 模型？每个模型需要的最低事件类型有哪些？
每个模型和优化目标的要求略有不同。请参阅用户事件数据要求。
通常每个目录项的事件数量越多，模型性能越好。对于流量较大并且目录较少的网站，您可以从少量的历史事件开始，但通常仍至少需要数周的历史数据和后续的实时事件。
7. 我的“添加到购物车”事件和“购买完成”事件对以下事件没有价值： 收入或数量我应该提交什么？
如果您没有数量值，可以传递不影响模型结果的默认值 1。商品应始终设置 displayPrice（可以是向用户显示的任何值，例如折扣价格）。originalPrice 和费用为可选项。
8. 我的数据仅涵盖有限类型的事件。我还可以使用 Vertex AI Search for Retail？
如需了解每种模型类型的最低数据要求，请参阅用户事件数据要求。
搜索结果
1. 搜索结果是个性化搜索结果吗？
是。Google 搜索可以提供个性化结果。 系统会根据访问者 ID 对搜索结果进行个性化设置。 如需了解详情，请参阅个性化。
2. 如何在 搜索请求？
基于商店 ID 的可用性和履单选项是商品目录的特性。履单选项是“在线配送”、“在线购买”和“店内取货”等特性。
特性可以作为搜索请求中的参数发送。因此，对于此示例，搜索请求可以指定用户的商店 ID。可以根据请求中的商店 ID 进行过滤结果或让结果排名靠前。
3. 我可以从搜索结果中隐藏商品吗？
可以。filter 参数可以根据其标记过滤掉结果。
4. 能否根据多个条件（例如库存状况和 价格？
是，[boostSpec] 允许复杂的排名规则。
5. 是否可以对某些属性进行分组，以便使用 该怎么办？例如，对于原产地，将同一国家/地区中的城市分组。
商品特性不是分层的。但是，您可以使用多个自定义特性来实现此目的。在此示例中，您可以将自定义特性同时用于生产国家/地区和生产城市。
6. “建议”功能是如何运作的？
建议是用户查询、重写的查询、产品名称等组合。为了生成高质量的自动补全建议，您应该提取足够的搜索事件以及目录。
预测结果
1. 返回的预测数量有限制吗？
默认情况下，预测请求会在响应中返回 20 个项。您可以通过提交 pageSize 值来增加或减少此数值。
如果您需要返回 100 多个项，请与 Google 支持团队联系以提高限额。但请注意，返回 100 多个项可能会增加响应延迟时间。
2. 我能否查看某个车型制造指定商品的原因 建议？
目前不能。
3. 我可以下载和缓存预测结果吗？
由于预测结果会实时响应您网站上的用户活动，因此我们不建议使用已缓存的预测。该模型每天都会重新训练模型，将更改纳入目录，并对可以改变结果的用户事件中的新趋势做出回应。
4. 我需要根据业务规则对返回的建议重新排序。系统是否支持本功能？
可以。虽然您可以根据业务规则重新调整返回的建议的优先级，但请注意，重新排序建议或过滤推荐结果可能会降低模型的整体优化效果。
对相关高价商品进行重新排序时，系统会先对一组 这些建议会被系统返回，并且可作为 您可能喜欢的其他模特以及为您推荐的其他模特。
请参阅价格重排序。
5. 我可以创建和 ？
您可以创建或可使用的唯一标记数量没有硬性限制。不过，该系统并非旨在为每个项目处理多个过滤器标签。如果可能，我们建议为每个目录项最多保留 10 个过滤器标记。在整个目录中都可以使用超过 10 个值；这是针对每件商品的限制。总标记（所有项标签的数量总和）上限为 1 亿。
请参阅文档，了解适用于零售的 Vertex AI Search 配额和限制。
6. 我可以提供多样化的推荐内容吗？
可以。多样化可以在投放配置中指定，也可以在预测请求参数中指定。由于多样性程度低，预测中可能包含属于同一类别的相似商品。多样化程度较高时，结果将包含其他类别的商品。
7. 我可以按价格优先显示建议吗？
可以。价格重排序会导致推荐概率相近的推荐商品按价格进行排序，价格最高的商品列在第一位。相关性仍会用于订购商品，因此启用价格重排序与按价格排序不同。可以在投放配置或预测请求参数中指定价格重排序。
模型
1. 我上传了目录，并且但我在执行上述操作后仍收到此响应 调用预测 API：“推荐模型尚未准备就绪。您可以在预测请求中将“dryRun”设置为 true 以进行集成，这会从目录中返回任意目录项（请勿用于生产流量）。”
这通常意味着您的模型尚未完成训练。如果您模型创建已超过 10 天，但仍收到此响应，请与支持团队联系。
2. 训练模型需要多长时间？
初始模型训练和调优需要 2-5 天才能完成，但可能需要 。 此后，除非停用，否则每天会自动重新训练模型。请参阅 暂停和恢复模型训练。
3. 我可以下载或导出模型吗？
不需要
4. 我可以在新项目中使用在现有项目中创建的模型吗？
5. 我想为我的类别页使用模型。可以这样做吗？
是。“为您推荐”功能在类别页面上非常有用。
类别页与首页相似，区别于前者只能显示属于该类别的商品。您可以使用推荐给您的带有过滤器标签的标准模型来实现此目的。例如，您可以向目录中的项添加自定义过滤器标记（对应于每个类别页面）。发送预测请求时，将用户事件对象设置为 category-page-view，并在 filter 字段中指定特定类别页面的标记。仅返回与所请求的过滤条件标记匹配的建议结果。在此用例中应停用多样性，因为多样性可能会与基于类别的过滤标记冲突。
6. 我可以停用模型的个性化功能吗？
默认情况下，系统会根据用户针对 您可能喜欢的其他、为您推荐和再次购买推荐模型类型。
我们不建议停用个性化功能，因为这会对模型性能产生负面影响。
如果您需要展示与正在查看的产品相关的目录商品 相比根据用户之前与您网站的互动情况进行判断， 使用随机的唯一身份访问者 ID 来接收非个性化推荐， 预测请求。请确保只针对您不想个性化的投放配置中的请求执行此操作。
Search for Retail 控制台
1. 我完全清除了许多活动，但信息中心仍然显示 这些事件类型。
这是正常现象，Search for Retail 信息中心会显示 在特定时间段内注入的事件；不会显示当前的数量 或事件数量
通常情况下，在记录用户事件后，您应妥善保留。不建议执行清除事件。如果您计划完全重置用户事件 请考虑创建一个新项目。
如果您确实需要完全清除未正确记录的事件，请参阅 了解移除用户事件的相关文档。事件完全清除 最多可能需要几天时间才能完成。
2. 如何判断我的目录或用户事件是否存在错误？
如果存在语法问题或者由于某种原因无法处理请求，则目录项更新或用户事件的大多数 API 调用都会返回错误。
Search for Retail 信息中心会显示未联接事件所占的百分比， 也是用于发现目录或活动问题的实用指标。如果的目录中不包含指定项目 ID，则会发生未联接的事件（或未连接的预测调用）。这通常意味着目录过期，需要上传新的或已更改的目录项，但也可能由于传递了错误项目 ID。请检查您的请求，确保项目 ID 正确映射到相应的目录，然后检查您上传的目录以确保项存在。
Cloud Monitoring 和 Cloud Logging 可用于监控事件的状态。例如，如果在某个时间段内没有事件或者预测调用低于特定阈值，您将收到提醒。
3. 为什么我的建议服务配置显示为无效？如何激活它们？
如需使用推荐服务配置，您首先需要提交 目录和用户事件数据，以训练相应的 model.模型训练完成后，信息中心会指示模型已可供查询。
4. Search for Retail 报告收入指标时采用什么币种？
Search for Retail 报告指标时采用下列币种： 上传的数据Vertex AI Search for Retail 不支持使用多个 每个目录的货币，并且不会转换货币。
如果您打算使用 Search for Retail 控制台 收入指标，请确保您的事件都使用单一币种或换算 全部采用同一币种，然后再上传到 Vertex AI Search for Retail。