Esta página descreve casos de uso de pesquisa, os respectivos níveis de desempenho e como verificar se há uma avaliação da qualidade dos seus dados e dos níveis de desempenho alcançados. Cada nível de desempenho é ativado automaticamente quando você cumpre todos os requisitos de dados de bloqueio de upgrade. Você também precisa atender aos requisitos de todos níveis anteriores para o upgrade para o próximo nível.
Pesquisar casos de uso
A pesquisa fornece resultados para dois casos de uso:
- Pesquisa de consulta de texto, usada quando os compradores procuram itens na sua o aplicativo inserindo consultas de texto e obtendo um conjunto de resultados relevantes.
- Pesquisa de navegação, usada quando os compradores chegam a uma categoria específica do aplicativo, como "Dispositivos" página da web da categoria de reformas de casas no site de varejo da loja e navegar pelos itens classificados na 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 de navegação têm diferentes níveis de desempenho que a melhorar cada vez mais seus resultados de pesquisa. O desbloqueio de níveis de desempenho depende o evento do usuário e os dados do catálogo que você envia para a Vertex AI para Pesquisa para varejo.
Os seguintes níveis de desempenho estão disponíveis para os casos de uso, pesquisa de consulta de texto e navegação:
Pesquisa de consulta de texto
NÍVEL 1
Relevância:
- Os resultados são retornados com base no grau de relevância da consulta, por exemplo, como um vestido preto é quando uma consulta é feita.
Requisitos mínimos de dados:
- Catálogo
- Consulta
NÍVEL 2
Relevância e popularidade:
- Refina o NÍVEL 1 para os itens mais populares na pesquisa consultada.
- Produtos igualmente relevantes são classificados pela popularidade do produto em seu site.
Requisitos mínimos de dados: dados de cliques
NÍVEL 3
Classificação otimizada de receita: os resultados relevantes são classificados pela probabilidade de compra do produto com base em uma atividade específica em todo o site.
Requisitos mínimos de dados: um grande volume de eventos do usuário.
NÍVEL 4
Classificação personalizada e otimizada para receita:
- Os resultados relevantes são classificados de acordo com as preferências do usuário individual e a probabilidade do produto ser comprado com base na atividade do usuário em todo o site.
- Produtos classificados com base na "qualidade de correspondência" para o usuário único pesquisando ou navegando no site.
Requisitos mínimos de dados:
- Um grande volume de eventos do usuário.
- Corresponde a
visitorID
e/ouuserId
, formatadas de maneira consistente nos eventos do usuário.
Procurar
BRONZE
Resultados aleatórios
- Qualquer resultado de pesquisa que se encaixe nos seus filtros, em ordem aleatória.
PADRÃO
Popularidade
- Os resultados são retornados com base apenas na relevância para a categoria.
GOLD
Classificação otimizada para receita
- Os resultados relevantes são classificados pela probabilidade de compra do produto com base na atividade em todo o site.
PLATINUM
Classificação personalizada otimizada para receita
- Os resultados relevantes são classificados de acordo com as preferências do usuário individual e a probabilidade de compra do produto com base na atividade em todo o site.
O console do Search for Retail tem uma página Qualidade de dados em que você pode verificar se você atendeu aos requisitos de dados de cada nível.
As próximas seções mostram como se inscrever para receber alertas de qualidade de dados que notificam em quais níveis seus dados se enquadram, de acordo com seus parâmetros atuais. Esses alertas também servem como um guia para requisitos específicos de dados do caso de uso para otimizar melhor os resultados da pesquisa.
Verificar a qualidade dos dados
Depois de fazer upload dos seus dados, acesse o console do Search for Retail para vê-los verificar as métricas de cada nível de desempenho para seu caso de uso.
Acesse a página Qualidade de dados no console do Search for Retail.
Acessar a página "Qualidade de dados"Visualize 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.
Confira a tabela de pontuação dos problemas de cada nível de desempenho na parte de cima da página.
- Se ele estiver marcado como "Em uso": você cumpriu todos os requisitos de bloqueio. problemas para esse nível e o desbloquearam.
- Se não houver problemas de bloqueio:você atingiu os dados. para esse nível. Se não houver problemas de bloqueio para este nível e em todos os níveis anteriores, leva cerca de 24 horas para treinar e preparar a 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 solucionar para desbloquear esse nível.
Consulte a tabela de métricas de verificação de dados de cada nível de desempenho para consultar uma lista dos problemas que podem bloquear upgrades de nível ou afetar o desempenho da pesquisa.
Confira o nível de prioridade de cada verificação de dados na coluna Status. métrica:
- Bloqueio de upgrade: identifica problemas de dados que impedem pesquisa ao atualizar seu caso de uso para o próximo nível de desempenho. Para desbloquear um nível, atenda a todos os dados de bloqueio de upgrade verifica o nível de desempenho (e os níveis anteriores).
- Desempenho crítico: identifica problemas de dados que não bloqueiam uma atualização, mas podem ter um impacto significativo na pesquisa de texto ou sobre o desempenho da pesquisa.
- Em conformidade: indica que a verificação de dados foi aprovada.
- Indisponível: indica que um dado de bloqueio que não é de upgrade a verificação 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 computação algumas verificações de dados.
Para saber mais sobre qualquer métrica, clique em Detalhes. que exibe a descrição dessa métrica, o carimbo de data/hora da verificação de dados e valores de limite.
verificar os limites no painel Detalhes de uma métrica para os valores; necessárias para satisfazer a verificação de dados dessa métrica e melhorar os resultados. Nem todas se aplicam a todas as métricas:
- Limite de bloqueio: um limite obrigatório para atender aos critérios. na verificação de dados dessa métrica.
- Limite crítico: é um limite altamente recomendado a ser alcançado. Não atingir esse limite pode ter um impacto negativo significativo em desempenho.
- Limite de aviso: é um limite recomendado para atingir. Não atender a esse limite pode ter um pequeno impacto no desempenho.
Para importar mais dados e satisfazer qualquer problema de dados, consulte Importar eventos históricos do usuário ou Importar informações do catálogo na documentação pública.
Práticas recomendadas
- Em solicitações de pesquisa e em eventos de usuário, forneça IDs de usuário, além de visitantes IDs de usuários conectados. Isso permite que a pesquisa personalize resultados para o usuário com base nas eventos conectados em vários dispositivos.
- Envie eventos do usuário em tempo real em vez de fazer 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 somente eventos que sejam atribuíveis às pesquisas.
Desativar a personalização
Para desativar a personalização, defina
ServingConfig.personalizationSpec
para mode.DISABLED
.
Alertas de qualidade de dados
Os alertas de qualidade de dados são acionados se um valor de métrica no painel mudar de satisfatório para não satisfatório. Os alertas são enviados por e-mail.
Para receber alertas relacionados ao Cloud Monitoring, acesse Configurar alertas.
Ver a qualidade dos dados
Acesse a página Qualidade de dados no console do Search 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
Chamar 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 para os alertas. Eles devem ser compatíveis com o protocolo SMTP (Simple Mail Transfer Protocol). É possível adicionar no máximo 20 endereços de e-mail a uma política de alertas.
Console
Acesse a página Qualidade de dados no console do Search for Retail.
Acessar a página "Qualidade de dados"Na parte de cima, clique em settings Configurar alertas.
Adicione pelo menos um endereço de e-mail. Os endereços de e-mail devem ser compatíveis com o protocolo SMTP (Simple Mail Transfer Protocol). É possível adicionar no máximo 20 endereços de e-mail a uma política de alertas.
Clique em Enviar.
Desativar alertas de qualidade de dados
REST
Chamar 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.
Console
Acesse a página Qualidade de dados no console do Search for Retail.
Acessar a página "Qualidade de dados"Na parte de cima, clique em settings Configurar alertas.
Excluir todos os e-mails existentes.
Clique em Enviar.
Resolver problemas
Veja alguns problemas comuns e como resolvê-los:
- Uma verificação de dados não foi aprovada
- Um valor de métrica é exibido como "N/A".
- Um nível de desempenho não está marcado como em uso, mas não tem problemas de dados de bloqueio
Uma verificação de dados não foi aprovada
Se uma verificação de dados não for aprovada, clique nos Detalhes dessa métrica na página Dados página de qualidade para ver uma descrição mais detalhada dessa métrica e do limites mínimos para atender a essa verificação de dados.
Se você já atendeu aos requisitos de dados, verifique a seção Carimbo de data/hora. de quando essa métrica foi calculada pela última vez. Se você reformatou ou processou recentemente uma quantidade significativa de dados, pode levar várias horas para recalcular essa métrica.
Se você não atender aos requisitos de dados, talvez precise reformatar os dados ou coletar mais dados para atender aos requisitos de verificação de dados. Depois de ter assegurado seus dados atenderão ao limite da métrica, importar novamente os dados reformatados ou Importe os dados extras e aguarde a métrica ser recalculada.
O valor de uma 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 o métricas ainda não foram calculadas. Pode levar até 24 horas após a importação de dados para o para computar 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:
Verifique se há problemas de dados de bloqueio para os níveis anteriores. Você precisa atendem aos requisitos de todos os níveis anteriores para fazer o upgrade para o próximo nível.
Aguarde 24 horas. Depois de todas as verificações de dados de bloqueio de upgrade, cerca de 24 horas para treinar e preparar o modelo e ativar o modelo recém-desbloqueado camada de armazenamento.
Se o nível de desempenho não estiver marcado como em uso até dois dias após a aprovação as verificações de dados com bloqueio de upgrade, entre em contato com o suporte da Vertex AI para Pesquisa para Retail com o número e o ID do projeto para receber ajuda.
Outras informações sobre os requisitos de dados
Para saber mais sobre os requisitos da Vertex AI para Pesquisa para dados de varejo, consulte a documentação:
- Requisitos gerais da Vertex AI para Pesquisa para Retail ao fazer upload de dados de eventos do usuário: Requisitos para eventos do usuário
- Requisitos mínimos de evento do usuário para receber resultados da pesquisa: Requisitos de pesquisa
- Requisitos de dados de catálogo: Métricas de qualidade de dados do catálogo