Calidad de los datos

En esta página, se describen los casos de uso de la búsqueda, sus respectivos niveles de rendimiento y cómo consultar la consola de Búsqueda para venta minorista para evaluar la calidad de tus datos y los niveles de rendimiento que desbloqueaste. Cada nivel de rendimiento se activa automáticamente cuando cumples con todos sus requisitos de datos que bloquean la actualización. También debes cumplir con los requisitos de todos los niveles anteriores para actualizar al siguiente.

Buscar casos de uso

La Búsqueda proporciona resultados de búsqueda para dos casos de uso:

  • Búsqueda de búsqueda de texto: Se usa cuando los compradores buscan artículos en tu aplicación ingresando búsquedas de texto y obteniendo un conjunto de resultados relevantes.
  • Búsqueda de exploración: Se usa cuando los compradores llegan a una página de categoría en particular, como la página web de la categoría "Electrodomésticos" del sitio de venta minorista de una tienda de mejoras para el hogar, y exploran los artículos ordenados en esa categoría.

Para obtener más información sobre las diferencias entre estos casos de uso, consulta Acerca de la búsqueda de texto y la búsqueda de navegación.

Desbloquea los niveles de rendimiento de la Búsqueda

La búsqueda de consultas de texto y la búsqueda de navegación tienen diferentes niveles de rendimiento que mejoran cada vez más los resultados de la búsqueda. Para desbloquear los niveles de rendimiento, se usan los datos de eventos del usuario y del catálogo que subes a Vertex AI Search para la venta minorista.

Los siguientes niveles de rendimiento están disponibles para ambos casos de uso: búsqueda de consultas de texto y navegación:

Búsqueda de consultas de texto

NIVEL 1

Relevancia:

  • Los resultados se muestran según el grado de relevancia para la búsqueda, como qué tan negro es un vestido cuando se consulta un vestido negro.

Requisitos mínimos de datos:

  • Catálogo
  • Consulta

NIVEL 2

Relevancia y popularidad:

  • Define mejor el nivel 1 para los elementos más populares de la búsqueda que se consultó.
  • Los productos igualmente relevantes se clasifican según la popularidad del producto en tu sitio.

Requisitos mínimos de datos: Datos de clics

NIVEL 3

Clasificación optimizada para los ingresos: Los resultados relevantes se clasifican según la probabilidad de que se compre el producto en función de la actividad específica en todo el sitio.

Requisitos mínimos de datos: Un gran volumen de eventos del usuario.

NIVEL 4

Clasificación personalizada optimizada para ingresos:

  • Los resultados relevantes se clasifican según las preferencias de cada usuario y la probabilidad de que el producto se compre en función de su actividad en todo el sitio.
  • Los productos se clasifican según la "calidad de la coincidencia" con el usuario único que busca o explora el sitio.

Requisitos mínimos de datos:

  • Un gran volumen de eventos del usuario
  • Coincide con visitorID o userId, con un formato coherente en todos los eventos del usuario.

Explorar

BRONZE

Resultados aleatorios

  • Cualquier resultado de la búsqueda que se ajuste a tus filtros, en orden aleatorio.

SILVER

Popularidad

  • Los resultados se muestran solo en función de la relevancia para la categoría.

ORO

Clasificación optimizada para los ingresos

  • Los resultados relevantes se clasifican según la probabilidad de que se compre el producto en función de la actividad en todo el sitio.

PLATINUM

Clasificación personalizada optimizada para ingresos

  • Los resultados relevantes se clasifican según las preferencias de cada usuario y la probabilidad de que se compre el producto en función de la actividad en todo el sitio.

La consola de Search for Retail proporciona una página Calidad de los datos en la que puedes verificar si cumples con los requisitos de datos de cada nivel.

En las siguientes secciones, se muestra cómo registrarte para recibir alertas de calidad de los datos que te notifican en qué nivel se encuentran tus datos, según tus parámetros actuales. Estas alertas también sirven como guía para los requisitos de datos de tu caso de uso específico para optimizar mejor los resultados de la búsqueda.

Verifica la calidad de tus datos

