Autocompletado de la búsqueda

En esta página, se presenta la función de autocompletado y cómo usarla. La Búsqueda proporciona autocompletado para las sugerencias de escritura anticipada del cuadro de búsqueda de conducción.

Autocompletar es una función para predecir el resto de una consulta que ingresa un usuario, lo que puede mejorar la experiencia de búsqueda del usuario y acelerar el proceso de compra antes de la confirmación. También puede mejorar la calidad de la respuesta de búsqueda y, de esta manera, generar más ingresos, ya que proporciona búsquedas bien formateadas.

Descripción general

Cuando un usuario final comienza a escribir un término de búsqueda en tu sitio, la búsqueda puede proporcionar una lista de sugerencias que podría querer el usuario. Por ejemplo, se pueden sugerir zapatos y camisas cuando el usuario ingresa za.

Fuente de datos

Puedes elegir una de las siguientes fuentes de datos para tus predicciones de sugerencias:

• Un conjunto de datos de BigQuery que subes
• Es un conjunto de datos que se genera a partir de eventos de usuario y otros metadatos con aprendizaje automático.

Conjunto de datos subido

Es una tabla de sugerencias de BigQuery que subes como un conjunto de datos y que se usa para sugerir consultas. Para saber cómo subir un conjunto de datos, consulta Cómo importar datos de autocompletar.

Conjunto de datos de aprendizaje automático

Es un conjunto de datos de sugerencias potenciado por aprendizaje automático que genera la búsqueda en función de los eventos de búsqueda de los usuarios.

Para habilitar el aprendizaje automático, sigue estos pasos:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
  "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/completionConfig?update_mask.paths=auto_learning"  --data "{auto_learning: true}"

Requisito previo del conjunto de datos de aprendizaje automático

El aprendizaje automático genera sugerencias a partir de los eventos del usuario (eventType = "search") del tipo de búsqueda. La generación utiliza los eventos del usuario de los últimos 180 días. Requiere una buena calidad y cantidad de eventos de usuario importados.

El aprendizaje automático filtra las sugerencias poco frecuentes, por lo que, si la cantidad de eventos del usuario del tipo de búsqueda es demasiado pequeña (menos de 20,000), es posible que se filtren muchos candidatos a sugerencias. En esta situación, es posible que primero quieras probar la función de autocompletar con una búsqueda más frecuente.

Programa de lanzamiento del conjunto de datos de aprendizaje automático

El conjunto de datos de aprendizaje automático se genera a diario y, luego, se envía a la indexación y la versión. El ciclo completo tarda alrededor de dos días.

Funciones de aprendizaje automático

La Búsqueda aplica técnicas de aprendizaje automático para limpiar y dar formato a los datos de sugerencias y búsquedas solo para el conjunto de datos de aprendizaje automático.

Cómo obtener sugerencias de autocompletado

Usa la API de completeQuery para recuperar las sugerencias. Ejemplo:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog:completeQuery?query=sho&dataset=user-data&deviceType=DESKTOP&maxSuggestions=5"

Opciones y controles de autocompletado

En esta sección, se explican las opciones y los controles disponibles para la función de autocompletar. Consulta la siguiente tabla para obtener una descripción general y más detalles.

Lista de entidades permitidas (lista de no quitar)

La Búsqueda realiza un procesamiento posterior, como la corrección ortográfica, en los datos de sugerencias de autocompletado. Puedes crear una lista de términos permitidos que la búsqueda omite durante el procesamiento posterior.

Los términos permitidos nunca se filtran de las sugerencias. La lista de entidades permitidas funciona para los conjuntos de datos subidos y el conjunto de datos de aprendizaje automático.

Ejemplos: hay algunos nombres de marcas intencionalmente mal escritos, como “froot loops” en lugar de “fruit” o “foot”. Consulta las instrucciones detalladas sobre la carga en los datos de finalización de la importación.

Para la importación de datos, puedes usar Consola de Cloud > Controles > Controles de autocompletado > Lista de no quitar o usar CompletionData:import en la API.

Los cambios se aplican en un plazo de 2 días.

Lista de bloqueo

La lista de bloqueo solo funciona para los conjuntos de datos de aprendizaje automático. La lista de bloqueo no funciona para los conjuntos de datos subidos.

Los términos de una lista de bloqueo nunca aparecen en las sugerencias.

Para importar una lista de bloqueo, puedes usar Consola de Cloud > Controles > Controles de autocompletar > Lista de bloqueo o la API CompletionData:import. Para obtener instrucciones detalladas sobre cómo importar una lista de bloqueo, consulta Importa datos de finalización.

Los cambios se aplican en un plazo de 2 días.

