实体

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

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

概览

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

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

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

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

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

同样，向加拿大买家提供的推荐商品更可能是加拿大国庆日商品，而不是美国独立日商品。

Enterprise Example Organization 最近收购了 Startup Example Organization。目录已合并，但 Startup 品牌和网站仍保留，因为它们拥有忠实的粉丝群。

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

设置 Vertex AI Search for Commerce 时，您可以使用不同项目或同一项目中的不同实体，为不同的买家群体获取不同的建议。

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

在以下情况下，请使用实体：

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

在以下情况下，请使用单独的项目，而不是实体：

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

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

在其他用户事件类型中包含实体字段有助于问题排查，但不会影响搜索或自动补全响应的质量。
对于推荐：尽可能在多种类型的用户事件中包含实体字段。

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

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

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

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

将 entity 字段添加到用户事件后，您无需执行任何其他操作即可利用实体来生成推荐内容。这是因为实体值是用户事件的一部分，而用户事件又包含在对 predict 方法的调用中。