Entidades

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

En la mayoría de los casos de uso, no se necesitan entidades para Vertex AI Search para venta minorista. Sin embargo, los minoristas que publican anuncios para 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 diferentes regiones o países, o que compran en sitios de marcas diferentes que pertenecen a tu empresa.

Ejemplo de caso de uso: dos países

Un minorista, Example Organization, tiene presencia web en EE.UU. y Canadá.

La organización de ejemplo desea publicar resultados de navegación y búsqueda, y sugerencias de autocompletar 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 del 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.

Los dos países tienen feriados importantes, pero diferentes, en julio. Con las entidades configuradas, cuando los compradores buscan July en el sitio de la organización de ejemplo, a los compradores estadounidenses se les muestran primero los artículos temáticos del 4 de julio y a los compradores canadienses se les muestran los artículos temáticos 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 Cuatro de Julio.

Ejemplo de caso de uso: una adquisición

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

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

¿Deseas crear varios proyectos o varias entidades?

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

Para algunas aplicaciones, se requieren proyectos independientes. Para otras aplicaciones, la mejor solución es configurar entidades.

Usa entidades cuando tengas lo siguiente:

  • Un catálogo compartido de forma total o parcial entre las entidades

  • Una o más de las siguientes opciones:

    • Varias marcas en el mismo país o área lingüística (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 independientes en lugar de entidades en los siguientes casos:

  • Catálogos que no se pueden combinar o catálogos 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 del usuario

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

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

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

  • Para las recomendaciones: Incluye el campo de entidad en la mayor cantidad posible de tipos de eventos del usuario.

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

Si falta una entidad en una solicitud, esta no hace ninguna suposición sobre la entidad en el resultado. Obtendrás un resultado promedio que se basa en los eventos del usuario con y sin la entidad especificada.

Búsqueda y entidades

Para obtener resultados de 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 de objeto completo del evento de usuario Búsqueda.

  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 autocompletado 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 las recomendaciones. Esto se debe a que el valor de la entidad forma parte del evento del usuario, que, a su vez, se incluye en la llamada al método predict.