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 ofrece la función autocompletar para potenciar los minoristas búsqueda sugerencias de escritura anticipada del cuadro.

Autocomplete es una función para predecir el resto de una consulta que escribe un usuario, lo que puede mejorar la experiencia de búsqueda del usuario y acelerar el proceso de compra antes de la confirmación de 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 tu sugerencia predicciones:

Un conjunto de datos de BigQuery que subes.
Conjunto de datos que se genera a partir de eventos de usuario y otros metadatos con el uso de automático.

Conjunto de datos subido

Una tabla de sugerencias de BigQuery que subes como un conjunto de datos, que es usarse para sugerir consultas. Para saber cómo subir un conjunto de datos, consulta Importa datos de autocompletar.

Conjunto de datos de aprendizaje automático

Un conjunto de datos de sugerencias con tecnología de aprendizaje automático generado por de búsqueda basada en la actividad buscar eventos.

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

Console

Ir a la página Controles
Ve a la pestaña Controles de Autocomplete.
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 de tipo de búsqueda (eventType = "search"). La generación usa 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 comunes, de modo que, si tipo de búsqueda que la cantidad de eventos de usuario es demasiado pequeña (menos de 20,000), muchas sugerencias candidatos podrían filtrarse. 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 diariamente y, luego, se envía a la indexación. lanzamiento. 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
Quita los caracteres especiales	Elimina los caracteres no estándares de los datos de sugerencias y de consultas escritas. Los caracteres estándar que se conservan en los datos de sugerencias y en las consultas escritas son `%`, `$`, `&` y `.` (punto).	"World's best #*! milk" → "worlds best milk"
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.
Corregir errores de ortografía	Cómo corregir la ortografía de palabras que son errores tipográficos Además, limpia las consultas de entrada en tiempo real antes de buscar coincidencias.	“Milc” → "Leche"
Agregar consultas a la lista de entidades permitidas	Las consultas que permitas explícitamente se agregan	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 Google Safe Search Cómo quitar consultas inapropiadas	Pornografía, contenido subido de tono, vulgar, violento, etc.
Quitar términos muy poco frecuentes	El sistema de IA ajusta el corte en función de las estadísticas de las consultas 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”
Anulación de términos duplicados	Potenciado por la comprensión semántica impulsada por IA En el caso de los términos casi idénticos, se mostrarán coincidencias para ambos, pero solo se sugerirá el más popular.	“Zapatos para mujer”, “Zapatos de mujer” y “Zapatos de mujer” se anulan los duplicados, por lo que solo se sugerirá una.

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

Esta sección explica las opciones y los controles disponibles para autocompletar. Consulta una descripción general en la siguiente tabla y más detalles a continuación.

Control	Detalles	Ubicación
Lista de bloqueo	Quita de forma manual las consultas de los datos de sugerencias	Solicitud a la API: CompletionData:import. Para obtener más información, consulta Importa los datos de autocompletar.
Lista de anunciantes permitidos	Agrega consultas a los datos de sugerencias de forma manual	Solicitud a la API: CompletionData:import (también consulta 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 hacen coincidir las sugerencias y las búsquedas de los usuarios.	Consola de Cloud > Controles
Recuento de sugerencias	Esta es la cantidad de sugerencias que se mostrarán en 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 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 subidas y generadas automáticamente, 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 entidades permitidas nunca se filtran de las sugerencias. La lista de entidades permitidas funciona para los conjuntos de datos subidos y 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 Google > Controles > Controles de Autocomplete > Lista Do Not Remove o CompletionData:import.

Los cambios se aplican 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 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 Autocomplete > Lista de bloqueo o API 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. El parámetro de configuración se encuentra en la consola de Cloud > Controles > Controles de Autocomplete > 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 establece en "La sugerencia comienza con el término", la función de autocompletar coincide con el usuario término de entrada como prefijo exacto para sugerencias. Por ejemplo, la entrada del usuario "sh" coincide con las sugerencias "zapatos" 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 convierte en token el término de entrada del usuario en palabras y lo hace coincidir con las palabras de 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 "azadas" no coincide con estas sugerencias ninguna de las palabras de las sugerencias comienza con "azadas".

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 en el autocompletado y no puede superar las 20. Puedes encontrar el parámetro de configuración en Consola de Cloud > Controles > Controles de Autocomplete > Recuento de sugerencias o se puede establecer 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

Esta sección describe las funciones avanzadas de autocompletar disponibles en 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 FeatureSet adicional para cada término de sugerencia de consulta para permitir los clientes mostrar 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 FeatureSet en la respuesta para enriquecer las sugerencias de búsqueda. Por ejemplo:

Agregar y crear "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 sugerencia de búsqueda.

Después de realizar cambios en el catálogo, como cambiar las categorías de los productos, esperar de dos semanas a 30 días hasta que las sugerencias de FeatureSet reflejen el cambios en el 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 la entrada del usuario. cadenas. Los tipos de sugerencias de atributos admitidos son marcas y categorías.

Las sugerencias de atributos difieren de un conjunto de atributos de sugerencias. Sugerencias de atributos son listas de atributos de productos sugeridos (como marcas y categorías) sobre cómo las sugerencias de consulta son listas de consultas sugeridas. Las sugerencias de atributos se pueden usar independientemente de las sugerencias de consulta. Se recomienda el uso de FeatureSet metadatos para una sugerencia de consulta y, por lo tanto, depende de estas sugerencias.

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 de asistencia al cliente.

Cuando se habilita el atributo sugerencia 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 atributo (como "color" o "categoría").

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

calzado para mujeres
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 para mujer (32)
- negro (10)
- taupe (16)
- blanco (10)
zapatos de hombre (43)
- negro (10)
- marrón (5)
- verde (17)

Como minorista, no necesitas presentar el recuento de productos al comprador pero puedes decidir ordenar la lista de sugerencias según la cantidad 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 un Lista FacetValues que contiene lo siguiente: recuento de productos por valor de faceta. La cantidad total de productos para cada búsqueda sugerida la consulta se devuelve en completeQuery.completionResults.totalProductCount

Para activar y usar facetas de sugerencia con los 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 quieres que se registren los recuentos de productos. Solo se permiten facetas textual_fields.
Durante al menos 7 días, asegúrate de que, cuando uses la API de search, incluyas la clave de faceta en FacetSpecs.

Este tiempo de espera se debe a que la información de las facetas se calcula a partir de la última semana del historiales de búsqueda de Google.
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 el autocompletado refleje mejor el comportamiento de los usuarios que compran esa marca en particular o un sitio web regional. 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 búsqueda de usuarios (eventType = "search"). Para obtener información, consulta el ejemplo completo del objeto de El evento de usuario Search
Establece el campo entity en tu solicitud a la API de CompleteQuery. y obtener sugerencias solo para esa entidad.

La cadena de entidad de los eventos de usuario y las solicitudes a la API deben ser un la coincidencia. 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.