Exporte as suas métricas de estatísticas para o BigQuery

Esta página descreve como exportar métricas de estatísticas do Vertex AI Search for commerce para o BigQuery. A exportação de métricas do Analytics permite-lhe reter as métricas e escrever SQL para a sua própria análise.

As métricas de estatísticas do Vertex AI Search para comércio são geradas automaticamente para si. Para mais informações sobre a medição do impacto empresarial do Vertex AI Search para comércio com métricas de estatísticas, consulte o artigo Ver estatísticas.

A exportação de dados de métricas para o BigQuery tem as seguintes limitações:

  • Os dados exportados para tabelas do BigQuery no seu projeto do Vertex AI Search for commerce são vistas autorizadas e não vistas materializadas.

  • Não pode alterar nem atualizar os dados nestas tabelas. Se precisar de alterar ou atualizar os seus dados, exporte ou copie a vista para outro destino.

  • Não pode exportar métricas de eventos de utilizadores com mais de 180 dias ou métricas geradas há mais de 180 dias. Não é possível obter métricas geradas antes do período de 180 dias.

Antes de começar

Antes de poder exportar as suas métricas para o BigQuery, tem de ter concluído os procedimentos descritos em Antes de começar. Isto inclui a importação dos seus eventos de utilizador e, opcionalmente, as informações do catálogo.

Para mais informações sobre a importação, consulte:

Crie um conjunto de dados no BigQuery

Tem de criar um conjunto de dados no BigQuery para armazenar os dados das métricas do Analytics.

Tem de criar os conjuntos de dados no mesmo projeto onde implementou o Vertex AI Search for commerce.

  1. Se nunca usou o BigQuery no seu projeto, ative a API BigQuery e certifique-se de que tem a função de IAM que lhe permite criar conjuntos de dados e tabelas.

    Consulte as secções Antes de começar e Controlo de acesso com a IAM

    na documentação do BigQuery.

  2. Crie um conjunto de dados no BigQuery na multirregião US (várias regiões nos Estados Unidos). Por exemplo, atribua-lhe o nome retail_data. Se criar o conjunto de dados numa região diferente, a exportação dos dados para o BigQuery falha. O CMEK para o conjunto de dados não é suportado. A respetiva ativação faz com que a exportação falhe.

    Para obter informações sobre como criar um conjunto de dados, consulte o artigo Criar conjuntos de dados na documentação do BigQuery.

    Este conjunto de dados vai ser usado para armazenar as tabelas de dados que exporta. Os procedimentos seguintes descrevem como exportar.

Exporte as suas métricas de estatísticas para uma tabela do BigQuery

Use o método exportAnalyticsMetrics para exportar o seu catálogo de retalho para uma tabela do BigQuery.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: O ID do projeto da API Vertex AI Search for commerce onde criou o conjunto de dados do BigQuery.
  • DATASET_ID: o nome do conjunto de dados que criou em Crie um conjunto de dados no BigQuery. Por exemplo, use retail_data ou retail_metrics_data.
  • TABLE_ID_PREFIX: um prefixo para o ID da tabela. Este prefixo não pode ser uma string vazia. É adicionado um sufixo de retail_analytics_metrics para completar o nome da tabela. Por exemplo, se o prefixo for test, a tabela tem o nome test_retail_analytics_metrics.

Corpo JSON do pedido: 

{
  "catalog": "projects/PROJECT_ID/locations/global/catalogs/default_catalog",
  "outputConfig":
  {
    "bigqueryDestination":
    {
      "datasetId": "DATASET_ID",
        "tableIdPrefix": "TABLE_ID_PREFIX",
        "tableType": "view"
    }
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/12310973052792775280",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.retail.v2.ExportAnalyticsMetricsResponse",
    "outputResult": {
      "bigqueryResult": [
        {
          "datasetId": "DATASET_ID",
          "tableId": "TABLE_ID_PREFIX_retail_analytics_metrics"
        }
      ]
    }
  }
}

Definições das métricas

As métricas exportadas são as métricas de contagem. Pode haver uma ligeira variação para algumas métricas de contagem, porque a filtragem de bots pode excluir alguns eventos do cálculo das métricas. A filtragem de bots pode ajudar a fornecer medições de desempenho mais precisas. Isto não afeta os testes A/B, que dependem da dimensão external_experiment_ids, enquanto a filtragem de bots é aplicada a todo o tráfego.

