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 entidad se incluye en la solicitud.

Ambos países tienen festividades importantes, pero diferentes, en julio. Con las entidades configuradas, cuando los compradores busquen July en el sitio de la organización de ejemplo, 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 autocompletar.

  • Para las recomendaciones: Incluye el campo de entidad en tantos tipos de eventos del 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 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

Después de agregar el campo entity a tus eventos de usuario, no se requiere ninguna acción adicional 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.