A Vertex AI para Pesquisa no varejo vai substituir a plataforma Retail. 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 Pesquisa da Vertex AI para varejo está afetando sua empresa.

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 dos eventos do usuário para acessar a Análise de eventos do usuário. As métricas são atualizadas a cada seis horas. Por isso, pode levar horas para que elas apareçam nas páginas de Análise depois que você cria o app.

Eventos do usuário

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

Eventos de pesquisa. Obrigatório para qualquer tipo de métrica.
Eventos de visualização da página de detalhes. Obrigatório para métricas de visualização de página.
Eventos de adição ao carrinho. Obrigatório para a taxa de adição ao carrinho e a 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 pedidos de compra, taxa de conversão.

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

Detalhes do produto. Para garantir o cálculo preciso das métricas relacionadas à pesquisa, inclua UserInfo.productDetails nos seus eventos do usuário. Com essas informações, a Vertex AI para Pesquisa no varejo pode atribuir pesquisas a 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á assumido para os 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 permitir uma análise significativa relacionada à receita.
Tokens de atribuição. Os tokens de atribuição são IDs exclusivos gerados pela Vertex AI Search for Retail 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 Vertex AI para Pesquisa para varejo.
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.

Acessar as análises de recomendações

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

No console do Google Cloud, acesse a página Pesquisar para varejo.

Acessar o console da Pesquisa para varejo
No menu de navegação, clique em Google Analytics.
Clique na guia Recomendação.
Use filtros para conferir suas métricas:
- Se disponível, insira um período personalizado ou selecione um período 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

Conferir 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 estatísticas de pesquisa:

No console do Google Cloud, acesse a página Pesquisar para varejo.

Acessar o console da Pesquisa para varejo
No menu de navegação, clique em Google Analytics.
Clique na guia Pesquisar.
Clique em uma guia para acessar o 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 as 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 ocorreram.

Conferir 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 estatísticas de navegação:

No console do Google Cloud, acesse a página Pesquisar para varejo.

Acessar o console da Pesquisa para varejo
No menu de navegação, clique em Google Analytics.
Clique na guia Procurar.
Clique em uma guia para acessar o grupo de métricas:
- Por pesquisa. As métricas são agrupadas por navegações.
- Por visita. As métricas são agrupadas por visitas de navegação.
Para filtrar as 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.

Analisar a configuração de veiculação

No console do Google Cloud, acesse a página Pesquisar para varejo.

Acessar o console da Pesquisa para varejo
No menu de navegação, clique em Serving Configs.
Clique no nome da configuração de veiculação que você quer analisar.
Clique na guia Analytics.
Selecione um tipo de métrica na lista suspensa Métrica para conferir o gráfico do último mês.

Definições de métricas

Métricas de resumo

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

Métricas de resumo das recomendações: métricas que representam o engajamento do usuário com os resultados das recomendações.
Métricas de resumo da pesquisa:
- Métricas de resumo da pesquisa de consulta de texto: métricas que representam o engajamento com os resultados da pesquisa de consulta de texto.
- Métricas de resumo da pesquisa de navegação: métricas que representam o engajamento com os resultados da pesquisa de navegação por 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 realizadas em todo o site.
Contagem de visualizações da página de detalhes	Número de vezes que um produto recomendado foi clicado.
Contagem de "Adicionar ao carrinho"	Número de vezes que um produto recomendado foi adicionado a um carrinho.
Contagem de compras	O número de ordens de compra em que pelo menos um produto foi recomendado.
Receita de compra	A receita de ordens 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 em relação ao número total de vezes que ele foi recomendado.
Taxa de compra por recomendação	A porcentagem de vezes que um pedido que incluiu um produto recomendado foi comprado em relação ao 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 que foi comprado do número total de vezes que ele foi recomendado.

Métricas de resumo da pesquisa de texto

As métricas a seguir para pesquisas de texto são exibidas 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 que ocorrem nos resultados da pesquisa dividido pelo número total de pesquisas.
Taxa de receita por pesquisa	O valor da receita gerada pelos eventos de compra concluída dividido pelo número total de pesquisas.
Valor médio da unidade (AUV) por pesquisa	O valor da receita gerada com eventos de conclusão de compra dividido pelo total de unidades geradas por eventos de conclusão de compra. Calculado com base apenas em eventos de conclusão de 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 da página de detalhes que ocorrem na visita de pesquisa dividida pelo número total de visitas de pesquisa.
Taxa de adição ao carrinho (ATC) por visita à 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, mesmo que não possam ser atribuídos diretamente à pesquisa.
Taxa de pedidos 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, independentemente de serem atribuídos diretamente à pesquisa.
Taxa de receita por visita de pesquisa	O valor da receita gerada por eventos de compra concluída na visita de pesquisa dividida pelo número total de visitas de pesquisa. Calculado incluindo todos os eventos de compra concluída, independentemente de serem atribuídos diretamente à pesquisa.
Valor médio do pedido (VMP) por visita de pesquisa	O valor da receita gerada com eventos de compra concluída na visita de pesquisa dividido pelo número de eventos de compra concluída que ocorrem na visita de pesquisa. Calculado incluindo todos os eventos de compra concluída, independentemente de serem atribuídos diretamente à pesquisa.

Procurar métricas do resumo da pesquisa

As métricas a seguir para pesquisas de navegação são exibidas na guia Procurar.

Métrica	Descrição
Contagem de navegação	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 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 pelos eventos de compra concluída dividido pelo número total de pesquisas de navegação.
Valor médio da unidade (AUV) por navegação	O valor da receita gerada com eventos de conclusão de compra dividido pelo total de unidades geradas por eventos de conclusão de compra. Calculado com base apenas em eventos de conclusão de 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.
Contagem de visitas de navegação	O número total de visitas de pesquisa de 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 da página de detalhes que ocorrem na visita de pesquisa de navegação dividida 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, mesmo que não possam ser atribuídos diretamente à pesquisa de navegação.
Taxa de pedidos 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 compra concluída, independentemente de serem 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 dividida pelo número total de visitas de pesquisa de navegação. Calculado incluindo todos os eventos de compra concluída, independentemente 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 compra concluída na visita de pesquisa de navegação dividido pelo número de eventos de compra concluída que ocorrem na visita de pesquisa de navegação. Calculado incluindo todos os eventos de compra concluída, independentemente de poderem ser atribuídos diretamente à pesquisa de navegação.

Métricas específicas de configuração

É possível conferir as métricas de uma configuração de exibição específica na página Configurações de exibição. Para 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.

A tabela abaixo 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.	Por exemplo, se a configuração de exibição apontar para um modelo "Comprados frequentemente", 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 previstas na página do carrinho de compras.
Taxa de conversão (CVR)	O número de eventos "Adicionar ao carrinho" no painel de recomendações de uma configuração de exibição dividido pelo número total de consultas `predict` dessa configuraçã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 resumidas, mas apenas para esta configuração de veiculação.

Para rastrear cliques de uma configuração de exibição, a Vertex AI para Pesquisa para varejo 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/compra será tratado como resultado da Pesquisa da Vertex AI para varejo.

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 à verdade, os valores podem ser menores, mas as tendências estão alinhadas.

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