189 Usuários online agora
189 Usuários online agora
Bem-vindos à Comunidade Oficial do Google Analytics
Aprenda com artigos escritos por nossos usuários especialistas
star_border

Uso da API Google Analytics para geração de relatórios automatizados

A API do Google Analytics nos permite extrair dados de forma automática para fazer nossas analises, criar gráficos e criar relatórios personalizados.

 

Quero compartilhar com vocês, uma maneira de extrair dados do Google Analytics para uma planilha do Google Docs e gerar seus relatórios e gráficos automaticamente. Com essa API conseguimos montar relatórios automatizados online.

 

Bem, vamos ao que interessa.

 

Abra seu Google Drive e crie uma do planilha Google Docs.

 

criar_planilha.png 

 

 

Com a Planilha aberta clique em Ferramentas >> Galeria de Scripts.

 

 

galeria_de_scripts.png

 


Abrirá um modal, na caixa de pesquisa, busque pelo script Google Analytics Report Automation (magic) e clique em Instalar, seu script deverá ficar conforme imagem abaixo:

 

galeria_de_scripts_1.png

 

Após instalar esse script, precisamos ativar a API do Google Analytics, para ativar clique em Editor de Scripts na sua planilha Google Docs.

 

editor_de_scripts.png

 

Em seguida, abrirá uma nova guia com o Editor de Script e o Script Google Analytics Report Automation (magic) aberto para edição.

 

Com o Editor de Script aberto, clique no menu Recursos >> Serviços Avançados do Google conforme imagem abaixo para selecionar e ativar o Google Analytics API.

 

editor_de_scripts_2.png

 

Abrirá um novo modal com todas as API de serviços disponíveis, selecione a Google Analytics API que esta com o status desativado e ative conforme imagem abaixo:

 

servicos_avançados_google.png

Após ativar o Google Analytics API, clique em Console do Google Developers que abrirá uma nova guia chamada Google Developers Console, onde você deverá ativar a Analytics API. Conforme imagem abaixo:

 

developers.png

 

 

No botão que esta com o valor OFF clique para ativa-lo. Após clicar nesse botão ele ficará verde com o valor ON. Após esse processo pode fechar a guia e voltar para o Editor de Scripts.

 

Clique em Ok e feche o Editor de Scripts e volte para sua Planilha e atualize a página (F5). Após

atualização, no menu da Planilha aparecerá um menu Google Analytics. Conforme imagem abaixo:

 

planilha.png

 

Agora sim estamos prontos para extrair os dados do Google Analytics diretamente para nossa planilha do Google Docs com apenas um clique. Basta algumas configurações e pronto!

 

Clique no menu Google Analytics >> Create Core Report.

 

 

create_core_report.png

 

Após clicar em Google Analytics >> Create Core Report aparecerá uma janela pedindo autorização, igual o processo de autorização de Scripts do Google Adwords. Clique em Ok e de a autorização necessária para o script acessar a conta.

 

autorização.png

 

Após autorizar o script, o mesmo criará uma sheet chamada gaconfig com alguns dados conforme imagem abaixo:

 

dados_core.png

 

Na linha 3 selecione e celula vazia ao lado do valor ids. Agora clique em Google Analytics >> Find Profile / ids.

 

find ids.png

 

Após clicar Google Analytics >> Find Profile / ids abrirá um modal onde você escolherá a conta do Google Analytics que você deseja extrair os dados. Copie o valor ids do modal e cole na celula vazia ao lado do ids (Linha 3).

 

find ids 2.png

 

 

Sua planilha deverá ficar como a imagem abaixo.

 

 

planilha2.png

 

 

Agora vamos as configurações do gaconfig.

 

 

query1 value1 Descrição
type core  
ids ga:77901219 ID da Conta (ids)
start-date 01/12/2013 Data de inicio
end-date 31/12/2013 Data Final
last-n-days 30 Últimos dias
metrics ga:visitors,ga:visits,gaLíngua do Smileyageviews Metricas do Google Analytics
dimensions ga:date Dimensões
sort -gaLíngua do Smileyageviews Ordenar pelas métricas
filters   Filtros
segment   Segmentos
max-results   Limite o máximo de dados por GET.
sheet-name Relatório Teste Nome da Sheet

 

 

Configure as métricas, dimensões, filtros e segmentos conforme suas necessidades.

 

Após todas as configurações clique no menu Google Analytics >> Get Data.

 

planilha3.png

 

 

Clicando em Get Data o script irá criar uma sheet automaricamente com os dados e o nome que você especificou nas configurações da sheet gaconfig.

 

Seguindo o exemplo acima ficará algo parecido com a imagem abaixo:

 

planilha4.png

 

Pronto!!! Agora temos os dados em uma Planilha do Google Docs, onde podemos tratar os dados conforme nossa necessidade. Podemos criar gráficos e manipular os dados com a facilidade da Planilha.

 

planilha5.png

 

