Accede a niveles de rendimiento de la Búsqueda

En esta página, se describen los casos de uso de búsqueda, sus respectivos niveles de rendimiento y cómo verificar la consola de Search for Retail a fin de obtener una evaluación de la calidad de tus datos y los niveles de rendimiento que desbloqueaste. Se muestra cómo registrarte para recibir alertas de calidad de los datos.

Buscar casos de uso

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

  • Búsqueda de texto, que se usa cuando tus compradores ingresan artículos en tu aplicación para buscar artículos en tu aplicación y obtener un conjunto de resultados relevantes.
  • Búsqueda de exploración, que se usa cuando tus 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.

Niveles de rendimiento

Las búsquedas de texto y de navegación tienen diferentes niveles de rendimiento que mejoran cada vez más los resultados de la búsqueda. El desbloqueo de los niveles de rendimiento se basa en los eventos del usuario y los datos del catálogo que subes a Vertex AI Search para la venta minorista.

Cada nivel de rendimiento se activa de forma automática cuando cumples con todos los requisitos de datos que bloquean las actualizaciones. También debes cumplir con los requisitos de todos los niveles anteriores para actualizar al siguiente nivel.

Los siguientes niveles de rendimiento están disponibles para cada caso de uso:

  • Caso de uso de búsqueda de consulta de texto

    • Relevancia: Los resultados se devuelven solo en función de la relevancia con respecto a la búsqueda
    • Relevancia y popularidad: los resultados se muestran en función de la relevancia de la consulta. Los productos que son igual de relevantes se clasifican según la popularidad del producto en tu sitio
    • Optimizada para ingresos: Los resultados relevantes se clasifican según la probabilidad de que el producto se compre según la actividad en todo el sitio
    • Personalizado y con optimización de ingresos: Los resultados relevantes se clasifican según las preferencias de cada usuario y la probabilidad de compra del producto en función de la actividad en todo el sitio.

  • Explora el caso de uso de la búsqueda

    • Popularidad: Los resultados se muestran solo según la relevancia para la categoría.
    • Optimizada para ingresos: Los resultados relevantes se clasifican según la probabilidad de que el producto se compre según la actividad en todo el sitio
    • Personalizado y con optimización de ingresos: Los resultados relevantes se clasifican según las preferencias de cada usuario y la probabilidad de compra del producto en función de la actividad en todo el sitio.

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

Verifica la calidad de los datos

Después de subir los datos, ve a la consola de Search para venta minorista 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 para tu caso de uso de búsqueda:

    • Para ver las métricas de búsqueda de texto, haz clic en la pestaña Buscar.
    • Para explorar las métricas de búsqueda, haz clic en la pestaña Explorar.

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

    • Si está etiquetado como “En uso”: Completaste todos los problemas de bloqueo para ese nivel y lo desbloqueaste.
    • Si hay 0 problemas de bloqueo: Completaste las verificaciones de datos para ese nivel. Si no hay problemas de bloqueo para este nivel y todos los anteriores, el entrenamiento y la preparación del modelo y la activación del nivel recién desbloqueado tardará aproximadamente 24 horas.
    • Si hay algún problema de bloqueo: Consulta las métricas de ese nivel para ver qué problemas de datos se deben abordar para desbloquear ese nivel.

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

  5. Verifica 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 impiden 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).
    • Crítico para el rendimiento: Identifica problemas de datos que no bloquean una actualización, pero que pueden tener un impacto significativo en la búsqueda de texto o en la exploración del rendimiento de la búsqueda.
    • Cumple: 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 la importación de datos para que se procesen algunas verificaciones de datos.

  6. Si quieres 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 la métrica, la marca de tiempo de verificación de datos y los valores de umbrales.

  7. Comprueba los umbrales en el panel Detalles de una métrica para ver los valores necesarios para cumplir con 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 cumplir con la verificación de datos de esta métrica.
    • Umbral crítico: Es un umbral altamente recomendado que se debe alcanzar. No alcanzar este umbral puede tener un impacto negativo significativo en el rendimiento.
    • Umbral de advertencia: Es un umbral recomendado que se debe alcanzar. No cumplir con este umbral puede tener un impacto leve en el rendimiento.

Si quieres importar más datos y solucionar cualquier problema relacionado con los datos, consulta Importa eventos históricos de usuarios 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 los IDs de usuario, además de los ID de visitante, para los usuarios que accedieron a sus cuentas. Esto permite que la búsqueda personalice los resultados del usuario en función de los eventos de acceso de los usuarios en todos los dispositivos.
  • Envía eventos de usuario en tiempo real en lugar de cargas por lotes con demora. Esto permite personalizar la búsqueda mediante la actividad más reciente de un usuario en tu sitio.
  • Sube todos los eventos de usuario. Por ejemplo, no envíes solo eventos que sean atribuibles a las búsquedas.

Desactivar la personalización

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

Alertas de calidad de los datos

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

Si quieres ver alertas relacionadas con Cloud Monitoring, consulta Configura alertas.

Ver la calidad de los datos

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

Una fila corresponde a una métrica y una métrica, 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: Las direcciones de correo electrónico en las que deseas inscribirte para las alertas. Deben ser compatibles con el Protocolo de transferencia de correo simple (SMTP). Se pueden agregar 20 direcciones de correo electrónico como máximo a una política de alertas.

Inhabilitar 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.

Solución de problemas

A continuación, se indican algunos problemas habituales y cómo solucionarlos:

Una verificación de datos no se aprueba

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

Si ya cumpliste con los requisitos de datos, consulta la sección Timestamp para conocer cuándo se calculó la métrica por última vez. Si recientemente reformateaste o transferiste una cantidad significativa de datos, es posible que te tome varias horas volver a calcular esa métrica.

Si no cumples con los requisitos de los 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. Una vez que te hayas asegurado de que tus datos cumplirán con el umbral de la métrica, vuelve a importar los datos reformateados o importa los datos adicionales y, luego, espera a que la métrica se vuelva a calcular.

El valor de una métrica se muestra 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 transcurrir hasta 24 horas después de importar datos para que se procesen algunas verificaciones de datos.

Un nivel de rendimiento no tiene problemas de bloqueo, pero no está en uso

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 nivel.

  2. Espera 24 horas. Después de pasar todas las verificaciones de datos que bloquean las actualizaciones, el entrenamiento y la preparación del modelo y la activación del nivel que se desbloqueó tardará unas 24 horas.

Si el nivel de rendimiento no se marca como en uso en un plazo de dos días después de aprobar todas las verificaciones de datos que bloquean las actualizaciones, comunícate con Vertex AI Search para asistencia de venta minorista con el número y el ID del proyecto para obtener ayuda.

Información adicional sobre los requisitos de datos

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

¿Qué sigue?