Descubre los niveles de rendimiento en la Búsqueda

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 la 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.
  • Explorar la búsqueda, que se usa cuando los compradores llegan a una categoría en particular como "Electrodomésticos", página web de categoría de una mejora para el hogar el sitio de venta minorista de su tienda y explorar 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 con exploración

Niveles de rendimiento

La búsqueda de búsqueda de texto y la búsqueda de exploración tienen diferentes niveles de rendimiento mejorar cada vez más los resultados de la búsqueda. El desbloqueo de los niveles de rendimiento los datos de eventos del usuario y del catálogo que subes a Vertex AI Search for Retail.

Los siguientes niveles de rendimiento están disponibles para los casos de uso, la búsqueda de consultas de texto y la exploración:

NIVEL 1

Relevancia:

  • Los resultados se muestran en función del grado de relevancia para la consulta, por ejemplo, qué tan es el negro de un vestido cuando se consulta.

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 consultada.
  • 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 de todo el sitio.

Requisitos mínimos de datos: Un gran volumen de eventos de usuarios

NIVEL 4

Clasificación personalizada optimizada para los ingresos:

  • Los resultados relevantes se clasifican según las preferencias individuales del usuario y la probabilidad de que se compre el producto en función de la actividad del usuario en todo el sitio.
  • Productos clasificados según la "calidad de concordancia" al usuario único que busca o navega en 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

BRONCE

Resultados aleatorios

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

PLATA

Popularidad

  • Los resultados se muestran solo según la relevancia para la categoría.

GOLD

Clasificación optimizada para 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 optimizada para los ingresos personalizada

  • Los resultados relevantes se clasifican según las preferencias individuales del 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 de Calidad de los datos en la que puede verificar si cumpliste 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 notifiquen en qué niveles 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 verlos Revisa las métricas de cada nivel de rendimiento para 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:

    • Si quieres 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 puntuaciones de problemas de cada nivel de rendimiento en la parte superior de la página.

    • Si aparece la etiqueta "En uso": Cumpliste con todos los bloqueos para ese nivel y lo desbloquearon.
    • Si no hay ningún problema de bloqueo, cumpliste con los datos. y verificaciones de ese nivel. Si no hay problemas de bloqueo para este nivel todos los niveles anteriores, por lo general, se necesitan unas 24 horas para capacitar y preparar un modelo de AA y activar el nivel recientemente desbloqueado.
    • Si hay problemas de bloqueo, verifica las métricas de ese nivel. a fin de ver qué problemas de datos abordar para desbloquear ese nivel.
  4. Consulta la tabla de métricas de verificación de datos de cada nivel de rendimiento que pueden bloquear las actualizaciones de nivel o afectar el rendimiento de la Búsqueda.

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

    • Bloqueo de actualizaciones: Identifica los problemas de datos que evitan desde la actualización de tu caso de uso a la siguiente el nivel de rendimiento actual. Para desbloquear un nivel, debes cumplir con todos los datos de bloqueo de actualizaciones comprobaciones de ese nivel de rendimiento (y los de sus niveles anteriores).
    • Es fundamental para el rendimiento: Identifica los problemas de datos que no bloquear una actualización, pero puede tener un impacto significativo en la búsqueda de texto o por el rendimiento de la búsqueda.
    • Cumple: Indica que se aprobó esta verificación de datos.
    • No disponible: Indica que hay datos de bloqueo que no son de actualización. aún no se completó la verificación. Los valores de estas métricas se muestran como No corresponde. Pueden pasar hasta 24 horas después de importar datos para que se procesen. algunas verificaciones de datos.
  6. Si deseas obtener más información sobre cualquier métrica, haz clic en Detalles para consultar información detallada. que muestra la descripción de esa métrica, la marca de tiempo de la verificación de datos y de los valores de umbral.

  7. Verifica los umbrales en el panel Detalles de una métrica para conocer los valores necesarios para satisfacer la verificación de datos de esa métrica y mejorar los resultados. Es posible que no todas se aplican a todas las métricas:

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

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

Prácticas recomendadas

  • En las solicitudes de búsqueda y los eventos de usuarios, proporciona los IDs de usuario además del visitante IDs de 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.
  • Enviar eventos de usuario en tiempo real en lugar de cargas por lotes con demora 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 búsquedas.

Cómo desactivar la personalización

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

Alertas sobre la calidad de los datos

Las alertas sobre la 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 deseas 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 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 SMTP (Protocolo de transferencia simple de correo electrónico). Se pueden agregar 20 direcciones de correo electrónico como máximo 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 los requisitos del protocolo de transferencia simple de correo electrónico (SMTP). Se pueden agregar 20 direcciones de correo electrónico como máximo a una política de alertas.

  4. Haz clic en Enviar.

Inhabilitar 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. En la parte superior, haz clic en Configurar alertas.

  3. Eliminar todos los correos electrónicos existentes.

  4. Haz clic en Enviar.

Solucionar problemas

Aquí encontrarás algunos problemas habituales y cómo solucionarlos:

Una verificación de datos no se aprueba

Si una verificación de datos no se aprueba, haz clic en Detalles de 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 cumpliste con los requisitos de datos, consulta la sección Timestamp. para cuándo se calculó esa métrica por última vez. Si recientemente reformateaste o transferiste una cantidad significativa de datos, puede llevarle varias horas volver a procesar esa métrica

Si no cumpliste 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 tus datos alcanzarán el umbral de métricas, volver a importar tus datos reformateados o importarás tus datos adicionales y, luego, espera a que la métrica se vuelva a procesar.

Los valores de las métricas se muestran como N/A

Los valores de las métricas se muestran como N/A si no se subieron datos o si aún no se calculan las métricas. Pueden pasar 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 problemas de bloqueo de datos en los niveles anteriores. Debes cumplir con los requisitos de todos los niveles anteriores para actualizar al siguiente.

  2. Espera 24 horas. Una vez que se aprueban todas las verificaciones de datos que bloquean actualizaciones, se tarda alrededor de 24 horas para entrenar y preparar el modelo, y activar el modelo del nivel de servicio.

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 Vertex AI Search para obtener asistencia de venta minorista con tu número de proyecto y el ID del 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 for Retail, consulta la siguiente documentación:

¿Qué sigue?