Facetas para la búsqueda

En esta página, se presentan algunas de las funciones de las facetas y cómo usarlas.

Definiciones relacionadas con las facetas

En esta sección, se proporcionan algunas definiciones y explicaciones básicas de algunos términos relacionados con las facetas:

• Facetas: Son las especificaciones de las facetas para realizar la búsqueda por facetas. Ayudan a los usuarios a encontrar lo que buscan filtrando los resultados. Por ejemplo, si un usuario busca shoes, algunas facetas que se podrían mostrar son: price, attributes.department, attributes.colors y attributes.size.

• Atributos del sistema: Los atributos del sistema predefinidos son campos de productos existentes que proporcionan más información sobre el producto. Estos incluyen algunos atributos de productos predefinidos, como brand, availability, color y size.

• Atributos personalizados: Los atributos personalizados son atributos adicionales que defines con el campo Product.attributes. Por ejemplo, esto podría incluir style, color o department.

• Clave de faceta: Es el nombre de una faceta. Por ejemplo, podría ser attributes.department o sizes. Las claves de los componentes facetados corresponden a los nombres de los atributos. Por ejemplo, el nombre del atributo del sistema (product) sizes corresponde a la clave de faceta sizes. De manera similar, el nombre del atributo personalizado (del producto) department corresponde a la clave de faceta attributes.department (para los atributos personalizados, se agrega el prefijo attributes. al nombre del atributo personalizado para obtener la clave de faceta). Los términos nombre de atributo, clave de faceta y nombre de faceta son intercambiables.

• Valor de faceta: En el caso de las claves de texto, este es uno de los valores de texto de una faceta. Por ejemplo, la clave de faceta textual brands podría tener valores textuales como Asics y Nike. Para las claves numéricas, un valor de faceta es un intervalo. Por ejemplo, la clave de faceta numérica precio podría tener un intervalo del tipo [20, 30).

• Tipo de atributo o faceta: Pueden ser textuales o numéricos.

• Facetas fijas: Es un atributo que pasas en la solicitud con FacetSpec con la opción enableDynamicPosition=false. Las facetas deben aparecer en su orden original antes de todas las facetas dinámicas en la respuesta.

• Facetas dinámicas: Son facetas que la búsqueda clasifica a su lado. Se pasan en la solicitud con la opción enableDynamicPosition=true o se recuperan según los modelos de búsqueda. Luego, se clasifican según los mismos modelos entrenados, con los más relevantes en la parte superior.

• Facetas, facetas dinámicas o mosaicos: Cuando un atributo está habilitado para las facetas dinámicas, la búsqueda puede usar automáticamente este atributo como una faceta dinámica en función del comportamiento anterior de los usuarios, como los clics y las vistas de las facetas. Para habilitar las facetas dinámicas para un atributo, también debes habilitar el indexado para ese atributo.

