Descubre los niveles de rendimiento en la Búsqueda

En esta página, se describen los casos de uso de búsqueda, sus respectivos niveles de rendimiento y cómo consultar la consola de Search for Retail para realizar una evaluación de la calidad de los datos y los niveles de rendimiento que desbloqueaste. Aquí se muestra cómo registrarse para recibir alertas de calidad de los datos.

Buscar casos de uso

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

  • La búsqueda de consultas de texto, que se usa cuando los compradores buscan artículos en tu aplicación mediante el ingreso de consultas de texto y la obtención de un conjunto de resultados relevantes
  • Explorar la búsqueda: Se usa cuando los compradores llegan a una página de categorías en particular, como la página web de la categoría "Electrodomésticos" de un sitio de venta minorista 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 por 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 que mejoran cada vez más los resultados de la búsqueda. El desbloqueo de niveles de rendimiento depende de los datos del catálogo y de eventos del usuario que subes a Vertex AI Search for Retail.

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 la búsqueda de consultas de texto

    • Relevancia: Los resultados se muestran solo según la relevancia para la búsqueda.
    • Relevancia y popularidad: Los resultados se muestran según la relevancia para la consulta. Los productos igualmente relevantes se clasifican según la popularidad del producto en tu sitio
    • Optimización 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.
    • Personalizada y 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 en todo el sitio.

  • Explora el caso de uso en la búsqueda

    • Popularidad: Los resultados se muestran solo según la relevancia para la categoría.
    • Optimización 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.
    • Personalizada y 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 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 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 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 está etiquetado como “En uso”: Cumples con todos los problemas de bloqueo de ese nivel y lo desbloqueaste.
    • Si no hay ningún problema de bloqueo, cumpliste con las verificaciones de datos para ese nivel. Si no hay problemas de bloqueo para este nivel ni para todos los niveles anteriores, entrenar y preparar el modelo y activar el nivel recién desbloqueado tardará alrededor de 24 horas.
    • Si hay problemas de bloqueo: Verifica las métricas de ese nivel para ver qué problemas de datos 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 los problemas que pueden bloquear las actualizaciones de nivel o afectar el rendimiento de la búsqueda.

  5. Revisa la columna Status 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 pueden tener un impacto significativo en el rendimiento de la búsqueda de texto o de navegación.
    • Cumple: Indica que se aprobó esta verificación de datos.
    • No disponible: Indica que aún no se completó la verificación de datos de bloqueo de la 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. 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 esa métrica, la marca de tiempo de verificación de datos y los valores de los umbrales.

  7. Revisa los umbrales en el panel Detalles de una métrica a fin de conocer 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 que se requiere alcanzar 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 importante 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.

Para importar más datos y satisfacer cualquier problema de datos, consulta Cómo importar eventos de usuario históricos o Cómo importar 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 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 de los usuarios en todos los dispositivos.
  • Enviar eventos de usuario en tiempo real en lugar de cargas por lotes con demora De esta manera, se personaliza la búsqueda con la actividad más reciente de un usuario en tu sitio.
  • Sube todos los eventos de usuario. Por ejemplo, no envíes solo eventos 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 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: 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 los 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 cumplir con esa verificación de datos.

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

Si no cumpliste 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. Una vez que te asegures de que tus datos alcanzarán el umbral de la métrica, vuelve a importar tus datos con formato nuevo o importa tus datos adicionales y, luego, espera a que la métrica se vuelva a calcular.

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

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

  2. Espera 24 horas. Después de que se pasan todas las verificaciones de datos de bloqueo de actualizaciones, el entrenamiento y la preparación del modelo y la activación del nivel recién desbloqueado tardan 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 la actualización, comunícate con la asistencia de Vertex AI Search para venta minorista y proporciona el número 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?