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

Se usó la API de Cloud Translation para traducir esta página.

Autocompletar para 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 los minoristas.

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 confirmar la compra. También puede mejorar la calidad de la respuesta de la búsqueda y, por lo tanto, generar mayores ingresos proporcionando 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 podría querer el usuario. Por ejemplo, se pueden sugerir “zapatos” y “camisas” 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 subas
Es un conjunto de datos que se genera a partir de eventos del usuario y otros metadatos con el aprendizaje automático.

Conjunto de datos subido

Una tabla de sugerencias de BigQuery que subes como 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

Un conjunto de datos de sugerencias potenciado por el aprendizaje automático que genera la búsqueda según 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}"

Requisito previo del conjunto de datos de aprendizaje automático

El aprendizaje automático genera sugerencias a partir de los eventos del usuario del tipo de búsqueda (eventType = "search"). La generación usa 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 de usuario del tipo de búsqueda es demasiado pequeña (menos de 20,000), es posible que se filtren muchas sugerencias candidatas. En esta situación, te recomendamos que primero pruebes la función de autocompletado con una búsqueda más frecuente.

Programación de lanzamientos de conjuntos 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 a 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 las consultas y los datos de sugerencias solo para el conjunto de datos de aprendizaje automático.

Atributo	Descripción	Ejemplo
Cómo quitar las búsquedas que no tienen resultados	Quita las búsquedas que no tienen resultados	Para el minorista de comestibles, "Bolsos Gucci" tiene 0 resultados de la búsqueda, por lo que se quita.
Cómo corregir errores tipográficos	Cómo corregir la ortografía de palabras que son errores tipográficos También limpia las consultas de entrada en tiempo real antes de la coincidencia	"Milc" → "Milk"
Agrega consultas de lista de entidades permitidas	Se agregan las consultas que permites de forma explícita	Consulta la sección Más información a continuación.
Quita las consultas de la lista de anunciantes bloqueados	Se quitan las consultas que bloqueas 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 Búsqueda segura de Google Cómo quitar consultas inapropiadas	Contenido pornográfico, sexual, vulgar, violento, etcétera
Quita los términos muy poco frecuentes	El sistema de IA ajusta el corte según las estadísticas de la consulta Si los términos son inusualmente raros, se quitan.	“Colchón de aire doble de 2 capas de 74 × 39 × 9 pulgadas con bomba manual de 120 V”
Anula los términos duplicados	Potenciado por la comprensión semántica basada en IA En el caso de los términos casi idénticos, se hará coincidir cualquiera de ellos, pero solo se sugerirá el más popular.	"Zapatos para mujeres", "Zapatos de mujer" y "Zapatos para mujer" se eliminan, así que solo se sugerirá uno.

Cómo obtener sugerencias de autocompletado

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"

Controles y opciones de Autocompletar

En esta sección, se explican las opciones y los controles 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 consultas de los datos de sugerencias de forma manual	Solicitud a la API: CompletionData:import. Para obtener más información, consulta Cómo importar datos de autocompletado.
Lista de anunciantes permitidos	Agrega consultas a los datos de sugerencias de forma manual	Solicitud a la API: CompletionData:import (consulta también Cómo importar datos de Autocomplete )
Longitud mínima para activar el autocompletado	Controla la cantidad de caracteres antes de que se active el autocompletado.	Consola de Cloud > Controles
Orden coincidente	El orden de coincidencia determina cómo se relacionan las sugerencias y las búsquedas de los usuarios.	Consola de Cloud > Controles
Recuento de sugerencias	Es la cantidad de sugerencias que se mostrarán del 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 según la popularidad de los tipos de dispositivos determinados. Si no especificas esto, se mostrarán 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 generadas automáticamente y subidas, puedes elegir cuál usar en el momento de la consulta.	Solicitud a la API: completeQuery.dataset
Idioma	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, en los datos de sugerencias de autocompletado. Puedes crear una lista de términos permitidos que la búsqueda omita durante el procesamiento posterior.

Los términos incluidos en la lista de anunciantes 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 Autocomplete > Lista Do Not Remove o CompletionData:import en la API.

Los cambios se aplicarán en aproximadamente 2 días.

Lista de bloqueo

La lista de entidades rechazadas solo funciona para los conjuntos de datos de aprendizaje automático. La lista de entidades rechazadas 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 entidades bloqueadas, puedes usar Consola de Cloud > Controles > Controles de Autocomplete > Lista de entidades bloqueadas o la API de CompletionData:import. Para obtener instrucciones detalladas sobre cómo importar una lista de entidades rechazadas, consulta Importa datos de finalización.

