Desbloquear níveis de desempenho da pesquisa

Esta página descreve os casos de uso de pesquisa, os respectivos níveis de desempenho e como verificar o console do Search for Retail para uma avaliação da qualidade dos dados e quais níveis de desempenho foram desbloqueados. Ele mostra como se inscrever para receber alertas de qualidade de dados.

Pesquisar casos de uso

A pesquisa fornece resultados para dois casos de uso:

  • Pesquisa de consulta de texto, usada quando os compradores procuram itens no seu aplicativo inserindo consultas de texto e recebendo um conjunto de resultados relevantes.
  • Procurar pesquisa, usada quando os compradores acessam uma página de categoria específica, como a página da Web da categoria "Equipamentos", de uma loja de artigos para reforma e procuram os itens classificados nessa categoria.

Para saber mais sobre as diferenças entre esses casos de uso, consulte Sobre a pesquisa de texto e a pesquisa de navegação.

Níveis de desempenho

As pesquisas de consulta de texto e navegação têm níveis de desempenho diferentes que melhoram cada vez mais os resultados da pesquisa. O desbloqueio de níveis de desempenho depende dos dados de evento e catálogo do usuário que você envia para a Vertex AI para Pesquisa para varejo.

Cada nível de desempenho é ativado automaticamente quando você atende a todos os requisitos de dados que bloqueiam upgrades. Você também precisa atender aos requisitos de todos os níveis anteriores para fazer upgrade para o próximo.

Os seguintes níveis de desempenho estão disponíveis para cada caso de uso:

  • Caso de uso de pesquisa de consulta de texto

    • Relevância: os resultados são retornados com base apenas na relevância para a consulta.
    • Relevância e popularidade: os resultados são retornados com base na relevância da consulta. Produtos igualmente relevantes são classificados pela popularidade do produto no site
    • Otimizado para receita: os resultados relevantes são classificados pela probabilidade de compra do produto com base na atividade em todo o site.
    • Personalizado e otimizado para receita: os resultados relevantes são classificados de acordo com as preferências do usuário e a probabilidade de compra do produto com base na atividade em todo o site.

  • Procurar caso de uso de pesquisa

    • Popularidade: os resultados são retornados com base apenas na relevância para a categoria.
    • Otimizado para receita: os resultados relevantes são classificados pela probabilidade de compra do produto com base na atividade em todo o site.
    • Personalizado e otimizado para receita: os resultados relevantes são classificados de acordo com as preferências do usuário e a probabilidade de compra do produto com base na atividade em todo o site.

O console do Search for Retail oferece uma página Qualidade de dados em que é possível verificar se você atendeu aos requisitos de dados de cada nível.

Verifique a qualidade dos seus dados

Depois de fazer upload dos dados, acesse o console do Search for Retail para conferir as métricas de verificação de dados de cada nível de desempenho para seu caso de uso.

  1. Acesse a página Qualidade de dados no console da Pesquisa for Retail.

    Acessar a página "Qualidade de dados"

  2. Veja as métricas de verificação de dados para seu caso de uso de pesquisa:

    • Para métricas de pesquisa de texto, clique na guia Pesquisa.
    • Para métricas de pesquisa de navegação, clique na guia Procurar.

  3. Verifique o card de pontuação de problemas de cada nível de desempenho na parte superior da página.

    • Se ele estiver rotulado como "Em uso": você atendeu a todos os problemas de bloqueio desse nível e o desbloqueou.
    • Se não houver problemas de bloqueio:as verificações de dados desse nível foram satisfatórias. Se não houver problemas de bloqueio para esse nível e todos os níveis anteriores, levará cerca de 24 horas para treinar e preparar o modelo e ativar o nível recém-desbloqueado.
    • Se houver problemas de bloqueio:verifique as métricas do nível para saber quais problemas de dados precisam ser resolvidos para desbloquear esse nível.

  4. Confira a tabela de métricas de verificação de dados de cada nível de desempenho para conferir uma lista de problemas que podem bloquear upgrades de nível ou afetar o desempenho da pesquisa.

  5. Confira na coluna Status o nível de prioridade de cada métrica de verificação de dados:

    • Bloqueio de upgrade: identifica problemas de dados que impedem a pesquisa de atualizar seu caso de uso para o próximo nível de desempenho. Para desbloquear um nível, realize todas as verificações de dados de bloqueio de upgrade para esse nível de desempenho (e para os níveis anteriores).
    • Crítico de desempenho: identifica problemas de dados que não bloqueiam um upgrade, mas podem ter um impacto significativo no desempenho da pesquisa de texto ou da navegação.
    • Em conformidade: indica que a verificação de dados foi aprovada.
    • Indisponível: indica que uma verificação de dados de bloqueio que não seja de upgrade ainda não foi concluída. Os valores dessas métricas são exibidos como N/A. Pode levar até 24 horas após a importação de dados para calcular algumas verificações de dados.

  6. Para mais informações sobre qualquer métrica, clique em Detalhes para ver um painel com a descrição, o carimbo de data/hora da verificação de dados e os valores de limite dela.

  7. Verificar os limites no painel Detalhes de uma métrica para encontrar os valores necessários para atender à verificação de dados dela e melhorar os resultados. Nem todos os limites se aplicam a todas as métricas:

    • Limite de bloqueio: é um limite obrigatório a ser cumprido para satisfazer a verificação de dados dessa métrica.
    • Limite crítico: é um limite altamente recomendado a ser atendido. Não atingir esse limite pode ter um impacto negativo significativo no desempenho.
    • Limite de alerta: é um limite recomendado a ser atingido. Não atender a esse limite pode ter um pequeno impacto no desempenho.

