数据质量

本页介绍了搜索使用情形、各自的性能层级，以及如何查看“面向商业的搜索”管理中心，以评估您的数据质量以及您已解锁的性能层级。 当您满足所有升级阻止数据要求时，系统会自动激活每个效果层级。您还必须满足所有较低层级的要求，才能升级到更高层级。

搜索用例

搜索功能可针对以下两种使用情形提供搜索结果：

• 文字查询搜索：当购物者通过输入文字查询在您的应用中查找商品时，系统会返回一组相关结果。
• 浏览搜索：当买家进入特定类别页面（例如家居装饰零售网站的“电器”类别网页）并浏览该类别中已排序的商品时，系统会使用此搜索类型。

如需详细了解这些使用情形之间的区别，请参阅关于文本搜索和浏览搜索。

解锁搜索广告效果层级

文本查询搜索和浏览搜索具有不同的性能层级，可不断改进搜索结果。解锁性能层级取决于您上传到 Vertex AI Search for Commerce 的用户事件和目录数据。

以下性能层级适用于这两种使用情形：文本查询搜索和浏览：

文本查询搜索

浏览

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

以下部分将介绍如何订阅数据质量提醒，以便在当前参数下，系统通知您数据属于哪个层级。这些提醒还可以作为指南，帮助您了解特定使用情形下的数据要求，以便尽可能优化搜索结果。

检查数据质量

上传数据后，前往面向商业的搜索控制台，查看相应用例的每个性能层级的数据检查指标。

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

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

   • 对于文字搜索指标，请点击搜索标签页。
   • 如需查看浏览搜索指标，请点击浏览标签页。

3. 查看页面顶部每个效果层级的得分卡，了解存在的问题。

   • 如果标签为“使用中”：您已解决相应层级的所有阻碍问题，并已解锁该层级。
   • 如果存在 0 个阻塞性问题：您已通过相应层级的数据检查。如果相应层级及其之前的所有层级都没有阻塞性问题，则大约需要 24 小时来训练和准备模型，并激活新解锁的层级。
   • 如果存在任何阻碍性问题：请检查相应层级的指标，了解需要解决哪些数据问题才能解锁该层级。

4. 查看每个效果层级的数据检查指标表格，了解可能会阻止层级升级或影响搜索效果的问题列表。

5. 查看状态列，了解每个数据检查指标的优先级：

   • 阻止升级：可识别出导致搜索功能无法将您的应用场景升级到下一性能层级的数据问题。如需解锁某个层级，需要通过相应性能层级（及其先前层级）的所有阻止升级的数据检查。
   • 性能严重：可识别出不会阻止升级但可能会对文本搜索或浏览搜索效果产生重大影响的数据问题。
   • 合规：表示已成功通过此数据检查。
   • 不可用：表示尚未完成非升级阻止性数据检查。这些指标的值显示为 N/A。导入数据后，最多可能需要 24 小时才能执行一些数据检查。

6. 如需详细了解任何指标，请点击详情以查看详细信息面板，其中会显示相应指标的说明、数据检查时间戳和阈值。

7. 在指标的详细信息面板中查看阈值，了解满足该指标的数据检查所需的值，并改进结果。并非所有阈值都适用于所有指标：

   • 阻塞阈值：必须满足的阈值，才能通过相应指标的数据检查。
   • 关键阈值：强烈建议达到的阈值。 未达到此阈值可能会对性能产生显著的负面影响。
   • 警告阈值：建议达到的阈值。未达到此阈值可能会对性能产生轻微影响。

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

最佳做法

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

针对收入优化程度较高的层级的特征选择

Vertex AI Search 商务解决方案已升级，可为数据达到较高性能层级的零售商提供可优化收入的搜索功能。这些高层级零售商现在可以使用功能选择：

• 对于浏览：白银级和黄金级
• 对于搜索：第 3 级和第 4 级

为何要升级排名？

