Aumenta los resultados

Agent Platform Search for commerce ofrece una función que te permite especificar los registros que se deben destacar en las búsquedas. Puedes controlar la clasificación de los resultados aplicando una regla de mejora para priorizar o reducir la prioridad de los elementos de búsqueda que se muestran.

La mejora te permite controlar la clasificación de los resultados mediante la promoción (mejora) o la degradación (ocultamiento) de elementos específicos en función de los criterios que definas. A diferencia del filtrado, que quita elementos del conjunto de resultados, el boosting ajusta la posición de los elementos que ya son aptos para mostrarse.

Anulaciones de mejora y filtro

Nota: Las reglas de filtrado siempre tienen prioridad sobre las reglas de mejora. Para obtener más información sobre cómo filtrar y ordenar los resultados de la búsqueda, consulta Filtra y ordena los resultados.

Estos son ejemplos de tipos de filtros comunes que tienen prioridad sobre las reglas de mejora:

1. Especificados por el usuario. Pueden ser elementos como el precio o la marca. Aparecen para el usuario final como tarjetas o facetas en el sitio web.

• Temática (relevancia). Estos filtros solo existen para las búsquedas (no para la exploración). Excluyen los productos menos relevantes de los resultados de la búsqueda. Por ejemplo, la búsqueda refrigerador no muestra microondas ni accesorios, como manijas de refrigerador. El filtro reconoce que no debe mejorar un microondas para una búsqueda de refrigerador.

Reglas de mejora

Las reglas de mejora solo se pueden aplicar cuando hay una puntuación de relevancia base, como en las búsquedas ordenadas por relevancia o los resultados de exploración con puntuaciones previas a la clasificación. La mejora es una función multiplicadora que se aplica a los resultados de la búsqueda y la exploración. La sintaxis y la lógica de la mejora se pueden desglosar de la siguiente manera:

• Disponibilidad. La mejora no puede anular las reglas de disponibilidad. Si un elemento se filtra (por ejemplo, si está agotado), mejorarlo no hará que aparezca.

• Operadores. Puedes usar operaciones como mayor que y menor que para los campos numéricos en las condiciones de mejora, que no están disponibles en el filtrado estricto estándar.

Valores de mejora o de ocultamiento

Un producto puede estar condicionado por varias reglas de mejora o de ocultamiento, que se establecen en la boostSpec clase de la API de Search. Un valor de mejora es un número de punto flotante entre -1.0 y 1.0.

• Valor positivo (de 0.0 a 1.0): Promociona el elemento y lo mueve más arriba en los resultados. Un valor de 1.0 otorga la promoción máxima.

• Valor negativo (de -1.0 a 0.0): Degrada (oculta) el elemento y lo mueve más abajo en los resultados. Un valor de -1.0 otorga la degradación máxima.

Varias reglas de mejora o de ocultamiento en un solo producto

Varias reglas de mejora o de ocultamiento pueden afectar un producto, y la suma o el máximo de los valores de mejora determinan la puntuación final. Cuando se aplican varias reglas de mejora al mismo producto, siempre verifica si la puntuación de otro producto lo desplazó del primer lugar. El modo máximo está configurado como predeterminado para que este problema sea menos probable.

Supongamos que un producto recibe mejoras de 2, 3 y 0.5, y otro producto recibe una mejora de 0.5. Aunque el producto solo recibió una puntuación de mejora de 0.5, cuando se mejora repetidamente, supera en clasificación al otro producto. Verifica cuidadosamente la especificación de mejora para asegurarte de que no se superponga o de que lo haga según lo previsto.

Resolución de conflictos

Si se aplican varias reglas de mejora al mismo producto, puedes definir cómo interactúan.

• Regla de mejora máxima (predeterminada): Agent Platform Search for commerce verifica cuál es el valor máximo y omite las otras reglas.

