Ver análise

Esta página descreve como visualizar análises para seus apps de pesquisa e recomendações de mídia.

Os dados de análise 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 do Vertex AI Agent Builder oferece uma experiência de painel interativo com tecnologia Looker.

• Para apps de recomendação de mídia: Acesso antecipado. Você pode conferir as métricas por recomendação com base nos eventos do usuário. É possível filtrar as métricas por período e tipo de dispositivo.
• Para apps de pesquisa genérica e de pesquisa 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. É possível filtrar as métricas por período, consulta e tipo de dispositivo.

As métricas são atualizadas a cada seis horas. Por isso, 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 acessar a Análise de eventos do usuário.

Os eventos de usuário que você envia afetam os dados gerados.

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

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

• Eventos de pesquisa. Obrigatório para a taxa de cliques.
• Eventos de visualização de item. Obrigató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 são atribuíveis à pesquisa da Vertex AI incluindo o item associado em UserEvent.Documents ao processar eventos do usuário. Essas informações são necessárias para 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 para Pesquisa e retornados a 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 as 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 o Vertex AI Agent Builder identifique sessões de usuários e forneça análises por sessão e resultados de pesquisa de qualidade superior, o Google recomenda que você defina 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.

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

Observação: a Análise de recomendações de mídia está em pré-lançamento público.

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

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

2. Clique no nome do app para ver as informações.

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 ocorreram.

Conferir análises de pesquisa

Observações:

• Para repositórios de dados em multirregiões dos EUA e da UE, a visualização de análises de pesquisa está em pré-lançamento público.
• As análises de pesquisa são o GA para repositórios de dados globais.
• As métricas do widget não aparecem na página do Google Analytics.

Use as instruções a seguir para conferir as análises de apps de pesquisa genérica ou de pesquisa de mídia.

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

2. Clique no nome do app para ver as informações.

3. Clique em Google Analytics.

4. Clique em uma guia para acessar o grupo de métricas:

   • Por pesquisa. As métricas são agrupadas por pesquisas.
   • Por sessão. As métricas são agrupadas por sessões de pesquisa.
   • Compare. As métricas de referência são mostradas com as métricas de um período de comparação. Selecione os períodos das métricas de referência (um período anterior) e das métricas de comparação (um período posterior). Esses intervalos de tempo não podem se sobrepor.

5. 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.
   • 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 as métricas Por pesquisa e Comparar.
   • Tipo de dispositivo. Selecione um tipo de dispositivo em que as consultas ocorreram.

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ção de recomendação	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ídias de recomendação concluídas	Número de vezes que os itens de mídia recomendados foram reproduzidos até o fim
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é o fim / 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 pesquisa

Nome da métrica	Definição de métricas	Observações
Contagem de pesquisas	Contagem de eventos de pesquisa	Com base nos registros de pesquisa
Sem taxa 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 de pesquisa são eventos de visualização de itens que podem ser atribuídos a um evento de pesquisa anterior. Com base em eventos do usuário
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 nos 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 se elas podem 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 sessão de pesquisa desistência é definida como uma sessão com uma única pesquisa, em que o usuário saiu após fazer apenas uma pesquisa. Com base em eventos do usuário

Desativar a análise

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

Para criar um app de pesquisa que não vai coletar 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.