Exportar suas métricas de análise para o BigQuery

Nesta página, descrevemos como exportar métricas de análise da Pesquisa da Vertex AI para comércio para o BigQuery. Ao exportar métricas de análise, você retém as métricas e escreve SQL para sua própria análise.

As métricas de análise da Vertex AI para Pesquisa de comércio são geradas automaticamente para você. Para mais informações sobre como medir o impacto comercial da Pesquisa da Vertex AI para e-commerce com métricas de análise, consulte Ver análises.

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 da Pesquisa da Vertex AI para e-commerce são visualizações autorizadas, não visualizações materializadas.

  • Não é possível mudar nem atualizar os dados nessas tabelas. Se você precisar mudar ou atualizar seus dados, exporte ou copie a visualização para outro destino.

  • Não é possível exportar métricas de eventos de usuário com mais de 180 dias ou geradas há mais de 180 dias. Não é possível recuperar métricas geradas antes desse período.

Antes de começar

Antes de exportar suas métricas para o BigQuery, conclua os procedimentos em Antes de começar. Isso inclui importar seus eventos do usuário e, opcionalmente, as informações do catálogo.

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

Criar um conjunto de dados no BigQuery

Você precisa criar um conjunto de dados no BigQuery para armazenar os dados de métricas do Analytics.

É necessário criar os conjuntos de dados no mesmo projeto em que você implementou a Vertex AI para Pesquisa para e-commerce.

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

    Consulte Antes de começar e Controle de acesso com o 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, nomeie-o como retail_data. Se você criar o conjunto de dados em uma região diferente, a exportação dos dados para o BigQuery vai falhar. A CMEK para o conjunto de dados não é compatível. Se você a ativar, a exportação vai falhar.

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

    Esse conjunto de dados será usado para armazenar as tabelas de dados que você exportar. Os procedimentos a seguir descrevem como exportar.

Exportar suas métricas do Google Analytics para uma tabela do BigQuery

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

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto da API Vertex AI Search para e-commerce em que você criou o conjunto de dados do BigQuery.
  • DATASET_ID: o nome do conjunto de dados que você criou em Criar 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. O prefixo não pode ser uma string vazia. Um sufixo retail_analytics_metrics é adicionado para completar o nome da tabela. Por exemplo, se o prefixo for test, a tabela será chamada test_retail_analytics_metrics.

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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 de métricas

As métricas exportadas são as métricas de contagem. Pode haver um pequeno desvio em algumas métricas de contagem porque a filtragem de bots pode excluir alguns eventos do cálculo das métricas. A filtragem de bots ajuda a gerar medições de performance mais precisas. Isso 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 brutas agregadas diretamente de eventos relevantes do usuário com as mesmas dimensões. Para interpretar as métricas, você precisa saber em quais dimensões elas se baseiam. Para fins de métricas de análise, os eventos de pesquisa e navegação são chamados de eventos de impressão, e os eventos detail_page_view, add_to_cart e purchase são chamados de eventos de conversão. A tabela a seguir define as dimensões de métrica.

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

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

Para métricas de impressão, essa é a data dos eventos de impressão.

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

Os IDs dos experimentos dos eventos relevantes que geraram as métricas.

Para métricas de impressão, esse é o ID do experimento do evento de impressão.

Para métricas de sessão e visitante, é a concatenação dos IDs externos exclusivos de todos os eventos de impressão que aparecem na sessão/visitante. Por exemplo, se houver dois eventos de pesquisa em uma sessão/visitante, o primeiro terá external_experiment_ids "test_arm_1,test_arm_2", e o segundo terá external_experiment_ids "test_arm_1,test_arm_3". Nesse caso, external_experiment_ids da sessão/visitante será "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 foi gerado em um dispositivo móvel ou computador.

Para métricas de impressão, esse é o tipo de dispositivo do evento de impressão.

Para métricas de sessão e visitante, esse campo fica vazio se a sessão/o visitante tiver mais de um tipo de dispositivo distinto ou "1" se houver apenas um tipo de dispositivo para toda a sessão/o visitante.
serving_config

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

Para métricas de impressão, essa é a configuração de veiculação do evento de impressão.

Para métricas de sessão e visitante, esse campo fica vazio se a sessão/o visitante tiver mais de uma configuração de exibição distinta ou se houver apenas uma configuração de exibição para toda a sessão/o visitante.
traffic_destination

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

Para métricas de impressão, esse valor é "Google" se a impressão for veiculada pelo Google ou "Não Google" se ela for veiculada pela sua própria solução.

Para métricas de sessão e visitante, o valor é "Misto" se a sessão/o visitante tiver eventos de impressão veiculados pelo Google e pela sua própria solução. É "Google" se os eventos de impressão forem veiculados apenas pelo Google ou "Não Google" se forem veiculados apenas pela sua solução durante toda a sessão/visitante.
entidade

Usado por varejistas que atendem vários sites de marcas ou regiões com um catálogo de produtos. A entidade geralmente representa as marcas ou os locais.

Para métricas de impressão, essa é a entidade do evento de impressão.

Para métricas de sessão e visitante, são as cinco principais entidades contadas dos eventos de impressão da sessão/visitante.

Métricas de impressão

