En esta página, se presentan algunas de las características 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 desean filtrando los resultados. Por ejemplo, si un usuario busca
shoes
, algunas facetas que se podrían mostrar son:price
,attributes.department
,attributes.colors
yattributes.size
.Atributos del sistema: Predefinidos Los atributos del sistema son campos de productos existentes que proporcionar más información sobre el producto. Estos incluyen algunos atributos de productos predefinidos, como
brand
,availability
,color
ysize
.Atributos personalizados: Los atributos personalizados son atributos adicionales que defines con el campo Product.attributes. Para por ejemplo,
style
,color
odepartment
.Clave de faceta: Es el nombre de una faceta. Por ejemplo, podría ser
attributes.department
osizes
. Las teclas de faceta corresponden al en los nombres de atributos. Por ejemplo, el nombre del atributo del sistema (producto)sizes
corresponde a la clave de facetasizes
. De manera similar, el nombre del atributo personalizado (del producto)department
corresponde a la clave de facetaattributes.department
(para los atributos personalizados, se agrega el prefijoattributes.
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 comoAsics
yNike
. 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 las facetas que la búsqueda clasifica según su lado derecho. Se pasan en la solicitud con la opción
enableDynamicPosition
=true
o recuperada 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.Facetable, faceta dinámica o tilable: Cuando se habilita un atributo para facetas dinámicas, la búsqueda puede usar automáticamente este atributo como faceta dinámica según el comportamiento anterior de los usuarios, como los clics en las facetas y las vistas. Para habilitar las facetas de un atributo, también debes habilitar la indexación para con ese atributo.
Filter: La sintaxis filter consiste en una expresión. lenguaje para construir un predicado a partir de uno o más campos de los productos que se está filtrando. Por ejemplo, si un usuario interactúa con los valores de faceta
Asics
de la clave de facetaattributes.brands
, parte del filtro podría(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 las facetas.
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 faceta son facetas. Configuración de facetas dinámicas en la API
se puede reemplazar para algunas claves de faceta específicas que elijas por configuración
controles de atributos en la consola de Search for Retail. 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 atributos de sitio completo
controles de acceso.
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 entrega tiene facetas y mosaicos dinámicos habilitados, y acabas de habilitarlos las facetas y los mosaicos dinámicos de una configuración de entrega deben esperar de tres a cuatro días para funcionar.
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 mosaicos
- Cómo reemplazar los controles de valores de facetas y mosaicos
- Controles de combinación de facetas
- Establece controles de intervalos numéricos
- Quitar facetas y controles de mosaicos
- Controles de facetas de retorno forzosas
- Volver a clasificar los controles de 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.
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.
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 uno abre un cuadro de 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 la faceta y los valores de mosaicos
Crea un control para ignorar faceta y valores de mosaicos cuando quieras quitar algunos elementos no deseados. Valores de faceta y mosaico para algunas claves específicas de faceta y mosaico.
Este control es útil para borrar valores de facetas y mosaicos no deseados, como NA
y Not_applicable
. Pero también se puede usar para borrar tendencias estacionales, como
Easter
si estás en octubre.
Para crear un control que omita los valores de faceta y mosaico, haz lo siguiente:
Ve a la página Controles en la consola de Search for Retail.
En la pestaña Controles de faceta, haz clic en add_boxCrear control.
Se abrirá el panel Crear control.
Selecciona Omitir valores de faceta y mosaico.
Especifica el nombre del atributo.
Por ejemplo,
brands
para un sistema . En el caso de un atributo personalizado, el nombre comienza conattributes.
, por ejemplo,attributes.department
yattributes.colors
.Opcional: Especifica la Hora de inicio o la Hora de finalización.
Especifica uno o más valores del atributo como Ignorar valores.
Por ejemplo,
NA
,Not_applicable
yEaster
.Haz clic en Enviar.
Crea un control para reemplazar los valores de faceta y mosaico
Crea un control de faceta de reemplazo y valores de mosaicos cuando desees consolidar una cantidad de valores similares de faceta y mosaico en un solo término.
A veces, el reemplazo de valores de facetas y mosaicos se conoce como combinación de valores de facetas y mosaicos.
Para evitar conflictos y asignaciones inútiles, si el valor de un atributo es facet_value_1
se reemplaza por otro valor de atributo, facet_value_2
, este último no puede
reemplazado por otro valor del 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.
Para crear un control que reemplace la faceta y los valores, sigue estos pasos:
Ve a la página Controles de la consola de Search for Retail.
En la pestaña Controles de faceta, haz clic en add_boxCrea un control.
Se abrirá el panel Crear control.
Selecciona Reemplazar los valores de faceta y mosaico.
Especifica el nombre del atributo.
Esta función solo funciona para los atributos personalizados, que comienzan con el prefijo
attributes
, por ejemplo,attributes.department
yattributes.colors
.Especifica uno o más valores de atributo como Reemplazar valores, por ejemplo,
RED
,Red
,dark red
,bright red
,ruby
ycrimson
.Un valor de atributo solo puede aparecer una vez en el campo Reemplazar valores.
Especifica un solo valor de atributo como Término de reemplazo, por ejemplo,
red
.Haz clic en Enviar.
Aunque los valores reemplazados pueden desaparecer rápidamente, el pueden tardar hasta cuatro días en aparecer.
Cuando se aplica el control de reemplazo de valores de faceta, si la clave de faceta (en este
el ejemplo attributes.colors
) se muestra en la respuesta, la faceta reemplazada
valores (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 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, imagina que tienes
varias teclas de faceta personalizadas para colores como attributes.colors_jeans
,
attributes.colors_clothes
y attributes.colors_hue
, y quieres reemplazar
con una clave de faceta personalizada existente llamada attributes.colors
.
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.
- 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ámicos.
Durante la indexación de cada producto, se asocian las claves y las claves combinadas 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
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
productos, pero tampoco se devolverán como claves dinámicas de faceta. Del mismo modo, si
combinar varias claves con la misma clave y esto da como resultado la cantidad de
Los valores del atributo de la clave combinada superan el límite de valores del atributo
la búsqueda trunca de forma arbitraria los valores de los atributos.
Para crear un control que combinó una faceta con otra:
Ve a la página Controles en la consola de Search for Retail.
En la pestaña Controles de faceta, haz clic en add_boxCrea un control.
Se abrirá el panel Crear control.
Selecciona Combinar facetas.
Especifica una clave de faceta personalizada válida que se combine con otra.
Esta función solo está disponible para los atributos personalizados, que comienzan con el prefijo con
attributes
, por ejemplo,attributes.colors_clothes
yattributes.colors_jeans
Especifica una clave de faceta personalizada válida como la clave combinada.
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 tarjeta o faceta 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
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 basados en la distribución de todos los atributos (numéricos)
de salida 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 número
facet con el siguiente comando
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 faceta numérica clave, 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 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, los intervalos calculados anteriormente mencionados con límites redondeados de seguridad.
Crea el control
Si quieres especificar tus propios intervalos para las facetas numéricas y las claves de mosaico en lugar de con las que calcula Vertex AI Search for Retail por ti y, luego, crea una establecer controles de intervalos numéricos.
Para crear un control para agregar intervalos, haz lo siguiente:
Ve a la página Controles de la consola de Search for Retail.
En la pestaña Controles de faceta, haz clic en add_boxCrea un control.
Se abrirá el panel Crear control.
Selecciona Establecer intervalos numéricos de tarjetas y facetas.
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 conattributes.
, por ejemplo,attributes.number_of_pieces
.Especifica al menos uno de los valores Minimum o Maximum. Si se especifican ambos, el mínimo no puede ser mayor que el máximo. Puedes elegir cada límite para ser inclusivos o exclusivos.
Para agregar más intervalos, haz clic en add_boxAgregar intervalos. La cantidad máxima de intervalos es 40.
Haz clic en Enviar.
Crear 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 faceta controla el atributo en sí. Si se aplica este tipo de control de faceta, no se mostrarán facetas ni mosaicos asociados con esta faceta como miembros en la búsqueda.
Este control es útil si deseas quitar algunas claves de faceta y de mosaico para alguna consulta
términos o navegar. Por ejemplo, puedes usar este control para quitar la clave de faceta attributes.shoe_size
de la consulta "zapatillas".
Para crear un control que permita quitar una faceta o una tarjeta:
Ve a la página Controles de la consola de Search for Retail.
En la pestaña Controles de faceta, haz clic en add_boxCrear control. Se abrirá el panel Crear control.
Selecciona Quitar facetas y mosaicos.
Cada control es para la búsqueda o la exploración, 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 los detalles información en términos de búsqueda y 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
yfall 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 del evento de usuario categorías de páginas. Para ejemplo, podría ser
page_categories
:Sales > 2023 Black Friday Deals
. Si hay un elemento concordancia exacta (distingue mayúsculas de minúsculas) entre esta última y una de las páginas categorías pasadas en el evento (para explorar), luego las teclas de faceta que se especificó a continuación no aparecerá como una faceta dinámica.
Especifica al menos una clave de faceta válida en Atributos para ignorar.
Haz clic en Enviar.
Crea un control de facetas de retorno forzado
El control de forzar facetas de retorno puede afectar la posición de la lista de una 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 es
no está entre las 10 primeras o no está en la lista de facetas dinámicas, entonces debería pasar a
posición 10 aproximadamente.
Para crear un control para forzar la faceta de retorno, haz lo siguiente:
Ve a la página Controles en la consola de Search for Retail.
En la pestaña Controles de faceta, haz clic en add_boxCrear control.
Se abrirá el panel Crear control.
Selecciona Forzar facetas de retorno.
Cada control es para la búsqueda o la exploración, pero no se puede aplicar a ambos. Realice una de las siguientes acciones:
En el caso de las búsquedas, haz clic en Búsqueda 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 y las condiciones de la búsqueda. Los términos de la consulta deben estar en minúscula para en ambos casos. Por ejemplo, puedes especificar los términos de consulta parcial
shirts
,polo
,jackets
,t-shirt
,fall coats
y las las claves de faceta especificadas a continuación deben aparecer alrededor de sus respectivos o más alta entre las facetas dinámicas si la consulta en minúscula es uno de estos términos de búsqueda o contiene alguno de ellos como una 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ágina 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 deben aparecer alrededor de su posición respectiva o más arriba entre las facetas dinámicas.
Especifica una clave de faceta válida y una posición de número entero entre 1 y 100 (inclusive).
Si deseas especificar más de una clave de faceta, haz clic en add_boxAgrega un ajuste y vuelve a realizar el paso anterior.
Haz clic en Enviar.
Crea un control de facetas dinámicas para volver a clasificar
La clasificación de las facetas dinámicas depende de la búsqueda o de las categorías de la página. (explorar). 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 la
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á de la faceta.
valor watches
. Puedes especificar los valores de faceta según los cuales quieras volver a clasificar.
facet o especifica solo la clave de faceta y vuelve a clasificar en todos los valores de faceta.
Para crear un control para volver a clasificar las facetas dinámicas, sigue estos pasos:
Ve a la página Controles en la consola de Search for Retail.
En la pestaña Controles de faceta, haz clic en add_boxCrear control.
Se abrirá el panel Crear control.
Selecciona Volver a clasificar facetas dinámicas.
Especifica una clave de faceta textual personalizada válida (todas las claves personalizadas tienen el prefijo
attributes.
).Puedes especificar algunos valores de faceta específicos o aplicarlos a todos.
Si deseas volver a clasificar en todos los valores de faceta, haz clic en add_boxCualquier cambio de valor.
Si deseas volver a clasificar según valores de faceta específicos, haz clic en add_boxCambios 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
,bed
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 un primera lista de claves de faceta que se presenta.
- Luego, el usuario interactúa primero con la clave de faceta
attributes.age_group
. - A continuación, interactúa con la clave de faceta
attributes.department
. con los valores de facetawatches
, en 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 que se interactuó anteriormente attributes.age_group
no se muestre en el
respuesta. Si pasas esta clave en la solicitud (con un
Facetspec
con
enableDynamicPosition
configurado en true
)
se mostrará automáticamente en la respuesta.
Sin embargo, la búsqueda podría devolver esa clave en la posición 27 y podrías mostrar solo las primeras 20 claves al usuario. Por este motivo, asegúrate de que se le muestren al usuario estas claves que activó anteriormente. Si no quieres mostrar demasiadas claves al usuario, es posible que debas filtrar algunas claves en la respuesta.