Para importar mais dados para atender a quaisquer problemas de dados, consulte Importar eventos históricos de usuários ou Importar informações do catálogo na documentação pública.

Práticas recomendadas

  • Nas solicitações de pesquisa e nos eventos de usuário, forneça os IDs dos usuários, além dos IDs dos visitantes para usuários conectados. Isso permite que a pesquisa personalize os resultados para o usuário com base nos eventos dos usuários conectados em vários dispositivos.
  • Enviar eventos do usuário em tempo real em vez de uploads em lote com atraso. Isso ajuda a personalizar a pesquisa usando a atividade mais recente do usuário no seu site.
  • Faça upload de todos os eventos do usuário. Por exemplo, não envie apenas eventos atribuíveis a pesquisas.

Desativar a personalização

Para desativar a personalização, defina ServingConfig.personalizationSpec como mode.DISABLED.

Alertas de qualidade de dados

Os alertas de qualidade de dados são acionados quando o valor de uma métrica no painel muda de "Satisfatório" para "Não satisfatório". Os alertas são enviados por e-mail.

Se quiser conferir alertas relacionados ao Cloud Monitoring, acesse Configurar alertas.

Ver a qualidade dos dados

Acesse a página Qualidade de dados no console da Pesquisa for Retail.

Acessar a página "Qualidade de dados"

Uma linha corresponde a uma métrica, e uma métrica corresponde a um alerta.

Configurar alertas de qualidade de dados

REST

Chame a API 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"
        }
      ]
    }
  ]
}'

Substitua:

  • PROJECT_ID: o ID do projeto do Google Cloud.
  • EMAIL_ADDRESS_1, EMAIL_ADDRESS_2: os endereços de e-mail em que você quer se inscrever nos alertas. Eles devem ser compatíveis com o SMTP (Protocolo de transferência simples de e-mail). É possível adicionar até 20 endereços de e-mail a uma política de alertas.

Desativar alertas de qualidade de dados

REST

Chame a API 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": [
      ]
    }
  ]
}'

Substitua:

  • PROJECT_ID: o ID do projeto do Google Cloud.

Resolver problemas

Veja alguns problemas comuns e como resolvê-los:

Uma verificação de dados não foi aprovada

Se uma verificação de dados não for aprovada, clique em Detalhes dessa métrica na página Qualidade de dados para ver uma descrição mais detalhada dela e os limites para atender à verificação de dados.

Se você já atendeu aos requisitos de dados, verifique a seção Carimbo de data/hora para saber quando essa métrica foi calculada pela última vez. Se você reformatou ou ingeriu recentemente uma quantidade significativa de dados, pode levar várias horas para recalcular essa métrica novamente.

Se você não atendeu aos requisitos de dados, talvez precise reformatar os dados ou coletar mais dados para atender aos requisitos de verificação de dados. Depois de garantir que seus dados atingirão o limite da métrica, importe novamente os dados reformatados ou importe os dados adicionais e aguarde a métrica ser recalculada.

Um valor de métrica é exibido como N/A.

Os valores de métricas serão exibidos como N/A se nenhum dado tiver sido enviado ou se as métricas ainda não tiverem sido calculadas. Pode levar até 24 horas após a importação de dados para calcular algumas verificações de dados.

Um nível de desempenho não tem problemas de bloqueio, mas não está em uso.

Para resolver o problema, siga estas etapas:

  1. Verifique se há problemas de bloqueio de dados nos níveis anteriores. Você precisa atender aos requisitos de todos os níveis anteriores para fazer upgrade para o próximo.

  2. Aguarde 24 horas. Depois que todas as verificações de dados com bloqueio de upgrade forem aprovadas, levará cerca de 24 horas para treinar e preparar o modelo e ativar o nível recém-desbloqueado.

Se o nível de desempenho não estiver marcado como em uso até dois dias após a aprovação de todas as verificações de dados que bloqueiam o upgrade, entre em contato com o suporte da Vertex AI para Pesquisa para varejo com o número e o ID do projeto para receber ajuda.

Informações adicionais sobre requisitos de dados

Para mais informações sobre os requisitos da Vertex AI para Pesquisa para o varejo, consulte a documentação:

A seguir