Información acerca de los controles de publicación

Puedes aplicar controles de publicación a los parámetros de configuración de publicación para personalizar la forma en que la búsqueda trata las consultas y muestra los resultados. Un control de publicación es una regla que consta de un par de condición-acción, en el que la condición determina cuándo se ejecutará el control de publicación y la acción especifica qué comportamiento implementará.

Puedes crear un control de publicación con el método Control.create de la API.

Si no quieres usar la API, puedes elegir la consola para crear controles de publicación en Vertex AI Search for commerce.

Controles de publicación disponibles

Los siguientes controles de entrega están disponibles:

  • Boost/Bury: Afecta la clasificación y el orden de los resultados en la lista de resultados que se muestra. Disponible para la búsqueda y las recomendaciones.
  • Filtro: Quita los resultados que no pasan el filtro de la lista de resultados que se muestra. Solo está disponible para la búsqueda.
  • Redireccionamiento: Redirecciona a los usuarios a una página específica según la búsqueda. Solo está disponible para la búsqueda.
  • Fijado: Se especifica la posición exacta en los resultados para un producto determinado.
  • Linguística: Personaliza la linguística de las búsquedas. Solo está disponible para la búsqueda. Existen varios tipos de controles lingüísticos disponibles:
    • Sinónimo: Expande los sinónimos considerados para una búsqueda.
    • Sinónimo unidireccional: Expande los sinónimos considerados unidireccionalmente para términos específicos.
    • Ignorar: evita que un término se use en las búsquedas.
    • No asociar: Evita que se usen términos en las búsquedas cuando aparecen términos específicos.
    • Reemplazo: reemplaza los términos en la búsqueda.

Condiciones de control

Las condiciones de control determinan cuándo se ejecutará un control de publicación.

Los campos de las condiciones de control pueden ser términos de consulta, intervalos de tiempo o ambos. Algunos tipos de control permiten varios campos de condición o no permiten ninguno.

Los campos de condiciones disponibles son los siguientes:

  • Términos de consulta: Se activa cuando el término aparece en la búsqueda.
    • Una coincidencia completa requiere que toda la consulta de búsqueda coincida con el término de la consulta.
    • Se pueden especificar varios términos de consulta. Se activa mientras aparezca uno de los términos de la consulta en la búsqueda.
  • Intervalo de tiempo activo: Se activa cuando la fecha de la búsqueda está en el intervalo de tiempo.
    • Se pueden especificar varios intervalos de tiempo. Se activa siempre que la fecha de la consulta esté dentro del intervalo de tiempo (inclusive).

Los campos de condición que especifiques determinarán si se aplicará el control.

  • Varios campos de condición se combinan con Y. Esto significa que si especificas el intervalo de tiempo y los términos de consulta, ambos campos de condición deben activarse para que se aplique el control.
  • Varios subcampos de condición se combinan con O. Esto significa que, si tienes varios términos de consulta, los términos de la consulta se activarán si alguno de ellos coincide. Si tienes varios intervalos de tiempo, el control se activará si alguno coincide.
  • Si no hay campos de condición especificados, siempre se aplica el control. Sin embargo, algunos controles requieren que se defina un campo.

Para obtener más información sobre la configuración de condiciones, consulta la referencia de la API de Controls.condition.

Controla las acciones

Una acción de control especifica qué comportamiento aplicará el control de publicación si se cumplen las condiciones durante una búsqueda.

El tipo de acción que puedes especificar depende del tipo de control de publicación que creas. Por ejemplo, la acción para un control de mejora o de bury es aplicar un valor de mejora o de bury a los productos que el filtro que especificas, mientras que para un control de sinónimo unidireccional es aplicar un término asociado que especifiques.

Controles mejorar y ocultar

Los controles de aumento o ocultamiento te permiten mostrar ciertos resultados de la búsqueda en una clasificación superior o inferior.

Puedes crear un control de aumento o ocultación para la búsqueda o las recomendaciones. La función para destacar o ocultar recomendaciones está en versión preliminar pública.

Cuando creas un control de boost/bury, puedes usar expresiones de filtro para especificar las condiciones según los campos Product.

Luego, puedes aplicar un valor boost entre −1.0 y 1.0 para indicar cuánto aumentar o deducir los resultados del producto que coinciden con esas condiciones. Un valor positivo mejora los resultados y un valor negativo los oculta.

