Ver análise

Esta página descreve como ver as análises das suas recomendações e apps de pesquisa.

As análises fornecem insights sobre as tendências de uso, a qualidade das pesquisas e das recomendações e o engajamento do usuário final com seu app. O console de aplicativos de IA oferece uma experiência de painel interativo com tecnologia Looker.

• Para apps de recomendação de mídia: acesso antecipado. É possível conferir métricas por recomendação com base em eventos do usuário. É possível filtrar as métricas por período e tipo de dispositivo.
• Para apps de pesquisa personalizada e de mídia: você pode conferir métricas por pesquisa e por sessão de pesquisa com base em registros de pesquisa e eventos do usuário. É possível filtrar métricas por período, consulta e tipo de dispositivo.
• Para apps de pesquisa de saúde: Acesso antecipado. É possível conferir métricas por pesquisa com base nos registros de pesquisa.

As métricas são atualizadas a cada seis horas. Portanto, pode levar várias horas até que você possa usar a página Analytics depois de criar o app.

Fontes de dados para análise

Esta seção descreve as fontes de dados para análises, dependendo do tipo de app.

É necessário concluir a integração de eventos do usuário para acessar a análise deles.

Os eventos de usuário que você envia por upload afetam as análises geradas.

Os apps de recomendações de mídia exigem os seguintes eventos do usuário para mostrar algumas métricas:

• Eventos de item de visualização. Obrigatório para a taxa de cliques.
• Eventos de conclusão de mídia. Obrigatório para a taxa de conclusão por reprodução e por recomendação.
• Eventos de reprodução de mídia. Necessário para contagem de reproduções de mídia de recomendação, taxa de reprodução, taxa de conclusão por reprodução e tempo médio de exibição por reprodução.

Os apps de pesquisa exigem os seguintes eventos do usuário para mostrar algumas métricas:

• Pesquisar eventos. Obrigatório para a taxa de cliques.
• Eventos de item de visualização. Obrigatório para a taxa de cliques.

As seguintes informações também são usadas para algumas análises:

• Impressões. Você pode fornecer impressões (visualizações ou cliques de itens) atribuíveis à Pesquisa da Vertex AI incluindo o item associado em UserEvent.Documents ao ingerir eventos do usuário. Essas informações são necessárias para a atribuição e para calcular métricas por pesquisa.
• Tokens de atribuição. Os tokens de atribuição são IDs exclusivos gerados pela Vertex AI para Pesquisa e retornados com cada solicitação de pesquisa. Inclua esse token de atribuição como UserEvent.attributionToken com todos os eventos do usuário resultantes de uma pesquisa. Isso é necessário para identificar se uma pesquisa é veiculada pela API. Somente eventos do usuário com um token de atribuição gerado pelo Google são usados para calcular métricas.
• User agent. Inclua UserInfo.userAgent com eventos do usuário para filtrar as métricas de eventos do usuário por tipo de dispositivo.

Registros de pesquisa

Os apps de pesquisa usam registros de pesquisa como fontes de dados para algumas métricas.

Os registros de pesquisa são baseados em solicitações de pesquisa. Para permitir que os aplicativos de IA identifiquem sessões de usuários e ofereçam análises por sessão e resultados da pesquisa de maior qualidade, o Google recomenda definir o campo opcional SearchRequest.UserPseudoId.

Se ainda não houver registros de pesquisa ou eventos do usuário, os valores padrão serão mostrados para todas as métricas.

Ver análises de recomendações de mídia

Use as instruções a seguir para conferir as análises das recomendações de mídia.

1. No console Google Cloud , acesse a página Aplicativos de IA.

   Aplicativos de IA

2. Clique no nome do app que você quer analisar.

3. Clique em Google Analytics.

4. Para filtrar suas métricas, especifique qualquer um dos filtros a seguir e clique no botão Atualizar para aplicá-los:

   • Período. Selecione um período predefinido ou, se disponível, insira um período personalizado.
   • Tipo de dispositivo. Selecione um tipo de dispositivo em que as consultas foram feitas.

Ver análises de pesquisa

Use as instruções a seguir para conferir as análises dos apps de pesquisa.

1. No console Google Cloud , acesse a página Aplicativos de IA.

   Aplicativos de IA

2. Clique no nome do app que você quer analisar.

3. Clique em Google Analytics.

4. Clique em uma guia para ver esse grupo de métricas:

   • Por pesquisa. As métricas são agrupadas por pesquisas. Para pesquisas de saúde, esse é 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 comparativo de mercado são mostradas ao lado das métricas de um período de comparação. Selecione os períodos das métricas de valor de referência (um período anterior) e de comparação (um período posterior). Esses períodos não podem se sobrepor.

