Entidades

En esta página, se presentan las entidades, las formas de capturar el comportamiento variado de los usuarios según varias marcas o productos en un solo sitio empresarial, así como la forma y el motivo por los que se pueden usar.

En la mayoría de los casos de uso, no se necesitan entidades para la Búsqueda de Commerce con IA. Sin embargo, los minoristas que atienden 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 minorista, Organización de ejemplo, tiene presencia en la Web en EE.UU. y Canadá.

Organización de ejemplo quiere publicar resultados de búsqueda y exploración, y sugerencias de autocompletado 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.

Los dos países tienen días festivos importantes, pero diferentes en julio. Con las entidades configuradas, cuando los compradores buscan July en el sitio de Organización de ejemplo, los compradores estadounidenses reciben primero artículos con el tema del Cuatro de Julio, y los compradores canadienses reciben artículos con el tema 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

Enterprise Example Organization adquirió recientemente Startup Example Organization. Los catálogos se combinaron, pero se conservan la marca y el sitio web de Startup porque tiene 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 recomendación que se publican en el sitio de Startup tengan en cuenta las preferencias de los compradores del sitio de Startup.

¿Varios proyectos o varias entidades?

Cuando configuras la Búsqueda de Commerce con IA, puedes usar diferentes proyectos o diferentes 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. En el caso de otras aplicaciones, configurar entidades es la mejor solución.

Usa entidades cuando tengas lo siguiente:

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

  • Uno o más de los siguientes elementos:

    • 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 tengas lo siguiente:

  • 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 de usuario y entidades

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

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

    Incluir el campo entity 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 las recomendaciones: Las entidades no son compatibles, 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 de usuario para que la función de entidades 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 que se basa en eventos de 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 entity campo en tus eventos de usuario de búsqueda (eventType="search"). Para obtener un ejemplo, consulta el ejemplo de objeto completo para el Search evento de usuario.

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

Autocompletado y entidades

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

Recomendaciones y entidades

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