Lembrando que esse gráficos podem ser publicados e implementados em qualquer lugar para suas apresentações de resultados. Basta clicar na setinha no canto superior direito do gráfico e clicar em Publicar Gráfico, onde aparecerá um modal com o script para você copiar e implementar onde desejar. Lembrado que toda vez que os dados forem atualizados na sua Planilha os dados do gráficos atualizarão automaticamente. Excelente né?

 

grafico script.png

 

 

Agora você deve estar perguntando. Tive todo esse trabalho para ficar clicando em Get Data para atualizar os meu dados?

 

Claro que não!!!

 

Abrindo o Editor de Scripts novamente, clique no menu Recursos >> Todos os acionadoresplanilha6.png

 

Abrirá um modal onde você pode configurar uma programação para execução do seu script. Configure com a frequência que desejar. Confira a imagem abaixo:

 

 

planilha7.png

 

Nesse exemplo, esta configurado para atualizar a cada uma hora, mas existem outras opções de ajustes. Use e abuse!!!

 

Agora você tem uma planilha que extrai dados do Google Analytics automaticamente e atualiza a cada uma hora seus dados e gráficos.

 

Monte a sua e planilha e seus gráficos, implemente na sua página e monte seu Dashboard online com a facilidade da API do Google Analytics e a elegância dos gráficos do Google.

Sobre Ricardo Gaya

Atualmente trabalho com consultoria de Digital Analytics, mas já atuei em áreas como mídia performance, web analytics/BI e data strategy. Sou apaixonado por open source, Google Analytics, Google Tag Manager, meu cachorro e comida (adoro comer). Desenvolvedor web por diversão, há alguns anos tentando aprender alguma coisa.

Comentários
por Nuno-Mota Principal Colaborador
Janeiro 2014

OIa Ricardo,

 

Excelente seu post sobre Analytics! Parabens e obrigado por partilhar.

 

 

por JoseDantas Principal Colaborador
Janeiro 2014

Show Ricardo!

 

Parabéns!

por JurandirGustavo
Janeiro 2014

Ricardo, fantástico! Muito obrigado por compartilhar, vai ajudar muita gente e vai otimizar muito o tempo.

por Jane-Audrei Principal Colaborador
Janeiro 2014

Ricardo !!

 

Gostei bastante! É sempre legal ter essas análises mais técnicas para nós estudarmos.

por BSI B
Janeiro 2014

Ricardo, eu gostaria de configurar as métricas como ga:month, teria algum exemplo?

por Ricardo-Gaya Principal Colaborador
Fevereiro 2014

BSI,

 

Tudo bem?

 

Sim, você consegue utilizar dimensions - ga:month normalmente. Entretanto, o periodo estipulado start-date e end-date deve ser maior que um mês. Caso contrário, daria erro de script.

 

Qualquer outra dúvida é só mandar.

 

Valeu pessoal!!!

 

Abraço.

por DaniloSPeres Estrela em Ascensão
Fevereiro 2014

Show de Bola Ricardo, amanhã já irei começar os testes =)

Não tem também uma forma de automatizar dados do Adwords no Drive? Olha eu pedindo demais, pode ser outro artigo seu.

por Ricardo-Gaya Principal Colaborador
Fevereiro 2014

Danilo, boa tarde.

 

Na verdade tem sim!!! Tem até um exemplo no Google Developers.

 

Exportar o relatório diário para a planilha do Google

 

E se der uma olhada em Serviços do Google AdWords, você verá varias entidades que da para usar.

 

Usando scripts do Adwords é possivel integrar o programa com a maioria dos produtos Google.

 

Esse exemplo que dei da API do Google Analytics eu uso para montar reports para contas do Adwords. Com as contas do GA e Adwords vinculadas é possível montar reports de campanhas automatizados trocando para as métricas que desejar.

 

 

 

 

 

 

por Ricardo-Gaya Principal Colaborador
Fevereiro 2014

Danilo,

 

Segue algumas métricas de Adwords que podem ser usadas nesse mesmo exemplo.

 

ga:medium, ga:source, ga:adClicks, ga:adCost, ga:impressions, ga:keyword, ga:adGroup, ga:campaign, ga:adSlotPosition e ga:adDestinationUrl. 

 

Lembrando que as contas devem estar vinculadas.

por Alex T
Maio 2014

Cara, muito show esse seu artigo. É super útil, principalmente se temos que gerenciar muitas contas. Podemos gerar automaticamente os relatórios referentes a cada conta e depois fazermos as análises sem termos de entrar em uma conta por vez. muito bom cara, parabéns, agilizou em muito nossa vida esse artigo!!!

 

VLW...

 

Att.: Alex Tigre - Brazuca Agência Digital - www.brazucadevweb.com.br

 

Whatsapp: 8487829006

por Solange T
Setembro 2014

Pessoal, 

 

Fui seguir o passo a passo e apareceu esta mensagem:

por Rafael B
Novembro 2014

Ricardo,

 

Parabéns pelo artigo, ficou muito legal.

 

Essa documentação é de extrema importancia para nós que não somos programadores e temos certa dificuldade em trabalhar com API.

 

