本页面介绍如何获取目录和用户事件导入中发生的错误以及其他 Retail API 操作。
有关设置提醒的帮助,请参阅设置提醒。
简介
向 Retail API 提供准确的目录信息和用户事件对于获得最高质量的结果非常重要。监控和了解错误来源有助于您查找和修复网站中的所有错误。
查看汇总的集成错误
如需查看数据上传流程和预测或搜索请求产生的聚合错误,请使用“监控”和“分析”页面上的监控标签页。
本页面显示了 Retail API 的所有错误。您可以查看与商品清单、用户事件、Recommendations AI 预测、Retail Search 搜索结果和模型相关的错误。系统还会记录导入操作中的错误,例如 Cloud Storage 文件中格式错误的行。系统为每个导入文件最多记录 100 个错误。您可以定义错误显示的时间段,并根据错误类型进行过滤。
您可以点击单个错误以在 Cloud Logging 中查看该错误的日志。
您可以通过展开单个错误日志来打开该日志。错误日志提供有关请求的更多详细信息,包括请求和响应载荷以及错误详情。此信息可帮助您确定错误的方法调用在网站中的位置。
对于无效的 JSON 错误,您可以通过展开 status
字段来获取有关该问题的更多信息。
查看特定集成操作的状态
您可以使用集成活动面板查看特定集成操作的状态:
转到 Google Cloud Console 中的“零售数据”页面。
转到“数据”页面点击按钮栏上的查看导入活动,打开“导入活动”面板。
您可以检查特定集成操作出现的错误。
在任何发生错误的操作的“详细信息”列中点击查看日志,可检查 Cloud Logging 中的相应日志文件。
错误类型
MISSING_FIELD
:未设置必填字段值。例如,目录项缺少标题。INVALID_TIMESTAMP
:时间戳无效,例如遥远的未来,或者格式不正确。FIELD_VALUE_TOO_SMALL
:字段中的值低于所需的最小值;例如负数价格。INCORRECT_JSON_FORMAT
:请求中的 JSON 格式不正确;例如缺少 { 括号。INVALID_LANGUAGE_CODE
:语言代码格式不正确。FIELD_VALUE_EXCEEDED
:字段中的值大于允许的最大值。INVALID_RESOURCE_ID
:资源 ID 无效;例如,资源名称中的catalog_id
不存在。FIELD_SIZE_EXCEEDED
:字段中的条目数超出上限。UNEXPECTED_FIELD
:本该留空的字段包含一个值;例如,详情页面查看事件对应的事务。INVALID_FORMAT
:字段格式不正确,例如字符串格式不正确RESOURCE_ALREADY_EXISTS
:您尝试创建已存在的资源,例如先前创建的目录商品。INVALID_API_KEY
:API 密钥与请求中的项目不匹配。INSUFFICIENT_PERMISSIONS
:您无权执行请求;此错误通常与缺少必要的 IAM 权限有关。UNJOINED_WITH_CATALOG
:请求中包括目录中不存在的目录项 ID。确保您的目录为最新状态。BATCH_ERROR
:请求中包含多个错误;例如,内嵌导入内容中有10 件商品因不同原因未通过验证。INACTIVE_RECOMMENDATION_MODEL
:您查询的模型目前无法提供服务。ABUSIVE_ENTITY
:与请求关联的访问者 ID 或用户 ID 在短时间内发送的事件次数异常。FILTER_TOO_STRICT
:预测请求过滤条件阻止了所有预测结果。返回一般(非个性化)热门项,除非调用将strictFiltering
指定为 false(在这种情况下,不返回任何项)。导致此问题的一些常见原因:- 您所指定的过滤标记在您的目录中不存在。过滤标记更新最长可能需要一天才会生效。
- 您的过滤条件范围太小。
直接查看日志
您也可以直接在 Logging 中打开日志文件。例如,此链接将打开过去一小时内所有 Retail 错误的日志:Open Retail 日志
查看数据加载指标
成功上传数据系统后,您还可以使用“零售数据”页面上的目录和事件标签页查看数据提取的错误指标,以确保一切顺畅运行。
您还可以添加提醒,以便系统在数据上传系统出现问题时通知您。
目录数据摘要
使用数据页面上的目录标签页查看每个目录分支的概要数据统计信息。此页面显示了您已导入的商品数量、多少商品有库存,以及上次为每个商品清单分支导入产品的时间。
您还可以预览已上传的目录项,并根据产品字段进行过滤。
您可以将数据导入不同分支,以便暂存和预览 Recommendations AI 或 Retail Search 结果。例如,为了为假期做好准备,您可以将新的目录数据上传到非默认分支,并确保零售结果正确生成,然后在您的网站上发布。
用户事件记录统计信息
对于每种用户事件,您可以在事件标签页中查看已记录多少个事件,以及有多少事件无法与产品关联(未联接事件) ,以及这些数字与上一时间段相比如何。您可以选择预设的时间段,也可以输入自定义时间范围。
指标图表显示一段时间内提取的用户事件,您可以按用户事件类型过滤。
数据质量指标
在数据页面上,点击查看数据质量,打开数据质量面板。
数据质量指标显示满足推荐数据质量标准的产品和用户事件所占的百分比。
虽然使用 Retail API 不需要根据这些指标提高数据质量,但我们强烈建议您这样做,以便获得更优质的推荐内容和搜索结果。
目录数据质量
数据页面上的目录标签页会显示目录中符合零售搜索目录质量指标的商品所占的百分比。
如需查看所有目录数据质量指标的列表,请参阅目录数据质量指标。
事件数据质量
数据页面上的事件标签页显示了有多少用户事件同时符合 Recommendations AI 和 Retail Search 的数据质量最佳做法。
事件数据质量标签页包含两个部分:
General Retail API 指标:此标签页中的第一部分显示适用于 Recommendations AI 和 Retail Search 的指标。遵循这些指标的建议可以改进建议和搜索结果。
您可以按所评估用户事件的时间范围过滤此部分中的指标。
搜索指标:本部分中的指标仅适用于零售搜索。遵循这些指标的建议可以改进搜索结果。
这些指标无法按时间范围过滤。
搜索事件指标几乎是实时更新的。包含过滤条件的搜索事件指标会在您首次上传搜索事件后的 4 到 24 小时之间首次更新。然后,大约每 4 小时更新一次。
只有在搜索事件指标达到 100% 后,此部分中的其他指标才会显示。在执行搜索事件后,您可以在大约 24 小时后看到这些指标。然后,系统每天更新一次。
访问的唯一产品和每个产品的平均搜索点击次数是相关的指标。如果这些指标的百分比较低,通过导入更多搜索事件数据来改进其中一个指标也会改善另一个指标。
如需了解 Recommendations AI 和 Retail Search 的所有用户事件要求和建议,请参阅用户事件要求和最佳做法。
未联接的事件
如果用户事件或 API 请求指的是尚未上传到 Retail 的产品,则为未联接事件。未联接的用户事件仍将被记录下来,并且系统会处理未联接的预测请求,但两者都无法用于进一步改进模型以用于将来的预测。因此,对于用户事件和预测请求而言,您应确保未记录的事件百分比极低。
您可以在数据页面的事件标签页中查看未联接用户事件的百分比。
API 错误
通过点击 Monitoring 和 Analytics(分析)页面 按钮栏上的查看 API 指标,您可以看到 API 错误随时间变化的图表,按方法名称显示。
监控 API 方法活动
如需按 API 方法直观呈现流量、错误和延迟时间,请转到“监控和分析”页面上的监控标签页。您可以选择预设的时间段,也可以输入自定义时间范围。
要查看每个图表的更多详细信息,请执行以下操作:
- 在图表下方,点击一个方法名称,以便在图表中将其隔离。
- 将光标悬停在图表上,即可查看标注以及其中包含的各个方法及其相应时间点的值。
- 点击并拖动图表的任意部分来放大该时间段。
后续步骤
- 了解如何为数据 Feed 设置错误提醒。
- 详细了解 Error Reporting。
- 详细了解如何在 Logging 中查看日志。