Google Analytics 4 API – Acesso, gerar dados GA usando Python

O tutorial do Python informa como conectar a API do Google Analytics usando Python, extrair os dados necessários e atualizar os dados no Google Sheets

As plataformas de análise da web são indispensáveis ​​para qualquer empresa hoje em dia, e o Google Analytics é a mais popular. Anteriormente, compartilhei como extrair os dados de SEO do console de pesquisa do Google para o painel do Planilhas Google. Você pode dizer que esse conjunto de dados carece de muitas outras dimensões e métricas. Em particular, você administra uma loja de comércio eletrônico e os dados de conversão são essenciais para você.

Neste tutorial de Python, mostrarei como conectar a API do Google Analytics usando Python e extrair os dados necessários. Ao final deste artigo, você aprenderá quais dimensões e métricas você chama via API no script Python. Além disso, você pode integrar esta atualização automatizada ao painel do Planilhas Google. Você pode ter equipamentos mais completos e visão dimensional.

Índice: Integração da API do Google Analytics 4 usando Python

Tutorial mais popular do Google Analytics 4 Fundamental e Avançado Couresa

  1. Google Analytics 4 fundamentos
  2. Google Analytics 4 avançado

Ativar API do Google Analytics 4

Primeiramente, precisamos habilitar a API do Google Analytics no desenvolvedor de APIs. Basta pesquisar no Google Analytics na biblioteca e você encontrará a API da versão GA V4. Este é o método programático mais avançado e você pode usá-lo para criar um painel personalizado

Assim como outros scripts de API do Google, você precisa criar uma credencial e uma chave para baixar o arquivo JSON. Na verdade, você pode continuar a usar a credencial e a chave do projeto do console de pesquisa do Google que criou no capítulo anterior.

Além do mais, você faz login em sua conta do Google Analytics e adiciona o e-mail do robô API ao gerenciamento de acesso de visualização na seção de administração. Assim, o robô pode ter acesso ao seu GA.

Configure o escopo e as credenciais do Google Analytics no script Python

Se lermos os dados do GA, o escopo da API do Google Analytics é o URL anexado abaixo. E também exige que adicionemos o URL do serviço de descoberta no método de construção

https://www.googleapis.com/auth/analytics.readonly

service = build('analytics', 'v4', credentials=credentials, discoveryServiceUrl=('https://analyticsreporting.googleapis.com/$discovery/rest?version=v4'))

É um formato JSON, como o feed de dados de produtos do Shopify. Basicamente, esta é a estrutura de dados abertos do GA que podemos extrair. Por último, mas não menos importante, a criação da variável de chave da API e das credenciais é tão boa quanto outros scripts de APIs do Google.

Use report() e batchGet() para estruturar o escopo de dados

A API do Google Analytics possui dois métodos de nível superior. Uma é a pesquisa e a outra é o batchGet. Dentro do método, podemos informar ao GA quais contas iremos acessar e quais dimensões de dados desejamos. E no bloco de escopo de dados, basicamente, você precisa ter esses valores.

response = service.reports().batchGet(
body={
'reportRequests':[
{
'viewId': 'xxxxxxxxx',
'dateRanges': [{'startDate': '2021-06-01','endDate': '2021-06-30'}],
'metrics': [{'expression': 'ga:goalCompletionsAll'}],
'dimensions': [{"name": "ga:landingPagePath"}],
'orderBys': [{"fieldName": "ga:goalCompletionsAll", "sortOrder": "DESCENDING"}],
'pageSize': 20
}]
}
).execute()

  • viewId : esta é sua conta GA e o ID de visualização de propriedade específico. Por favor, não confunda com o ID de rastreamento. A localização do ID da visualização deve estar aqui, como na captura de tela anexada.
  • dateRanges : você pode definir a data de início e a data de término dos seus dados. Esta seção é igual ao período selecionado no GA
  • Metrics and Dimensions : a métrica é definida como os dados específicos que você está extraindo, como sessões, transações, tempo no site, etc. A dimensão é definida como a perspectiva macro que você está analisando, como nível de país, dispositivo, páginas, etc. Para obter mais detalhes sobre o valor que você pode usar na documentação, consulte o UA Dimensions & Metrics Explorer
  • orderBys : Esta é a configuração de ordem decrescente ou crescente. Basicamente, usamos isso para classificar os dados de métricas que definimos acima
  • pageSize : você não precisa buscar todos os dados todas as vezes e pode configurar o número com base em suas necessidades criando um painel personalizado