• Suma del efecto de mejora (configuración alternativa): Si hay una degradación más una promoción, Agent Platform Search for commerce suma los valores de todas las reglas de mejora y de ocultamiento aplicables. Esto permite un efecto acumulativo. La suma resultante es una mejora reducida o un efecto de ocultamiento neto.

Configura la mejora

Para configurar un conjunto de datos con reglas de mejora o de ocultamiento, define condiciones basadas en atributos del producto (como la marca o el precio) y asigna un valor de mejora entre -1.0 (ocultar) y 1.0 (mejorar) para ajustar la puntuación de clasificación de los elementos coincidentes. Los siguientes productos están disponibles para configurar los controles de mejora o de ocultamiento:

• Búsqueda: Filtro de temática más cualquier otro filtro aplicado por el usuario, como las facetas en las instalaciones. Obtén más información para configurar la mejora para la búsqueda.

• Exploración: Como no hay una consulta de texto, solo se aplican los filtros aplicados por el usuario. También se aplican filtros para verificar que el producto (por ejemplo, trajes) pertenezca a la categoría de producto correcta (no suéteres, por ejemplo). Obtén más información para configurar la mejora para las recomendaciones.

Conjunto de datos de ejemplo

Ver ejemplo de conjunto de datos de productos

id	cargo	marcas	categorías	price_info.price
“nest_mini_2nd_gen”	“Nest Mini (segunda generación)”	[“Google”, “Nest”]	["Nest > bocinas y pantallas"]	49.00
“nest_audio”	“Nest Audio”	[“Google”, “Nest”]	["Nest > bocinas y pantallas"]	99.99
“nest_hub_max”	“Nest Hub Max”	[“Google”, “Nest”]	["Nest > bocinas y pantallas"]	229.00
“nest_hub”	“Nest Hub”	[“Google”, “Nest”]	["Nest > bocinas y pantallas"]	88.99
"google_home_max"	"Google Home Max"	[“Google”, “Nest”]	["Nest > bocinas y pantallas"]	299.00
"google_home_mini"	"Google Home Mini"	[“Google”, “Nest”]	["Nest > bocinas y pantallas"]	49.00
“google_pixel_5”	“Google Pixel 5”	[“Google”, “Pixel”]	["Pixel > teléfonos"]	699.00
“google_pixel_4a_with_5g”	“Google Pixel 4a con 5G”	[“Google”, “Pixel”]	["Pixel > teléfonos"]	499.00
“google_pixel_4a”	“Teléfonos Google Pixel 4a”	[“Google”, “Pixel”]	["Pixel > teléfonos"]	349.00
“google_pixel_stand”	“Google Pixel Stand”	[“Google”, “Pixel”]	[“Pixel > accesorios destacados”]	79.00
“google_pixel_buds”	“Google Pixel Buds”	[“Google”, “Pixel”]	[“Pixel > accesorios destacados”]	179.00
“google_pixel_5_case”	“Funda de Google Pixel 5”	[“Google”, “Pixel”]	[“Pixel > accesorios destacados”]	40.00
“google_pixel_4a_5g_case”	“Funda Google Pixel 4a (5G)”	[“Google”, “Pixel”]	[“Pixel > accesorios destacados”]	40.00
“google_pixel_4a_case”	“Funda de Google Pixel 4a”	[“Google”, “Pixel”]	[“Pixel > accesorios destacados”]	40.00

Opciones de configuración

En Agent Platform Search for commerce, la mejora se aplica como un multiplicador a la puntuación de relevancia base generada por el algoritmo de búsqueda. Puedes configurar las reglas de mejora directamente en una solicitud de búsqueda con una especificación de mejora o adjuntando controles de entrega a una configuración de entrega. En la respuesta, los elementos que coinciden con estas condiciones reciben una puntuación de relevancia modificada, lo que hace que aparezcan más arriba o más abajo en la lista de resultados sin que se quiten por completo. Para configurar un control de mejora o de ocultamiento de búsqueda, haz lo siguiente:

Consola de Cloud

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

2. En la pestaña Controles de entrega, haz clic en Editar a la derecha de un control.

