El nombre de Retail cambiará a Vertex AI Search para venta minorista. Estamos en proceso de actualizar el contenido para reflejar el nuevo desarrollo de la marca.

Autocompletar para la búsqueda

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

Autocomplete es una función para predecir el resto de una consulta que un usuario escribe, lo que puede mejorar su experiencia de búsqueda y acelerar el proceso de compra antes de la confirmación de la compra. También puede mejorar la calidad de la respuesta de búsqueda y, por lo tanto, generar mayores ingresos cuando proporciona consultas con un formato correcto.

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 el usuario podría querer. Por ejemplo, "calzado" y "camisas" podrían sugerirse cuando el usuario escribe "sh".

Fuente de datos

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

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

Conjunto de datos subido

Una tabla de sugerencias de BigQuery que subes como conjunto de datos, que se usa para sugerir consultas. Si deseas obtener información para subir un conjunto de datos, consulta la sección sobre cómo importar datos de autocompletar.

Conjunto de datos de aprendizaje automático

Es un conjunto de datos de sugerencias con tecnología de aprendizaje automático generado por búsquedas basadas en los eventos de búsqueda de los usuarios.

Para habilitar el aprendizaje automático, haz lo siguiente:

Console

Ir a la página Controles
Ve a la pestaña Controles de Autocompletar.
Haz clic en Editar la configuración.
Activa Aprendizaje automático.
Haz clic en Guardar configuración.

El aprendizaje automático puede tardar entre 1 y 2 días en actualizarse.

cURL

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}"

Requisitos previos del conjunto de datos de aprendizaje automático

El aprendizaje automático genera sugerencias a partir de los eventos del usuario de tipo de búsqueda (eventType = "búsqueda"). La generación utiliza los últimos 180 días de eventos de usuario. 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 de usuario del tipo de búsqueda es demasiado pequeña (menos de 20,000), es posible que se filtren muchos candidatos para sugerencias. En esta situación, es recomendable que primero pruebes la función de autocompletado con una búsqueda más frecuente.

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

Este conjunto de datos se genera a diario y, luego, se envía a la indexación y al lanzamiento. El ciclo completo dura alrededor de dos días.

Funciones de aprendizaje automático

La búsqueda aplica técnicas de aprendizaje automático para limpiar y formatear consultas y datos de sugerencias solo para el conjunto de datos de aprendizaje automático.

Atributo	Descripción	Ejemplo
Quita los caracteres especiales	Quita los caracteres no estándar de los datos de sugerencias y de las consultas escritas. Los caracteres estándar que se mantienen en los datos de sugerencias y en las consultas escritas son los siguientes: `%`, `$`, `&` y `.` (punto)	"La mejor leche del mundo*" → "La mejor leche del mundo"
Eliminar búsquedas de 0 resultados	Quita las consultas que no tienen ningún resultado de la búsqueda	Para el minorista de comestibles, "Bolsos Gucci" no tiene resultados de búsqueda, por lo que se quitó.
Corregir errores tipográficos	Corregir la ortografía de las palabras que son errores tipográficos Limpia también las consultas de entrada en tiempo real antes de que coincidan	"Milc" → "Milk"
Agregar consultas de lista de entidades permitidas	Las consultas que permitas explícitamente se agregarán	Consulta la sección Más información a continuación.
Quitar consultas de listas de entidades bloqueadas	Se quitarán las consultas que bloquees de forma explícita.	Consulta la sección Más información a continuación.
Quita los términos no seguros	Con la tecnología de Google Safe Search Cómo quitar búsquedas inapropiadas	Pornografía, contenido subido de tono, vulgar, violencia, etcétera
Quita los términos muy poco frecuentes	El sistema de IA ajusta el corte según las estadísticas de las consultas Si los términos son inusualmente inusuales, se quitan.	“Colchón de aire doble de 2 capas de 74 x 39 x 9 pulgadas con bomba de mano de 120 V”
Anula los términos duplicados	Basado en la comprensión semántica impulsada por IA Para términos casi idénticos, cualquiera de los términos coincidirá, pero solo se sugerirá el más popular.	Los valores de "Zapatos para mujeres", "Zapatos de mujer" y "Zapatos de mujer" no tienen duplicados, por lo que solo se sugerirá uno.

