Acessar relatórios personalizados do Google Analytics no BigQuery

Neste guia, explicamos como acessar relatórios personalizados do Google Analytics no BigQuery usando o complemento Planilhas Google Analytics e o conector do BigQuery do Google Drive.

Este guia mostra como gerar um relatório personalizado usando o complemento das Planilhas Google Analytics, expor a planilha de resultados do relatório como uma tabela externa do BigQuery e consultar os dados do relatório no BigQuery.

Este guia usa o Relatório de aquisição de usuários como exemplo, mas você pode aplicar essas etapas a qualquer tipo de relatório.

Etapa 1: configurar um relatório personalizado nas Planilhas Google

1. Instale o complemento das Planilhas Google para o Google Analytics no Google Workspace Marketplace.

2. Abra a caixa de diálogo Extensions → GA4 Reports Builder for Google Analytics → Create new report.

   

3. Para configurar o relatório, especifique a propriedade do Google Analytics, o período e os campos do relatório.

4. Use os seguintes campos para o relatório "Aquisição de usuários":

   Dimensões

   • firstUserDefaultChannelGroup

   Métricas

   • eventCount
   • keyEvents
   • totalRevenue
   • newUsers
   • engagedSessions
   • engagementRate

5. Deixe os campos Filtros de dimensões e Filtros de métricas vazios.

   Esta é uma imagem das configurações corretas do relatório:

   

   

   

6. Clique em Criar relatório para definir a configuração no documento do Planilhas atual:

   

7. Selecione Extensões → Criador de relatórios do GA4 para Google Analytics → Executar relatórios para gerar o relatório. Uma nova guia com o nome do seu relatório será criada assim que ele for concluído.

   

8. Abra a caixa de diálogo Extensões → Criador de relatórios do GA4 para Google Analytics → Programar relatórios para configurar a pesquisa periódica dos dados dos relatórios mais recentes. Especifique a programação e clique em Salvar.

   

Etapa 2: conecte um documento de relatório do Planilhas Google como uma tabela externa do BigQuery

Com o BigQuery, você pode criar uma tabela permanente vinculada à sua fonte de dados externa no Planilhas Google. Use esse recurso para conectar a planilha de relatório do Google Analytics criada na etapa anterior como uma tabela externa do BigQuery.

Esta etapa requer a sequência do guia Criar tabelas externas do Google Drive na documentação do BigQuery.

Console do Google Cloud

1. No Console do Google Cloud, abra a página do BigQuery.

   Ir para o BigQuery

2. No painel Explorer, expanda o projeto e selecione um conjunto de dados.

3. Expanda a opção Ações e clique em Abrir.

4. No painel de detalhes, clique em Criar tabela .

5. Na página Criar tabela, na seção Origem:

   • Em Criar tabela de, selecione Drive.

   • No campo Selecionar URI do Drive, insira o URI do Drive do documento da planilha Google que contém o relatório, no formato https://docs.google.com/spreadsheets/d/[file_id].

   • Em Formato de arquivo, selecione Planilha Google.

6. Na página Criar tabela, na seção Destino:

   • Em Nome do conjunto de dados, escolha o conjunto de dados apropriado e, no campo Nome da tabela, insira o nome da tabela que você está criando no BigQuery.

   • Verifique se o Tipo de tabela está definido como Tabela externa.

7. Na caixa Intervalo da planilha, especifique o nome da planilha e o intervalo de células a serem consultados. Esta é a página que contém os dados do relatório: sheet_name!top_left_cell_id:bottom_right_cell_id para um intervalo de células. No nosso exemplo de relatório, o intervalo pode ser especificado como User acquisition report!A:G. Observe como a planilha correspondente ao nome do relatório personalizado é mencionada no intervalo.

8. Na seção Esquema, ative a opção Detectar automaticamente.

9. Abra a seção Opções avançadas e, na caixa Linhas de cabeçalho a serem ignoradas, especifique o número de linhas a serem omitidas. No nosso exemplo, os dados do relatório começam com a linha 15, que é o valor que precisa ser definido na caixa de entrada.

10. Na página Criar tabela, na seção Destino:

    • Em Conjunto de dados, escolha o conjunto de dados apropriado e, no campo Tabela, insira o nome da tabela que você está criando no BigQuery.

    • Verifique se o Tipo de tabela está definido como Tabela externa.

11. Em seguida, clique em CRIAR TABELA.

12. Se necessário, selecione sua conta e clique em Permitir para que o Google Drive possa acessar as ferramentas de cliente do BigQuery.

Confira um exemplo de tela de configuração de uma tabela externa do BigQuery:

Etapa 3: consultar uma tabela de relatório das Planilhas Google no BigQuery

Agora é possível fazer uma consulta na tabela de relatórios das Planilhas Google como se ela fosse uma tabela padrão do BigQuery, sujeita às limitações em fontes de dados externas.

1. Abra a tabela user_acquisition_report para inspecionar o esquema dela:

   

2. Clique em Consulta. Na consulta sugerida, mude SELECT FROM para SELECT * FROM para receber todos os campos do relatório e, em seguida, Executar consulta para executar uma consulta na tabela externa.

A consulta no exemplo a seguir vai gerar um snippet de dados na tabela para todas as colunas: