Facetas para la búsqueda

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

Definiciones relacionadas con facetas

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

• Facetas: Las especificaciones de la faceta 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 producto predefinidos, como brand, availability, color y size.

• Atributos personalizados: Los atributos personalizados son atributos adicionales que defines mediante el campo Product.attribute. Por ejemplo, puedes 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 faceta corresponden a los nombres de los atributos. Por ejemplo, el nombre del atributo del sistema (producto) sizes corresponde a la clave de faceta sizes. De manera similar, el nombre del atributo personalizado department (producto) corresponde a la clave de faceta attributes.department (para los atributos personalizados, el prefijo attributes. se agrega al nombre del atributo personalizado para obtener la clave de faceta). Los términos nombre del atributo, clave de faceta y nombre de faceta son intercambiables.

• Valor de faceta: En el caso de las claves textuales, este es uno de los valores textuales 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, el precio de la clave de faceta numérica podría tener un intervalo con el formato [20, 30).

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

• Facetas fijadas: Es una faceta que pasas en la solicitud mediante FacetSpec con la opción enableDynamicPosition=false. Las facetas deberían 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 mediante los mismos modelos entrenados con los más relevantes en la parte superior.

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

• Filtro: La sintaxis de filter consiste en 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 de filtro distingue mayúsculas de minúsculas. Obtén más detalles sobre el filtro en esta guía del usuario.

Información acerca de las facetas dinámicas

Cuando la faceta dinámica está habilitada para una configuración de entrega, la búsqueda puede usar atributos automáticamente como facetas dinámicas en los resultados de la búsqueda de esta configuración, según el comportamiento anterior del usuario, como los clics en facetas y las vistas. Las facetas dinámicas no serán eficaces para la configuración de entrega si la faceta dinámica no está habilitada. 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 con los más relevantes en la parte superior.

De forma predeterminada, la mayoría de las claves de faceta se pueden usar en facetas. La configuración de facetas dinámicas de la API se puede reemplazar para algunas claves de faceta específicas mediante los controles de atributos de todo el sitio en la consola de Search for Retail. En otras palabras, si quieres que algunas claves de faceta no sean facetas, debes inhabilitar la faceta 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 en todo el sitio. Ten en cuenta que las facetas dinámicas se pueden crear basándose solo en datos precisos del catálogo de productos. Sin embargo, para que la función se ejecute de manera óptima en tu sitio, los modelos de faceta deben aprender de la actividad en el sitio. Para ello, debes configurar con precisión los campos de consulta, categoría y filtro en las cargas de los eventos de búsqueda.

Si ninguna de tus configuraciones de entrega tiene habilitadas las facetas dinámicas y solo habilitaste las facetas dinámicas en una configuración de entrega, deberás esperar entre 3 y 4 días para que funcionen las facetas dinámicas.

Controles de facetas

En esta sección, se proporcionan instrucciones para crear diferentes tipos de controles de faceta:

• Ignorar los controles de valores de faceta
• Reemplaza los controles de valores de faceta
• Combina los controles de facetas
• Establece controles de intervalos numéricos
• Cómo quitar los controles de facetas
• Fuerza los controles de facetas de retorno
• Volver a clasificar los controles de facetas dinámicas

Vertex AI Search para venta minorista realiza una búsqueda de coincidencias que distingue mayúsculas de minúsculas para todos estos controles de facetas, a menos que se indique lo contrario.

Crea un control de valores de faceta para ignorar

Crea un control de valores de faceta ignorar cuando desees quitar algunos valores de faceta no deseados para algunas claves de faceta específicas.

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

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

Para crear un control que ignore los valores de faceta, 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 facetas, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Ignorar valores de faceta.

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. Especifica la Hora de inicio o la Hora de finalización (opcional).

6. Especifica uno o más valores de atributos como Ignorar valores.

   Por ejemplo, NA, Not_applicable y Easter.

7. Haz clic en Enviar.

Crea un control de valores de faceta de reemplazo

Crea un control de valores de faceta de reemplazo cuando desees consolidar varios valores de faceta similares en un solo término.

