A Vertex AI para Pesquisa no varejo está sendo renomeada como Vertex AI para Pesquisa no comércio. Estamos atualizando o conteúdo para refletir o novo branding.

Esta página foi traduzida pela API Cloud Translation.

Ver análise

Nesta página, descrevemos as métricas que podem ajudar você a determinar como a Vertex AI Search para e-commerce está afetando seus negócios.

Pré-requisitos

Os painéis de análise usam eventos do usuário ingeridos como fontes de dados para métricas. É necessário concluir a integração de eventos do usuário para acessar a análise deles. As métricas são atualizadas a cada seis horas. Por isso, pode levar horas após a criação do app para que elas apareçam nas páginas de Análise.

Eventos do usuário

Os seguintes eventos de usuário são necessários para visualizar algumas métricas:

Pesquisar eventos. Obrigatório para qualquer tipo de métrica.
Eventos de visualização da página de detalhes. Necessário para métricas de visualização de página.
Eventos de adição ao carrinho. Obrigatório para taxa de adição ao carrinho e taxa de conversão.
Eventos de conclusão da compra. Obrigatório para receita total, receita gerada pelas recomendações, valor médio do pedido, taxa de compra, taxa de receita, valor médio da unidade, taxa de pedido de compra e taxa de conversão.

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

Detalhes do produto. Para garantir a computação precisa das métricas relacionadas à pesquisa, inclua UserInfo.productDetails nos eventos do usuário. Essas informações permitem que a Vertex AI para Pesquisa de comércio atribua pesquisas com interações específicas de produtos. Se o campo UserInfo.ProductDetail.quantity for omitido nos eventos do usuário, um valor padrão de 1 será usado nos cálculos.
Receita. O campo UserInfo.PurchaseTransaction.revenue é crucial para gerar métricas de receita precisas. Verifique se esse campo está preenchido nos eventos do usuário para ativar uma análise significativa relacionada à receita.
Tokens de atribuição. Os tokens de atribuição são IDs exclusivos gerados pela Vertex AI para Pesquisa de comércio 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 Vertex AI para Pesquisa no comércio.
User agent. Inclua UserInfo.userAgent com eventos do usuário resultantes de uma pesquisa para filtrar as métricas de eventos do usuário por tipo de dispositivo.

Ver a análise de recomendações

Para acessar as análises de recomendações:

No console Google Cloud , acesse a página Pesquisa para e-commerce.

Acessar o console da Pesquisa para e-commerce
No menu de navegação, clique em Analytics.
Clique na guia Recomendação.
Use filtros para conferir suas métricas:
- Se disponível, insira um período personalizado ou selecione um predefinido.
- Você pode selecionar um tipo de dispositivo em que a recomendação ocorreu.
- Para mostrar as métricas de uma configuração de recomendação, use todos os filtros a seguir. Defina "Nenhum" para mostrar métricas agregadas em todas as configurações de recomendação.
  - ID da configuração de veiculação
  - ID da recomendação
  - Tipo de evento de contexto com uma recomendação exibida

Ver análises de pesquisa

Se não houver eventos do usuário, os valores padrão serão mostrados para todas as métricas.

Para conferir as análises de pesquisa:

No console Google Cloud , acesse a página Pesquisa para e-commerce.

Acessar o console da Pesquisa para e-commerce
No menu de navegação, clique em Analytics.
Clique na guia Pesquisar.
Clique em uma guia para ver esse grupo de métricas:
- Por pesquisa. As métricas são agrupadas por pesquisas.
- Por visita. As métricas são agrupadas por visitas de pesquisa.
Para filtrar suas métricas, use os seguintes filtros:
- 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 foram feitas.

Ver análises de navegação

Se ainda não houver eventos do usuário, os valores padrão serão mostrados para todas as métricas.

Para conferir as análises de navegação:

No console Google Cloud , acesse a página Pesquisa para e-commerce.

Acessar o console da Pesquisa para e-commerce
No menu de navegação, clique em Analytics.
Clique na guia Procurar.
Clique em uma guia para ver esse grupo de métricas:
- Por procura. As métricas são agrupadas por navegações.
- Por visita. As métricas são agrupadas por visitas de navegação.
Para filtrar suas métricas, use os seguintes filtros:
- 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 a navegação ocorreu.

Ver análises da configuração de veiculação

No console Google Cloud , acesse a página Pesquisa para e-commerce.

Acessar o console da Pesquisa para e-commerce
No menu de navegação, clique em Configurações de veiculação.
Clique no nome da configuração de veiculação para ver as análises.
Clique na guia Analytics.
Selecione um tipo de métrica na lista suspensa Métrica para ver o gráfico do último mês.

Definições de métricas

Estas seções fornecem definições das métricas em todo o site exibidas na página Analytics:

