Esta página descreve como descobrir se várias métricas dos seus dados de mídia atendem aos limites de requisito.
Sobre a verificação da qualidade dos dados de mídia
Como os eventos recentes do usuário são muito importantes para as recomendações de mídia, é necessário verificar regularmente a qualidade dos dados ingeridos e dos eventos do usuário. Para fazer isso, consulte a guia Otimização do app de recomendações de mídia para determinar quais melhorias podem ser feitas nos dados para otimizar a qualidade das recomendações.
Se o limite de uma métrica não for atendido, ela terá um status de alerta. Em seguida, analise a métrica e a descrição dela para determinar quais ações precisam ser tomadas para melhorar a qualidade da mídia.
Todos os modelos e objetivos precisam atender aos limites de métrica da qualidade geral. Alguns modelos e objetivos têm métricas e limites de qualidade específicos do app. As métricas de qualidade gerais são as mesmas para todos os apps que usam o mesmo repositório de dados, mas as métricas de qualidade específicas do app variam de acordo com o modelo e os objetivos do app.
Para saber mais sobre os modelos e objetivos de recomendação, consulte Sobre os tipos de recomendações de apps de mídia.
Verificar a qualidade dos dados
Console
Para verificar a qualidade dos dados de recomendações de mídia, siga estas etapas:
No Console do Google Cloud, acesse a página Criador de agentes.
Clique no nome do app de recomendações de mídia para verificar a qualidade dos dados.
No menu de navegação, clique em Qualidade de dados e na guia Otimização. Esta página mostra o status de várias métricas para os dados associados ao seu app.
Analise os status Qualidade geral e Qualidade específica do app na parte de cima da página. O status de resumo na parte de cima da página aparece como um alerta se uma ou mais métricas excederem o limite.
As duas tabelas de métricas (Qualidade geral e Qualidade específica do app) listam as métricas individuais.
Nas tabelas de métricas, clique em Ver detalhes para mais informações sobre as métricas no estado de alerta.
Opcional: se quiser conferir o limite de uma métrica em conformidade, clique em Ver detalhes. Os limites para métricas em conformidade não são mostrados na tabela de métricas.
REST
Use o método requirements:checkRequirement
para verificar a
qualidade dos dados de recomendações de mídia, conforme mostrado.
Para verificar a qualidade na linha de comando, siga estas etapas:
Encontre o ID do repositório de dados. Se você já tiver o ID do repositório de dados, pule para a próxima etapa.
No console do Google Cloud, acesse a página Criador de agentes e, no menu de navegação, clique em Repositórios de dados.
Clique no nome do seu repositório de dados.
Na página Dados do seu repositório de dados, encontre o ID do repositório.
Execute o comando curl a seguir para saber se as recomendações de mídia atendem aos limites das métricas gerais:
curl -X POST \ -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://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/requirements:checkRequirement" \ -d '{ "location": "projects/PROJECT_ID/locations/global", "requirementType": "discoveryengine.googleapis.com/media_recs/general/all/warning", "resources": [ { "labels": { "branch_id": "0", "collection_id": "default_collection", "datastore_id": "DATA_STORE_ID", "location_id": "global", "project_number": "PROJECT_ID" }, "type": "discoveryengine.googleapis.com/Branch" }, { "labels": { "collection_id": "default_collection", "datastore_id": "DATA_STORE_ID", "location_id": "global", "project_number": "PROJECT_ID" }, "type": "discoveryengine.googleapis.com/DataStore" } ] }'
- PROJECT_ID: o ID do seu projeto do Google Cloud.
- DATA_STORE_ID: o ID do repositório de dados da Vertex AI para Pesquisa.
Confira o resultado:
Procure o valor de
result
:Se o valor for
SUCCESS
, seus dados atendem aos requisitos gerais. Continue para a etapa 4.Se o valor for
WARNING
, continue para a etapa b.Se você não encontrar
result
na saída, há alguns motivos possíveis:O
PROJECT_ID
ouDATA_STORE_ID
na solicitação está incorreto.Alguns valores de métricas estão indisponíveis. Tente de novo em seis horas ou entre em contato com um engenheiro de atendimento ao cliente para receber ajuda.
Procure a expressão (
requirement.Condition.Expression
): se essa expressão for avaliada como falsa, há um problema com seus dados.O valor das métricas está no campo
requirementCondition.metricResults.value
. Os valores do limite de alerta estão nos camposthresholdBindings.thresholdValues
. Os camposdescription
podem ajudar a entender a finalidade da métrica.Por exemplo, o valor de
doc_with_same_title_percentage
é30.47
e o limite de aviso paradoc_with_same_title_percentage_threshold
é1
. Há um problema de dados em que muitos dos títulos no repositório de dados são iguais, e isso precisa ser investigado.
Se a combinação de modelo e objetivo usada para o app de recomendações aparecer nesta tabela, também será necessário chamar o método de verificação de requisitos, atualizado com os valores do modelo e do objetivo:
Modelo Objetivo MODEL_OBJ
Outros itens que você pode gostar Taxa de conversão oyml/cvr
Recomendados para você Taxa de conversão rfy/cvr
Mais conteúdo semelhante Taxa de conversão mlt/cvr
Mais popular Taxa de conversão mp/cvr
Outros itens que você pode gostar Duração da exibição por sessão. oyml/wdps
Recomendados para você Duração da exibição por sessão. rfy/wdps
Mais conteúdo semelhante Duração da exibição por sessão. mlt/wdps
curl -X POST \ -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://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/requirements:checkRequirement" \ -d '{ "location": "projects/PROJECT_ID/locations/global", "requirementType": "discoveryengine.googleapis.com/media_recs/MODEL_OBJ/warning", "resources": [ { "labels": { "branch_id": "0", "collection_id": "default_collection", "datastore_id": "DATA_STORE_ID", "location_id": "global", "project_number": "PROJECT_ID" }, "type": "discoveryengine.googleapis.com/Branch" }, { "labels": { "collection_id": "default_collection", "datastore_id": "DATA_STORE_ID", "location_id": "global", "project_number": "PROJECT_ID" }, "type": "discoveryengine.googleapis.com/DataStore" } ] }'
- PROJECT_ID: o ID do seu projeto do Google Cloud.
- DATA_STORE_ID: o ID do repositório de dados da Vertex AI para Pesquisa.
- MODEL_OBJ: consulte a tabela anterior para escolher o valor correto para seu app de recomendações.
Confira o resultado:
Procure o valor de
result
:Se o valor for
SUCCESS
, os dados são bons o suficiente.Se o valor for
WARNING
, continue para a etapa b.Se você não encontrar
result
na saída, há alguns motivos possíveis:O
PROJECT_ID
ouDATA_STORE_ID
na solicitação está incorreto.Alguns valores de métricas estão indisponíveis. Tente de novo em seis horas ou entre em contato com um engenheiro de atendimento ao cliente para receber ajuda.
Analise a expressão (
requirement.Condition.Expression
). Se essa expressão for avaliada como falsa, há um problema com seus dados.O valor das métricas pode ser encontrado no campo
requirementCondition.metricResults.value
e os valores do limite de aviso nos camposthresholdBindings.thresholdValues
. Os camposdescription
podem ajudar você a entender a finalidade da métrica.