Duración mínima para activar

Puedes establecer la cantidad de caracteres requeridos para que las consultas de autocompletado muestren resultados. El parámetro de configuración se encuentra en Consola de Cloud > Controles > Controles de autocompletar > Longitud mínima para activar.

Los cambios se aplican de inmediato.

Orden coincidente

Esto determina cómo hacer coincidir las sugerencias con los términos ingresados por el usuario.

Cuando se configura como La sugerencia comienza con el término, la función de autocompletar coincide con el término de entrada del usuario como un prefijo exacto para las sugerencias. Por ejemplo, la entrada del usuario "za" coincide con las sugerencias "zapatos" y "zapatillas", pero no con la sugerencia "zapatos rojos".

Cuando se establece en La sugerencia puede comenzar desde cualquier parte del término, el autocompletado tokeniza el término de entrada del usuario en palabras y lo compara con las palabras de las sugerencias, independientemente del orden de las palabras. Por ejemplo, el término de entrada del usuario "rojo" coincide con las sugerencias "camisas rojas", "zapatos rojos" y "zapatos rojos para niños". Sin embargo, el término de entrada "hoes" no coincide con estas sugerencias, ya que ninguna de las palabras en las sugerencias comienza con "hoes".

El parámetro de configuración se encuentra en Consola de Cloud > Controles > Controles de autocompletado > Orden de coincidencia.

Los cambios se aplican de inmediato.

Recuento de sugerencias

Es la cantidad de sugerencias que se mostrarán para las búsquedas de autocompletado y no puede superar las 20. El parámetro de configuración se encuentra en Consola de Cloud > Controles > Controles de autocompletar > Cantidad de sugerencias o se puede establecer en completeQuery.

Los cambios se aplican de inmediato.

Tipo de dispositivo

El autocompletado de la búsqueda admite diferentes tipos de dispositivos, como mobile y desktop. Puedes subir o recibir sugerencias diferentes según los tipos de dispositivo. Si no se especifica deviceType en completeQuery, la sugerencia será para todos los tipos de dispositivos.

Para un conjunto de datos de aprendizaje automático basado en eventos del usuario de búsqueda, configura user_agent en UserEvent.user_info para admitir diferentes tipos de dispositivos. Consulta usuario-agente en wiki.

Funciones avanzadas

En esta sección, se describen las funciones avanzadas de autocompletado disponibles con la búsqueda. Por ejemplo, puedes complementar las sugerencias de autocompletar búsquedas con otras sugerencias, como marcas y categorías.

Estas funciones avanzadas solo están disponibles para los conjuntos de datos de aprendizaje automático.

FeatureSet de sugerencia

Proporcionamos un FeatureSet adicional para cada término de sugerencia de búsqueda para permitir que los clientes muestren funciones avanzadas en sus sitios web.

El objeto FeatureSet aparece en la respuesta como un mapa de clave-valor. Vertex AI Search for Commerce devuelve hasta cinco categorías y marcas populares relacionadas con cada sugerencia de búsqueda en la respuesta de la API de completeQuery.completionResults.attributes. Las sugerencias de FeatureSet no tienen que coincidir con las cadenas de búsqueda que ingresa el usuario final.

Puedes usar el FeatureSet en la respuesta para enriquecer las sugerencias de búsqueda. Por ejemplo:

• Agregamos y creamos las secciones Marcas populares y Categorías populares que aparecen debajo de la lista de sugerencias de búsqueda.
• Mostrar la marca o categoría más popular junto a los términos de sugerencia de búsqueda

Después de realizar cambios en el catálogo, como cambiar las categorías de los productos, espera entre dos semanas y 30 días hasta que las sugerencias de FeatureSet reflejen los cambios en el catálogo de productos. Este tiempo de espera se debe a que el aprendizaje automático se entrena con los datos de eventos de búsqueda de los últimos 30 días.

Sugerencias de atributos

La Búsqueda proporciona sugerencias de atributos que coinciden con las cadenas de entrada del usuario. Los tipos de sugerencias de atributos admitidos son las marcas y las categorías.

Las sugerencias de atributos difieren de un FeatureSet de sugerencias. Las sugerencias de atributos son listas de atributos de productos sugeridos (como marcas y categorías), de forma similar a como las sugerencias de búsquedas son listas de búsquedas sugeridas. Las sugerencias de atributos se pueden usar independientemente de las sugerencias de búsqueda. Un FeatureSet de sugerencia son metadatos para una sugerencia de búsqueda, por lo que depende de las sugerencias de búsqueda.

Las sugerencias de atributos se pueden usar para autocompletar marcas o categorías que escribe un usuario final, en secciones separadas debajo de la lista de sugerencias de búsqueda.