Después de subir tus datos, ve a la consola de Search for Retail para ver las métricas de verificación de datos de cada nivel de rendimiento de tu caso de uso.

  1. Ve a la página Calidad de los datos en la consola de Search for Retail.

    Ir a la página Calidad de los datos

  2. Consulta las métricas de verificación de datos de tu caso de uso de búsqueda:

    • Para las métricas de búsqueda de texto, haz clic en la pestaña Búsqueda.
    • Para ver las métricas de búsqueda de exploración, haz clic en la pestaña Explorar.

  3. Consulta la tarjeta de puntuación de problemas de cada nivel de rendimiento en la parte superior de la página.

    • Si está etiquetado como "En uso": Satisfaciste todos los problemas de bloqueo de ese nivel y lo desbloqueaste.
    • Si no hay 0 problemas de bloqueo: Cumpliste con las verificaciones de datos de ese nivel. Si no hay problemas de bloqueo para este nivel y todos los niveles anteriores, el entrenamiento y la preparación del modelo y la activación del nivel recién desbloqueado tardan alrededor de 24 horas.
    • Si hay algún problema de bloqueo, revisa las métricas de ese nivel para ver qué problemas de datos debes abordar para desbloquearlo.

  4. Consulta la tabla de métricas de verificación de datos de cada nivel de rendimiento para ver una lista de problemas que pueden bloquear las actualizaciones de nivel o afectar el rendimiento de la búsqueda.

  5. Consulta la columna Estado para ver el nivel de prioridad de cada métrica de verificación de datos:

    • Bloqueo de actualización: Identifica problemas de datos que evitan que la búsqueda actualice tu caso de uso al siguiente nivel de rendimiento. Para desbloquear un nivel, debes cumplir con todas las verificaciones de datos de bloqueo de actualizaciones para ese nivel de rendimiento (y las de sus niveles anteriores).
    • Rendimiento crítico: Identifica problemas de datos que no bloquean una actualización, pero pueden tener un impacto significativo en la búsqueda de texto o en el rendimiento de la búsqueda de navegación.
    • Cumple con los requisitos: Indica que se aprobó esta verificación de datos.
    • No disponible: Indica que aún no se completó una verificación de datos de bloqueo que no es de actualización. Los valores de estas métricas se muestran como N/A. Pueden pasar hasta 24 horas después de importar datos para que se procesen algunas verificaciones de datos.

  6. Para obtener más información sobre cualquier métrica, haz clic en Detalles para ver un panel de detalles que muestra la descripción de esa métrica, la marca de tiempo de la verificación de datos y los valores de umbral.

  7. Consulta los umbrales en el panel Detalles de una métrica para ver los valores necesarios para satisfacer la verificación de datos de esa métrica y mejorar los resultados. No todos los umbrales se aplican a todas las métricas:

    • Umbral de bloqueo: Es un umbral obligatorio que se debe cumplir para satisfacer la verificación de datos de esta métrica.
    • Umbral crítico: Es un umbral que se recomienda cumplir. No cumplir con este umbral puede tener un impacto negativo significativo en el rendimiento.
    • Umbral de advertencia: Es un umbral recomendado que se debe cumplir. No cumplir con este umbral puede tener un impacto menor en el rendimiento.

Para importar más datos y resolver cualquier problema, consulta Importa eventos de usuario históricos o Importa información del catálogo en la documentación pública.

Prácticas recomendadas

  • En las solicitudes de búsqueda y en los eventos de usuario, proporciona IDs de usuario, además de los IDs de visitante para los usuarios que accedieron a sus cuentas. Esto permite que la búsqueda personalice los resultados para el usuario en función de los eventos de acceso en todos los dispositivos.
  • Envía eventos de usuario en tiempo real en lugar de cargas masivas con retraso. Esto ayuda a que la búsqueda se personalice con la actividad más reciente de un usuario en tu sitio.
  • Sube todos los eventos de usuario. Por ejemplo, no envíes solo los eventos que se puedan atribuir a las búsquedas.

Selección de funciones para los niveles superiores optimizados para ingresos

Vertex AI Search para venta minorista se actualizó para los minoristas cuyos datos alcanzaron los niveles de rendimiento más altos que desbloquean capacidades de búsqueda optimizadas para los ingresos. Estos minoristas de los niveles superiores ahora pueden usar la selección de funciones:

  • Para Explorar: PLATA y ORO
  • Para la Búsqueda: Niveles 3 y 4

