Ver estatísticas

Esta página descreve como ver as estatísticas das suas recomendações e apps de pesquisa.

O Analytics oferece estatísticas sobre as tendências de utilização, a qualidade da pesquisa e das recomendações, e a interação do utilizador final com a sua app. A consola AI Applications oferece uma experiência de painel de controlo interativo com tecnologia Looker.

• Para apps de recomendações de conteúdo multimédia: pré-visualização pública. Pode ver métricas por recomendação com base em eventos do utilizador. Pode filtrar as métricas por intervalo de datas e tipo de dispositivo.
• Para apps de pesquisa personalizada e pesquisa de multimédia: pode ver métricas por pesquisa e métricas por sessão de pesquisa com base nos registos de pesquisa e nos eventos do utilizador. Pode filtrar as métricas por intervalo de datas, consulta e tipo de dispositivo.
• Para apps de pesquisa de cuidados de saúde: pré-visualização pública. Pode ver métricas por pesquisa com base nos registos de pesquisa.

As métricas são atualizadas aproximadamente a cada seis horas. Por isso, pode demorar várias horas até poder usar a página Analytics depois de criar a sua app.

Origens de dados para a análise

Esta secção descreve as origens de dados para as estatísticas, consoante o tipo de app.

Tem de concluir a integração de eventos do utilizador para poder ver as estatísticas de eventos do utilizador.

Os eventos de utilizador que carrega afetam as estatísticas geradas.

As apps de recomendações de conteúdo multimédia requerem os seguintes eventos de utilizador para ver algumas métricas:

• Eventos view_item. Necessário para a taxa de cliques.
• Eventos media_complete. Obrigatório para a taxa de conclusão por reprodução e a taxa de conclusão por recomendação.
• Eventos de reprodução de multimédia. Necessário para a contagem de reproduções de conteúdo multimédia de recomendações, taxa de visualização completa, taxa de conclusão por reprodução e tempo de visualização médio por reprodução.

As apps de pesquisa requerem os seguintes eventos do utilizador para ver algumas métricas:

• Pesquisar eventos. Necessário para a taxa de cliques.
• Eventos view_item. Necessário para a taxa de cliques.

As seguintes informações também são usadas para algumas estatísticas:

• Impressões. Pode fornecer impressões (visualizações ou cliques de artigos) atribuíveis à Pesquisa da Vertex AI incluindo o artigo associado em UserEvent.Documents quando carrega eventos do utilizador. Estas informações são necessárias para a atribuição e para calcular as métricas por pesquisa.
• Tokens de atribuição. Os tokens de atribuição são IDs exclusivos gerados pela Vertex AI Search e devolvidos com cada pedido de pesquisa. Certifique-se de que inclui esse token de atribuição como UserEvent.attributionToken com quaisquer eventos do utilizador resultantes de uma pesquisa. Isto é necessário para identificar se uma pesquisa é apresentada pela API. Apenas os eventos de utilizador com um token de atribuição gerado pela Google são usados para calcular as métricas.
• Agente do utilizador. Inclua UserInfo.userAgent com eventos do utilizador para poder filtrar métricas de eventos do utilizador por tipo de dispositivo.

Registos de pesquisa

As apps de pesquisa usam registos de pesquisa como origens de dados para algumas métricas.

Os registos de pesquisa baseiam-se em pedidos de pesquisa. Para permitir que as aplicações de IA identifiquem as sessões dos utilizadores, de modo a poderem fornecer estatísticas por sessão e resultados de pesquisa de maior qualidade, a Google recomenda vivamente que defina o campo opcional userPseudoId.

Se ainda não existirem registos de pesquisa ou eventos do utilizador, são apresentados valores predefinidos para todas as métricas.

Veja as estatísticas das recomendações de multimédia

Nota: as estatísticas das recomendações de multimédia estão em pré-visualização pública.

Siga as instruções abaixo para ver as estatísticas das recomendações de multimédia.

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

   Aplicações de IA

2. Clique no nome da app para a qual quer ver as estatísticas.

3. Clique em Analytics.

4. Para filtrar as suas métricas, especifique qualquer um dos seguintes filtros e, de seguida, clique no botão Atualizar para os aplicar:

   • Intervalo de datas. Selecione um intervalo de datas predefinido ou, se disponível, introduza um intervalo de datas personalizado.
   • Tipo de dispositivo. Selecione um tipo de dispositivo no qual as consultas ocorreram.

Veja as estatísticas de pesquisa

Notas:

• Para armazenamentos de dados em várias regiões dos EUA e da UE, a visualização das estatísticas de pesquisa está em pré-visualização pública.
• Uma vez que as aplicações de IA para a pesquisa de cuidados de saúde apenas fornecem serviços de pesquisa na multirregião dos EUA (`us`), as estatísticas da pesquisa de cuidados de saúde estão em pré-visualização pública.
• As estatísticas de pesquisa estão disponíveis no GA para arquivos de dados globais.
• Por predefinição, as métricas do widget não são apresentadas na página Analytics. Para ver as métricas dos widgets, contacte a equipa da sua Conta Google e peça para ser adicionado à lista de autorizações.

Siga as instruções abaixo para ver as estatísticas das apps de pesquisa.

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

   Aplicações de IA

2. Clique no nome da app para a qual quer ver as estatísticas.

3. Clique em Analytics.

4. Clique num separador para ver esse grupo de métricas:

   • Por pesquisa. As métricas são agrupadas por pesquisas. Para a pesquisa de cuidados de saúde, este é o único grupo de métricas disponível.
   • Por sessão. As métricas são agrupadas por sessões de pesquisa.
   • Comparar. As métricas de base são apresentadas juntamente com as métricas de um período de comparação. Selecione intervalos de datas para as métricas de base (um intervalo de datas anterior) e as métricas de comparação (um intervalo de datas posterior). Estes intervalos de tempo não se podem sobrepor.

5. Para filtrar as métricas, especifique os filtros e, de seguida, clique no botão Atualizar para os aplicar.

   Para apps de multimédia e apps de pesquisa personalizadas, estão disponíveis os seguintes filtros:

   • Intervalo de datas. Selecione um intervalo de datas predefinido ou, se disponível, introduza um intervalo de datas personalizado.
   • Consulta de pesquisa. Selecione uma condição e um valor de consulta de pesquisa. Pode adicionar vários filtros de consulta de pesquisa. Disponível para as métricas Por pesquisa e Comparar.
   • Tipo de dispositivo. Selecione um tipo de dispositivo no qual as consultas ocorreram.

   Para apps de pesquisa de cuidados de saúde, estão disponíveis os seguintes filtros:

   • Intervalo de datas. Selecione um intervalo de datas predefinido ou, se disponível, introduza um intervalo de datas personalizado. Quando seleciona uma data específica para o intervalo de datas personalizado, essa data é a data em que a pesquisa ocorreu no fuso horário UTC -08:00.
   • Consulta de pesquisa. Selecione uma condição e um valor de consulta de pesquisa. Pode adicionar vários filtros de consulta de pesquisa.
   • Localização do utilizador. Selecione a localização do hospital, da clínica ou do prestador de serviços de saúde que foi definida no pedido de pesquisa. Este filtro só está disponível se tiver sido definido no pedido de pesquisa.
   • Função de utilizador. Selecione a categoria profissional do utilizador que enviou o pedido de pesquisa. Este filtro só está disponível se tiver sido definido no pedido de pesquisa.
   • Definição do utilizador. Selecione a definição de cuidados de saúde definida no pedido de pesquisa, como tratamento hospitalar, ambulatório ou híbrido. Este filtro só está disponível se tiver sido definido no pedido de pesquisa.

Definições das métricas

As tabelas seguintes descrevem como as métricas são definidas.

Métricas de recomendações de multimédia

Nome da métrica	Definição das métricas	Notas
Contagem de recomendações	Número total de recomendações
Contagem de reproduções de recomendações	Número de vezes que os itens multimédia recomendados foram reproduzidos
Contagem de cliques de recomendações	Número de vezes que os itens multimédia recomendados foram clicados
Taxa de cliques	Número de cliques em recomendações / número de recomendações	Os cliques em recomendações são eventos view_item que podem ser atribuídos a uma recomendação
Contagem de multimédia de recomendações concluídas	Número de vezes que os itens de multimédia recomendados foram reproduzidos até ao fim
Taxa de conclusão por recomendação	Número de vezes que os itens de multimédia recomendados foram reproduzidos / número de recomendações
Taxa de conclusão por visualização	Número de vezes que os itens multimédia recomendados foram reproduzidos até ao fim / número de vezes que os itens multimédia foram reproduzidos
Tempo de visualização médio por reprodução	Tempo em segundos que os itens multimédia recomendados foram reproduzidos / número de vezes que os itens multimédia recomendados foram reproduzidos
Taxa de conclusão por recomendação	Número de vezes que os itens multimédia foram reproduzidos até ao fim / contagem de recomendações
Tempo de visualização médio por recomendação	Tempo em segundos que os itens multimédia recomendados foram vistos / número de recomendações