3. En la ventana emergente Editar control, haz clic en el campo debajo del campo Nombre del control para modificar el nombre del control.

4. Opcional: Para la búsqueda, en la sección Activadores, selecciona qué tipo de comportamiento del usuario activa este control. Las secciones Explorar categorías y Buscar aparecen atenuadas.

5. Opcional: Edita los Términos de búsqueda coincidentes.

   Nota: Si especificas una condición de categoría o término de consulta, además de condiciones de intervalo de tiempo, el control solo se aplica cuando se cumplen ambas condiciones.

6. Opcional: Haz clic en la opción Agregar intervalo de tiempo para agregar uno o más intervalos de tiempo durante los cuales se puede aplicar este control.

   Nota: Si especificas condiciones de intervalo de tiempo además de este tipo de condición, el control solo se aplica si se cumplen ambas condiciones.

7. Haz clic en Continuar para ir a la sección Acciones.

8. Agrega filtros para los atributos del producto en el campo Mejorar/ocultar producto.

   Usa la sintaxis de expresión de filtro documentada en Filtra y ordena los resultados. Por ejemplo, para especificar las versiones rojas y azules de "product1" y "product2", usa la siguiente expresión: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. Para Mejorar/ocultar valor, usa el control deslizante para establecer la intensidad de la mejora. Los valores positivos mejoran los resultados y los valores negativos los ocultan. Haz clic en Continuar.

10. En la sección Configuraciones de entrega, selecciona las configuraciones de entrega a las que se aplicará el control.

11. Envía la configuración de control.

Ahora puedes encontrar la regla de control de mejora o de ocultamiento agregada como un nuevo Tipo de control que aparece en Controles de entrega para tu proyecto. Obtén información para crear un nuevo control de mejora y de ocultamiento en Crea controles.

JSON

En este ejemplo, se muestra la mejora por precio.

Supongamos que deseas priorizar los productos más económicos (menos de USD 95) y reducir la prioridad de los más costosos (más de USD 95). Puedes aplicar una especificación de mejora.

{
  "condition_boost_specs": [
    {
      "condition": "price: IN(*, 95.0e)",
      "boost": 0.5
    },
    {
      "condition": "price: IN(95.0e, *)",
      "boost": -0.5
    }
  ]
}

En este ejemplo, los productos de menos de USD 95 reciben una promoción (0.5), mientras que los de más de USD 95 se degradan (-0.5).

En el resultado, "nest_mini_2nd_gen", "google_home_mini" y "nest_hub" pueden ser los primeros tres, mientras que "nest_audio", "nest_hub_max" y "google_home_max" pueden ser los tres últimos. Sin embargo, no se predetermina ningún orden específico, a diferencia de ordenar por precio, como se explica en Filtra y ordena los resultados.

Mejora en la búsqueda

Para la búsqueda, aplica la puntuación de clasificación de los elementos coincidentes de forma dinámica incluyendo una especificación de mejora (boostSpec) con condition_boost_specs directamente en SearchRequest.

Condiciones y activadores

La mejora de la búsqueda puede ser condicional. Puedes activar una regla de mejora en función de estas condiciones:

• Términos de consulta: Aplica la mejora solo cuando el usuario busca términos específicos (por ejemplo, mejora los abrigos de invierno cuando la consulta contiene chaqueta).

• Intervalos de tiempo: Aplica la mejora solo durante un período promocional específico.

• Global: Aplica la mejora a todas las consultas que publica una configuración específica.

Ejemplo de solicitud y respuesta de búsqueda

En el conjunto de datos de ejemplo que se mostró anteriormente, si buscas "Bocina de Google", obtendrás "nest_mini_2nd_gen", "nest_audio", "nest_hub_max", "nest_hub", "google_home_max" y "google_home_mini" sin un orden específico.

Ver ejemplo de solicitud y respuesta de búsqueda