Establecer una intensidad de mejora alta le da al elemento una promoción grande, pero no necesariamente significa que el elemento mejorado será el resultado principal en todo momento. Los resultados que son mucho más relevantes para la búsqueda aún pueden tener prioridad sobre los elementos preferibles, pero irrelevantes. Del mismo modo, si se establece la intensidad de la mejora en −1.0, el elemento recibirá un gran descenso, pero es posible que se muestren los resultados muy relevantes.

Como ejemplo mediante el uso de boost/bury, podrías priorizar los productos más económicos y reducir la prioridad de los costosos.

Las condiciones de control difieren entre los controles de mejora y ocultación de la búsqueda y las recomendaciones:

  • Búsqueda: Puedes establecer términos de consulta e intervalos de tiempo aplicables como las condiciones de control.
  • Recomendaciones: Las condiciones de control no están disponibles. El control siempre se aplica.

Como acción de control, especifica un filtro para los productos que deseas mejorar o destinar, y configura el valor de la mejora.

Para crear un control de aumento o ocultación, consulta Crea un control de entrega nuevo.

Para obtener más información sobre la configuración de los controles de aumento/ocultación, consulta la referencia de la API de Controls.BoostAction.

Controles de filtro

Con los controles de filtro, puedes agregar de forma dinámica filtros predefinidos en función de una solicitud de búsqueda específica.

Puedes usar expresiones de filtro basadas en campos Product. Consulta Filtra y ordena los resultados para ver la sintaxis de expresión de filtro.

Puedes establecer términos de consulta y intervalos de tiempo aplicables como las condiciones de control. Como acción de control, especifica un filtro para aplicar en el momento de la consulta.

Por ejemplo, si usas la consulta zapatos azules, puedes usar un control de filtro para filtrar automáticamente los resultados de la búsqueda por el color azul. También puedes usar controles de filtro para evitar que se muestren ciertos resultados a los compradores.

Para crear un control de filtro, consulta Crea un control de entrega nuevo.

Para obtener más información sobre la configuración del control de filtros, consulta la referencia de la API de Controls.FilterAction.

Controles de redireccionamiento

Puedes usar un control de redireccionamiento para redireccionar a los compradores a diferentes páginas según su intent, en lugar de solo mostrarles los resultados de la búsqueda.

Puedes establecer términos de consulta y intervalos de tiempo aplicables como las condiciones de control. Como acción de control, especifica un URI de redireccionamiento para el que se redireccione si las condiciones coinciden.

Por ejemplo, puedes crear un control de redireccionamiento para que, durante una promoción del producto gShoe, las búsquedas con zapato para correr o calzado deportivo redireccionen a la página de productos de gShoe. Otro caso en el que se pueden usar los controles de redireccionamiento es para redireccionar a los compradores a una página específica si buscan un término que no es relevante para tu sitio, como una búsqueda de Preguntas frecuentes que redirecciona al usuario a la página de Preguntas frecuentes de tu sitio en lugar de mostrar los resultados de la búsqueda.

Para crear un control de redireccionamiento, consulta Crea un control de entrega nuevo.

Para obtener más información sobre la configuración del control de redireccionamiento, consulta la referencia de la API de Controls.RedirectAction.

Controles de fijación

Los controles de fijación te permiten especificar una posición exacta en los resultados en la que quieres que aparezca un producto determinado.

Puedes crear un control de fijación para la búsqueda o la navegación. No es compatible con las recomendaciones.

Cuando creas un control de fijación, puedes usar expresiones de filtro para especificar las condiciones según los campos Product.

Como acción de control, agrega un Rule a tu búsqueda o explora Condition, que será el campo de acción pin_action..

Luego, puedes aplicar un valor pin entre [1,120] para indicar la posición fija en la que se fijarán los resultados que coincidan con esas condiciones.

  • Condición de la regla: Debes especificar un [Condition.query_terms][] (solo para la búsqueda) o un [Condition.page_categories][] (solo para la navegación) no vacío, pero no ambos.
  • Entrada de acción: Se asignan pares [pin_position, product_id] (la posición de entrada puede ser un valor de 1 a 120). El tamaño máximo es el tamaño máximo de la página de la solicitud. 10 es la cantidad de pares permitidos en el mapa de pines.
  • Resultado de la acción: Fijar productos con IDs coincidentes en la posición especificada en el orden de resultados final A modo de ejemplo, supongamos que la consulta es zapatos, [Condition.query_terms][] es "shoes" y pin_map tiene {1, pid1}. El producto con pid1 se fija en la posición superior de los resultados finales.

Habilitación de pines y reglas aplicadas