¿Por qué se actualizó la clasificación?

Los clientes de venta minorista de Vertex AI Search de gran tamaño tienen hasta 10,000 atributos personalizados en su catálogo de productos, mientras que el modelo de clasificación anteriormente solo tenía 20 atributos de productos estáticos (como el precio y la calificación promedio) que se compartían entre todos los clientes. Como resultado, el modelo de clasificación tenía datos de productos muy incompletos y no podía personalizar las características de los productos para diferentes dominios de venta minorista y casos de uso, como moda, hardware o artículos para el hogar.

La incapacidad de modelar atributos personalizados llevó a algunos usuarios a colocar los atributos que consideraban importantes en las funciones estáticas (fijas) del producto. Sin embargo, esto requería un esfuerzo manual y, claramente, solo funcionaba para una pequeña cantidad de atributos.

Selección de atributos personalizados dinámicos

Vertex AI Search para la venta minorista actualizó sus niveles optimizados para los ingresos para seleccionar automáticamente atributos personalizados. La actualización implica incorporar atributos personalizados relevantes en el proceso de clasificación:

  • Analiza todos los atributos personalizados de cada minorista y elige los más útiles para agregarlos al conjunto de funciones estáticas de los productos.
  • Muestra los atributos seleccionados para cada minorista.
  • Repite el proceso de selección de atributos de forma periódica (una vez cada 30 días).

En resumen, Vertex AI Search for Retail no solo le brinda al modelo de clasificación acceso a hasta 100 veces o más atributos nuevos potenciales para seleccionar, sino que los atributos de cada cliente también se actualizan con regularidad para adaptarse a las ventas de temporada y otros cambios dinámicos en los datos.

La solución de clasificación actualizada proporciona estadísticas de búsqueda más potentes, ya que utiliza atributos personalizados actualizados periódicamente para mejorar la calidad de los datos.

Conocimiento completo de los productos

  • Selección de atributos: El algoritmo de Vertex AI Search para la venta minorista selecciona hasta 20 atributos personalizados más importantes para cada minorista.
  • Beneficios: Mejora la precisión de las clasificaciones aprovechando la información adicional sobre los productos, como los códigos de oferta y las especificaciones de productos o estilos.
  • Visibilidad: Los minoristas pueden ver los atributos personalizados seleccionados y asegurarse de que se mantengan y estén actualizados.
  • Personalización y aprendizaje: Los clientes pueden identificar patrones en los atributos personalizados seleccionados y agregar otros relevantes para aumentar aún más el rendimiento de la clasificación.

Cómo ver qué atributos se están usando

Si un cliente tiene habilitados los niveles más altos con datos de eventos de usuario suficientes, la nueva información de los atributos personalizados ahora se puede ver en la consola, en la pestaña Búsqueda de texto o Búsqueda de navegación de la página Calidad de los datos de la Búsqueda para venta minorista. Aquí, se te indica qué atributos personalizados eligió el sistema de Vertex AI Search for Retail.

Texto alternativo

Qué hacer con los atributos personalizados

  • Mantén los atributos que se eligieron y no los borres ni descatalogues, ya que podrían afectar el modelo.
  • Mejora la cobertura de los atributos seleccionados automáticamente completando estos campos para más productos
  • Examina las tendencias en las que se seleccionan automáticamente los atributos personalizados. Si tienes otros atributos similares, agrégalos a tu catálogo. Se convertirán en candidatos para que el algoritmo de búsqueda de atributos los seleccione.
  • Para anotar correctamente los atributos numéricos, asígnales valores numéricos en lugar de valores de cadena. Por ejemplo, proporciona un valor numérico de 10.5, en lugar de texto ("10.5").

Cómo desactivar la personalización

Para desactivar la personalización, establece ServingConfig.personalizationSpec en mode.DISABLED.

Alertas sobre la calidad de los datos

Las alertas de calidad de los datos se activan si un valor de métrica en el panel cambia de satisfactorio a no satisfactorio. Las alertas se envían por correo electrónico.

Si quieres ver alertas relacionadas con Cloud Monitoring, ve a Configurar alertas.

Ver la calidad de los datos

  1. Ve a la página Calidad de los datos en la consola de Search for Retail.

    Ir a la página Calidad de los datos

  2. Revisa las filas, las métricas y las alertas: Una fila corresponde a una métrica, y una métrica corresponde a una alerta.

