Verifique a qualidade dos dados para recomendações de conteúdo multimédia

Esta página descreve como saber se várias métricas dos seus dados de multimédia cumprem os limites dos respetivos requisitos.

Acerca da verificação da qualidade dos dados de multimédia

Uma vez que os eventos de utilizadores recentes são tão importantes para as recomendações de multimédia, tem de verificar regularmente a qualidade dos dados carregados e dos eventos de utilizadores. Pode fazê-lo revendo o separador Otimização da app de recomendações de multimédia para determinar que melhorias pode fazer aos seus dados de modo a otimizar em função de recomendações de melhor qualidade.

Se o limite de uma métrica não for atingido, a métrica tem um estado de aviso. Em seguida, tem de rever a métrica e a respetiva descrição para determinar que ação deve tomar para melhorar a qualidade dos seus suportes.

Todos os modelos e objetivos têm de passar os limites da métrica de Qualidade geral. Alguns modelos e objetivos têm métricas e limites de qualidade específicos da app adicionais. As métricas de qualidade gerais são as mesmas para todas as apps que usam o mesmo repositório de dados, mas as métricas de qualidade específicas da app variam de acordo com o modelo e os objetivos da app.

Para ver informações sobre os modelos de recomendações e os objetivos, consulte o artigo Acerca dos tipos de recomendações de apps de multimédia.

Verifique a qualidade dos dados

Consola

Para verificar a qualidade dos dados de recomendações de multimédia, siga estes passos:

  1. Na Google Cloud consola, aceda à página Aplicações de IA.

    Aplicações de IA

  2. Clique no nome da app de recomendações de multimédia para a qual quer verificar a qualidade dos dados.

  3. No menu de navegação, clique em Qualidade dos dados e, de seguida, no separador Otimização. Esta página mostra o estado de várias métricas para os dados associados à sua app.

  4. Reveja os estados de Qualidade geral e Qualidade específica da app na parte superior da página. O estado do resumo na parte superior da página é apresentado como um aviso se uma ou mais métricas tiverem excedido o respetivo limite.

    As duas tabelas de métricas (Qualidade geral e Qualidade específica da app) apresentam as métricas individuais.

    O separador de otimização mostra uma métrica de aviso para a qualidade geral doc_with_same_title_percentage

  5. Nas tabelas de métricas, clique em Ver detalhes para ver mais informações sobre as métricas no estado de aviso.

  6. Opcional: se quiser ver o limite para uma métrica em conformidade, clique em Ver detalhes. Os limites para métricas em conformidade não são apresentados na tabela de métricas.

REST

Use o método requirements:checkRequirement para verificar a qualidade dos dados de recomendações de multimédia, conforme mostrado.

Para verificar a qualidade a partir da linha de comandos, siga estes passos:

  1. Encontre o ID da loja de dados. Se já tiver o ID do armazenamento de dados, avance para o passo seguinte.

    1. Na Google Cloud consola, aceda à página Aplicações de IA e, no menu de navegação, clique em Armazenamentos de dados.

      Aceda à página Armazenamentos de dados

    2. Clique no nome do seu arquivo de dados.

    3. Na página Dados da sua loja de dados, obtenha o ID da loja de dados.

  2. Execute o seguinte comando curl para saber se as suas recomendações de multimédia cumprem os 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"
        }
      ]
    }'

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .
    • DATA_STORE_ID: o ID do arquivo de dados do Vertex AI Search.

  3. Reveja o resultado:

    1. Procure o valor de result:

      • Se o valor for SUCCESS, os seus dados cumprem os requisitos gerais; avance para o passo 4.

      • Se o valor for WARNING, avance para o passo b.

      • Se não vir result no resultado, existem alguns motivos possíveis:

        • O PROJECT_ID ou o DATA_STORE_ID no pedido está incorreto.

        • Alguns valores de métricas não estão disponíveis. Tente novamente dentro de 6 horas ou contacte um engenheiro de clientes para receber ajuda.

    2. Procure a expressão (requirement.Condition.Expression): se esta expressão for avaliada como falsa, existe um problema com os seus dados.

      O valor das métricas encontra-se no campo requirementCondition.metricResults.value. Os valores do limite de aviso estão nos campos thresholdBindings.thresholdValues. Os campos description podem ajudar a compreender o objetivo da métrica.

      Por exemplo, o valor de doc_with_same_title_percentage é 30.47 e o limite de aviso para doc_with_same_title_percentage_threshold é 1. Existe um problema de dados em que muitos dos títulos no repositório de dados são iguais, e isto tem de ser investigado.

  4. Se a combinação de modelo e objetivo usada para a sua app de recomendações aparecer nesta tabela, também tem de chamar o método check requirement, atualizado com os valores do seu modelo e objetivo:

    Modelo Objetivo MODEL_OBJ
    Outros de que pode gostar Taxa de conversão oyml/cvr
    Recomendadas para si Taxa de conversão rfy/cvr
    Mais deste género Taxa de conversão mlt/cvr
    Mais populares Taxa de conversão mp/cvr
    Outros de que pode gostar Tempo de visualização por sessão oyml/wdps
    Recomendadas para si Tempo de visualização por sessão rfy/wdps
    Mais deste género Tempo de visualizaçã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"
        }
      ]
    }'

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .
    • DATA_STORE_ID: o ID do arquivo de dados do Vertex AI Search.
    • MODEL_OBJ: consulte a tabela anterior para escolher o valor correto para a sua app de recomendações.

  5. Reveja o resultado:

    1. Procure o valor de result:

      • Se o valor for SUCCESS, os seus dados são suficientemente bons.

      • Se o valor for WARNING, avance para o passo b.

      • Se não vir result no resultado, existem alguns motivos possíveis:

        • O PROJECT_ID ou o DATA_STORE_ID no pedido está incorreto.

        • Alguns valores de métricas não estão disponíveis. Tente novamente dentro de 6 horas ou contacte um engenheiro de clientes para receber ajuda.

    2. Procure a expressão (requirement.Condition.Expression). Se esta expressão for avaliada como falsa, existe um problema com os seus dados.

      Pode encontrar o valor das métricas no campo requirementCondition.metricResults.value e os valores do limite de aviso nos campos thresholdBindings.thresholdValues. Os campos description podem ajudar a compreender o objetivo da métrica.