Cuando se habilita un control de fijación, sucede lo siguiente:

  • Los productos con IDs de productos que coinciden con un pin aparecen en la respuesta final en la posición exacta que especifica el control.
  • No se permiten pines en la segunda página o posteriores (número de página más alto), es decir, se ignora cualquier pin que se establezca en una posición superior a la solicitud page_size.
  • Se puede fijar un máximo de 10 productos con un control.
  • El product_id debe ser el ID de un producto existente en el catálogo.

El producto siempre se recupera en cada búsqueda y aparece en la página, a menos que ocurra lo siguiente:

  • Se aplican los filtros y la ordenación. Esto evita que aparezcan los pines.
  • El orden de clasificación (como tener los resultados de la búsqueda ordenados por precio) no es el predeterminado.

Comportamiento de los pines

  • Si un producto está fijado, se ignorarán los aumentos o ocultamientos de la solicitud o de otros controles.
  • Si un producto está fijado en varias posiciones, el control actualizado más recientemente tiene prioridad.
  • No se pueden fijar dos productos en la misma posición dentro del mismo control de fijación (mapa de pines).
    • Si varios controles coinciden con la misma consulta y cada uno tiene un pin diferente para el mismo ID de producto, el par [pin_pos, p_id] del control actualizado más recientemente tiene prioridad.

Controles linguísticos

Puedes crear adiciones o anulaciones para la forma en que se tratan las palabras en ciertas búsquedas.

Controles de sinónimos

Establecer dos palabras como sinónimos es un control lingüístico que asocia dos palabras.

Los controles de sinónimos agregan contexto adicional a una búsqueda. No obligan a que un resultado se incluya en los resultados de la búsqueda, pero pueden ayudar al sistema a incluir productos adicionales en los resultados de la búsqueda, lo que aumenta la probabilidad de que se incluya un resultado determinado. En otras palabras, los controles de sinónimos pueden fomentar que el resultado de la búsqueda considere más opciones, pero, en última instancia, el resultado de la búsqueda dependerá de la puntuación.

Por ejemplo, si deseas que los resultados de la búsqueda de zapatillas para correr también incluyan zapatillas deportivas, crea un control de sinónimos lingüísticos. La condición es que se ingrese zapatillas para correr como término de búsqueda. La acción es incluir el sinónimo zapato deportivo con esa búsqueda. Por lo tanto, cuando un comprador en tu sitio busca zapato para correr, la búsqueda encuentra esa coincidencia en el control lingüístico que creaste y lo expande para incluir zapato deportivo cuando muestra los resultados de la búsqueda al comprador.

Para crear un control de sinónimos, consulta Crea un control de entrega nuevo.

Controles de sinónimos bidireccionales

Usa controles de sinónimos bidireccionales para vincular varios términos de modo que la búsqueda los trate de la misma manera durante las búsquedas.

Puedes establecer términos de consulta y intervalos de tiempo aplicables como las condiciones de control. No es necesario establecer una acción de control separada. Si un término que especificaste se usa como una consulta, la acción de control es usar otros términos que especificaste como sinónimos.

Por ejemplo, puedes configurar un control de sinónimos bidireccional que asocie los términos repasador y trapo para cocina como sinónimos. Cuando un comprador en tu sitio ingresa repasador como una consulta, la búsqueda puede expandir la consulta para incluir los resultados de trapo para platos y repasador.

Para crear un control de sinónimos, consulta Crea un control de entrega nuevo.

Los sinónimos no cambian la consulta original. Por ejemplo, si las consultas A y B son sinónimos de dos vías, espera el siguiente efecto:

  • Resultados de la consulta A que se muestran: Conjunto A (sin aplicar ninguna regla de sinónimos) y parte del conjunto B. Sin embargo, los resultados podrían ser menores que la combinación de A y B.

  • Resultados de la consulta B que se muestran: Conjunto B y parte de A, pero posiblemente menos que la suma de los conjuntos de resultados A y B.

Para obtener más información sobre la configuración del control de sinónimos de dos vías, consulta la referencia de la API de Controls.TwowaySynonymsAction.

Controles de sinónimos unidireccionales

Los controles de sinónimos unidireccionales expanden los términos de la búsqueda para vincularlos de forma unidireccional.

Puedes establecer términos de consulta y intervalos de tiempo aplicables como las condiciones de control. Como acción de control, especifica los términos que se usarán como sinónimos unidireccionales.

Por ejemplo, puedes configurar un control de sinónimos unidireccional que expanda las búsquedas del término rosa para incluir el término rosado. Debido a que es un sinónimo unidireccional, la búsqueda del término rosa no se expande para incluir el término rosado.

Para crear un control de sinónimos unidireccional, consulta Crea un control de entrega nuevo.

