Entidades

En esta página, se presentan las entidades y se explica cómo y por qué se pueden usar.

En la mayoría de los casos de uso, las entidades no son necesarias en Vertex AI Search para la venta minorista. Sin embargo, los minoristas que entregan varias marcas o regiones desde un solo catálogo de productos pueden obtener mejores resultados si usan entidades.

Descripción general

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

Ejemplo de caso de uso: dos países

Un minorista, Organización Ejemplo, tiene presencia web tanto en EE.UU. como en Canadá.

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

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

En julio, se celebran festividades importantes pero diferentes en ambos países. Con las entidades configuradas, cuando los compradores busquen July en el sitio de la Organización de ejemplo, los compradores estadounidenses recibirán primero los artículos temáticos del 4 de julio, y los compradores canadienses recibirán artículos con un tema para el Día de Canadá.

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

Caso de uso de ejemplo: una adquisición

Enterprise Example Organization adquirió recientemente Startup Example Organization. Se combinaron los catálogos, pero se conservan la marca y el sitio web de la startup porque tienen seguidores leales.

La empresa crea una entidad, startup, para etiquetar los eventos de usuario que se originan en el sitio de Startup. Esto permite que las sugerencias de búsqueda, exploración, autocompletado y recomendaciones que se publican en el sitio de startups tengan en cuenta las preferencias de los compradores del sitio.

¿Varios proyectos o varias entidades?

Cuando configuras Vertex AI Search para la venta minorista, puedes usar diferentes proyectos o entidades en el mismo proyecto a fin de obtener diferentes sugerencias para las distintas poblaciones de compradores.

En algunas aplicaciones, se requieren proyectos diferentes. Para otras aplicaciones, la configuración de entidades es la mejor solución.

Usa entidades cuando tengas lo siguiente:

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

  • Una o más de las siguientes opciones:

    • Varias marcas en el mismo país o área de idioma (por ejemplo, tienes tu marca original y una marca adquirida, google_home y nest)

    • Varias regiones en el 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 separados en lugar de entidades cuando tienes lo siguiente:

  • Son catálogos que no se pueden combinar o que, si se combinan, tienen poca o ninguna superposición.

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

Eventos y entidades de usuario

Para aprovechar la función de las entidades, agrega el campo de entidad a tus eventos de usuario.

  • Para la búsqueda y el autocompletado: Incluye el campo entity en los eventos de usuario del tipo search.

    La inclusión del campo de entidad en otros tipos de eventos de usuario puede ser útil para solucionar problemas, pero no afecta la calidad de las respuestas de búsqueda o autocompletado.

  • Para recomendaciones: Incluye el campo de entidad en tantos tipos de eventos de usuario como puedas.

Por lo general, se necesitan entre 30 y 90 días de datos de eventos del usuario para que la función de la entidad muestre sugerencias óptimas.

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

Búsqueda y entidades

Para obtener resultados de la búsqueda o exploración que tengan en cuenta la entidad, haz lo siguiente:

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

  2. Agrega el campo entity a tu solicitud de búsqueda. Para obtener información sobre cómo realizar solicitudes de búsqueda, consulta Cómo obtener resultados de la búsqueda.

Autocompletado y entidades

Para obtener resultados de autocompletar que tengan en cuenta la entidad, haz lo siguiente:

Recomendaciones y entidades

Después de agregar el campo entity a tus eventos de usuario, no se requiere ninguna otra acción para aprovechar las entidades para recomendaciones. Esto se debe a que el valor de la entidad es parte del evento del usuario, el cual, a su vez, se incluye en la llamada al método predict.