Entidades

En esta página, se presentan las entidades, las formas de captar el comportamiento variado de los usuarios según las diferentes marcas o productos en un solo sitio empresarial, y 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 for Commerce. Sin embargo, los comercios que publican anuncios de 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 los diferentes comportamientos y preferencias de los compradores que se encuentran en diferentes regiones o países, o que compran en sitios con diferentes marcas que pertenecen a tu empresa.

Ejemplo de caso de uso: dos países

Un comercio minorista, Example Organization, tiene presencia en la Web tanto en EE.UU. como en Canadá.

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

Ambos países tienen días festivos importantes, pero diferentes, en julio. Con las entidades configuradas, cuando los compradores busquen July en el sitio de Example Organization, los compradores estadounidenses verán primero los artículos con temática del Día de la Independencia y los compradores canadienses recibirán 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 artículos del Cuatro de Julio.

Ejemplo de caso de uso: una adquisición

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

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

¿Varios proyectos o varias entidades?

Cuando configuras Vertex AI Search para comercio electrónico, puedes usar diferentes proyectos o entidades en el mismo proyecto para obtener diferentes sugerencias para tus diferentes poblaciones de compradores.

En el caso de algunas aplicaciones, se requieren proyectos separados. Para otras aplicaciones, configurar entidades es la mejor solución.

Usa entities 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 en los siguientes casos:

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

  • Son 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 la función de autocompletar: Incluye el campo entity en los eventos de 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 las respuestas de la búsqueda o de la función de autocompletar.

  • Para las recomendaciones: No se admiten las entidades, pero se pueden agregar como un atributo personalizado en los eventos de usuario.

Por lo general, se necesitan entre 30 y 90 días de datos de eventos del usuario para que la función de entidades devuelva 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 basado 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 completo del objeto para el 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.

Autocompletar y entidades

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

Recomendaciones y entidades

Si bien las recomendaciones no admiten la función de entidades, como solución alternativa, el campo entity se puede agregar como un atributo personalizado, que se puede incluir en la llamada al método predict.