Extraia os dados necessários e faça upload para o Planilhas Google

Ao comandar B pelas codificações python acima, ele estará funcionando com APIs GA se o resultado dos dados que você pretende buscar aparecer neste formato. O próximo passo seria criar um loop para extrair o valor sem este formato

Primeiramente, criamos duas variáveis ​​sem valores, A e B. Elas serão utilizadas em instantes. Você pode dizer que todos os dados estão contidos nos relatórios. Portanto, podemos usar o método get() em um loop para extrair o bloco de dados que precisamos primeiro. Esses seriam o cabeçalho da coluna, as dimensões, o metricHeader e as linhas nos relatórios.

for report in response.get('reports', []):

columnSection = report.get('columnHeader', {})
dimensionSection = columnSection.get('dimensions', [])
metricSection = columnSection.get('metricHeader', {}).get('metricHeaderEntries', [])
rows = report.get('data', {}).get('rows', [])

Em segundo lugar, dentro das linhas, existem dimensões e métricas. Você pode descobrir que o valor neste bloco é respectivamente o alvo que iremos extrair. Então precisamos criar um loop chamado row aqui. Está funcionando se você imprimir e os dados aparecerem como a captura de tela anexada.

for row in rows:

dimensions = row.get('dimensions', [])
dateRangeValues = row.get('metrics', [])

Você pode dizer que os dados buscados no momento ainda não estão prontos para upload. Precisamos extrair ainda mais os valores essenciais de que precisamos desse ciclo.

1) Remova o cabeçalho “ga:” e combine duas variáveis ​​para funcionar usando o método zip()

O método zip() do Python cria um iterador que agregará elementos de dois ou mais iteráveis. Você pode usar o iterador resultante para resolver problemas comuns de programação de forma rápida e consistente. Aqui você pode ver que dimensionSection e dimensões são duas variáveis ​​no mesmo caminho para obter o valor final. Portanto, para este loop chamado dimensão, podemos usar o método zip() para executar juntos.

for header, dimension in zip(dimensionSection, dimensions):
A.append(dimension)

2) Extraia o valor da métrica

Ao lidar com iteradores, também precisamos manter uma contagem de iterações. Python facilita a tarefa dos programadores fornecendo uma função integrada enumerate() para esta tarefa. O método Enumerate() adiciona um contador a um iterável e o retorna na forma de um objeto enumerador.

for i, values in enumerate(dateRangeValues):
for metaicHeader, value in zip(metricHeaders, values.get('values')):
B.append(int(value))

3) Enquadre os dados usando Pandas e faça upload para o Planilhas Google usando a API Easy2Digital.

Script Python completo da API Google Analytics 4

Se você deseja ter a versão completa do script Python da API do Google Analytics 4, por favor assine nossa newsletter adicionando a mensagem “Capítulo 20” . Enviaremos o script imediatamente para sua caixa de correio.

Contate-nos

Espero que você goste de ler o Capítulo 20: Acesso à API do Google Analytics 4 usando Python para integração com seu painel de marketing personalizado. Se você fez isso, por favor, apoie-nos fazendo uma das coisas listadas abaixo, porque isso sempre ajuda nosso canal.

  • Apoie e doe para nosso canal através do PayPal ( paypal.me/Easy2digital )
  • Inscreva-se no meu canal e ative o sininho de notificação do canal Easy2Digital no Youtube .
  • Siga e curta minha página Página Easy2Digital no Facebook
  • Compartilhe o artigo em sua rede social com a hashtag #easy2digital
  • Compre produtos com código de desconto Easy2Digital 10% OFF ( Easy2DigitalNewBuyers2021)
  • Você se inscreve em nosso boletim informativo semanal para receber os artigos, vídeos e códigos de desconto mais recentes da Easy2Digital
  • Assine nossa assinatura mensal através do Patreon para aproveitar benefícios exclusivos ( www.patreon.com/louisludigital )

PERGUNTAS FREQUENTES:

P1: O que é a API do Google Analytics 4?

R: A API do Google Analytics 4 é uma interface que permite aos desenvolvedores interagir com os dados do Google Analytics 4 de forma programática.

P2: O que posso fazer com a API do Google Analytics 4?

R: Com a API do Google Analytics 4, você pode recuperar dados de suas propriedades do Google Analytics 4, criar relatórios personalizados, automatizar a extração de dados e integrar dados do Google Analytics com outros aplicativos.

P3: Como faço para acessar a API do Google Analytics 4?

