Observação:a Vertex AI para Pesquisa está sendo renomeada como Pesquisa de agente. Estamos atualizando o conteúdo para refletir o novo branding.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Ver análise

Esta página descreve como visualizar as análises dos seus apps de recomendação e pesquisa.

As análises oferecem insights sobre as tendências de uso, a qualidade da pesquisa e da recomendação e o engajamento do usuário final com seu app. O console da Pesquisa de agentes oferece uma experiência de painel interativa com tecnologia Looker.

Para apps de recomendação de mídia: pré-lançamento público. É possível conferir métricas por recomendação com base em eventos do usuário. Você pode filtrar as métricas por período e tipo de dispositivo.
Para apps de pesquisa personalizada e de mídia: é possível conferir métricas por pesquisa e por sessão de pesquisa com base em registros de pesquisa e eventos do usuário. Você pode filtrar as métricas por período, consulta e tipo de dispositivo.
Para apps de pesquisa de serviços de saúde: pré-lançamento público. É possível conferir métricas por pesquisa com base em 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 Análise depois de criar o app.

Fontes de dados para análise

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

É necessário concluir a integração de eventos do usuário para poder conferir as análises de eventos do usuário.

Os eventos do usuário que você faz upload afetam as análises geradas.

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

Eventos de item de visualização. Necessário para a taxa de cliques.
Eventos de mídia concluída. Necessário para a taxa de conclusão por reprodução e a taxa de conclusão por recomendação.
Eventos de reprodução de mídia. Necessário para a contagem de reprodução de mídia de recomendação, a taxa de reprodução, a taxa de conclusão por reprodução e o 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:

Eventos de pesquisa. Necessário para a taxa de cliques.
Eventos de item de visualização. Necessário para a taxa de cliques.

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

Impressões. É possível fornecer impressões (visualizações ou cliques de itens) que podem ser atribuídas à Pesquisa de agentes, 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 Pesquisa de agentes 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 que você possa 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 a Pesquisa de agentes identifique as sessões do usuário para que ela possa fornecer análises por sessão e resultados de pesquisa de maior qualidade, o Google recomenda que você defina o campo opcional field 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.

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

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

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

Aplicativos de IA
Clique no nome do app para o qual você quer conferir as análises.
Clique em Análise.
Para filtrar suas métricas, especifique um dos seguintes filtros 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 ocorreram.

Conferir análises de pesquisa

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

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

Aplicativos de IA
Clique no nome do app para o qual você quer conferir as análises.
Clique em Análise.
Clique em uma guia para conferir esse grupo de métricas:
- Por pesquisa. As métricas são agrupadas por pesquisas. Para a pesquisa de serviços 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 referência são mostradas junto com as métricas de um período de comparação. Selecione períodos para as métricas de referência (um período anterior) e as métricas de comparação (um período posterior). Esses períodos não podem se sobrepor.
Para filtrar suas métricas, especifique os filtros e clique no botão Atualizar para aplicá-los.

Para apps de mídia e apps 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 Por pesquisa e Comparar.
- Tipo de dispositivo. Selecione um tipo de dispositivo em que as consultas ocorreram.
Para apps de pesquisa de serviços 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 o período 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. É possível adicionar vários filtros de consulta de pesquisa.
- Localização do usuário. Selecione a localização do hospital, da clínica ou do provedor de serviços de saúde que foi definido na solicitação de pesquisa. Esse filtro só está disponível se tiver sido 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 tiver sido definido na solicitação de pesquisa.
- Configuração do usuário. Selecione a configuração de saúde definida na solicitação de pesquisa, como tratamento de internação, ambulatorial ou híbrido. Esse filtro só está disponível se tiver sido 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 de recomendações	Número de vezes que os itens de mídia recomendados foram clicados
Taxa de cliques	Contagem de cliques de recomendações / contagem de recomendações	Os cliques de recomendações são eventos de item de visualização que podem ser atribuídos a uma recomendação
Contagem de mídia completa de recomendações	Número de vezes que os itens de mídia recomendados foram reproduzidos até a conclusão
Taxa de reproduçã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
Contagem de pesquisas	Contagem de eventos de pesquisa	Com base em registros de pesquisa.
Sem taxa de resultado	Contagem de eventos de pesquisa sem resultados / contagem de pesquisas	Com base em registros de pesquisa.
Taxa de cliques (CTR) por pesquisa	Contagem de cliques da pesquisa / contagem de pesquisas	Os cliques da 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 marcações "Gostei" e "Não gostei" de feedback	Contagem de marcações "Gostei" e "Não gostei"	Um registro das respostas de feedback "Gostei" e "Não gostei" enviadas pelos usuários do app.
Detalhes dos motivos de "Não gostei" do feedback	Porcentagem dos motivos de "Não gostei"	Quando um usuário não gosta de uma resposta gerada, ele pode selecionar vários motivos para explicar o motivo. A porcentagem mostra a frequência com que cada motivo foi selecionado.
Contagem de sessões de pesquisa	Contagem de sessões de pesquisa	Uma sessão de pesquisa é uma sessão do usuário que contém pelo menos um evento de pesquisa. Uma sessão do 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 termina. Com base em registros de pesquisa.
Visualização de página por visita 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, independentemente de poderem ser atribuídas à Pesquisa de agentes. 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 serviços de saúde

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

Nome da métrica	Definição de métricas	Observações
Contagem de pesquisas	Número de eventos de pesquisa
Contagem de resultados	Número de eventos de pesquisa sem resultados
Taxa de resultados 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 é deduplicado 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 definidas pelo usuário de pesquisa	É possível enviar um ID de sessão na pesquisa. Para mais informações, consulte `session`.
Contagem de visitantes de pesquisa	Número de usuários que enviaram uma solicitação de pesquisa	Os usuários são contados com base no `userInfo` campo.
Contagem de sessões de pesquisa sintéticas	Número de sessões de pesquisa definidas pelo Google	Uma sessão de pesquisa é uma sessão do usuário que contém pelo menos um evento de pesquisa. Uma sessão do 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 termina.

Desativar a análise

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

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

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.