Dimensões de métricas

As métricas de contagem são as contagens não processadas agregadas diretamente de eventos de utilizadores relevantes com as mesmas dimensões. Para interpretar as métricas, tem de saber em que dimensões se baseiam. Para efeitos das métricas de estatísticas, os eventos de pesquisa e navegação são denominados eventos de impressão e os eventos detail_page_view, add_to_cart e purchase são denominados eventos de conversão. A tabela seguinte define as dimensões das métricas.

Dimensão da métrica Descrição
data

A data dos eventos relevantes que geraram as métricas.

Para as métricas de impressões, esta é a data dos eventos de impressões.

Para as métricas de sessão e visitante, esta é a data do primeiro evento de impressão da sessão/visitante.
external_experiment_ids

Os IDs das experiências dos eventos relevantes que geraram as métricas.

Para as métricas de impressões, este é o ID da experiência do evento de impressão.

Para as métricas de sessão e visitante, esta é a concatenação dos IDs de experiências externas únicos de todos os eventos de impressão que aparecem na sessão/visitante. Por exemplo, se existirem dois eventos de pesquisa numa sessão/visitante, o primeiro evento de pesquisa tiver external_experiment_ids "test_arm_1,test_arm_2" e o segundo evento de pesquisa tiver external_experiment_ids "test_arm_1,test_arm_3", então external_experiment_ids da sessão/visitante é "test_arm_1,test_arm_2,test_arm_3"
device_type

O tipo de dispositivo dos eventos relevantes que geraram as métricas, por exemplo, se o evento for gerado a partir de um dispositivo móvel ou de um computador.

Para as métricas de impressões, este é o tipo de dispositivo do evento de impressão.

Para as métricas de sessão e visitante, este campo está vazio se a sessão/visitante tiver mais do que um tipo de dispositivo distinto ou 1 se existir apenas um tipo de dispositivo para toda a sessão/visitante.
serving_config

A configuração de publicação dos eventos relevantes que geraram as métricas.

Para as métricas de impressões, esta é a configuração de publicação do evento de impressão.

Para as métricas de sessão e visitante, este campo está vazio se a sessão/visitante tiver mais do que uma configuração de publicação distinta ou tiver apenas uma configuração de publicação para toda a sessão/visitante.
traffic_destination

A origem dos eventos relevantes que geraram as métricas.

Para as métricas de impressões, este valor é "Google" se a impressão for publicada pela Google ou "Não Google" se a impressão for publicada pela sua própria solução.

Para as métricas de sessão e visitante, esta é "Mista" se a sessão/visitante tiver eventos de impressões publicados pela Google e pela sua própria solução. É "Google" se os eventos de impressão forem publicados exclusivamente pela Google ou "Não Google" se os eventos de impressão forem publicados exclusivamente pela sua solução para toda a sessão/visitante.
entidade

É usado por retalhistas que publicam vários sites ou regiões de marcas com um catálogo de produtos. Normalmente, a entidade representa as marcas ou as localizações.

Para as métricas de impressões, esta é a entidade do evento de impressão.

Para as métricas de sessão e visitante, estas são as cinco principais entidades contabilizadas dos eventos de impressão para a sessão/visitante.

Métricas de impressões

As métricas de impressões são calculadas de acordo com os pré-requisitos. Os eventos de conversão (eventos detail_page_view, add_to_cart e purchase) só podem ser atribuídos a um evento de impressão se corresponderem aos seguintes critérios.

  • O evento de impressão e o evento de conversão têm o mesmo visitante.

  • O ID do produto do evento de conversão tem de aparecer nos resultados do evento de impressão.

  • O evento de conversão está dentro do período necessário após a ocorrência do evento de impressão. Aplicam-se diferentes períodos de tempo de conversão a diferentes tipos de eventos de conversão.

    Caminho de conversão Período de tempo de conversão
    Impressão -> Visualização da página de detalhes 60 segundos
    Impressão -> Adicionar ao carrinho 24 horas
    Impressão -> Compra 48 horas

Métricas de impressões de pesquisa