Vertex AI Search for Commerce 的大型客户在其商品清单中最多有 10,000 个自定义属性，而之前的排名模型只有 20 个静态商品特征（例如价格和平均评分），这些特征在所有客户之间共享。这导致排名模型的产品数据非常不完整，并且无法针对不同的零售网域和使用情形（例如时尚、硬件或家居用品）自定义产品特征。

无法对自定义属性进行建模，导致一些用户将他们认为重要的属性放入静态（固定）商品特征中。不过，这需要手动操作，并且显然只适用于少量属性。

动态自定义功能选择

Vertex AI Search 商务解决方案已升级其可优化收入的层级，以自动选择自定义属性。升级涉及将相关自定义属性纳入排名流程：

• 遍历每个零售商的所有自定义属性，并选择最有用的属性添加到静态产品功能集中。
• 显示每个零售商的所选属性。
• 定期（每 30 天一次）重复执行特征选择流程。

总而言之，Vertex AI Search for Commerce 不仅让排名模型能够访问多达 100 个或更多潜在的新特征以供模型选择，而且还会定期刷新每个客户的属性，以适应季节性销售和其他动态数据变化。

升级后的排名解决方案可提供更强大的搜索数据洞见，并利用定期更新的自定义属性来提高数据质量。

全面的产品知识

• 特征选择：Vertex AI Search for Commerce 算法会为每个零售商选择最多 20 个最重要的自定义属性。
• 优势：利用有关产品的其他信息（例如促销代码和产品或款式规格）提高排名准确性。
• 可见性：零售商可以查看所选的自定义属性，并确保这些属性得到维护且是最新的。
• 自定义和学习：客户可以识别所选自定义属性中的模式，并添加其他相关属性，以进一步提升排名效果。

如何查看正在使用的属性

如果客户启用了较高层级，且拥有足够的用户事件数据点，那么现在可以在控制台中看到新的自定义属性信息，这些信息会列在“Search for commerce”的数据质量页面中的文本搜索和/或浏览搜索标签页下。此处会显示 Vertex AI Search for Commerce 系统选择的自定义属性。

如何处理自定义属性

• 请保留所选的属性，不要删除或弃用这些属性，因为这可能会影响模型。
• 提高自动选择的属性的覆盖率，为更多商品填写这些字段
• 检查自动选择自定义特性的趋势。如果您有其他类似属性，请将其添加到目录中。它们将成为功能搜索算法的选择对象。
• 通过为数值属性分配数值而非字符串值，正确地对其进行注释。例如，提供数值 10.5，而不是文本（“10.5”）。

关闭个性化功能

如需关闭个性化设置，请将 ServingConfig.personalizationSpec 设置为 mode.DISABLED。

数据质量提醒

如果信息中心内的某项指标值从满足条件变为不满足条件，系统就会触发数据质量提醒。系统会通过电子邮件发送提醒。

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

查看数据质量

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

2. 查看行、指标和提醒：一行对应一个指标，一个指标对应一个提醒。

设置数据质量提醒

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"
        }
      ]
    }
  ]
}'

停用数据质量提醒

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": [
      ]
    }
  ]
}'

问题排查

下面介绍了如何解决以下常见问题。

数据检查未通过

如果某项数据检查未通过，请在数据质量页面上点击相应指标的详情，查看该指标的更详细说明以及满足相应数据检查的阈值。

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

如果您未满足数据要求，可能需要重新设置数据格式或收集更多数据，才能满足数据检查要求。确保数据达到指标阈值后，重新导入重新格式化的数据或导入其他数据，然后等待系统重新计算指标。

标记为“不适用”的指标值

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

效果层级没有阻塞性问题，但未被使用

如需进行问题排查，请按以下步骤操作：

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

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

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

其他数据要求信息

如需详细了解 Vertex AI Search 商务解决方案的数据要求，请参阅以下文档：

• 上传用户事件数据时，Vertex AI Search for Commerce 的一般要求： 用户事件要求
• 获取搜索结果的最低用户事件要求： 搜索要求
• 目录数据要求： 目录数据质量指标

后续步骤

• 导入历史用户事件
• 导入目录信息