Ver e exportar dados de análise

A análise de dados oferece insights sobre as tendências de uso, a qualidade da pesquisa e o engajamento do usuário final com seu app. O console oferece uma experiência de painel interativa com tecnologia do Looker. Nesta página, descrevemos como ver as análises dos seus apps.

Antes de começar

Confira se o app está conectado a um repositório de dados. As métricas do app só ficam disponíveis a partir do momento em que um repositório de dados é vinculado a um app.

Se você não tiver um repositório de dados, será necessário conectar uma fonte de dados do Google ou uma fonte de dados de terceiros ao seu app.

Eventos do usuário para análise

Nesta seção, descrevemos os eventos de usuário que o Gemini Enterprise usa para gerar as métricas relacionadas à pesquisa, como contagem de pesquisas e taxa de cliques. Não é preciso fazer outras configurações se você estiver usando a interface do usuário para pesquisar e receber respostas pelo assistente do Gemini Enterprise. No entanto, se você usar as APIs do Gemini Enterprise nos seus próprios apps, será necessário configurar a pesquisa no app para capturar os eventos do usuário e, em seguida, importar os eventos do usuário para o app.

Os apps do Gemini Enterprise exigem os seguintes eventos do usuário para receber as 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. É possível fornecer impressões (visualizações ou cliques de itens) atribuíveis ao Google incluindo o item associado em UserEvent.Documents ao ingerir eventos do usuário. Essas informações são necessárias para atribuição e para calcular métricas por pesquisa.
  • Tokens de atribuição. Os tokens de atribuição são IDs exclusivos gerados pelo Google e retornados com cada solicitação de pesquisa. Inclua esse token de atribuição como UserEvent.attributionToken em todos os eventos de usuário resultantes de uma pesquisa. Isso é necessário para identificar se uma pesquisa é veiculada pela API. Somente os eventos do usuário com um token de atribuição gerado pelo Google são usados para calcular as métricas.
  • Registros de pesquisa. Os registros de pesquisa são baseados em solicitações de pesquisa. Para permitir que o Google identifique as sessões do usuário e forneça análise de dados por sessão e resultados da pesquisa de maior qualidade, recomendamos que você defina o campo opcional SearchRequest.UserPseudoId.

Se 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 do Gemini Enterprise

É possível ver as análises de pesquisa do seu app. Você verá as métricas relacionadas às chamadas de pesquisa feitas para o app. Se o app estiver conectado a vários repositórios de dados, recomendamos fazer chamadas de pesquisa para o app especificando o recurso engine para que você possa receber resultados de todos os repositórios de dados conectados.

Siga as instruções abaixo para ver as análises do seu app.

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. Clique no nome do app com as análises que você quer ver.

  3. Clique em Google Analytics.

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

    • Adoção: métricas sobre o status de adoção do usuário.

    • Uso e qualidade: métricas sobre feedback do usuário e uso do app.

    • Agente: métricas para agentes no app da Web Gemini Enterprise, incluindo agentes criados pelo Google, Gemini Notebook Enterprise e agentes que sua organização criou e registrou no Gemini Enterprise.

    • Valor: métricas sobre a economia de custos alcançada pelos usuários que consultam dados com o app.

    • Nível do usuário: as métricas incluem os IDs de usuário (endereço de e-mail ou identificador exclusivo) dos usuários na organização e as interações deles com agentes criados pelo Google e pela organização e registrados no Gemini Enterprise.

    Confira os dados de análise para adoção.
    Ver os dados de análise para adoção

  5. Para filtrar as métricas, especifique os filtros disponíveis para a guia de métricas e clique no botão Atualizar para aplicá-los.

Definições de métricas

A tabela a seguir descreve como as métricas são definidas.