Nome da métrica Descrição
search_event Contagem de eventos de pesquisa
detail_page_view_from_search Contagem de eventos de visualização da página de detalhes a partir da pesquisa
add_to_cart_unit_from_search Contagem de unidades adicionadas ao carrinho a partir da pesquisa
purchase_unit_from_search Contagem de unidades compradas a partir da pesquisa
revenue_from_search Receita da pesquisa
search_event_without_result Contagem de eventos de pesquisa que não geram resultados
search_request_personalization_enabled Contagem de pedidos de pesquisa com a personalização ativada
search_request_personalization_result_served Contagem de pedidos de pesquisa apresentados com resultados personalizados

Métricas de impressões de navegação

Nome da métrica Descrição
browse_event Contagem de eventos de navegação
detail_page_view_from_browse Contagem de eventos de visualização da página de detalhes a partir da navegação
add_to_cart_unit_from_browse Contagem de blocos de adições ao carrinho a partir da navegação
purchase_unit_from_browse Contagem de unidades compradas a partir da navegação
revenue_from_browse Receita da navegação
browse_event_without_result Procurar contagem de eventos que não produz resultados
browse_request_personalization_enabled Contagem de pedidos de navegação com a personalização ativada
browse_request_personalization_result_served Contagem de pedidos de navegação publicados com resultados personalizados

Métricas de sessão

Uma sessão é definida como um período contínuo de interação entre um utilizador e o sistema. Qualquer evento do utilizador marca o início de uma sessão, e o fim de uma sessão é marcado quando não ocorre nenhum outro evento durante os 30 minutos seguintes. A sessão é prolongada por mais 30 minutos sempre que ocorre um evento do utilizador numa sessão iniciada. Após o término de uma sessão, uma nova sessão é iniciada quando o utilizador interage novamente com o sistema.

As dimensões que caraterizam as métricas de sessão são definidas em conjunto por todos os eventos do utilizador na sessão. Consulte as métricas/dimensões para saber como os valores das dimensões são definidos para a sessão.

Nome da métrica Descrição
sessão Contagem de sessões

Métricas de sessão de pesquisa

Uma sessão de pesquisa é uma sessão que contém, pelo menos, um evento de pesquisa. Tenha em atenção que uma sessão de pesquisa também pode ser uma sessão de navegação, conforme definido pelas métricas de sessão de navegação.

Nome da métrica Descrição
search_session Contagem de sessões que envolvem uma pesquisa
search_event_in_search_session Pesquise a quantidade de eventos em sessões de pesquisa
browse_event_in_search_session Contagem de eventos de procura em sessões de pesquisa
detail_page_view_in_search_session Contagem de visualizações da página de detalhes em sessões de pesquisa
add_to_cart_in_search_session Contagem de eventos de adição ao carrinho em sessões de pesquisa
add_to_cart_unit_in_search_session Contagem de unidades adicionadas ao carrinho em sessões de pesquisa
purchase_order_in_search_session Contagem de notas de encomenda em sessões de pesquisa
purchase_unit_in_search_session Contagem de unidades de compra em sessões de pesquisa
revenue_in_search_session Receita nas sessões de pesquisa
bounce_count_in_search_session Contagem de sessões do visitante que navega para fora do site depois de ver apenas uma página em sessões de pesquisa

Explore as métricas de sessão

Uma sessão de navegação é uma sessão que contém, pelo menos, um evento de navegação. Tenha em atenção que uma sessão de navegação também pode ser uma sessão de pesquisa, conforme definido pelas métricas de sessão de pesquisa.

Nome da métrica Descrição
browse_session Contagem de sessões que envolvem a navegação
search_event_in_browse_session Quantidade de eventos de pesquisa em sessões de navegação
browse_event_in_browse_session Contagem de eventos de procura em sessões de procura
detail_page_view_in_browse_session Contagem de visualizações da página de detalhes em sessões de navegação
add_to_cart_in_browse_session Contagem de eventos de adição ao carrinho em sessões de navegação
add_to_cart_unit_in_browse_session Contagem de blocos de adições ao carrinho em sessões de navegação
purchase_order_in_browse_session Contagem de notas de encomenda em sessões de navegação
purchase_unit_in_browse_session Contagem de unidades compradas em sessões de navegação
revenue_in_browse_session Receita em sessões de navegação
bounce_count_in_browse_session Contagem de sessões do visitante que navega para fora do site depois de ver apenas uma página em sessões de navegação

Métricas de visitantes

