Autocompletar en la búsqueda

En esta página se presenta la función Autocompletar y se explica cómo usarla. La búsqueda ofrece la función Autocompletar para sugerencias de escritura anticipada en el cuadro de búsqueda de rutas.

Autocompletar es una función que predice el resto de una consulta que está introduciendo un usuario, lo que puede mejorar su experiencia de búsqueda y acelerar el proceso de compra antes de la tramitación. También puede mejorar la calidad de las respuestas de búsqueda y, por lo tanto, generar más ingresos proporcionando consultas bien formateadas.

Información general

Cuando un usuario final empieza a escribir un término de búsqueda en su sitio, la búsqueda puede proporcionar una lista de sugerencias que le puedan interesar. Por ejemplo, se pueden sugerir zapatos y camisas cuando el usuario escriba ca.

Fuente de datos

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

• Un conjunto de datos de BigQuery que subas.
• Conjunto de datos generado 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 y que se usa para sugerir consultas. Para saber cómo subir un conjunto de datos, consulta Importar datos de autocompletado.

Conjunto de datos de aprendizaje automático

Conjunto de datos de sugerencias basado en aprendizaje automático generado por la búsqueda a partir 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 de usuario (eventType = "search") del tipo de búsqueda. Para ello, se utilizan los eventos de usuario de los últimos 180 días. Para ello, es necesario importar una buena cantidad de eventos de usuario de calidad.

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 a sugerencia. En este caso, te recomendamos que primero pruebes la función Autocompletar con una consulta de búsqueda más frecuente.

Programación de lanzamiento de conjuntos de datos de aprendizaje automático

El conjunto de datos de aprendizaje automático se genera a diario y, a continuación, se envía a la indexación y a la publicación. El ciclo completo dura unos 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.

Obtener sugerencias de autocompletado

Usa la API completeQuery para obtener 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 Autocompletar

En esta sección se explican las opciones y los controles disponibles para el autocompletado. Consulta un resumen en la siguiente tabla y más detalles.

Lista de permitidos (lista que no se debe quitar)

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

Los términos permitidos nunca se excluyen de las sugerencias. La lista de permitidos funciona tanto para los conjuntos de datos subidos como para los conjuntos de datos de aprendizaje automático.

Por ejemplo, hay algunos nombres de marca que se han escrito mal intencionadamente, como "froot loops" en lugar de "fruit" o "foot". Consulta las instrucciones detalladas sobre la subida en la sección Datos de finalización de la importación.

Para importar datos, puedes usar Consola de Cloud > Controles > Controles de autocompletar > Lista de no eliminar o usar CompletionData:import en la API.

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

Lista de no permitidas

La lista de denegación solo funciona con conjuntos de datos de aprendizaje automático. La lista de denegación no funciona con los conjuntos de datos subidos.

Los términos de una lista de denegación nunca aparecen en las sugerencias.

Para importar una lista de denegación, puedes usar Cloud Console > Controles > Controles de autocompletado > Lista de denegación o la API CompletionData:import. Para obtener instrucciones detalladas sobre cómo importar una lista de denegación, consulta Importar datos de finalización.

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

Longitud mínima para activarse

Puedes definir el número de caracteres que se deben introducir para que las consultas de autocompletar devuelvan resultados. Puedes encontrar este ajuste en Consola de Cloud > Controles > Controles de autocompletar > Longitud mínima para activar.

Los cambios se aplican al momento.

Orden de coincidencia

Determina cómo se deben asociar las sugerencias con los términos introducidos por los usuarios.

Si se selecciona La sugerencia empieza por el término, el autocompletado coincide con el término introducido por el usuario como prefijo exacto de las sugerencias. Por ejemplo, la entrada de usuario "ca" coincide con las sugerencias "camisa" y "camiseta", pero no con "camisa roja".

Si se selecciona La sugerencia puede empezar desde cualquier parte del término, la función de autocompletar tokeniza el término introducido por el 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 sh" 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 empieza por "hoes".

Puedes encontrar este ajuste en Consola de Cloud > Controles > Controles de autocompletar > Orden de coincidencia.

Los cambios se aplican al momento.

Número de sugerencias

Es el número de sugerencias que se devolverán de las consultas de autocompletado y no puede superar las 20. Puedes encontrar este ajuste en Consola de Cloud > Controles > Controles de autocompletar > Número de sugerencias o configurarlo en completeQuery.

Los cambios se aplican al momento.

Tipo de dispositivo

