解锁搜索效果层级

本页面介绍了搜索用例及其各自的性能层级,以及如何查看 Search for Retail 控制台以评估数据质量以及您已解锁哪些性能层级。了解如何注册数据质量提醒。

搜索用例

Google 搜索为两种使用场景提供搜索结果:

  • 文本查询搜索:当买家通过输入文本查询并获取一组相关结果在您的应用中查找商品时,会使用此模式。
  • 浏览搜索,在买家到达特定类别网页(例如家装店零售网站的“电器”类别网页)时,使用浏览搜索来浏览该类别中的已排序商品。

如需详细了解这些用例之间的差异,请参阅关于文本搜索和浏览搜索

性能层级

文本查询搜索和浏览搜索具有不同的性能层级,可提高搜索结果的质量。性能层级的解锁取决于您上传到 Vertex AI Search for Retail 的用户事件和目录数据。

当您满足每个性能层级的所有阻止升级的数据要求后,系统会自动激活该层级。您还必须满足之前所有层级的相关要求,才能升级到下一层级。

以下性能层级适用于每种用例:

  • 文本查询搜索用例

    • 相关性:系统仅根据与查询的相关性返回结果
    • 相关性和热门程度:系统会根据与查询的相关性返回结果。相关程度相等的商品按照商品在您网站上的热门程度进行排名
    • 针对收入进行了优化:相关结果按照商品被购买的可能性(基于网站级活动)进行排名
    • 个性化且针对收入进行了优化:相关结果按单个用户的偏好以及用户购买相应商品的可能性(基于网站级活动)进行排名
  • 浏览搜索用例

    • 热门程度:系统仅根据与类别的相关性返回结果
    • 针对收入进行了优化:相关结果按照商品被购买的可能性(基于网站级活动)进行排名
    • 个性化且针对收入进行了优化:相关结果按单个用户的偏好以及用户购买相应商品的可能性(基于网站级活动)进行排名

Search for Retail 控制台提供了一个数据质量页面,您可以在其中检查您是否满足每个层级的数据要求。

检查数据质量

上传数据后,请前往 Search for Retail 控制台,查看您的用例的每个性能层级的数据检查指标。

  1. 前往 Search for Retail 控制台中的数据质量页面。

    转到“数据质量”页面

  2. 查看您的搜索用例的数据检查指标:

    • 对于文本搜索指标,请点击搜索标签页。
    • 如需查看浏览搜索指标,请点击浏览标签页。
  3. 在页面顶部查看每个性能层级的问题计分卡。

    • 如果标记为“正在使用”:表示您已解决该层级的所有阻止问题,并已解锁该层级。
    • 如果未发生阻止问题:您已满足该层级的数据检查要求。如果此层级以及之前的所有层级都不存在阻止问题,系统大约需要 24 小时才能训练和准备模型,然后激活新解锁的层级。
    • 如果存在任何阻塞问题:请查看该层级的指标,以了解需要解决哪些数据问题才能解锁该层级。
  4. 查看每个性能层级的数据检查指标表,了解可能会阻止层级升级或影响搜索性能的问题列表。

  5. 检查 Status 列,了解每个数据检查指标的优先级:

    • 阻止升级:识别阻止搜索将您的用例升级到下一性能层级的数据问题。如需解锁某个层级,需要通过相应性能层级(及其先前层级)的所有阻止升级的数据检查。
    • 性能关键型:识别不会阻止升级但可能会对文本搜索或浏览搜索性能产生重大影响的数据问题。
    • 合规:表示已通过此数据检查。
    • 不可用:表示非升级阻止数据检查尚未完成。这些指标的值显示为不适用。导入数据后,最多可能需要 24 小时才能执行一些数据检查。
  6. 如需详细了解任何指标,请点击详细信息以查看详细信息面板,其中会显示该指标的说明、数据检查时间戳和阈值值。

  7. 查看指标的详细信息面板中的阈值,了解需要满足哪些值才能满足该指标的数据检查要求并改进结果。并非所有阈值都适用于所有指标:

    • 阻塞阈值:要满足此指标的数据检查要求,必须满足一定的阈值。
    • 临界阈值:强烈建议满足的阈值。 未达到此阈值可能会对性能产生重大负面影响。
    • 警告阈值:建议达到的阈值。未达到此阈值可能会对性能产生轻微的影响。