A veces, el reemplazo de valores de faceta se conoce como combinación de valores de faceta.

Para evitar conflictos y asignaciones inútiles, si el valor de un 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 podrás reemplazar dark red por red posteriormente.

Para cada nombre de atributo, el valor de un 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 numéricos de los atributos. Durante la indexación de cada producto, los valores reemplazados y los de reemplazo se incluirán como valores de atributos, a menos que superes la cantidad máxima de valores permitidos por atributo personalizado por producto. En ese caso, la búsqueda truncará los valores de reemplazo de manera arbitraria.

Para crear un control que reemplace los valores de faceta:

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 facetas, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Reemplazar valores de faceta.

4. Especifica el nombre del atributo.

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

5. Especifica uno o más valores de atributos 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 4 días en aparecer.

Cuando el control de valores de la faceta de reemplazo surte efecto, 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 facetas de combinación

Es mejor configurar de forma correcta los nombres y valores de los atributos personalizados del producto antes de que los productos 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 de combinación. Puedes crear un control de facetas de combinación si deseas combinar (reemplazar) una faceta con otra faceta. Por ejemplo, puedes tener varias claves de faceta personalizadas para colores como attributes.colors_jeans, attributes.colors_clothes y attributes.colors_hue, y quieras reemplazarlas por una clave de faceta personalizada existente llamada attributes.colors.

Nota: Solo puedes combinar una faceta textual en otra faceta textual individual. Del mismo modo, solo puedes combinar una faceta numérica en otra faceta numérica. Puedes combinar una faceta en, como máximo, 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 agregado attributes.). En otras palabras, estas dos claves deben ser los nombres de atributos personalizados de algunos productos transferidos. Preferentemente, las claves combinadas deben ser nombres de atributos personalizados que sean permanentes, que no cambien de tipo y que sean nombres de 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ámicas.

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, en cuyo caso la búsqueda trunca de manera arbitraria las claves combinadas que se convierten en nombres de atributos. Por ejemplo, supongamos que ya tienes la cantidad máxima de nombres de atributos personalizados para un producto específico y que 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, y el nombre del atributo colors no se agregará a este producto específico, dado 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 no se mostrarán como claves de faceta dinámica. De manera similar, si combinas varias claves con la misma clave, el número de valores de atributos para la clave combinada supera el límite permitido de valores de atributos, entonces la búsqueda trunca de manera arbitraria los valores de los atributos.

Para crear un control que combinó una faceta con otro, 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 facetas, 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 combina con otra.

   Esta función solo funciona para 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 clave combinada.

6. Haz clic en Enviar.

Este control suele aplicarse en un plazo de 2 a 4 días.

Crea un control de intervalos numéricos establecido

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

Por ejemplo, la búsqueda puede calcular los intervalos [10,15), [15,20) [20,25], [25,30), [30,40) y [40,50) e [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) e [32,infinito].

Acerca de los intervalos calculados y los intervalos establecidos

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

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

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

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

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

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

Crea el control

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

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

Si deseas crear un control para agregar intervalos, 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 facetas, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Establecer intervalos numéricos.

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

   Por ejemplo, price para un atributo del sistema. En el caso de 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 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

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

Este control es útil si quieres quitar algunas claves de faceta para algunos términos de consulta o exploración. Por ejemplo, puedes usar este control para quitar la clave de faceta attributes.shoe_size de la consulta "shoes".

Si deseas crear un control para quitar la faceta, 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 facetas, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Quitar facetas.

4. Cada control sirve para la búsqueda o la exploración, pero no se puede aplicar a ambos. Realice una de las siguientes acciones:

   • Para las búsquedas, haz clic en Search y especifica algunos términos de búsqueda parciales o algunos exactos con los que coincidir. Consulta la información detallada en los términos de consulta y las conditions. Los términos de la consulta deben estar en minúsculas para 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 especificadas 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 alguno de ellos como un unigrama.

   • Para navegar, 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ágina de los eventos de los usuarios. Por ejemplo, podría ser page_categories : Sales > 2023 Black Friday Deals. Si hay una concordancia exacta (distingue mayúsculas de minúsculas) entre esta última y una de las categorías de página pasadas en el evento (para la exploración), las claves de faceta especificadas a continuación no aparecerán como una faceta dinámica.