Obtén sugerencias de finalización

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

cURL

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 Autocomplete

En esta sección, se explica qué opciones y controles están disponibles para el autocompletado. Consulta una descripción general en la siguiente tabla y más detalles a continuación.

Control	Detalles	Ubicación
Lista de bloqueo	Quita manualmente las consultas de los datos de sugerencias	Solicitud a la API: CompletedData:import. Para obtener más información, consulta Cómo importar datos de autocompletado.
Lista de entidades permitidas	Agrega consultas de forma manual a los datos de sugerencias	Solicitud a la API: CompletionData:import (consulta también Cómo importar datos de Autocomplete )
Longitud mínima para activar la función de autocompletar	Controla la cantidad de caracteres antes de que se active la función de autocompletar.	Consola de Cloud > Controles
Orden coincidente	El orden de coincidencia determina cómo se vinculan las sugerencias y la consulta del usuario.	Consola de Cloud > Controles
Recuento de sugerencias	Esta es la cantidad de sugerencias que se mostrarán con el autocompletado	Consola de Cloud > Controles o Solicitud a la API: completeQuery.maxSuggestions
Tipo de dispositivo	Cuando se especifican los tipos de dispositivos, las sugerencias se generan en función de la popularidad de esos tipos Si no se especifica esto, devuelve sugerencias basadas en la popularidad combinada de todos los tipos de dispositivos	Solicitud a la API: completeQuery.deviceType
Fuente de datos de sugerencias	Si tienes fuentes de datos autogeneradas y subidas, puedes elegir cuál usar en el momento de la consulta.	Solicitud a la API: completeQuery.dataset
lenguaje	Puedes especificar en qué idiomas quieres que aparezcan las sugerencias.	Solicitud a la API: completeQuery.languageCodes[]

Lista de entidades permitidas (lista de No quitar)

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

Los términos incluidos en la lista de entidades permitidas nunca se filtran de las sugerencias. La lista de entidades permitidas funciona para los conjuntos de datos subidos y los conjuntos 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 la consola de Cloud > Controles > Controles de autocompletado > Lista No quitar o usar CompletionData:import.

Los cambios tardan aproximadamente 2 días en aplicarse.

Lista de bloqueo

La lista de bloqueo solo funciona para 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 la consola de Cloud > Controles > Controles de autocompletado > Lista de denegación o usar la API CompletionData:import. Si quieres obtener instrucciones detalladas para importar una lista de bloqueo, consulta cómo importar datos completados.

Los cambios tardan aproximadamente 2 días en aplicarse.

Duración mínima para activar

Puedes configurar la cantidad de caracteres requeridos para que las consultas de autocompletar muestren resultados. El parámetro de configuración se encuentra en Consola de Cloud > Controles > Controles de autocompletado > 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 de entrada del usuario.

Cuando se configura como "La sugerencia comienza con el término", la función de autocompletar establece una coincidencia con el término ingresado por el usuario como un prefijo exacto de las sugerencias. Por ejemplo, la entrada del usuario "sh" coincide con las sugerencias "calzado" y "camisas", pero no con la sugerencia "zapatos rojos".

Cuando se configura en "La sugerencia puede comenzar desde cualquier parte del término", la función de autocompletar asigna tokens al término de entrada del usuario en palabras y hace que coincida con las palabras de las sugerencias, independientemente del orden de las palabras. Por ejemplo, el término de entrada del usuario “redsh” 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 porque ninguna de las palabras de las sugerencias comienza con "hoes".

El parámetro de configuración se encuentra en la consola de Cloud > Controles > Controles de autocompletado > Orden coincidente.

Los cambios se aplican de inmediato.

Recuento de sugerencias

Esta es la cantidad de sugerencias que se mostrarán a partir de las consultas de autocompletado y no puede ser superior a 20. El parámetro de configuración se encuentra en Cloud Console > Controles > Controles de autocompletado > Recuento de sugerencias o se puede establecer en completeQuery.