Los cambios se aplicarán en aproximadamente 2 días.

Duración mínima para activar

Puedes establecer la cantidad de caracteres requeridos para que las consultas de autocompletado muestren resultados. Puedes encontrar el parámetro de configuración 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 que ingresa el usuario.

Cuando se establece en La sugerencia comienza con el término, la función de autocompletado hace coincidir el término que ingresa el usuario como un prefijo exacto de las sugerencias. Por ejemplo, la entrada del usuario "sh" coincide con las sugerencias "zapatos" y "camisas", pero no con la sugerencia "zapatos rojos".

Cuando se establece en La sugerencia puede comenzar desde cualquier parte del término, el autocompletado divide el término que ingresa el usuario en palabras y lo hace coincidir con las palabras de las sugerencias, independientemente del orden de las palabras. Por ejemplo, el término de entrada del usuario "red sh" coincide con las sugerencias "shirts red", "red shoes" y "kid red shoes". Sin embargo, el término de entrada "hoes" no coincide con estas sugerencias, ya que ninguna de las palabras de las sugerencias comienza con "hoes".

Puedes encontrar el parámetro de configuración en Consola de Cloud > Controles > Controles de autocompletado > Orden de coincidencia.

Los cambios se aplican de inmediato.

Recuento de sugerencias

Esta es la cantidad de sugerencias que se mostrarán de las consultas de autocompletado y no puede superar las 20. Puedes encontrar el parámetro de configuración en Consola de Cloud > Controles > Controles de Autocomplete > Cantidad de sugerencias o puedes configurarlo en completeQuery.

Los cambios se aplican de inmediato.

Tipo de dispositivo

La función Autocomplete 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 los 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 de la consulta con otras sugerencias, como marcas y categorías.

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

Suggestion FeatureSet

Proporcionamos un conjunto de atributos adicional para cada término de sugerencia de búsqueda para 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 for Retail muestra 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 consulta que ingresa el usuario final.

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

Agrupa y crea las secciones Marcas populares y Categorías populares que aparecen debajo de la lista de sugerencias de búsqueda.
Muestra la marca o categoría más popular junto a los términos de sugerencias 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 del catálogo de productos. Este tiempo de espera se debe a que el aprendizaje automático se entrena en 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 conjunto de atributos de sugerencia. Las sugerencias de atributos son listas de atributos de productos sugeridos (como marcas y categorías), al igual que las sugerencias de búsqueda son listas de búsquedas sugeridas. Las sugerencias de atributos se pueden usar independientemente de las sugerencias de consulta. Un conjunto de atributos de sugerencia es un conjunto de metadatos para una sugerencia de consulta, por lo que depende de las sugerencias de consulta.

Las sugerencias de atributos se pueden usar para autocompletar las marcas o categorías que un usuario final escribe, 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 faceta de sugerencias con la función de recuento de productos, el completeQuery.completionResults que se muestra proporciona una lista de sugerencias de autocompletado como de costumbre, pero también los 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 Autocomplete que se muestran podrían ser las siguientes:

calzado para mujeres
calzado para hombres

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 para mujer (32)
- negro (10)
- Taupe (16)
- blanco (10)
calzado para hombres (43)
- negro (10)
- marrón (5)
- verde (17)

Como minorista, no es necesario que presentes el recuento de productos al comprador, pero puedes ordenar la lista de sugerencias en función del recuento de productos en lugar del orden que se muestra en completeQuery.completionResults. Por ejemplo, si quieres que los compradores vean zapatos verdes para hombres, puedes hacer que estos 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. El recuento total de productos de cada consulta de búsqueda sugerida se muestra en completeQuery.completionResults.totalProductCount.

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

Comunícate con el equipo de asistencia al cliente y pídeles que activen la función Faceta de sugerencias con recuentos de productos. Especifica para qué FacetKeys deseas que se registren los recuentos de productos. Solo se permiten textual_fields facetas.
Durante al menos 7 días, asegúrate de que, cuando uses la API de search, incluyas la clave de faceta en FacetSpecs.search.searchRequest.facetSpecs

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

Sugerencia filtrada 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. Quieres que la función de autocompletar refleje mejor el comportamiento de los usuarios que compran en esa marca o 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 tus eventos de usuario de búsqueda (eventType = "search"). Para obtener información, consulta el ejemplo de objeto completo del evento de usuario de Búsqueda.
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 muestra 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 entidad pueda mostrar sugerencias de autocompletado óptimas.