Entidades

En esta página se presentan las entidades, que son formas de registrar el comportamiento variado de los usuarios en función de varias marcas o productos en un solo sitio empresarial, así como cómo y por qué se pueden usar.

En la mayoría de los casos prácticos, no se necesitan entidades para Vertex AI Search para el comercio. Sin embargo, los comerciantes que ofrecen varias marcas o regiones desde un solo catálogo de productos pueden obtener mejores resultados si usan entidades.

Información general

Configurar varias entidades en tu proyecto es una forma de tener en cuenta los diferentes comportamientos y preferencias de los compradores que se encuentran en distintas regiones o países, o que compran en sitios con marcas diferentes que pertenecen a tu empresa.

Ejemplo de uso: dos países

Una tienda, Ejemplo, tiene presencia web en Estados Unidos y Canadá.

La organización de ejemplo quiere ofrecer resultados de búsqueda y de navegación, así como sugerencias de autocompletado, que tengan en cuenta las diferencias entre los compradores de los dos países. Por lo tanto, la organización de ejemplo designa dos entidades: org_us y org_ca.

Los eventos de usuario se etiquetan con un valor de entidad, en función del sitio web que haya visitado el comprador (.com o ca). Cuando un comprador hace una solicitud de búsqueda, el valor de entidad se incluye en la solicitud.

Ambos países tienen festivos importantes, pero diferentes, en julio. Una vez configuradas las entidades, cuando los compradores busquen July en el sitio de la organización de ejemplo, los compradores de EE. UU. verán primero los artículos con temática del 4 de julio y los compradores de Canadá verán los artículos con temática del Día de Canadá.

Del mismo modo, es más probable que las recomendaciones para los compradores canadienses muestren artículos del Día de Canadá que del 4 de julio.

Ejemplo de caso práctico: una adquisición

La organización de ejemplo de empresa ha adquirido recientemente la organización de ejemplo de startup. Los catálogos se han combinado, pero se ha conservado la marca y el sitio web de Startup porque tiene una base de seguidores fieles.

La empresa crea una entidad, startup, para etiquetar los eventos de usuario procedentes del sitio de la startup. De esta forma, las sugerencias de búsqueda, navegación, autocompletado y recomendaciones que se ofrecen al sitio de la startup tienen en cuenta las preferencias de los compradores del sitio de la startup.

¿Varios proyectos o varias entidades?

Cuando configures Vertex AI Search para el comercio, podrás usar diferentes proyectos o entidades en el mismo proyecto para obtener sugerencias distintas para tus diferentes poblaciones de compradores.

En algunas aplicaciones, se necesitan proyectos independientes. En otras aplicaciones, es mejor configurar entidades.

Usa entidades cuando tengas lo siguiente:

  • Un catálogo compartido total o parcialmente entre las entidades

  • Una o varias de las siguientes opciones:

    • Varias marcas en el mismo país o zona de idioma. Por ejemplo, tienes tu marca original y una marca adquirida, google_home y nest.

    • Varias regiones del mismo país (por ejemplo, enterprise_east y enterprise_west).

    • Una marca, pero en varios países con el mismo idioma (por ejemplo, brand_us y brand_ca).

Usa proyectos independientes en lugar de entidades cuando tengas lo siguiente:

  • Catálogos que no se pueden combinar o que, si se combinan, tienen poco o ningún solapamiento.

  • Entidades que requieren idiomas diferentes. Solo se permite un idioma por proyecto.

Eventos y entidades de usuario

Para aprovechar la función de entidades, añada el campo de entidad a sus eventos de usuario.

  • Para la búsqueda y la función Autocompletar: incluye el campo entity en los eventos de usuario de tipo search.

    Incluir el campo de entidad en otros tipos de eventos de usuario puede ser útil para solucionar problemas, pero no afecta a la calidad de las respuestas de búsqueda o autocompletado.

  • Para las recomendaciones: incluya el campo de entidad en tantos tipos de eventos de usuario como pueda.

Normalmente, se necesitan entre 30 y 90 días de datos de eventos de usuario para que la función de entidad devuelva sugerencias óptimas.

Si falta una entidad en una solicitud, la solicitud no hace ninguna suposición sobre la entidad en el resultado. Obtendrá un resultado medio basado en eventos de usuario con y sin la entidad especificada.

Búsqueda y entidades

Para obtener resultados de búsqueda o navegación que tengan en cuenta la entidad, sigue estos pasos:

  1. Incluye el campo entity en tu búsqueda de eventos de usuario (eventType="search"). Por ejemplo, consulta el objeto completo del evento de usuario Search.

  2. Añade el campo entity a tu solicitud de búsqueda. Para obtener información sobre cómo hacer solicitudes de búsqueda, consulta Obtener resultados de búsqueda.

Autocompletar y entidades

Para obtener resultados de autocompletar que tengan en cuenta la entidad, sigue estos pasos:

Recomendaciones y entidades

Una vez que haya añadido el campo entity a sus eventos de usuario, no tendrá que hacer nada más para aprovechar las entidades en las recomendaciones. Esto se debe a que el valor de la entidad forma parte del evento de usuario, que, a su vez, se incluye en la llamada al método predict.