Porém, hoje dia 24/11/2014 fui tentar montar o relatório conforme suas instruções e notei que já houve modificações nas etapas. Uma delas é a Galeria de Scripts por exemplo.

 

Gostaria de pedir seu auxilio em revisar as etapas deste conteúdo e nos presentear com este artigo mais atualizado, seria possivel ? Neste momento seria muito útil para min. 

 

Muito obrigado

 

Abs

por Ricardo-Gaya Principal Colaborador
Novembro 2014

Rafael, boa tarde.

 

Tudo bem?

 

Que bom que tenha gostado. Realmente esta desatualizado! O Google fez algumas mudanças na Galeria de Scripts e também atualizou outras no Drive.

 

Vou atualzar o artigo com essas novas modificações do Google. Pelo que eu estava vendo ficou mais simples de integrar as ferramentas. Acredito que ainda essa semana esteja atualizado, pois estou com algumas demandas urgentes por aqui. Smiley feliz Vou verificar todas as etapas e testa-las.

 

Abraço.

por Diego F
Novembro 2014

Eai Pessoal! Alguém já usou filtros nesse report automation? Estou procurando algum caso mas não achei.

por Clayton Miranda
Agosto 2015

Muito bom, Ricardo!

Está pensando em formas de apresentar dados de forma simples e sempre atualizável.

Essa foi a mais prática que encontrei. Obrigado por compartilhar!

 

Abraços 

por Rafael O
Janeiro 2016

Olá Ricardo, muito bom seu artigo!

Fui tentar fazer mas acho que teve alguma atualização no Gdocs, pois ao tentar instalar o Script ele mostra que agora a opção está em complementos. Porém indo lá não aparece a opção do "Google Analytics Report Automation" apenas a opção do Google Analytics, porém essa sem as opções do artigo, sabe se tem ainda como instalar essa outra API?

 

Abrs!

por Ricardo-Gaya Principal Colaborador
Janeiro 2016

Rafael, tudo bem? 

 

Sim, houve atualizações no Google Drive e mudou muita coisa. Vou atualizar artigo. Smiley feliz

 

Agora ficou bem mais fácil, para instalar você acessa o menu Complementos >> Instalar complementos >> Google Analytics. O complemento Google Analytics faz a mesma coisa e tem a mesma configuração de setup de relatórios. 

 

A etapa de ativar a API do Google Analytics não é mais necessária hoje, com as atualizações, o Google integrou com o complemento do Google Analytics e hoje não precisamos mais fazer aquele caminho torduoso de ativar API. Smiley feliz É só instlar o complemento e usar e abusar do seus relatórios!

 

 

por Marcelo R
Janeiro 2016

Olá Ricardo,

 

  obrigado por compartilhar. Consegui me virar com sua ajuda oportuna. Valeu

 

 

Marcelo

por IETEC I
Maio 2016

Olá Ricardo-Gaya,

 

parabéns pelo post!

Foi muito útil para mim.

Obrigado por compartilhar o conhecimento.

 

Estou com um problema. Ao configurar um relatório para obter dados do Adwords, não consegui visualizar as publicidades feitas na rede de display (remarketing) na dimensão ga:adMatchType, pois só são exibidos as publicidades de rede de pesquisa.

 

É possível resolver isso?

por Ricardo-Gaya Principal Colaborador
Maio 2016

@IETEC I, tudo bem?

 

Obrigado! Smiley feliz

 

Então sobre essa dimensão não acho que não bem a que você quer usar. Da uma olhadinha aqui nessa documentação sobre dimensões e métricas.

 

https://developers.google.com/analytics/devguides/reporting/core/dimsmets

 

Aqui tem todas e muitas que na maioria das vezes nem utilizamos no dia a dia. Smiley feliz Se não resolver posta aqui que tentamos ajudar. 

 

Abraço.

 

 

por Bruno C
Julho 2016 - editado pela última vez Julho 2016

Muito legal este conteúdo, parabéns ! Imagina aliar esta técnica de coleta automatizada de dados relacionando informações como Metas, Tags UTM etc; teremos super-poderes! Smiley feliz Smiley feliz  


 

por Luiz G
um mês atrás

Gostaria de pegar o numero de paginas indexadas e suas datas respectivamente. Ou ainda grafico de paginas indexadas.

 

ja consultei o doc não encontrei nada referente a isso.

 

existe a possibilidade?

 

obrigado

por Ricardo-Gaya Principal Colaborador
um mês atrás

@Luiz G, tudo bem?

 

Não entendi quais seriam essa páginas? Qual API você esta utilizando? Pode me fornecer mais informações? 

 

Abs

por Luiz G
um mês atrás

os dados que eu preciso é o grafico de paginas indexadas.

 

ja utilizei algumas api do google como o search porem so consegui pegar as impressoes ordenadas por data.

 

gostaria de pegar todos os dados do grafico via alguma api ou web crawler.

 

a documentação de diversas api do google não apontam um possibilidade de retorno do numero de paginas indexadas e suas respectivas datas.

 

existe uma alternativa?

 

obrigado.