Faceta de sugerencias con recuentos de productos (experimental)

Esta es una función experimental para clientes limitados. Para usarla, comunícate con el equipo de asistencia al cliente.

Cuando se habilita la función de sugerencias con recuento de productos, el objeto completeQuery.completionResults que se devuelve proporciona una lista de sugerencias de autocompletar como de costumbre, pero también incluye recuentos de productos para cada sugerencia con el recuento total y el recuento de productos por faceta (como color y category).

Por ejemplo, si la búsqueda es "zapato", las sugerencias de Autocompletar que se muestran podrían ser las siguientes:

• Calzado para mujer
• calzado para hombre

Además, si la clave de faceta de interés es color, también se devuelve un recuento de productos y un recuento de productos por color con cada sugerencia de Autocomplete:

• Calzado para mujer (32)
  • negro (10)
  • Taupe (16)
  • Blanco (10)
• Calzado para hombre (43)
  • negro (10)
  • marrón (5)
  • Verde (17)

Como minorista, no es necesario que le muestres al comprador el recuento de productos, pero puedes decidir ordenar la lista de sugerencias según el recuento de productos en lugar del orden que se muestra en completeQuery.completionResults. Por ejemplo, es posible que desees alentar a los compradores a que miren zapatos verdes para hombres, por lo que harás que los zapatos verdes aparezcan en la parte superior del cuadro de sugerencias, aunque no sean el artículo más popular.

Por ejemplo:

{
  "completion_results": [{ 
    "suggestion": "womens shoes"
    "facets": [ 
      {
        "key": "color"
        "values": [ 
          {
            "value": "black"
            "count": 10
          }
          {
            "value": "taupe"
            "count": 16
          }
          {
            "value": "white"
            "count": 10
          }
        ]
      }
    ]
    "total_product_count": 32
  },
  (...)
  ],
}

La información del recuento de facetas aparece como una lista de Facets en completeQuery.completionResults.facets para cada búsqueda sugerida. Cada faceta tiene una lista FacetValues que contiene el recuento de productos por valor de faceta. La cantidad total de productos para cada búsqueda sugerida se muestra en completeQuery.completionResults.totalProductCount.

Para activar y usar las facetas de sugerencias con recuentos de productos, sigue estos pasos:

1. Comunícate con el equipo de asistencia al cliente y pídele que active la función Facet de sugerencias con recuentos de productos. Especifica para qué FacetKeys deseas obtener los recuentos de productos. Solo se permiten facetas textual_fields.

2. Durante al menos 7 días, asegúrate de que, cuando uses la API de search, incluyas la clave de faceta en FacetSpecs y en search.searchRequest.facetSpecs.

   Este tiempo de espera se debe a que la información de las facetas se calcula con los datos del historial de búsqueda de la semana anterior.

3. Después de que se active la función para ti, las sugerencias que devuelva la API de completeQuery contendrán los recuentos de productos por faceta y por sugerencia.

Sugerencia filtrada por entidad

Las entidades te permiten filtrar las sugerencias de autocompletar de la búsqueda. Una entidad puede ser un sitio web de una marca o región diferente. Deseas que la función de autocompletar refleje mejor el comportamiento de los usuarios que compran en esa marca en particular o en el sitio web regional. Para obtener más información sobre las entidades, consulta Entidades.

Ten en cuenta que el filtrado de entidades solo se aplicará a completion_results (relevante para UserEvent). Este filtro no se aplicará a attribute_results (relevante para Product). Por lo tanto, independientemente del valor de entity, el attribute_results es el mismo.

Para incluir entidades en las sugerencias de autocompletar, sigue estos pasos:

1. Incluye el campo entity en tus eventos de usuario de búsqueda (eventType = "search"). Para obtener información, consulta el ejemplo de objeto completo para el evento de usuario Search.

2. Establece el campo entity en tu solicitud a la API de CompleteQuery para obtener sugerencias solo para esa entidad.

   La cadena de la entidad en los eventos de usuario y las solicitudes a la API debe coincidir exactamente. De lo contrario, Autocompletar devolverá sugerencias vacías.

3. Asegúrate de que la entidad (ya sea en los eventos del usuario de la búsqueda o en las solicitudes de Autocomplete) tenga como máximo 256 caracteres. Si es más largo, se trunca a 256 caracteres cuando se procesan los eventos o las solicitudes, lo que genera un riesgo de discrepancia.

Por lo general, se necesitan entre 30 y 90 días de datos de eventos del usuario para que la función de entidades pueda devolver sugerencias de autocompletar óptimas.