Grupo de métricas Nome da métrica Definição da métrica Observações
Adoção Total de usuários Número de usuários ativos únicos do Gemini Enterprise no período selecionado. Um usuário é considerado ativo se fizer login e acionar chamadas de API, como ao acessar a página inicial. Como a contagem é única, um usuário que chama os métodos da API Assistant, Answer e Search é contado apenas uma vez no total.
Assistente de ligação para usuários Número de usuários que chamaram os métodos AssistantService ou usaram o Google Assistente para gerar respostas.
Resposta de usuários que ligam Número de usuários que chamaram os métodos ConversationalSearchService e GenerativeSearchAnswerService para gerar respostas.
Pesquisa de usuários que estão ligando Número de usuários que chamaram os métodos SearchService para receber resultados da pesquisa.
Usuários que chamam outros métodos de API Número de usuários que chamaram métodos de API diferentes de streamAssist, streamAnswer e engines.servingConfigs.search. Por exemplo, usuários que chamam os métodos da API de autenticação.
Usuários ativos por dia Contagem de usuários ativos por dia Um usuário é considerado ativo se fizer login e acionar qualquer chamada de API, como ao acessar a página inicial.
Usuários ativos semanalmente Contagem de usuários ativos por semana. A semana começa na segunda-feira e termina no domingo.
Usuários ativos por mês Contagem de usuários ativos por mês
Taxa de retenção de 7 dias Contagem de usuários recorrentes no período atual de sete dias / contagem de usuários ativos no período anterior de sete dias Um usuário é considerado recorrente se estiver ativo durante o período atual de sete dias e o período anterior de sete dias.
Taxa de crescimento em 7 dias A diferença percentual entre o número de usuários ativos no período atual de sete dias e no período anterior de sete dias.
Taxa de desistência em 7 dias Contagem de usuários desistentes no período atual de sete dias / contagem de usuários ativos no período anterior de sete dias Um usuário é considerado desistência de usuários se estava ativo no período de sete dias anterior, mas não está ativo no período de sete dias atual.
Taxa de retenção de 28 dias Contagem de usuários recorrentes no período atual de 28 dias / contagem de usuários ativos no período anterior de 28 dias
Taxa de crescimento em 28 dias É a diferença percentual entre o número de usuários ativos no período atual de 28 dias e no período anterior de 28 dias
Taxa de desistência de usuários em 28 dias Contagem de usuários que cancelaram o serviço no período atual de 28 dias / contagem de usuários ativos no período anterior de 28 dias
Licenças compradas O número de licenças (assentos) que a organização comprou Inclui todas as licenças compradas desde o registro no Gemini Enterprise.
Licenças reivindicadas O número de licenças de usuário atribuídas e aceitas por pessoas na sua organização Inclui todas as licenças reivindicadas desde o registro no Gemini Enterprise.
Uso e qualidade Número de pesquisas Número total de consultas de pesquisa feitas pelos usuários no Gemini Enterprise.
Número de respostas Número total de vezes que o Gemini Enterprise gerou uma resposta para a consulta de um usuário. As respostas geradas por um agente não são incluídas nessa contagem.
Contagem de ações Total de interações, como upload de arquivos, criação de pastas ou uso de ações de conector no Gemini Enterprise. Inclui ações como criar um modelo de e-mail.
Taxa de cliques (CTR) por pesquisa Número total de cliques da pesquisa / contagem de pesquisa Os cliques da pesquisa incluem cliques em resultados da pesquisa e referências internas.
Visualização de página por categoria Número total de visualizações de cada página de categoria
Contagem de marcações "Gostei" e "Não gostei" do feedback Contagem de marcações "Gostei" e "Não gostei" enviadas pelos usuários Um registro das respostas de feedback "Gostei"/"Não gostei" enviadas pelos usuários do app.
Detalhamento dos motivos de feedback negativo 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.
Taxa de pesquisa bem-sucedida Contagem de pesquisas bem-sucedidas / contagem de pesquisas
Taxa de respostas bem-sucedidas Contagem de respostas bem-sucedidas / contagem de respostas
Agentes Usuários ativos por mês do agente Número total de usuários ativos que usaram o agente por mês. Um usuário é considerado ativo para um agente sempre que faz uma chamada do Assistente para esse agente no modo de agente, pesquisa ou criação de ideias. Isso inclui a atividade do criador do agente durante prévias ou testes no Workflow Builder, porque essas ações geram chamadas regulares do Google Assistente com o ID do agente, semelhante a qualquer interação do usuário final. Somente as interações com rascunhos não salvos que não têm um ID de agente atribuído são excluídas dessa contagem.
Sessões de chat mensais com agentes Número total de sessões de chat iniciadas pelos usuários que interagem com um agente específico por mês. Uma sessão de chat é definida como um usuário interagindo com um agente na mesma conversa em um único dia. Se o usuário continuar a conversa na mesma conversa em um dia subsequente, ela será considerada uma nova sessão. As sessões de pré-lançamento e teste iniciadas no Workflow Builder são contabilizadas porque passam pelo mesmo caminho da API Assistant que as sessões do usuário final e recebem um ID de sessão.
Agentes usados por mês Número total de agentes que tiveram pelo menos um usuário ativo por mês. Usa a mesma definição de usuário ativo que Usuários ativos por mês. Essa contagem pode, ocasionalmente, exceder o total mensal de sessões de chat em um determinado mês, quando muitos agentes recebem chamadas de curta duração do Assistente que não produzem um ID de sessão persistente (por exemplo, turnos cancelados ou interrompidos ou chamadas únicas que não abrem uma sessão de chat).
Total mensal de sessões de chat Número total de sessões de chat iniciadas pelos usuários que interagem com os agentes por mês. Uma sessão de chat é definida como um usuário interagindo com um agente na mesma conversa em um único dia. Se o usuário continuar a conversa na mesma conversa em um dia subsequente, ela será considerada uma nova sessão. As sessões de visualização e teste iniciadas no Workflow Builder são contadas porque seguem o mesmo caminho da API Assistant que as sessões do usuário final e recebem um ID de sessão.
Agentes mensais criados Número total de agentes criados no último mês.
Usuários ativos por dia do Gemini Notebook Enterprise Contagem de usuários ativos do Gemini Notebook Enterprise por dia. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, e não por mecanismo.
Notebooks diários do Gemini Notebook Enterprise criados Contagem de notebooks do Gemini Notebook Enterprise criados por dia. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, e não por mecanismo.
Notebooks diários do Gemini Notebook Enterprise criados por usuário Contagem de notebooks do Gemini Notebook Enterprise criados por usuário por dia. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, não por mecanismo.
Notebooks diários do Gemini Notebook Enterprise compartilhados Contagem de notebooks do Gemini Notebook Enterprise compartilhados por dia. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, não por mecanismo.
Resumos em Áudio diários do Gemini Notebook Enterprise criados Contagem de resumos em áudio do Gemini Notebook Enterprise criados por dia. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, e não por mecanismo.
Usuários ativos por mês do Gemini Notebook Enterprise Contagem de usuários ativos do Gemini Notebook Enterprise por mês. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, e não por mecanismo.
Notebooks mensais do Gemini Notebook Enterprise criados Contagem de notebooks do Gemini Notebook Enterprise criados por mês. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, e não por mecanismo.
Notebooks mensais do Gemini Notebook Enterprise criados por usuário Contagem média de notebooks do Gemini Notebook Enterprise criados por usuário por mês. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, não por mecanismo.
Notebooks mensais compartilhados do Gemini Notebook Enterprise Contagem de notebooks do Gemini Notebook Enterprise compartilhados por mês. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, e não por mecanismo.
Resumos em áudio mensais criados no Gemini Notebook Enterprise Contagem de Resumos em Áudio do Gemini Notebook Enterprise criados por mês. As métricas do Gemini Notebook Enterprise são calculadas em todo o projeto, não por mecanismo.
Valor
(pré-lançamento público)
Pesquisa concluída Contagem de pesquisas bem-sucedidas. O número de pesquisas bem-sucedidas é determinado pelo comportamento do usuário após uma pesquisa. Uma pesquisa é considerada bem-sucedida se uma das seguintes condições ocorrer:
  • Se um resultado da pesquisa recebe um clique antes que uma nova pesquisa seja iniciada.
  • Se o resultado da pesquisa incluir um resultado de pesquisa de pessoas e não for seguido por outra pesquisa em dois minutos. Isso ocorre porque os resultados da pesquisa de pessoas são exibidos na página de resultados da pesquisa e normalmente não exigem um clique.