As métricas de impressão são calculadas de acordo com os pré-requisitos. Os eventos de conversão (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 precisa aparecer nos resultados do evento de impressão.

  • O evento de conversão está dentro da janela de tempo necessária após a ocorrência do evento de impressão. Janelas de tempo de conversão diferentes se aplicam a diferentes tipos de eventos de conversão.

    Caminho de conversão Período da 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 parcela 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 na pesquisa
add_to_cart_unit_from_search Número de unidades adicionadas ao carrinho na pesquisa
purchase_unit_from_search Contagem de unidades compradas na 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 solicitações de pesquisa com a personalização ativada
search_request_personalization_result_served Contagem de solicitações de pesquisa veiculadas com resultados personalizados.

Procurar métricas de impressã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 na navegação
add_to_cart_unit_from_browse Contagem de unidades adicionadas ao carrinho na navegação
purchase_unit_from_browse Contagem de unidades compradas na navegação
revenue_from_browse Receita da navegação
browse_event_without_result Contagem de eventos de navegação que não geram resultados
browse_request_personalization_enabled Contagem de solicitações de navegação com a personalização ativada
browse_request_personalization_result_served Contagem de solicitações de navegação veiculadas com resultados personalizados.

Métricas de sessão

Uma sessão é definida como um período contínuo de interação entre um usuário e o sistema. Qualquer evento de usuário marca o início de uma sessão, e o fim de uma sessão é marcado quando nenhum outro evento ocorre nos próximos 30 minutos. A sessão é estendida por mais 30 minutos sempre que um evento do usuário ocorre em uma sessão iniciada. Depois que uma sessão termina, uma nova começa quando o usuário interage com o sistema novamente.

As dimensões que caracterizam as métricas de sessão são definidas conjuntamente por todos os eventos do usuário na sessão. Consulte dimensões de métricas para saber como os valores de dimensão 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. 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 envolvendo uma pesquisa
search_event_in_search_session Contagem de eventos de pesquisa em sessões de pesquisa
browse_event_in_search_session Contagem de eventos de navegação em sessões de pesquisa
detail_page_view_in_search_session Contagem de visualizações de 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 Adicionar ao carrinho: contagem de unidades em sessões de pesquisa
purchase_order_in_search_session Contagem de ordens de compra em sessões de pesquisa
purchase_unit_in_search_session Contagem de unidades compradas em sessões de pesquisa
revenue_in_search_session Receita em sessões de pesquisa
bounce_count_in_search_session Contagem de sessões do visitante que sai do site depois de visualizar apenas uma página em sessões de pesquisa

Procurar métricas de sessão

Uma sessão de navegação é aquela que contém pelo menos um evento de navegação. 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 envolvendo navegação
search_event_in_browse_session Contagem de eventos de pesquisa em sessões de navegação
browse_event_in_browse_session Contagem de eventos de navegação em sessões de navegação
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 unidades adicionadas ao carrinho em sessões de navegação
purchase_order_in_browse_session Contagem de ordens de compra 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 sai do site depois de visualizar apenas uma página em sessões de navegação.

Métricas de visitante

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

As dimensões que caracterizam as métricas do visitante são definidas conjuntamente por todos os eventos do usuário para o visitante. Consulte dimensões de métricas para saber como os valores de dimensão são definidos para o visitante.

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

Métricas de visitantes da pesquisa

Um visitante de pesquisa é alguém que realiza pelo menos um evento de pesquisa. 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 Contagem 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 Contagem de eventos de navegação de visitantes da pesquisa
detail_page_view_from_search_visitor Contagem de visualizações de 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 Adicionar ao carrinho: contagem de unidades de visitantes da pesquisa
purchase_order_from_search_visitor Contagem de ordens de compra 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

Procurar métricas de visitantes

Um visitante de navegação é aquele que realiza pelo menos um evento de navegação. 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 Contagem de visitantes que fazem pelo menos uma navegação
search_event_from_browse_visitor Contagem de eventos de pesquisa de visitantes que navegam
browse_event_from_browse_visitor Contagem de eventos de navegação de visitantes
detail_page_view_from_browse_visitor Contagem de visualizações da página de detalhes de visitantes da navegação
add_to_cart_from_browse_visitor Contagem de eventos "Adicionar ao carrinho" de visitantes que navegam
add_to_cart_unit_from_browse_visitor Adicionar ao carrinho: contagem de unidades de visitantes que navegaram
purchase_order_from_browse_visitor Contagem de pedidos de compra de visitantes da navegação
purchase_unit_from_browse_visitor Contagem de unidades compradas por visitantes da navegação
revenue_from_browse_visitor Receita de visitantes que navegam

Exemplo de uso

Se você copiar ou exportar os dados de métricas para outro destino, use o SQL para receber informações gerais ou específicas sobre as métricas exportadas. Algumas maneiras comuns de analisar as métricas exportadas usando SQL são fornecidas nas seções a seguir.

Calcular a taxa de cliques (CTR)

Calcule a CTR da pesquisa por data, tipo de dispositivo e 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

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

Receba eventos de visualização de página de detalhes que vêm de eventos de navegação para tráfego do Google com external_experiment_ids contendo test_arm e mostre todas as informações de dimensão. 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)

Receber as configurações de veiculação mais usadas

Receba as configurações de exibição mais usadas entre "2023-10-01" e "2023-11-01" para o tráfego do Google. Cada evento de pesquisa precisa ter uma configuração de exibiçã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