Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 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.
No console Google Cloud , acesse a página Aplicativos de IA.
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 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.
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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[[["\u003cp\u003eThis page details how to access and interpret analytics for recommendations and search apps within the Vertex AI Agent Builder console.\u003c/p\u003e\n"],["\u003cp\u003eAnalytics dashboards, powered by Looker, provide insights into app usage, search and recommendation quality, and user engagement, with data refreshed approximately every six hours.\u003c/p\u003e\n"],["\u003cp\u003eSpecific metrics and filtering options vary depending on whether the app is for media recommendations, generic search, or healthcare search, all of which support filtering by date range and device type.\u003c/p\u003e\n"],["\u003cp\u003eUser events, such as view-item, media-complete, and search events, are critical for generating certain metrics, and for search apps, search logs are used as a data source for some metrics.\u003c/p\u003e\n"],["\u003cp\u003eWhile analytics are enabled by default, new search apps can be created without analytics by setting \u003ccode\u003e"disableAnalytics": true\u003c/code\u003e in the REST API configuration.\u003c/p\u003e\n"]]],[],null,["# View analytics\n\nThis page describes how to view analytics for your recommendations\nand search apps.\n\nAnalytics give you insight into the usage trends, search and recommendation\nquality, and end-user engagement of your app. The AI Applications console\nprovides an interactive dashboard experience powered by Looker.\n\n- **For media recommendations apps**: Public preview. You can see per-recommendation metrics based on user events. You can filter metrics by date range and device type.\n- **For custom search and media search apps**: You can see per-search metrics and per-search-session metrics based on search logs and user events. You can filter metrics by date range, query, and device type.\n- **For healthcare search apps**: Public preview. You can see per-search metrics based on search logs.\n\nMetrics are refreshed about every six hours, so it can take several hours before\nyou can use the **Analytics** page after you create your app.\n\nData sources for analytics\n--------------------------\n\nThis section describes the data sources for analytics depending on app type.\n\nYou must complete user events integration to be\nable to see user event analytics.\n\nWhich user events you upload affect which analytics are generated.\n\nMedia recommendations apps require the following user events to view some\nmetrics:\n\n- **View-item events.** Required for click-through-rate.\n- **Media-complete events.** Required for completion rate per play and completion rate per recommendation.\n- **Media-play events.** Required for recommendation media play count, playthrough rate, completion rate per play, and average watch time per play.\n\nSearch apps require the following user events to view some metrics:\n\n- **Search events.** Required for click-through-rate.\n- **View-item events.** Required for click-through-rate.\n\nThe following information is also used for some analytics:\n\n- **Impressions** . You can provide impressions (item views or clicks) that are attributable to Vertex AI Search by including the associated item in `UserEvent.Documents` when ingesting user events. This information is needed for attribution and to compute per-search metrics.\n- **Attribution tokens** . Attribution tokens are unique IDs generated by Vertex AI Search and returned with each search request. Make sure to include that attribution token as `UserEvent.attributionToken` with any user events resulting from a search. This is needed to identify if a search is served by the API. Only user events with a Google-generated attribution token are used to compute metrics.\n- **User agent** . Include `UserInfo.userAgent` with user events so that you can filter on user event metrics by device type.\n\n### Search logs\n\nSearch apps use search logs as data sources for some metrics.\n\nSearch logs are based on search requests. To allow AI Applications to\nidentify user sessions so that it can deliver per-session analytics and higher\nquality search results, Google strongly recommends that you set the optional\nfield [`userPseudoId`](/generative-ai-app-builder/docs/reference/rest/v1/projects.locations.collections.engines.servingConfigs/search#body.request_body.FIELDS.user_pseudo_id).\n\nIf there are not yet any search logs or user events, default values are shown\nfor all metrics.\n\nView media recommendations analytics\n------------------------------------\n\n| **Note:** Media recommendations analytics are in Public preview.\n\nUse the following instructions to view analytics for media recommendations.\n\n1. In the Google Cloud console, go to the **AI Applications** page.\n\n [AI Applications](https://console.cloud.google.com/gen-app-builder/start)\n2. Click the name of the app that you want to view analytics for.\n\n3. Click **Analytics**.\n\n4. To filter your metrics, specify any of the following filters and then click\n the **Refresh** button to apply them:\n\n - **Date range**. Select a preset date range or, if available, enter a custom date range.\n - **Device type**. Select a device type that queries occurred on.\n\nView search analytics\n---------------------\n\n| **Notes:**\n|\n| - For data stores in US and EU multi-regions, viewing search analytics is in Public preview.\n| - Because AI Applications for healthcare search provides search services only in the US multi-region (\\`us\\`), analytics for healthcare search are in Public preview.\n| - Search analytics are GA for global data stores.\n| - By default, metrics from the widget don't appear on the **Analytics** page. To view widget metrics, contact your Google account team and ask to be added to the allowlist.\n\nUse the following instructions to view analytics for search apps.\n\n1. In the Google Cloud console, go to the **AI Applications** page.\n\n [AI Applications](https://console.cloud.google.com/gen-app-builder/start)\n2. Click the name of the app that you want to view analytics for.\n\n3. Click **Analytics**.\n\n4. Click a tab to view that metric group:\n\n - **Per Search**. Metrics are grouped by searches. For healthcare search, this is the only available metric group.\n - **Per Session**. Metrics are grouped by search sessions.\n - **Compare**. Baseline metrics are shown alongside metrics from a comparison period. Select date ranges for the baseline metrics (an earlier time range) and comparison metrics (a later time range). These time ranges can't overlap.\n5. To filter your metrics, specify the filters and then click\n the **Refresh** button to apply them.\n\n For media apps and for custom search apps, the following filters are\n available:\n - **Date range**. Select a preset date range or, if available, enter a custom date range.\n - **Search query** . Select a condition and search query value. You can add multiple search query filters. Available for **Per Search** and **Compare** metrics.\n - **Device type**. Select a device type that queries occurred on.\n\n For healthcare search apps, the following filters are available:\n - **Date range**. Select a preset date range or, if available, enter a custom date range. When you select a specific date for custom date range, that date is the date when the search took place in the UTC -08:00 time zone.\n - **Search query**. Select a condition and search query value. You can add multiple search query filters.\n - **User location**. Select the location of the hospital, clinic, or the healthcare service provider that was set in the search request. This filter is available only if it was set in the search request.\n - **User role**. Select the job category of the user who sent the search request. This filter is available only if it was set in the search request.\n - **User setting**. Select the healthcare setting set in the search request, such as inpatient, outpatient, or hybrid treatment. This filter is available only if it was set in the search request.\n\nMetrics definitions\n-------------------\n\nThe following tables describe how metrics are defined.\n\n### Media recommendations metrics\n\n### Media and custom search metrics\n\n### Healthcare search metrics\n\nThe following search metrics are available for healthcare search apps.\n\nTurn off analytics\n------------------\n\nYou can't turn off analytics for an existing app, but when you create an app you\ncan choose to create it with analytics turned off.\n\nTo create a search app that won't collect analytics data:\n\n1. Follow the REST instructions in [Create a search app](/generative-ai-app-builder/docs/create-engine-es), adding\n the following to the curl command:\n\n \"disableAnalytics\": true\n\n #### Example command\n\n ```\n curl -X POST \\\n -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-Goog-User-Project: my-project-123\" \\\n \"https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines?engineId=my-app\" \\\n -d '{\n \"displayName\": \"App without analytics\",\n \"dataStoreIds\": [\"my-data-store\"],\n \"solutionType\": \"SOLUTION_TYPE_SEARCH\",\n \"searchEngineConfig\": {\n \"searchTier\": \"SEARCH_TIER_ENTERPRISE\",\n \"searchAddOns\": [\"SEARCH_ADD_ON_LLM\"]\n },\n \"disableAnalytics\": true\n }'\n\n \n ```\n\n\n This command creates an app that won't collect search analytics data."]]