Los cambios se aplican de inmediato.

Tipo de dispositivo

El autocompletado de búsquedas 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á en todos los tipos de dispositivos.

Para un conjunto de datos de aprendizaje automático basado en eventos de 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 autocompletado de consultas con otras sugerencias, como marcas y categorías.

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

Conjunto de atributos de sugerencias

Proporcionamos un FeatureSet adicional para cada término de sugerencia de consulta a fin de permitir que los clientes muestren funciones avanzadas en sus sitios web.

El FeatureSet aparece en la respuesta como un mapa de par clave-valor. Actualmente, Vertex AI Search para venta minorista muestra hasta cinco categorías y marcas populares relacionadas con cada sugerencia de consulta en la respuesta de la API de completeQuery.completionResults.attributes. Las sugerencias de FeatureSet no tienen que coincidir con las cadenas de consulta que ingresa el usuario final.

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

Agrega y crea secciones de "Marcas populares" y "Categorías populares" que aparezcan debajo de la lista de sugerencias de búsqueda.
Muestra la marca o categoría más popular junto a los términos de las sugerencias de búsqueda.

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

Sugerencias de atributos (experimental)

Esta función se encuentra en fase experimental. Comunícate con el equipo de asistencia al cliente si te interesa convertirte en un usuario pionero.

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

Las sugerencias de atributos difieren de un conjunto de atributos de sugerencia. Las sugerencias de atributos son listas de atributos de productos sugeridos (como marcas y categorías), de manera similar a como las sugerencias de consulta son listas de consultas sugeridas. Las sugerencias de atributos se pueden usar independientemente de las sugerencias de consulta. Un FeatureSet de sugerencia son metadatos para una sugerencia de consulta y, por lo tanto, depende de estas sugerencias.

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

Faceta de sugerencia 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 la faceta de sugerencias con la función de recuento de productos está habilitada, el objeto completeQuery.completionResults que se muestra proporciona una lista de sugerencias de autocompletar de forma normal, pero también cuenta de productos para cada sugerencia con el recuento total y el recuento de productos por faceta (como "color", "categoría").

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

zapatos de mujer
calzado hombre

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

calzado de mujer (32)
- negro (10)
- topo (16)
- blanco (10)
calzado hombre (43)
- negro (10)
- marrón (5)
- verde (17)

Como minorista, no necesitas presentar el recuento de productos al comprador, pero puedes ordenar la lista de sugerencias según el recuento de productos, en lugar del pedido que se muestra en completeQuery.completionResults. Por ejemplo, podrías motivar a los compradores a mirar zapatos verdes para hombres. Para ello, haz que aparezcan zapatos verdes 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. El recuento total de productos para cada búsqueda sugerida se muestra en completeQuery.completionResults.totalProductCount.

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

Comunícate con el equipo de asistencia al cliente y pídele que active la función “Faceta de sugerencia con recuentos de productos”. Especifica para qué FacetKeys quieres que se cuenten los productos. Solo se permiten textual_fields facetas.
Durante al menos 7 días, asegúrate de que, cuando uses la API de search, incluya la clave de faceta en FacetSpecs incluya la clave de faceta en search.searchRequest.facetSpecs.

El tiempo de espera se debe a que la información de las facetas se calcula con la última semana de datos del historial de búsqueda.
Después de activar la función, las sugerencias que se muestran de la API de completeQuery contienen los recuentos de productos por faceta y por sugerencia.

Se filtró la sugerencia por entidad

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

Para incluir entidades en las sugerencias de autocompletar, haz lo siguiente:

Incluye el campo entity en los eventos de usuario de la búsqueda (eventType = "search"). A fin de obtener información, consulta el ejemplo completo de objeto para el evento de usuario Search.
Establece el campo entity en tu solicitud a la API de CompleteQuery para obtener sugerencias solo para esa entidad.

La cadena de entidad en los eventos de usuario y las solicitudes a la API debe ser una coincidencia exacta. De lo contrario, el autocompletado mostrará sugerencias vacías.

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