5. Especifica al menos una clave de faceta válida en Atributos que se deben ignorar.

6. Haz clic en Enviar.

Crea un control de facetas de retorno forzado

El control forzado de las facetas de retorno puede afectar la posición en 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 consulta o exploración. Por ejemplo, puedes usar este control para forzar la clave de faceta brands a fin de que aparezca en la posición 10 o una posición más pequeña para la consulta handbags. Si la faceta brands ya está entre los 10 principales de las facetas dinámicas de esta consulta, entonces no debería moverse mucho. Si no está entre los 10 principales o no en la lista de facetas dinámicas, debería moverse aproximadamente a la posición 10.

Si deseas crear un control para forzar la faceta de retorno, 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 facetas, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Forzar las facetas de retorno.

4. Cada control sirve para la búsqueda o la exploración, pero no se puede aplicar a ambos. Realice una de las siguientes acciones:

   • Para las búsquedas, haz clic en Search y especifica algunos términos de búsqueda parciales o algunos exactos con los que coincidir. Consulta la información detallada en los términos de consulta y las conditions. Los términos de la consulta deben estar en minúsculas para 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 especificadas a continuación deberían aparecer alrededor de su posición respectiva o más arriba entre las facetas dinámicas si la consulta en minúscula es uno de estos términos de consulta o contiene cualquiera de ellos como un unigrama.

   • Para navegar, 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ágina de los eventos de los usuarios. Por ejemplo, podría ser page_categories : Sales > 2023 Black Friday Deals. Si hay una concordancia exacta (distingue mayúsculas de minúsculas) entre esta última y una de las categorías de página pasadas en el evento (para la exploración), las claves de faceta especificadas a continuación deberían 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 rehaz el paso anterior.

7. Haz clic en Enviar.

Crear un control de facetas dinámicas de reclasificación

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

Por ejemplo, si se usa 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 exploración, la clasificación también dependerá del valor de faceta watches. Puedes especificar los valores de faceta a los que deseas volver a clasificar según la clave de faceta o especificar solo la clave de faceta y volver a clasificar todos los valores de faceta.

Nota: Puedes usar este control solo para claves textuales facetas personalizadas. Para usar este control, también debes pasar todas las claves de faceta que participa el usuario en la solicitud con el campo Facetspec. En particular, si no pasas las claves de faceta activas en las que deseas volver a clasificar, este control no será efectivo. Además, para obtener mejores resultados, los valores de faceta a los que quieres volver a clasificar deben ser similares al inglés (lo ideal sería estar compuestos por palabras, guiones bajos y espacios).

Si deseas crear un control para volver a clasificar las facetas dinámicas, 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 facetas, haz clic en Crear control.

   Se abrirá el panel Crear control.

3. Selecciona Volver a clasificar 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 sus valores de faceta, haz clic en Cualquier cambio de valor.

   • Si deseas volver a clasificar los valores de faceta específicos, haz clic en Cambios en los valores seleccionados. Luego, inserta todos los valores de faceta en los que desees volver a clasificar (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 participa el usuario en la solicitud por el siguiente motivo. Supongamos que un usuario busca ventas. El usuario obtiene una primera lista de claves de faceta que se presentan. Luego, el usuario interactúa primero con la clave de faceta attributes.age_group. Luego, interactúan la clave de faceta attributes.department con los valores de faceta watches, para los cuales configuras un control en el que 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 involucrada anteriormente no se muestre en la respuesta. Si pasas esta clave en la solicitud (con Facetspec con enableDynamicPosition configurado en true), se mostrará automáticamente en la respuesta. Sin embargo, la búsqueda podría mostrar esa clave en la posición 27 y es posible que le muestres al usuario solo las primeras 20 claves. Por lo tanto, por tu parte, debes asegurarte de que se le muestren estas claves que el usuario atrajo anteriormente (es posible que debas filtrar algunas claves intermedias no activadas en la respuesta si no quieres mostrarle demasiadas claves al usuario).