实体

本页介绍了实体，即根据单个企业网站上的多个品牌或产品捕获各种用户行为的方式，以及如何使用实体和使用实体的理由。

对于大多数使用情形，AI 商业搜索不需要实体。不过，如果零售商通过单个产品目录为多个品牌或区域提供服务，则使用实体可以获得更好的结果。

概览

在项目中设置多个实体，可以考虑不同区域或国家/地区的购物者或在企业旗下不同品牌网站购物的购物者的不同行为和偏好。

零售商 Example Organization 在美国和加拿大都有网站。

Example Organization 希望提供浏览和搜索结果以及自动补全建议，这些结果和建议会考虑到这两个国家/地区的购物者之间的差异。因此，Example Organization 指定了两个实体：org_us 和 org_ca。

用户事件会根据购物者访问的网站（.com 或 ca）标记实体值。当购物者发出搜索请求时，该请求中会包含实体值。

这两个国家/地区在 7 月份有重要但不同的节日。设置实体后，当买家在 Example Organization 网站上搜索 July 时，美国买家会首先看到以美国国庆日为主题的商品，而加拿大买家会看到以加拿大国庆日为主题的商品。

同样，向加拿大购物者提供的推荐更有可能显示加拿大国庆日商品，而不是美国国庆日商品。

企业 Example Organization 最近收购了初创公司 Example Organization。目录已合并，但初创公司品牌和网站得以保留，因为该品牌和网站拥有忠实的受众群体。

该企业创建了一个实体 startup，用于标记源自初创公司网站的用户事件。这样一来，向初创公司网站提供的搜索、浏览、自动补全和推荐建议就可以考虑到初创公司网站购物者的偏好。

设置 AI 商业搜索时，您可以使用不同的项目，也可以在同一项目中使用不同的实体，以便为不同的购物者群体提供不同的建议。

对于某些应用，您需要使用单独的项目。对于其他应用，设置实体是更好的解决方案。

如果您有以下情况，请使用实体：

实体之间共享全部或部分目录
具有以下一项或多项：
- 同一国家/地区或语言区域内有多个品牌，例如，您有原始品牌和收购的品牌，google_home 和 nest。
- 同一国家/地区内有多个区域，例如 enterprise_east 和 enterprise_west。
- 一个品牌，但在多个国家/地区使用同一种语言，例如 brand_us 和 brand_ca。

如果您有以下情况，请使用单独的项目 而不是实体：

如需利用实体功能，请将实体字段添加到用户事件中。

对于搜索和自动补全：在类型为 search 的用户事件中添加 entity 字段。

在其他用户事件类型中添加实体字段有助于问题排查，但不会影响搜索或自动补全响应的质量。
对于推荐 ：系统不支持实体，但您可以将实体作为自定义属性添加到用户事件中。

通常，实体功能需要 30 到 90 天的用户事件数据才能返回最佳建议。

如果请求中缺少实体，则请求不会对结果中的实体做出任何假设。您将获得基于指定和未指定实体的用户事件的平均结果。

如需获取考虑到实体的搜索或浏览结果，请执行以下操作：

如需获取考虑到实体的自动补全结果，请执行以下操作：