R: Para acessar a API Google Analytics 4, você precisa criar um projeto no Console do Google Cloud, ativar a API Analytics, configurar a autenticação e obter uma chave de API ou token de acesso.

P4: Quais linguagens de programação posso usar com a API do Google Analytics 4?

R: Você pode usar qualquer linguagem de programação que suporte solicitações HTTP e JSON, como Python, Java, JavaScript, PHP, Ruby ou .NET.

P5: Quais dados posso recuperar com a API do Google Analytics 4?

R: A API do Google Analytics 4 permite recuperar uma ampla variedade de dados, incluindo métricas de engajamento do usuário, dados de eventos, dados de conversão, propriedades do usuário e insights do público.

P6: Posso usar a API do Google Analytics 4 para dados em tempo real?

R: Sim, a API do Google Analytics 4 oferece recursos de recuperação de dados em tempo real, permitindo que você acesse informações atualizadas sobre as interações do usuário em seu site ou aplicativo.

P7: Há alguma limitação ou cota para o uso da API Google Analytics 4?

R: Sim, existem certas limitações e cotas impostas pelo Google ao uso da API Google Analytics 4. Isso inclui limites para o número de solicitações por dia, a quantidade de dados recuperados por solicitação e o número de solicitações simultâneas.

P8: Posso modificar dados usando a API do Google Analytics 4?

R: Não, a API do Google Analytics 4 é somente leitura e não permite modificação de dados. Se precisar fazer alterações na configuração do Google Analytics ou enviar dados para sua propriedade, você deve usar a interface de administração ou o protocolo de medição do Google Analytics.

P9: O uso da API do Google Analytics 4 é gratuito?

R: Sim, o uso da API do Google Analytics 4 é gratuito. No entanto, lembre-se de que poderá haver custos associados se você exceder os limites de cota gratuita ou se usar serviços adicionais do Google Cloud em conjunto com a API.

P10: Onde posso encontrar documentação e recursos para a API Google Analytics 4?

R: Você pode encontrar documentação oficial, exemplos de código e outros recursos da API Google Analytics 4 no site do Google Developers.

Perguntas frequentes:

Q1: O que é o Google Analytics?

A: O Google Analytics é uma plataforma de análise de dados que permite que os usuários rastreiem e avaliem o tráfego de seus sites e aplicativos.

Q2: Quais são os recursos principais do Google Analytics?

A: O Google Analytics oferece recursos como rastreamento de dados, análise de tráfego, relatórios personalizados, segmentação de público-alvo e integração com outras ferramentas do Google.

Q3: Como posso configurar o Google Analytics no meu site?

A: Para configurar o Google Analytics no seu site, você precisa criar uma conta no Google Analytics, obter um código de acompanhamento e inseri-lo em todas as páginas do seu site.

Q4: O Google Analytics é gratuito?

A: Sim, o Google Analytics oferece uma versão gratuita com recursos básicos. No entanto, também há uma versão paga, chamada Google Analytics 360, com recursos avançados.

Q5: Quais são os benefícios de usar o Google Analytics?

A: Os benefícios de usar o Google Analytics incluem a compreensão do comportamento dos usuários, identificação de fontes de tráfego, otimização de desempenho do site, melhorias no marketing digital e acompanhamento de metas e conversões.

Q6: Posso usar o Google Analytics em sites móveis?

A: Sim, o Google Analytics pode ser usado em sites móveis. Você pode acompanhar o tráfego e o comportamento dos usuários nos seus aplicativos móveis e sites responsivos.

Q7: É possível integrar o Google Analytics com outras ferramentas do Google?

A: Sim, o Google Analytics pode ser integrado com outras ferramentas do Google, como Google Ads, Google Search Console e Google Data Studio.

Q8: Como posso visualizar os relatórios no Google Analytics?

A: Após configurar o Google Analytics e adicionar o código de acompanhamento ao seu site, você pode acessar os relatórios no painel de controle do Google Analytics. Lá, você encontrará várias opções de relatórios para análise de dados.

Q9: O Google Analytics é compatível com quais navegadores?

A: O Google Analytics é compatível com a maioria dos navegadores populares, incluindo Google Chrome, Mozilla Firefox, Safari e Microsoft Edge.

Q10: Existe suporte técnico disponível para o Google Analytics?

A: Sim, o Google oferece suporte técnico para o Google Analytics. Você pode encontrar recursos de suporte, documentação e fóruns de ajuda no site oficial do Google Analytics.