La función Autocompletar de la Búsqueda es compatible con diferentes tipos de dispositivos, como mobile y desktop. Puedes subir o recibir diferentes sugerencias en función del tipo de dispositivo. Si no se especifica deviceType en completeQuery, la sugerencia se aplicará a todos los tipos de dispositivos.

En el caso de un conjunto de datos de aprendizaje automático basado en eventos de usuario de búsqueda, defina user_agent en UserEvent.user_info para admitir diferentes tipos de dispositivos. Consulta el user-agent en la wiki.

Funciones avanzadas

En esta sección se describen las funciones avanzadas de Autocompletar disponibles con la búsqueda. Por ejemplo, puede complementar las sugerencias de autocompletar 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.

Suggestion FeatureSet

Proporcionamos un FeatureSet adicional para cada término de sugerencia de consulta para que los clientes puedan mostrar funciones avanzadas en sus sitios web.

FeatureSet aparece en la respuesta como un mapa de valores clave. Vertex AI Search para el sector del comercio devuelve hasta cinco categorías y marcas populares relacionadas con cada sugerencia de consulta en la respuesta de la API completeQuery.completionResults.attributes. Las sugerencias de FeatureSet no tienen que coincidir con las cadenas de consulta introducidas por el usuario final.

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

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

Después de hacer cambios en el catálogo, como cambiar las categorías de los productos, tendrás que esperar entre dos semanas y 30 días para 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 marcas y categorías.

Las sugerencias de atributos son diferentes de las de FeatureSet. Las sugerencias de atributos son listas de atributos de producto sugeridos (como marcas y categorías), de forma similar a las sugerencias de consultas. Las sugerencias de atributos se pueden usar independientemente de las sugerencias de consultas. Un FeatureSet de sugerencia es metadatos de una sugerencia de consulta y, por lo tanto, depende de las sugerencias de consulta.

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

Facetas de sugerencias con recuentos de productos (experimental)

Se trata de una función experimental para un número limitado de clientes. Para usarlo, ponte en contacto con el equipo de Asistencia.

Cuando se habilita la función de faceta de sugerencias con recuento de productos, la respuesta completeQuery.completionResults proporciona una lista de sugerencias de autocompletado como de costumbre, pero también el recuento de productos de cada sugerencia, así como el recuento total y el recuento de productos por faceta (como color y category).

Por ejemplo, si la consulta de búsqueda es "zapatos", las sugerencias de autocompletar devueltas podrían ser las siguientes:

• Zapatos de mujer
• zapatos de hombre

Además, si la clave de la 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 Autocompletar:

• zapatos de mujer (32)
  • negro (10)
  • Gris pardo (16)
  • blanco (10)
• zapatos de hombre (43)
  • negro (10)
  • marrón (5)
  • Verde (17)

Como comercio, no tiene que mostrar el número de productos al comprador, pero puede decidir ordenar la lista de sugerencias en función del número de productos en lugar del orden devuelto en completeQuery.completionResults. Por ejemplo, puede animar a los compradores a que vean zapatos verdes para hombre haciendo que 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 consulta de búsqueda sugerida. Cada faceta tiene una lista FacetValues que contiene el número de productos por valor de faceta. El recuento total de productos de cada consulta de búsqueda sugerida se devuelve en completeQuery.completionResults.totalProductCount.

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

1. Ponte en contacto con el equipo de Asistencia y pídele que active la función Facetas de sugerencias con recuentos de productos. Especifica de qué FacetKeys quieres obtener el recuento de productos. Solo se permiten las facetas textual_fields.

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

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

3. Una vez que se haya activado la función, las sugerencias devueltas por la API completeQuery contendrán el número 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 otra marca u otra región. Quieres que la función de autocompletar refleje lo mejor posible el comportamiento de los usuarios que compran esa marca o en ese sitio web regional. Para obtener más información sobre las entidades, consulta Entidades.

Ten en cuenta que el filtro 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, attribute_results será el mismo.

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

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

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

   La cadena de entidad de los eventos de usuario y las solicitudes de la API debe ser exactamente igual. De lo contrario, Autocompletar devuelve sugerencias vacías.

3. Comprueba que la entidad (ya sea en eventos de usuario de búsqueda o en solicitudes de autocompletar) tenga un máximo de 256 caracteres. Si es más larga, se trunca a 256 caracteres cuando se procesan los eventos o las solicitudes, lo que puede provocar que no coincidan.

Normalmente, se necesitan entre 30 y 90 días de datos de eventos de usuario para que la función de entidad pueda devolver sugerencias de autocompletar óptimas.