Configura alertas de calidad de los datos

REST

Llama a la API de UpdateAlertConfig.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "ENROLLED",
      "recipients": [
        {
          "emailAddress": "EMAIL_ADDRESS_1"
        },
        {
          "emailAddress": "EMAIL_ADDRESS_2"
        }
      ]
    }
  ]
}'

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto de Google Cloud.
  • EMAIL_ADDRESS_1, EMAIL_ADDRESS_2: Son las direcciones de correo electrónico en las que deseas inscribirte para recibir las alertas. Deben cumplir con el SMTP. Se pueden agregar un máximo de 20 direcciones de correo electrónico a una política de alertas.

Console

  1. Ve a la página Calidad de los datos en la consola de Search for Retail.

    Ir a la página Calidad de los datos

  2. En la parte superior, haz clic en Configurar alertas.

  3. Agrega al menos una dirección de correo electrónico. Las direcciones de correo electrónico deben cumplir con el SMTP (protocolo de transferencia simple de correo). Como máximo, puedes agregar hasta 20 direcciones de correo electrónico a una política de alertas.

  4. Haz clic en Enviar.

Inhabilita las alertas de calidad de los datos

REST

Llama a la API de UpdateAlertConfig.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" -H "X-GFE-SSL: yes" -H "X-Goog-User-Project: PROJECT_ID" \
 "https://retail.googleapis.com/v2alpha/projects/PROJECT_ID/alertConfig" \
--data '
{
  "alertPolicies": [
    {
      "alertGroup": "search-data-quality",
      "enrollStatus": "DECLINED",
      "recipients": [
      ]
    }
  ]
}'

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto de Google Cloud.

Console

  1. Ve a la página Calidad de los datos en la consola de Search for Retail.

    Ir a la página Calidad de los datos

  2. Haz clic en Configurar alertas.

  3. Borra todos los correos electrónicos existentes.

  4. Haz clic en Enviar.

Solucionar problemas

A continuación, te indicamos cómo resolver los siguientes problemas habituales.

La verificación de datos no se aprueba

Si una verificación de datos no se aprueba, haz clic en Detalles para esa métrica en la página Calidad de los datos para ver una descripción más detallada de esa métrica y los umbrales que se deben cumplir para satisfacer esa verificación de datos.

Si ya cumples con los requisitos de datos, consulta la sección Marca de tiempo para ver cuándo se calculó esa métrica por última vez. Si recientemente cambiaste el formato de una gran cantidad de datos o los transferiste, es posible que se tarden varias horas en volver a calcular esa métrica.

Si no cumples con los requisitos de datos, es posible que debas cambiar el formato de los datos o recopilar más datos para cumplir con los requisitos de verificación de datos. Después de asegurarte de que tus datos cumplan con el umbral de la métrica, vuelve a importar los datos con el formato correcto o importa los datos adicionales y, luego, espera a que se vuelva a calcular la métrica.

Un valor de métrica etiquetado como N/A

Los valores de las métricas se muestran como N/A si no se subieron datos o si las métricas aún no se calcularon. Pueden pasar hasta 24 horas después de importar datos para que se procesen algunas verificaciones de datos.

El nivel de rendimiento no tiene problemas de bloqueo, pero no se está usando

Para solucionar el problema, sigue estos pasos:

  1. Verifica si hay algún problema de bloqueo de datos para los niveles anteriores. Debes cumplir con los requisitos de todos los niveles anteriores para actualizar al siguiente.

  2. Espera 24 horas. Después de que se aprueben todas las verificaciones de datos de bloqueo de actualización, se tarda aproximadamente 24 horas en entrenar y preparar el modelo y activar el nivel recién desbloqueado.

Si el nivel de rendimiento no se marca como en uso en un plazo de dos días después de que se aprueben todas sus verificaciones de datos que bloquean la actualización, comunícate con el equipo de asistencia de Vertex AI Search for Retail con el número y el ID del proyecto de tu proyecto para obtener ayuda.

Información adicional sobre los requisitos de datos

Para obtener más información sobre los requisitos de datos de Vertex AI Search para la venta minorista, consulta la documentación:

¿Qué sigue?