Resposta correta Contagem de respostas corretas O sucesso de uma resposta é determinado pelo comportamento do usuário depois que ela é gerada. O sucesso é medido pelo feedback fornecido ou pela rapidez com que uma pergunta de acompanhamento foi feita.
  • Se o usuário marcar a resposta com "Gostei", a consulta será considerada bem-sucedida.
  • Se não houver feedback e o usuário não fizer outra consulta em até 30 segundos, a consulta será considerada bem-sucedida.
Horas de trabalho dos funcionários economizadas nas datas selecionadas (Número de pesquisas bem-sucedidas + número de respostas bem-sucedidas) x minutos economizados por resposta bem-sucedida
Valor salvo para as datas selecionadas Horas economizadas nas datas selecionadas ✕ Taxa média por hora do funcionário Para conferir essa métrica, na guia Valor, especifique uma taxa por hora para o campo Taxa por hora do funcionário.
Projeção anual de horas economizadas dos funcionários (Número de pesquisas bem-sucedidas + número de respostas bem-sucedidas) x minutos economizados por pesquisa bem-sucedida A contagem anual projetada de pesquisas bem-sucedidas é derivada da contagem de pesquisas bem-sucedidas no período escolhido. Cada consulta economiza cerca de três minutos, uma estimativa baseada em pesquisas internas do Google.
Valor anual estimado economizado Horas anuais projetadas de funcionários economizadas ✕ Taxa média por hora de funcionários Para conferir essa métrica, na guia Valor, especifique uma taxa por hora para o campo Taxa por hora do funcionário.
Nível de usuário
ID do usuário O endereço de e-mail de cada usuário na sua organização. Se o endereço de e-mail não estiver disponível, o identificador exclusivo original do usuário será exibido.
Total de mensagens O número total de mensagens que um usuário enviou para o app da Web do Gemini Enterprise. Inclui todas as mensagens enviadas pelo usuário e não se limita a conversas com agentes do Gemini Enterprise.
Mensagens para agentes criados pelo Google O número total de mensagens que um usuário enviou para agentes criados pelo Google no período selecionado.
Mensagens para nossos agentes O número total de mensagens que um usuário enviou para agentes criados pela organização e registrados no Gemini Enterprise no período selecionado.