Métricas de multimédia e de pesquisa personalizada

Nome da métrica	Definição das métricas	Notes
Contagem de pesquisas	Contagem de eventos de pesquisa	Com base nos registos de pesquisa.
Taxa de nenhum resultado	Contagem de eventos de pesquisa sem resultados / Contagem de pesquisas	Com base nos registos de pesquisa.
Taxa de cliques (CTR) por pesquisa	Contagem de cliques de pesquisa /Contagem de pesquisas	Os cliques em pesquisas são eventos de visualização de artigos que podem ser atribuídos a um evento de pesquisa anterior. Com base em eventos do utilizador.
Número de gostos e não gostos no feedback	Número de gostos e não gostos	Um registo das respostas de feedback Gosto/Não gosto enviadas pelos utilizadores da app.
Análise detalhada dos motivos de feedback negativo	Percentagem dos motivos de não gosto	Quando um utilizador não gosta de uma resposta gerada, pode selecionar vários motivos para explicar o seu desagrado. A percentagem mostra a frequência com que cada motivo foi selecionado.
Quantidade de sessões de pesquisa	Contagem de sessões de pesquisa	Uma sessão de pesquisa é uma sessão do utilizador que contém, pelo menos, um evento de pesquisa. Uma sessão de utilizador, também denominada visita, é um conjunto contínuo de eventos do utilizador. Quando existem 30 minutos de inatividade, a sessão termina. Com base nos registos de pesquisa.
Visualização de página por visita de pesquisa	Contagem de eventos view_item em sessões de pesquisa / contagem de sessões de pesquisa	Esta métrica inclui todas as visualizações de páginas em visitas de pesquisa, independentemente de poderem ser atribuídas ao Vertex AI Search. Com base em eventos do utilizador.
Taxa de rejeição	Contagem de rejeições em sessões de pesquisa / Contagem de sessões de pesquisa	Um rejeição de sessão de pesquisa é definido como uma sessão com uma única pesquisa, em que o utilizador saiu depois de fazer apenas uma pesquisa. Com base em eventos do utilizador.

Métricas de pesquisa de cuidados de saúde

As seguintes métricas de pesquisa estão disponíveis para apps de pesquisa de cuidados de saúde.

Nome da métrica	Definição das métricas	Notes
Contagem de pesquisas	Número de eventos de pesquisa
Nenhum número de resultados	Número de eventos de pesquisa sem resultados
Taxa de nenhum resultado por pesquisa	Número de eventos de pesquisa sem resultados por pesquisa
Número de pacientes	Contagem de IDs de pacientes para os quais foram feitas pesquisas	Esta ação é desduplicada por utilizador de pesquisa, mas não por paciente. Por exemplo, se o utilizador 1 pesquisar os pacientes A e B, e o utilizador 2 pesquisar apenas o paciente B, a contagem é três.
Contagem de sessões de pesquisa de clientes	Número de sessões definidas pelo utilizador de pesquisa	Pode enviar um ID da sessão na sua pesquisa. Para mais informações, consulte session.
Número de visitantes da pesquisa	Número de utilizadores que enviaram um pedido de pesquisa	Os utilizadores são contabilizados com base no campo userInfo.
Quantidade de sessões de pesquisa sintéticas	Número de sessões de pesquisa definidas pela Google	Uma sessão de pesquisa é uma sessão do utilizador que contém, pelo menos, um evento de pesquisa. Uma sessão de utilizador, também denominada visita, é um conjunto contínuo de eventos do utilizador. Quando existem 30 minutos de inatividade, a sessão termina.

Desative as estatísticas

Não pode desativar as estatísticas de uma app existente, mas quando cria uma app, pode optar por criá-la com as estatísticas desativadas.

Para criar uma app de pesquisa que não recolhe dados de estatísticas:

1. Siga as instruções REST em Crie uma app de pesquisa e adicione o seguinte ao comando curl:

      "disableAnalytics": true
   

   Exemplo de comando

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app" \
   -d '{
     "displayName": "App without analytics",
     "dataStoreIds": ["my-data-store"],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "searchEngineConfig": {
        "searchTier": "SEARCH_TIER_ENTERPRISE",
        "searchAddOns": ["SEARCH_ADD_ON_LLM"]
      },
     "disableAnalytics": true
   }'
   
       

   Este comando cria uma app que não recolhe dados de estatísticas de pesquisa.