Ten en cuenta que, al igual que con los sinónimos de dos vías, se ejecuta la consulta original y los sinónimos se proporcionan como sugerencias para esa consulta. Los sinónimos de palabras completamente diferentes pueden hacer que solo se incluyan pequeños números de los términos sinónimos en los resultados. El ejemplo anterior muestra elementos rosas con énfasis en rosas rosas, pero una regla de sinónimos que expande las búsquedas del término perro para incluir gato muestra principalmente elementos con perros y algunos con gatos.

Para obtener más información sobre la configuración del control de sinónimos unidireccional, consulta la referencia de la API de Controls.OnewaySynonymsAction.

Los sinónimos no proporcionan resultados idénticos

Los resultados de la búsqueda de dos sinónimos no siempre son idénticos.

Por ejemplo, si configuras bolsos para laptop y equipaje como sinónimos de dos vías, es posible que el sistema ya asocie maleta con equipaje. Por lo tanto, cuando un usuario busca equipaje, Vertex AI Search for Commerce muestra resultados sobre equipaje, maletas y bolsos para laptops. Sin embargo, cuando buscas bolsos para laptops, Vertex AI Search for Commerce solo agrega equipaje a los sinónimos. Por lo tanto, es posible que los resultados no contengan maleta.

Ignorar controles

Los controles de omisión evitan que la búsqueda use ciertos términos de consulta durante las búsquedas. Marcan los términos omitidos en una búsqueda como no importantes, pero no los excluyen por completo de la búsqueda.

Para quitar por completo un término de búsqueda de una consulta, usa un control de reemplazo. Si bien un control de filtro afecta los resultados que se muestran, un control de reemplazo es una forma más sólida de evitar que Vertex AI Search para el comercio muestre resultados para un término específico.

Un control de omisión no garantiza que los resultados del término ignorado no se muestren en los resultados de Vertex AI Search para comercio. Por ejemplo, un control de omisión para la palabra aceite podría mostrar pinturas al óleo para una búsqueda de pinturas al óleo. La consulta se pasará como paints, y es posible que haya muchas pinturas al óleo que coincidan, pero el conjunto de resultados será más grande, ya que la búsqueda es de paints. Este tipo de control puede ser útil si pinturas al óleo fuera una consulta popular en tu sitio y vendes muchos tipos de pinturas diferentes, pero no muchas pinturas a base de aceite.

Puedes establecer términos de consulta y intervalos de tiempo aplicables como las condiciones de control. No es necesario establecer una acción de control separada. Si un término que especificaste se usa como una consulta, la acción de control es ignorar ese término.

Por ejemplo, puedes crear un control que ignore los términos de consulta que usan lenguaje ofensivo.

Para crear un control de ignorado, consulta Crea un control de entrega nuevo.

Para obtener más información sobre la configuración de control de omisión, consulta la referencia de la API de Controls.IgnoreAction.

Controles de no asociación

Los controles de no asociación evitan que los términos de la consulta se consulten juntos durante las búsquedas con otros términos que especifiques.

Puedes establecer términos de consulta y intervalos de tiempo aplicables como las condiciones de control. Como acción de control, especifica los términos que no deben estar asociados a los términos de la consulta.

Por ejemplo, puedes crear un control que impida que el nombre de una marca (como gShoe) se agrupe con los términos económico y baja calidad en una consulta, de modo que, si un comprador busca gzapatos baratos de baja calidad, la búsqueda solo busque gzapatos.

Si un resultado relevante para el término de la consulta también contiene un término especificado como no asociar, ese resultado relevante podría mostrarse. Para evitar que esto suceda por completo, usa un control de filtro.

Para crear un control de no asociar, consulta Crea un control de entrega nuevo.

Para obtener más información sobre la configuración de los controles de no asociar, consulta la referencia de la API de Controls.DoNotAssociateAction.

Controles de reemplazo

Los controles de reemplazo reemplazan uno o más términos de consulta dados por un término diferente que especifiques. Puedes especificar varios términos que se pueden asignar a un solo término (pero no al revés).

Puedes establecer términos de consulta y intervalos de tiempo aplicables como las condiciones de control. Como acción de control, especifica el término que se debe usar como reemplazo.

Por ejemplo, podrías crear un control que reemplace los sobrenombres de una marca con el nombre completo, que se usa con mayor frecuencia en las descripciones de productos.

Para crear un control de reemplazo en la consola de Search for commerce, consulta Crea un control de entrega nuevo.

Para obtener más información sobre la configuración del control de reemplazo, consulta la referencia de la API de Controls.ReplacementAction.