Métricas de resumo de recomendações: métricas que representam o engajamento do usuário com os resultados de recomendações.
métricas de resumo da pesquisa:
- Métricas de resumo da pesquisa por consulta de texto: métricas que representam o engajamento com resultados de pesquisa por consulta de texto.
- Procurar métricas de resumo da pesquisa: métricas que representam o engajamento com os resultados da pesquisa por navegação de categoria.

Métricas de resumo das recomendações

As métricas a seguir são exibidas para recomendações na guia Recomendações.

Métrica	Descrição
Contagem de recomendações	O número total de recomendações feitas em todo o site.
Contagem de visualizações da página de detalhes	O número de vezes que um produto recomendado foi clicado.
Número de eventos "Adicionar ao carrinho"	O número de vezes que um produto recomendado foi adicionado a um carrinho.
Contagem de compras	O número de pedidos de compra em que pelo menos um produto foi recomendado.
Receita de compra	A receita dos pedidos de compra em que pelo menos um produto foi recomendado.
Taxa de cliques (CTR) por recomendação	A porcentagem de vezes que um produto recomendado foi clicado em relação ao número total de vezes que ele foi recomendado.
Taxa de adição ao carrinho por recomendação	A porcentagem de vezes que um produto recomendado foi adicionado a um carrinho do número total de vezes que ele foi recomendado.
Taxa de compra por recomendação	A porcentagem de vezes que um pedido que incluía um produto recomendado foi comprado do número total de vezes que o produto foi recomendado.
Valor médio do pedido por recomendação	A receita de um pedido que incluiu o produto recomendado comprado do número total de vezes que ele foi recomendado.

Métricas de resumo da pesquisa de texto

As seguintes métricas para pesquisas de texto são mostradas na guia Pesquisa.

Métrica	Descrição
Número de pesquisas	O número total de pesquisas realizadas em todo o site.
Taxa de nenhum resultado	O número de pesquisas sem resultados dividido pelo número total de pesquisas.
Taxa de cliques (CTR) por pesquisa	O número de cliques nos resultados da pesquisa dividido pelo número total de pesquisas.
Taxa de adição ao carrinho (ATC) por pesquisa	O número de eventos de adição ao carrinho que ocorrem nos resultados da pesquisa dividido pelo número total de pesquisas.
Taxa de compra por pesquisa	O número de unidades em eventos de compra concluída que ocorrem nos resultados da pesquisa dividido pelo número total de pesquisas.
Taxa de receita por pesquisa	O valor da receita gerada por eventos de conclusão de compra dividido pelo número total de pesquisas.
Valor médio da unidade (VMU) por pesquisa	O valor da receita gerada por eventos de conclusão da compra dividido pela quantidade total de unidades gerada por esses eventos. Calculado com base apenas em eventos de conclusão da compra atribuídos a pesquisas.
Taxa de personalização	O número de pesquisas personalizadas dividido pelo número total de pesquisas.
Contagem de visitas de pesquisa	O número total de visitas de pesquisa realizadas em todo o site.
Visualização de página por acesso de pesquisa	O número total de eventos de visualização de página de detalhes que ocorrem na visita de pesquisa dividido pelo número total de visitas de pesquisa.
Taxa de adição ao carrinho (ATC) por visita de pesquisa	O número de eventos de adição ao carrinho que ocorrem na visita de pesquisa dividido pelo número total de visitas de pesquisa. Calculado incluindo todos os eventos de adição ao carrinho, independente de poderem ser atribuídos diretamente à pesquisa.
Taxa de pedidos de compra por visita de pesquisa	O número de eventos de compra concluída que ocorrem na visita de pesquisa dividido pelo número total de visitas de pesquisa. Calculado incluindo todos os eventos de compra concluída, independente de poderem ser atribuídos diretamente à pesquisa.
Taxa de receita por visita de pesquisa	O valor da receita gerada por eventos de compra concluída em uma visita de pesquisa dividido pelo número total de visitas de pesquisa. Calculado incluindo todos os eventos de compra concluída, independente de poderem ser atribuídos diretamente à pesquisa.
Valor médio do pedido (VMP) por visita de pesquisa	O valor da receita gerada com eventos de conclusão da compra na visita de pesquisa dividido pelo número de eventos de conclusão da compra que ocorrem na visita de pesquisa. Calculado incluindo todos os eventos de compra concluída, independente de poderem ser atribuídos diretamente à pesquisa.

Procurar métricas de resumo da pesquisa

As seguintes métricas para pesquisas de navegação são exibidas na guia Navegar.