Um visitante é identificado de forma exclusiva pelo ID de visitante. As métricas de visitantes agregam todas as informações de eventos do utilizador para o visitante.

As dimensões que caraterizam as métricas de visitantes são definidas em conjunto por todos os eventos do utilizador para o visitante. Consulte as dimensões de métricas para saber como os valores das dimensões são definidos para o visitante.

Nome da métrica Descrição
visitante Contagem de visitantes

Pesquise métricas de visitantes

Um visitante de pesquisa é um visitante que realiza, pelo menos, um evento de pesquisa. Tenha em atenção que um visitante de pesquisa também pode ser um visitante de navegação, conforme definido pelas métricas de visitante de navegação.

Nome da métrica Descrição
search_visitor Número de visitantes que fazem, pelo menos, uma pesquisa
search_event_from_search_visitor Contagem de eventos de pesquisa de visitantes da pesquisa
browse_event_from_search_visitor Procure a contagem de eventos de visitantes da pesquisa
detail_page_view_from_search_visitor Contagem de visualizações da página de detalhes de visitantes da pesquisa
add_to_cart_from_search_visitor Contagem de eventos de adição ao carrinho de visitantes da pesquisa
add_to_cart_unit_from_search_visitor Contagem de unidades adicionadas ao carrinho de visitantes da pesquisa
purchase_order_from_search_visitor Contagem de notas de encomenda de visitantes da pesquisa
purchase_unit_from_search_visitor Unidade de contagem de compras de visitantes da pesquisa
revenue_from_search_visitor Receita de visitantes da pesquisa

Procure métricas de visitantes

Um visitante de navegação é um visitante que realiza, pelo menos, um evento de navegação. Tenha em atenção que um visitante de navegação também pode ser um visitante de pesquisa, conforme definido pelas métricas de visitante de pesquisa.

Nome da métrica Descrição
browse_visitor Número de visitantes que realizam, pelo menos, uma navegação
search_event_from_browse_visitor Contagem de eventos de pesquisa de visitantes de navegação
browse_event_from_browse_visitor Contagem de eventos de visitantes que navegam
detail_page_view_from_browse_visitor Contagem de visualizações da página de detalhes de visitantes que navegam
add_to_cart_from_browse_visitor Contagem de eventos de adição ao carrinho de visitantes de navegação
add_to_cart_unit_from_browse_visitor Contagem de unidades adicionadas ao carrinho de visitantes de navegação
purchase_order_from_browse_visitor Número de notas de encomenda de visitantes de navegação
purchase_unit_from_browse_visitor Número de unidades compradas de visitantes que navegam
revenue_from_browse_visitor Receita de visitantes que navegam

Exemplo de utilização

Se copiar ou exportar os dados de métricas para outro destino, pode usar SQL para obter informações gerais ou específicas sobre as métricas exportadas. Algumas formas comuns de explorar as métricas exportadas através de SQL são apresentadas nas secções seguintes.

Calcule a taxa de cliques (CTR)

Calcular a CTR para a pesquisa por data, por tipo de dispositivo e por destino de tráfego.

SELECT
  `date`,
  device_type,
  traffic_destination,
  SUM(detail_page_view_from_search) / SUM(search_event) as search_CTR
FROM copied_table
GROUP BY `date`, device_type, traffic_destination

Obtenha a contagem de visualizações da página de detalhes geradas pela navegação

Obtenha eventos de visualização da página de detalhes provenientes de eventos de navegação para tráfego do Google com external_experiment_ids contendo test_arm e apresente todas as informações das dimensões. external_experiment_ids é repetido string.

SELECT
  `date`,
  external_experiment_ids,
  device_type,
  serving_config,
  traffic_destination,
  entity,
  detail_page_view_from_browse
FROM copied_table
WHERE
  traffic_destination = 'Google' AND 'test_arm' in UNNEST(external_experiment_ids)

Obtenha as configurações de publicação mais usadas

Obtenha as configurações de publicação mais usadas entre "2023-10-01" e "2023-11-01" para tráfego do Google. Cada evento de pesquisa deve ter uma configuração de publicação associada.

SELECT
  serving_config,
  SUM(search_event) as total_search_count
FROM copied_table
WHERE `date` between '2023-10-01' and '2023-11-01' AND traffic_destination = 'Google'
GROUP BY serving_config
ORDER BY total_search_count