Java

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec;
import com.google.cloud.retail.v2.SearchRequest.BoostSpec.ConditionBoostSpec;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchProductsWithBoostSpec(String query, int pageSize,
    String condition, float boostStrength) throws IOException, InterruptedException {
  BoostSpec boostSpec = BoostSpec.newBuilder()
      .addConditionBoostSpecs(ConditionBoostSpec.newBuilder()
          .setCondition(condition)
          .setBoost(boostStrength)
          .build())
      .build();

  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setBoostSpec(boostSpec)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

Mejora en las recomendaciones

La mejora para las recomendaciones se administra con controles de entrega. A diferencia de la búsqueda, la mejora de recomendaciones no admite condiciones basadas en consultas (ya que no hay una consulta del usuario). En cambio, el control se aplica a todas las predicciones generadas por la configuración de entrega a la que está adjunto. Por este motivo, por lo general, configuras las recomendaciones adjuntando controles de entrega de mejora o de ocultamiento a la configuración de entrega, en lugar de pasar una especificación de mejora en la solicitud.

Campos admitidos para las recomendaciones

Cuando definas qué productos mejorar en las recomendaciones, usa una expresión de filtro. Si bien el filtrado de recomendaciones estándar se limita a los campos de texto, la mejora admite campos numéricos adicionales.

Tipo de campo	Campos admitidos	Descripción
Texto	productId, brands, categories, genders, ageGroups, colorFamilies, colors, sizes, title,materials, patterns, conditions, attributes.key, tags	Campos estándar disponibles para el filtrado y la mejora. Ten en cuenta que tags son etiquetas personalizadas asociadas con el producto.
Numérico	price, discount, rating, ratingCount	Exclusivo para la mejora o el ocultamiento. Estos campos te permiten mejorar los productos en función del precio, los descuentos o las calificaciones de los usuarios.

Para obtener más información, consulta la sección Campos admitidos para la mejora o el ocultamiento en Filtra recomendaciones.

Mejora los productos con calificaciones altas

Supongamos que quieres asegurarte de que las películas con calificaciones altas aparezcan más arriba en su panel de recomendaciones "Otras opciones que te pueden gustar". Para este caso de uso, crea un control de entrega para mejorar los elementos con un recuento de calificaciones superior a 100. Configura tus controles teniendo en cuenta lo siguiente:

• Tipo de control: Mejorar o ocultar

• Selección de productos: Recomendación

• Acción:

  • Expresión de filtro: ratingCount > 100

  • Valor de mejora: 0.5

Este control garantiza que los elementos populares y con buenas calificaciones se prioricen en la lista de recomendaciones, sin dejar de mantener la relevancia de la personalización para el usuario.

Depuración y solución de problemas

Todos los productos son aptos para la mejora ilimitada, pero los filtros aplicados por el usuario eliminan productos de la respuesta de búsqueda. Para solucionar el motivo por el que un producto mejorado podría no aparecer en los resultados de la búsqueda y la exploración, verifica lo siguiente:

• Varias reglas de mejora (incluidas las degradaciones de ocultamiento): Verifica la configuración del modo de mejora (suma o máximo) y determina la puntuación final.
• Relevancia: Un producto debe ser relevante para la consulta y pasar los filtros de relevancia. Si una búsqueda es de calzado Nike y el título del producto es Air Jordans, las palabras no coinciden, pero su estrecha relación semántica da como resultado una puntuación de relevancia alta. Un título de producto como chaqueta amarilla tiene una puntuación de relevancia baja con una búsqueda de Nike. Del mismo modo, si el título del producto es un número de modelo enigmático que no tiene relación con ninguna palabra, la puntuación de relevancia será baja para cualquier consulta.
• Filtros: Las reglas de filtrado anulan cualquier regla de mejora y evitan que los productos mejorados aparezcan en los resultados. El filtro siempre se aplica sobre la mejora. Si un producto tiene filtros aplicados por el usuario o si una categoría de producto filtra la exploración, la mejora no funcionará en absoluto.

Instructivo de boosting

En este instructivo, se muestran algunos ejemplos de boosting de productos.

---

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

---