Ver análise

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

O Analytics oferece insights sobre tendências de uso, pesquisas e recomendações e engajamento do usuário final com seu app. O console da Vertex AI Agent Builder fornece uma experiência de painel interativo com a tecnologia do 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 métricas por período e tipo de dispositivo.
  • Para apps de pesquisa genérica e de mídia: é possível ver métricas por pesquisa. e por sessão de pesquisa, com base em registros de pesquisa e eventos do usuário. Você pode filtrar 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 de usuário para mostrar algumas métricas:

  • Eventos de visualização de item. Obrigatório para taxa de cliques.
  • Eventos de preenchimento de mídia: Obrigatório para a taxa de conclusão por reprodução e 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:

  • Pesquisar eventos. Obrigatório para 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. Você pode fornecer impressões (cliques ou visualizações do item) que estão que podem ser atribuídos à Vertex AI para Pesquisa, 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 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 uma atribuição gerada 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 Vertex AI Agent Builder identificar sessões de usuários para que possa fornecer análises por sessão e mais resultados de pesquisa de alta qualidade, o Google recomenda que você defina os parâmetros campo SearchRequest.UserPseudoId.

Se ainda não houver logs 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

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 aplicativo com os dados de análise que você quer conferir.

  3. Clique em Google Analytics.

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

    • 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 análises de mídia ou pesquisa genérica e apps de pesquisa.

  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 esse 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 um dos filtros a seguir e clique em o botão Atualizar para aplicá-las:

    • 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. Você 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 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
Número de vezes que as recomendações foram tocadas Número de vezes que os itens de mídia recomendados foram reproduzidos
Contagem de cliques na recomendação Número de cliques em itens de mídia recomendados
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 itens de mídia recomendados foram reproduzidos / contagem das 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

Pesquisar métricas

Nome da métrica Definição de métricas Observações
Contagem de pesquisas Contagem de eventos de pesquisa Com base em logs de pesquisa
Nenhuma taxa de resultados Número de eventos de pesquisa sem resultados / Contagem de pesquisas Com base em logs de pesquisa
Taxa de cliques (CTR) por pesquisa Contagem de cliques da pesquisa / Contagem de pesquisas 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. Um sessão do usuário, além chamada de visita, conjunto contínuo de usuários eventos. Quando há 30 minutos de inatividade, a sessão é encerrada. Com base nos registros de pesquisa
Exibição de página por pesquisa acesse 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 nos eventos do usuário
Taxa de rejeição Contagem de rejeições no sessões de pesquisa / Pesquisar contagem de sessões 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