如需导入更多数据以满足任何数据问题,请参阅公开文档中的导入历史用户事件导入目录信息

最佳实践

  • 在搜索请求和用户事件中,除了已登录的用户 ID 之外,还应提供用户 ID。这样,Google 搜索就可以根据用户在设备上的登录事件,为用户显示个性化的搜索结果。
  • 实时发送用户事件,而不是延迟进行批量上传。这有助于 Google 搜索根据您网站上用户的最新活动提供个性化搜索结果。
  • 上传所有用户事件。例如,不要仅提交可归因于搜索的事件。

关闭个性化功能

如需关闭个性化功能,请将 ServingConfig.personalizationSpec 设置为 mode.DISABLED

数据质量提醒

如果信息中心内的某个指标值从满意变为不满意,就会触发数据质量提醒。提醒是通过电子邮件发送的。

如果您想查看与 Cloud Monitoring 相关的提醒,请参阅设置提醒

查看数据质量

前往 Search for Retail 控制台中的数据质量页面。

转到“数据质量”页面

一行对应一个指标,一个指标对应一条提醒。

设置数据质量提醒

REST

调用 UpdateAlertConfig API。

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "ENROLLED",
      "recipients": [
        {
          "emailAddress": "EMAIL_ADDRESS_1"
        },
        {
          "emailAddress": "EMAIL_ADDRESS_2"
        }
      ]
    }
  ]
}'

替换以下内容:

  • PROJECT_ID:您的 Google Cloud 项目的 ID。
  • EMAIL_ADDRESS_1EMAIL_ADDRESS_2:您要注册接收提醒的电子邮件地址。它们应该符合 SMTP(简单邮件传输协议)。最多可以向一项提醒政策中添加 20 个电子邮件地址。

停用数据质量提醒

REST

调用 UpdateAlertConfig API。

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "DECLINED",
      "recipients": [
      ]
    }
  ]
}'

替换以下内容:

  • PROJECT_ID:您的 Google Cloud 项目的 ID。

问题排查

以下是一些常见问题及其解决方法:

数据检查未通过

如果数据检查未通过,请在数据质量页面上点击该指标的详细信息,以查看该指标的更详细说明以及满足该数据检查要求的阈值。

如果您已满足数据要求,请查看时间戳部分,了解上次计算该指标的时间。如果您最近调整了格式或提取了大量数据,则可能需要几个小时才能重新计算该指标。

如果您尚未满足数据要求,则可能需要重新设置数据格式或收集更多数据,以满足数据检查要求。在确保数据满足指标阈值后,请重新导入已重新设置格式的数据或导入其他数据,然后等待指标重新计算。

指标值显示为“不适用”

如果未上传任何数据或尚未计算指标,则指标值显示为“不适用”。导入数据后,最多可能需要 24 小时才能执行一些数据检查。

性能层级不存在阻塞问题,但未被使用

要进行问题排查,请按以下步骤操作:

  1. 检查之前的层级是否存在任何阻塞数据问题。您需要满足之前所有层级的要求才能升级到下一层级。

  2. 等待 24 小时。在所有阻止升级的数据检查通过后,系统大约需要 24 小时才能训练和准备模型并激活新解锁的层级。

如果性能层级在通过所有阻止升级的数据检查后的两天内未标记为“使用中”,请与 Vertex AI Search for Retail 支持团队联系,并提供您的项目编号和项目 ID 以获取帮助。

其他数据要求信息

如需详细了解适用于零售业的 Vertex AI Search 数据要求,请参阅以下文档:

后续步骤