• Filtro: La sintaxis de filtro consta de un lenguaje de expresión para construir un predicado a partir de uno o más campos de los productos que se filtran. Por ejemplo, si un usuario interactúa con los valores de faceta Asics de la clave de faceta attributes.brands, parte del filtro podría ser (attributes.brands:ANY(\"Asics",\"Nike\")). La expresión del filtro distingue mayúsculas de minúsculas. Consulta más detalles sobre el filtro en esta guía del usuario.

Acerca de las facetas y los mosaicos dinámicos

Cuando las facetas dinámicas están habilitadas para una configuración de publicación, la búsqueda puede usar automáticamente atributos como facetas y tarjetas dinámicas en los resultados de la búsqueda para esta configuración, según el comportamiento anterior del usuario, como los clics y las vistas de la faceta. Las facetas dinámicas se pasan en la solicitud con la opción enableDynamicPosition=true o se recuperan según los modelos de búsqueda. Luego, se clasifican según los mismos modelos, y los más relevantes se muestran en la parte superior.

De forma predeterminada, la mayoría de las claves de facetas son facetables. La configuración de las facetas dinámicas en la API se puede reemplazar por controles de atributos de todo el sitio en la consola de Search for Retail para algunas claves de faceta específicas que elijas. En otras palabras, si quieres que algunas claves de faceta no sean facetadas, debes inhabilitar la facetación dinámica para cada una de estas claves en la pestaña Attribute controls. Para obtener más información, consulta Cómo administrar controles de atributos de todo el sitio.

Ten en cuenta que las tarjetas y facetas dinámicas se pueden crear solo en función de datos precisos del catálogo de productos. Sin embargo, para que la función funcione de manera óptima en tu sitio, los modelos de facetas deben aprender a partir de la actividad en el sitio. Para ello, debes configurar los campos de consulta, categoría y filtro en las cargas de eventos de búsqueda con precisión.

Si ninguna de tus configuraciones de publicación tiene habilitadas las tarjetas y las facetas dinámicas, y solo habilitaste las tarjetas y las facetas dinámicas en una configuración de publicación, espera entre tres y cuatro días para que funcionen.

Controles de facetas

En esta sección, se proporcionan instrucciones para crear diferentes tipos de controles de faceta, muchos de los cuales también rigen el comportamiento de las tarjetas:

• Ignora los controles de valores de faceta y mosaico
• Cómo reemplazar los controles de valores de facetas y mosaicos
• Controles de combinación de facetas
• Establece controles de intervalos numéricos
• Cómo quitar facetas y controles de tarjetas
• Controles de facetas de retorno forzosas
• Controles para volver a clasificar las facetas dinámicas

Vertex AI Search para la venta minorista realiza la concordancia con distinción entre mayúsculas y minúsculas para todos estos controles de faceta, a menos que se indique lo contrario.

Nota: Los últimos tres tipos de control de facetas dinámicos, quitar, forzar la devolución y volver a clasificar, no afectan a las tarjetas.

Para controlar valores de facetas y el comportamiento de las tarjetas específicos, navega a la pestaña Controles de facetas en la consola de Búsqueda para venta minorista.

Ir a la página Controles

Haz clic en Crear control para modificar las facetas que se devuelven de la búsqueda. Se abrirá el panel Crear control. Haz clic en el campo Tipo de control para abrir un menú desplegable en el que puedes seleccionar el tipo de control. Cada una abre un diálogo con opciones para controlar tus facetas. Todos los tipos de control de facetas requieren al menos la información del atributo, pero cada formulario requiere información ligeramente diferente.

Crea un control para ignorar valores de faceta y mosaico

Crea un control para ignorar valores de facetas y mosaicos cuando quieras quitar algunos valores de facetas y mosaicos no deseados para algunas claves de facetas y mosaicos específicas.

Nota: Solo puedes ignorar los atributos de texto. Este control no se aplica a los atributos numéricos.

Este control es útil para borrar valores de facetas y mosaicos no deseados, como NA y Not_applicable. Sin embargo, también se puede usar para borrar las tendencias estacionales, como Easter, si estás en octubre.

Para crear un control que omita los valores de faceta y mosaico, haz lo siguiente:

1. Ve a la página Controles en la consola de Search for Retail.

   Ir a la página Controles

2. En la pestaña Controles de faceta, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Omitir valores de faceta y mosaico.

4. Especifica el nombre del atributo.

   Por ejemplo, brands para un atributo del sistema. En el caso de un atributo personalizado, el nombre comienza con attributes., por ejemplo, attributes.department y attributes.colors.

5. Opcional: Especifica la Hora de inicio o la Hora de finalización.

6. Especifica uno o más valores de atributo como Valores para ignorar.

   Por ejemplo, NA, Not_applicable y Easter.

7. Haz clic en Enviar.

Crea un control para reemplazar los valores de faceta y mosaico

Crea un control de reemplazo de valores de faceta y mosaico cuando desees consolidar una serie de valores de faceta y mosaico similares en un solo término.

A veces, reemplazar los valores de faceta y mosaico se conoce como combinar valores de faceta y mosaico.

Para evitar conflictos y asignaciones inútiles, si un valor de atributo facet_value_1 se reemplaza por otro valor de atributo facet_value_2, este último no se puede reemplazar por otro valor de atributo. Por ejemplo, si reemplazas ruby por dark red, no puedes reemplazar dark red por red posteriormente.

Para cada nombre de atributo, un valor de atributo no debe aparecer más de una vez en el campo Reemplazar valores.

Nota: Esta función solo funciona para atributos textuales personalizados. No se pueden reemplazar los valores de los atributos numéricos. Durante la indexación de cada producto, se incluirán los valores reemplazados y los valores de reemplazo como valores de atributo, a menos que superes la cantidad máxima de valores permitidos por atributo personalizado por producto, en cuyo caso la búsqueda truncará los valores de reemplazo de forma arbitraria.

Para crear un control que reemplace la faceta y los valores, sigue estos pasos:

1. Ve a la página Controles en la consola de Search for Retail.

   Ir a la página Controles

2. En la pestaña Controles de faceta, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Reemplazar los valores de faceta y mosaico.

4. Especifica el nombre del atributo.

   Esta función solo funciona para los atributos personalizados, que comienzan con el prefijo attributes, por ejemplo, attributes.department y attributes.colors.

5. Especifica uno o más valores de atributo como Reemplazar valores, por ejemplo, RED, Red, dark red, bright red, ruby y crimson.

   Un valor de atributo solo puede aparecer una vez en el campo Reemplazar valores.

6. Especifica un solo valor de atributo como Término de reemplazo, por ejemplo, red.

7. Haz clic en Enviar.

Aunque los valores reemplazados pueden desaparecer rápidamente, los términos de reemplazo pueden tardar hasta cuatro días en aparecer.

Cuando el control de reemplazo de valores de faceta se aplica, si la clave de faceta (en este ejemplo, attributes.colors) se muestra en la respuesta, los valores de faceta reemplazados (como dark red y crimson) no estarán presentes como valores de faceta. Se reemplazan por sus términos de reemplazo (por ejemplo, red).

Crea un control de combinación de facetas

Es mejor que configures correctamente los nombres y valores de los atributos personalizados de los productos antes de que se transfieran a la base de datos de la Búsqueda. Sin embargo, si no puedes cambiar los nombres de los atributos personalizados, puedes crear controles de facetas combinadas. Creas un control de combinación de facetas si deseas combinar (reemplazar) una faceta con otra. Por ejemplo, puedes tener varias claves de faceta personalizadas para colores, como attributes.colors_jeans, attributes.colors_clothes y attributes.colors_hue, y deseas reemplazarlas por una clave de faceta personalizada existente llamada attributes.colors.

Nota: Solo puedes combinar un valor de faceta textual con otro valor de faceta textual. De manera similar, solo puedes combinar una faceta numérica en otra faceta numérica única. Puedes combinar una faceta en un máximo de una faceta combinada. Puedes combinar varias facetas en la misma faceta combinada. Tanto una clave como su clave combinada deben ser nombres de atributos personalizados válidos (con el prefijo attributes. agregado). En otras palabras, estas dos claves deben ser los nombres de atributos personalizados de algunos productos transferidos.

De preferencia, las claves combinadas deben cumplir con los siguientes requisitos:

• Son nombres de atributos personalizados que son permanentes y no cambiarán de tipo.
• Los nombres de los atributos de muchos productos transferidos

Si borras una clave combinada, perderás sus datos de participación, que se usan para entrenar modelos de facetas dinámicos.

Durante la indexación de cada producto, las claves y las claves combinadas se incluyen como nombres de atributos, a menos que superes la cantidad máxima de atributos permitidos por producto. Si la cantidad máxima de atributos supera la cuota permitida por producto, la búsqueda trunca de manera arbitraria las claves combinadas que se convierten en nombres de atributos.

Por ejemplo, si ya tienes la cantidad máxima de nombres de atributos personalizados para un producto específico y uno de sus nombres de atributos personalizados es colors_jeans, supongamos que usas un control de combinación de facetas para combinar attributes.colors_jeans en attributes.colors. En este caso, el nombre del atributo colors no se agregará a este producto específico, ya que ya contiene la cantidad máxima de claves personalizadas por producto. Las claves combinadas no se borrarán de los nombres de atributos (personalizados) de los productos, pero tampoco se mostrarán como claves de facetas dinámicas. De manera similar, si combinas varias claves con la misma clave y esto hace que la cantidad de valores de atributos de la clave combinada supere el límite de valores de atributos permitidos, la búsqueda trunca los valores de atributos de forma arbitraria.

Para crear un control que combine una faceta en otra, sigue estos pasos:

1. Ve a la página Controles en la consola de Search for Retail.

   Ir a la página Controles

2. En la pestaña Controles de faceta, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Combinar facetas.

4. Especifica una clave de faceta personalizada válida que se combine con otra.

   Esta función solo funciona para los atributos personalizados, que comienzan con el prefijo attributes, por ejemplo, attributes.colors_clothes y attributes.colors_jeans.

5. Especifica una clave de faceta personalizada válida como la clave combinada.

6. Haz clic en Enviar.

Por lo general, este control se aplica en un plazo de 2 a 4 días.

Crea un control de intervalos numéricos establecidos

El control de intervalos numéricos establecidos te permite determinar los intervalos de una faceta o tarjeta numérica en lugar de tener que aceptar intervalos calculados.

Por ejemplo, la búsqueda podría calcular los intervalos [10,15), [15,20) [20,25), [25,30), [30,40) y [40,50) y [50,infinito) para la clave de faceta numérica personalizada attributes.monitor_size. Sin embargo, es posible que prefieras los intervalos [0,14), [14,17), [17,21), [21,24), [24,27), [27,32) y [32,infinito).

Acerca de los intervalos calculados y establecidos

Nota: La Búsqueda calcula los intervalos solo si tienes al menos un serving config con DynamicFacetSpec establecido en Enabled.

Para todos los atributos personalizados numéricos y los atributos numéricos del sistema price, rating y ratingCount, la búsqueda calcula algunos intervalos con límites redondeados según la distribución de todos los valores del atributo (numérico) para cada uno de estos atributos. También puedes especificar algunos intervalos en la solicitud. Como última opción, puedes establecer tus propios intervalos para cada clave de faceta numérica con los siguientes controles para establecer intervalos numéricos.

Este es el orden de prioridad que determina qué intervalos se usan:

• Primero, si se especifican algunos intervalos en la solicitud de una clave de faceta numérica, estos intervalos se conservan.

• De lo contrario, si una clave de faceta numérica es dinámica o se pasa en la solicitud sin intervalos, los intervalos que incluyes con los controles de intervalos numéricos establecidos se agregan a esa clave de faceta numérica si estos intervalos no están vacíos.

• De lo contrario, se agregarán los intervalos calculados mencionados anteriormente con límites redondeados.

Crea el control

Si deseas especificar tus propios intervalos para las claves numéricas de facetas y tarjetas en lugar de usar los que Vertex AI Search para venta minorista calcula por ti, crea un set de controles de intervalos numéricos.

Nota: Solo puedes establecer intervalos en atributos numéricos.

Para crear un control para agregar intervalos, sigue estos pasos:

1. Ve a la página Controles en la consola de Search for Retail.

   Ir a la página Controles

2. En la pestaña Controles de faceta, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Establecer intervalos numéricos de tarjetas y facetas.

4. Especifica el nombre de un atributo numérico.

   Por ejemplo, price para un atributo del sistema. Para un atributo personalizado, el nombre comienza con attributes., por ejemplo, attributes.number_of_pieces.

5. Especifica al menos uno de los valores Mínimo o Máximo. Si se especifican ambos, el valor mínimo no puede ser mayor que el máximo. Puedes elegir que cada límite sea inclusivo o exclusivo.

6. Para agregar más intervalos, haz clic en Agregar intervalos. La cantidad máxima de intervalos es 40.

7. Haz clic en Enviar.

Crea un control para quitar facetas y mosaicos

El control para quitar facetas te permite quitar una faceta y una clave de mosaico específicas de las facetas dinámicas. Las claves de faceta y mosaico se quitan según algunos términos de consulta o categorías de página determinados.

Este tipo de control de facetas controla el atributo en sí. Si se aplica este tipo de control de facetas, no se mostrarán facetas ni tarjetas asociadas a esta faceta como miembros en la búsqueda.

Este control es útil si quieres quitar algunas claves de facetas y tarjetas para algunos términos de búsqueda o navegación. Por ejemplo, puedes usar este control para quitar la clave de faceta attributes.shoe_size de la consulta "zapatillas".

Para crear un control que quite una faceta o un mosaico, sigue estos pasos:

1. Ve a la página Controles en la consola de Search for Retail.

   Ir a la página Controles

2. En la pestaña Controles de faceta, haz clic en Crear control. Se abrirá el panel Crear control.

3. Selecciona Quitar facetas y mosaicos.

4. Cada control es para buscar o explorar, pero no se puede aplicar a ambos. Realice una de las siguientes acciones:

   • En el caso de las búsquedas, haz clic en Buscar y especifica algunos términos de búsqueda parciales o algunos términos de búsqueda exactos que coincidan. Consulta la información detallada en los términos de la consulta y las condiciones. Los términos de la búsqueda deben estar en minúsculas en ambos casos. Por ejemplo, puedes especificar los términos de consulta parciales shirts, polo, jackets, t-shirt y fall coats, y las claves de faceta que se especifican a continuación no aparecerán como una faceta dinámica si la consulta en minúsculas es uno de estos términos de consulta o contiene cualquiera de estos términos de consulta como un unigrama.

   • Para explorar, haz clic en Explorar categorías y especifica algunas categorías de página. Puedes especificar una lista (hasta 10 entradas) de categorías o departamentos. El formato debe ser el mismo que el de las categorías de páginas de los eventos del usuario. Por ejemplo, podría ser page_categories : Sales > 2023 Black Friday Deals. Si hay una coincidencia exacta (con distinción entre mayúsculas y minúsculas) entre este último y una de las categorías de página que se pasa en el evento (para la navegación), las claves de faceta que se especifican a continuación no aparecerán como una faceta dinámica.

5. Especifica al menos una clave de faceta válida en Atributos para ignorar.

6. Haz clic en Enviar.

Crea un control de facetas de retorno forzado

El control de facetas que se muestran de forma forzosa puede afectar la posición de la lista de una clave de faceta dinámica para una consulta o un evento de navegación específicos.

Este control es útil si deseas forzar una clave de faceta específica entre las facetas dinámicas para algunos términos de búsqueda o navegación. Por ejemplo, puedes usar este control para forzar que la clave de faceta brands aparezca en la posición 10 o en una posición más baja para la consulta handbags. Si el atributo brands ya está en el top 10 de los atributos dinámicos para esta consulta, no debería moverse mucho. Si no está en las 10 primeras posiciones ni en la lista de facetas dinámicas, debería ubicarse en la posición 10 aproximadamente.

Para crear un control para la faceta de retorno forzado, sigue estos pasos:

1. Ve a la página Controles en la consola de Search for Retail.

   Ir a la página Controles

2. En la pestaña Controles de faceta, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Forzar facetas de retorno.

4. Cada control es para buscar o explorar, pero no se puede aplicar a ambos. Realice una de las siguientes acciones:

   • En el caso de las búsquedas, haz clic en Buscar y especifica algunos términos de búsqueda parciales o algunos términos de búsqueda exactos que coincidan. Consulta la información detallada en los términos de la consulta y las condiciones. Los términos de la búsqueda deben estar en minúsculas en ambos casos. Por ejemplo, puedes especificar los términos de la búsqueda parcial shirts, polo, jackets, t-shirt y fall coats, y las claves de faceta que se especifican a continuación deben aparecer alrededor de su posición respectiva o más arriba entre las facetas dinámicas si la búsqueda en minúsculas es uno de estos términos de búsqueda o contiene cualquiera de estos términos de búsqueda como un unigrama.

   • Para explorar, haz clic en Explorar categorías y especifica algunas categorías de página. Puedes especificar una lista (hasta 10 entradas) de categorías o departamentos. El formato debe ser el mismo que el de las categorías de páginas de los eventos del usuario. Por ejemplo, podría ser page_categories : Sales > 2023 Black Friday Deals. Si hay una coincidencia exacta (con distinción entre mayúsculas y minúsculas) entre este último y una de las categorías de página que se pasó en el evento (para la navegación), las claves de faceta que se especifican a continuación deben aparecer alrededor de su posición respectiva o más arriba entre las facetas dinámicas.

5. Especifica una clave de faceta válida y una posición de número entero entre 1 y 100 inclusive.

6. Si deseas especificar más de una clave de faceta, haz clic en Agregar ajuste y vuelve a realizar el paso anterior.

7. Haz clic en Enviar.

Crea un control de facetas dinámicas para volver a clasificar

La clasificación de facetas dinámica depende de la consulta (búsqueda) o de las categorías de página (navegación). El control de facetas dinámicas de clasificación nueva también permite que la clasificación dependa de algunos valores de faceta que el usuario haya activado.

Por ejemplo, con este control, si el usuario interactúa con el valor de faceta watches de la clave de faceta attributes.department después de una búsqueda o navegación, la clasificación también dependerá del valor de faceta watches. Puedes especificar los valores de facetas en los que deseas volver a establecer la clasificación según la clave de faceta, o bien especificar solo la clave de faceta y volver a establecer la clasificación en todos sus valores.

Nota: Puedes usar este control solo para claves textuales de facetas personalizadas. Para usar este control, también debes pasar todas las claves de faceta que el usuario activó en la solicitud con el campo FacetSpec. En particular, si no pasas las claves de facetas activadas en las que deseas volver a clasificar, este control no será eficaz. Además, para obtener mejores resultados, los valores de las facetas que deseas volver a clasificar deben ser similares al inglés (idealmente, deben estar formados por palabras, guiones bajos y espacios).

Para crear un control para volver a clasificar las facetas dinámicas, sigue estos pasos:

1. Ve a la página Controles en la consola de Search for Retail.

   Ir a la página Controles

2. En la pestaña Controles de faceta, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Volver a clasificar las facetas dinámicas.

4. Especifica una clave de faceta textual personalizada válida (todas las claves personalizadas tienen el prefijo attributes.).

5. Puedes especificar algunos valores de faceta específicos o aplicarlos a todos.

   • Si deseas volver a clasificar todos los valores de la faceta, haz clic en Cualquier cambio de valor.

   • Si deseas volver a clasificar los valores de facetas específicos, haz clic en Cambios en los valores seleccionados. Luego, inserta todos los valores de facetas para los que deseas volver a establecer la clasificación (se distingue mayúsculas de minúsculas). Por ejemplo, podría ser watches, luggages o bed.

6. Haz clic en Enviar.

Debes pasar todas las claves de faceta que el usuario activó en la solicitud por los siguientes motivos:

• Supongamos que un usuario busca ventas y obtiene una primera lista de claves de facetas presentadas.
• Luego, el usuario interactúa primero con la clave de faceta attributes.age_group.
• A continuación, activan la clave de faceta attributes.department con los valores de faceta watches, para los que configuraste un control para volver a clasificar.

En ese momento, la búsqueda vuelve a clasificar las claves.

Por lo tanto, es posible que la clave de faceta attributes.age_group que se activó anteriormente no se muestre en la respuesta. Si pasas esta clave en la solicitud (con un Facetspec con enableDynamicPosition configurado como true), se mostrará automáticamente en la respuesta.

Sin embargo, la búsqueda podría mostrar esa clave en la posición 27 y podrías mostrarle al usuario solo las primeras 20 claves. Por este motivo, asegúrate de que se le muestren al usuario estas claves que activó anteriormente. Si no quieres mostrarle demasiadas teclas al usuario, es posible que debas filtrar algunas teclas intermedias que no estén activadas en la respuesta.