5. Para filtrar suas métricas, especifique os filtros e clique no botão Atualizar para aplicá-los.

   Para apps de mídia e de pesquisa personalizada, os seguintes filtros estão disponíveis:

   • Período. Selecione um período predefinido ou, se disponível, insira um período personalizado.
   • Consulta de pesquisa. Selecione uma condição e um valor de consulta de pesquisa. É possível adicionar vários filtros de consulta de pesquisa. Disponível para métricas de Por pesquisa e Comparar.
   • Tipo de dispositivo. Selecione um tipo de dispositivo em que as consultas foram feitas.

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

   • Período. Selecione um período predefinido ou, se disponível, insira um período personalizado. Quando você seleciona uma data específica para um período personalizado, essa data é o dia em que a pesquisa foi realizada no fuso horário UTC -08:00.
   • Consulta de pesquisa. Selecione uma condição e um valor de consulta de pesquisa. É possível adicionar vários filtros de consulta de pesquisa.
   • Localização do usuário. Selecione o local do hospital, da clínica ou do provedor de serviços de saúde definido na solicitação de pesquisa. Esse filtro só está disponível se foi definido na solicitação de pesquisa.
   • Função do usuário. Selecione a categoria de trabalho do usuário que enviou a solicitação de pesquisa. Esse filtro só está disponível se foi definido na solicitação de pesquisa.
   • Configuração do usuário. Selecione o ambiente de saúde definido na solicitação de pesquisa, como tratamento para pacientes internados, ambulatorial ou híbrido. Esse filtro só está disponível se foi definido na solicitação de pesquisa.

Definições de métricas

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

Métricas de recomendações de mídia

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

Métricas de mídia e pesquisa personalizada

Nome da métrica	Definição de métricas	Observações
Número de pesquisas	Contagem de eventos de pesquisa	Com base nos registros de pesquisa.
Taxa de ausência de resultado	Contagem de eventos de pesquisa sem resultados / Contagem de pesquisa	Com base nos registros de pesquisa.
Taxa de cliques (CTR) por pesquisa	Contagem de cliques da pesquisa / Contagem de pesquisa	Os cliques na pesquisa são eventos de visualização de item que podem ser atribuídos a um evento de pesquisa anterior. Com base em eventos do usuário.
Contagem de likes e deslikes de feedback	Contagem de marcações "Gostei" e "Não gostei"	Um registro das respostas de feedback de gostei/não gostei enviadas pelos usuários do app.
Detalhes dos motivos de uma resposta não ter sido útil	Porcentagem dos motivos de não gostar	Quando um usuário não gosta de uma resposta gerada, ele pode selecionar vários motivos para explicar a rejeição. A porcentagem mostra com que frequência cada motivo foi selecionado.
Contagem de sessões de pesquisa	Contagem de sessões de pesquisa	Uma sessão de pesquisa é uma sessão de usuário que contém pelo menos um evento de pesquisa. Uma sessão de usuário, também chamada de visita, é um conjunto contínuo de eventos do usuário. Quando há 30 minutos de inatividade, a sessão é encerrada. Com base em registros de pesquisa.
Visualização de página por acesso de pesquisa	Contagem de eventos de item de visualização em sessões de pesquisa / Contagem de sessões de pesquisa	Essa métrica inclui todas as visualizações de página em visitas de pesquisa, independente de poderem ser atribuídas à Pesquisa da Vertex AI. Com base em eventos do usuário.
Taxa de rejeição	Contagem de rejeições em sessões de pesquisa / Contagem de sessões de pesquisa	Uma rejeição de sessão de pesquisa é definida como uma sessão com uma única pesquisa, em que o usuário saiu depois de fazer apenas uma pesquisa. Com base em eventos do usuário.

Métricas de pesquisa de saúde

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

Nome da métrica	Definição de métricas	Observações
Número de pesquisas	Número de eventos de pesquisa
Nenhum resultado	Número de eventos de pesquisa sem resultados
Taxa de nenhum resultado por pesquisa	Número de eventos de pesquisa sem resultados por pesquisa
Contagem de pacientes	Contagem de IDs de pacientes para os quais as pesquisas foram realizadas	Isso é feito por usuário de pesquisa, mas não por paciente. Por exemplo, se o usuário 1 pesquisar os pacientes A e B, e o usuário 2 pesquisar apenas o paciente B, a contagem será três.
Contagem de sessões de pesquisa de clientes	Número de sessões de pesquisa definidas pelo usuário	Você pode enviar um ID de sessão na sua pesquisa. Para mais informações, consulte estes tópicos session.
Contagem de visitantes da pesquisa	Número de usuários que enviaram uma solicitação de pesquisa	Os usuários são contados com base no campo userInfo.
Contagem de sessões de pesquisa sintética	Número de sessões de pesquisa definidas pelo Google	Uma sessão de pesquisa é uma sessão de usuário que contém pelo menos um evento de pesquisa. Uma sessão de usuário, também chamada de visita, é um conjunto contínuo de eventos do usuário. Quando há 30 minutos de inatividade, a sessão é encerrada.

Desativar a análise

Não é possível desativar a análise de um app já criado, mas, ao criar um app, você pode escolher criá-lo com a análise desativada.

Para criar um app de pesquisa que não colete dados de análise:

1. Siga as instruções REST em Criar um app de pesquisa, adicionando 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
   }'
   
       

   Esse comando cria um app que não coleta dados de análise de pesquisa.