Métrica	Descrição
Contagem de navegações	O número total de pesquisas de navegação realizadas em todo o site.
Taxa de nenhum resultado	O número de pesquisas de navegação sem resultados dividido pelo número total de pesquisas de navegação.
Taxa de cliques (CTR) por navegação	O número de cliques nos resultados da navegação dividido pelo número total de pesquisas de navegação em todo o site. O número total de pesquisas de navegação inclui consultas paginadas.
Taxa de adição ao carrinho (ATC) por navegação	O número de eventos de adição ao carrinho que ocorrem nos resultados da navegação dividido pelo número total de pesquisas de navegação.
Taxa de compra por navegação	O número de unidades em eventos de compra concluída que ocorrem nos resultados da navegação dividido pelo número total de pesquisas de navegação. O número total de pesquisas de navegação inclui consultas paginadas.
Taxa de receita por navegação	O valor da receita gerada por eventos "purchase_complete" dividido pelo número total de pesquisas de navegação.
Valor médio da unidade (VMU) por navegação	O valor da receita gerada por eventos de conclusão da compra dividido pela quantidade total de unidades gerada por esses eventos. Calculado com base apenas em eventos de conclusão da compra atribuídos a pesquisas de navegação.
Taxa de personalização	O número de pesquisas de navegação personalizadas dividido pelo número total de pesquisas de navegação.
Procurar contagem de visitas	O número total de visitas de pesquisa por navegação realizadas em todo o site.
Visualização de página por visita de navegação	O número total de eventos de visualização de página de detalhes que ocorrem na visita de pesquisa de navegação dividido pelo número total de visitas de pesquisa de navegação.
Taxa de adição ao carrinho (ATC) por visita de navegação	O número de eventos de adição ao carrinho que ocorrem na visita de pesquisa de navegação dividido pelo número total de visitas de pesquisa de navegação. Calculado incluindo todos os eventos de adição ao carrinho, independente de poderem ser atribuídos diretamente à pesquisa de navegação.
Taxa de pedidos de compra por visita de navegação	O número de eventos de compra concluída que ocorrem na visita de pesquisa de navegação dividido pelo número total de visitas de pesquisa de navegação. Calculado incluindo todos os eventos de conclusão de compra, independente de poderem ser atribuídos diretamente à pesquisa de navegação.
Taxa de receita por visita de navegação	O valor da receita gerada por eventos de compra concluída na visita de pesquisa de navegação dividido pelo número total de visitas de pesquisa de navegação. Calculado incluindo todos os eventos de conclusão de compra, independente de poderem ser atribuídos diretamente à pesquisa de navegação.
Valor médio do pedido (VMP) por visita de navegação	O valor da receita gerada com eventos de conclusão da compra na visita de pesquisa de navegação dividido pelo número de eventos de conclusão da compra que ocorrem na visita de pesquisa de navegação. Calculado incluindo todos os eventos de conclusão de compra, independente de poderem ser atribuídos diretamente à pesquisa de navegação.

Métricas específicas de configuração

É possível ver as métricas de uma configuração de exibição específica na página Configurações de exibição. Para ver gráficos de métricas, clique no nome de uma configuração de exibição para acessar a página de detalhes dela e selecione a guia Analytics.

Esta tabela fornece definições para métricas específicas da configuração.

Métrica	Descrição	Detalhes
Taxa de cliques (CTR)	O número de visualizações de detalhes do produto no painel de recomendações de uma configuração de exibição dividido pelo número total de consultas `predict` para essa configuração de exibição.	Por exemplo, se a configuração de exibição apontar para um modelo "Juntos comprados com frequência", a CTR será o número de páginas de detalhes de produtos visualizadas no painel de recomendações do carrinho de compras dividido pelo número de consultas de previsão na página do carrinho de compras.
Taxa de conversão (CVR)	O número de eventos "adicionar ao carrinho" em um painel de recomendações da configuração de exibição dividido pelo número total de consultas `predict` dessa configuração de exibição.	Semelhante à CTR, exceto que, em vez das visualizações de detalhes do produto, a taxa de conversão usa eventos de adição ao carrinho.
Receita gerada pelas recomendações	A receita total das recomendações para essa configuração de veiculação.	É semelhante à receita gerada pelas recomendações para métricas de resumo, mas apenas para essa configuração de veiculação.

Para rastrear cliques de uma configuração de exibição, a Vertex AI para Pesquisa de comércio alinha os resultados nas respostas predict e search com eventos de usuário ingeridos. Se um item clicado aparecer nas respostas para o mesmo ID de visitante em uma janela de tempo de uma hora, o clique ou a compra será tratado como resultado da Pesquisa da Vertex AI para e-commerce.

Esse processo é totalmente automático; você não precisa configurar nada. No entanto, ao configurar a previsão e as solicitações de pesquisa pela primeira vez, confirme o seguinte:

Os IDs de visitante na solicitação são os mesmos que os de visitante usados nos processamentos de eventos.
O carimbo de data/hora na resposta corresponde aproximadamente ao carimbo de data/hora desse evento.

Quando as métricas são comparadas ao resultado ideal esperado ou às informações empíricas, os valores podem ser menores, mas as tendências estão alinhadas.

Uma alternativa mais direta a esse método é usar os tokens de atribuição. Isso requer instrumentação significativa e é recomendado apenas como um caso de uso de rastreamento avançado.