Exportar métricas

Siga estas etapas para exportar as métricas para uma tabela do BigQuery no projetoGoogle Cloud :

  1. Verifique se você tem as permissões e os papéis necessários.

  2. Crie um conjunto de dados do BigQuery:

    1. Abra a página do BigQuery no console do Google Cloud .

      Acessar a página do BigQuery

    2. No painel Explorer, selecione o mesmo projeto em que seu app do Gemini Enterprise está para criar o conjunto de dados.

    3. Clique na opção e em Criar conjunto de dados.

    4. Na página Criar conjunto de dados, faça o seguinte:

      • Em ID do conjunto de dados, insira um nome exclusivo. Você precisa do nome do conjunto de dados para exportar as métricas pela API.

      • Para Tipo de local, a tabela a seguir mostra como mapear os locais do BigQuery para os locais do app Gemini Enterprise:

        Local multirregional do app Gemini Enterprise Local multirregional do BigQuery
        Global EUA (várias regiões nos Estados Unidos)
        EUA (várias regiões nos Estados Unidos) EUA (várias regiões nos Estados Unidos)
        EU (várias regiões na União Europeia) EU (várias regiões na União Europeia)

    5. Clique em Criar conjunto de dados.

  3. Crie uma tabela vazia do BigQuery para o conjunto de dados que você criou.

    1. No painel Explorer, expanda o projeto e selecione o conjunto de dados que você criou.
    2. Na seção Informações do conjunto de dados, clique em Criar tabela.
    3. No painel Criar tabela, especifique um nome para a tabela no campo Tabela. Você precisa do nome da tabela para exportar as métricas pela API.
    4. Clique em Criar tabela.

  4. Chame o método analytics:exportMetrics para extrair dados de métricas dos últimos 30 dias, incluindo o dia atual.

    REST

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
-d '{
   "analytics": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
   "outputConfig":
      {
         "bigqueryDestination":
         {
            "datasetId": "BIGQUERY_DATASET_ID",
            "tableId": "BIGQUERY_TABLE_ID"
         }
      }
   }' \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/analytics:exportMetrics"

    Substitua:

    • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
      • us para a multirregião dos EUA
      • eu para a multirregião da UE
      • global para o local global
      Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
    • LOCATION: a multirregião do seu repositório de dados: global, us ou eu
    • PROJECT_ID: o ID do seu projeto do Google Cloud .
    • APP_ID: o ID do app de que você quer exportar métricas.
    • BIGQUERY_DATASET_ID: o ID do conjunto de dados do BigQuery que você criou.
      O ID do conjunto de dados segue o formato <PROJECT_ID>.<DATASET_ID>. Você só precisa fornecer o <DATASET_ID>.
    • BIGQUERY_TABLE_ID: o ID da tabela do BigQuery que você criou.
      Na visualização Explorador clássico, o ID da tabela segue o formato <PROJECT_ID>.<DATASET_ID>.<TABLE_ID>. Você só precisa informar o <TABLE_ID>.

    A resposta inclui o nome e o ID da operação. Anote o ID da operação para usar na próxima etapa.
    Por exemplo:

    {
   "name": "projects/my-project-123/locations/global/collections/default_collection/engines/my-app/operations/OPERATION_ID",
   "metadata": {
      "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ExportMetricsMetadata"
   }
}

  5. Para ver o status da operação de exportação de métricas, chame o método engines.operations.get:

    REST

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/operations/OPERATION_ID"

    Substitua:

    • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
      • us para a multirregião dos EUA
      • eu para a multirregião da UE
      • global para o local global
      Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
    • LOCATION: a multirregião do seu repositório de dados: global, us ou eu
    • APP_ID: o ID do app de que você quer receber as operações de longa duração.
    • OPERATION_ID: o ID da operação de exportação de métricas retornado na resposta quando você executou o comando para exportar as métricas.