ProtoGAExtractor

ProtoGAExtractor

Download ProtoGAExtractor v0.2a

Download
ProtoGAExtractor v0.4a

ProtoGaExtractor é uma ferramenta desenvolvida em Excel/VBA para facilitar a extração de dados de Google Analytics para o Excel através da API oficial do Google Analytics, facilitando a automatização de relatórios e a exploração de dados de maneira simples e intuitiva. Por ser desenvolvida totalmente em VBA, a ferramenta não exige a instalação de nenhum plugin e pode ser utilizada sem nenhuma permissão especial do Windows.

Licença:

O ProtoGAExtractor é software livre, distribuído sob a GPL License, que pode ser encontrada em: http://www.gnu.org/licenses/gpl.html

 

Features:

  • Utiliza a API oficial do Google
  • Não recebe nem guarda dados de acesso como nome de usuário ou senha
  • Criar e armazenar queries
  • Execução sequencial de queries
  • Permite consultas a diversas contas/propriedades/visualizações de maneira rápida
  • Armazena permissões, permitindo o compartilhamento de relatórios automatizados sem compartilhar senha ou acessos do GA
  • Flexibilidade com fórmulas do Excel: consultas podem ter datas e outros dados alterados automaticamente
  • Não requer a instalação de plugins
  • Permite a automatização de relatórios
  • Funciona com os cálculos automáticos desativados (permite cálculo antes de cada query)
  • Informa se houve sampling nos dados
  • Interface bilingue: pode ser alterada entre Português e Inglês

 

Guia rápido de uso:

  1. Ao abrir o arquivo pela primeira vez você estará na planilha “Configuração Geral”
    1. Clique no botão “login” para iniciar o login no Google
    2. Uma janela de browser será aberta. Utilize-a para fazer login no Google e autorizar o aplicativo
    3. Após autorizar o aplicativo, você será apresentado a um código. Copie-o e cole-o na janela que está aberta no Excel.
  2. Após o Login, vá para a aba “Contas & Views” para selecionarmos a Visualização de onde os dados deveráo ser tirados
    1. Clique em “Selecionar Visualização”
    2. Na janela que aparecer, selecione uma Conta na coluna esquerda
    3. Na coluna do meio, selecione uma Propriedade
    4. Na coluna da direita, selecione uma Visualização
    5. Clique em OK
  3. De volta à planilha, clique em “Criar nova query com os dados selecionados”
    1. Na janela de diálogo que aparecer, crie um nome para a nova consulta e clique em “OK”
      • Você será enviado para a planilha “Queries Salvas”, onde uma nova linha na tabela de consultas terá sido criada
    2. Preencha os campos “Data Inicial”  e “Data Final” com as datas de que deseja pegar os dados
    3. Preencha o campo “Métricas” com as métricas que deseja utilizar
      • As métricas devem seguir a nomenclatura da API, começando sempre em “ga:” e separadas por vírgulas
      • Ex: ga:sessions,ga:timeOnSite
      • A lista completa das métricas e dimensões pode ser vista aqui: Dimensions & Metrics Explorer
    4. Opcionalmente, preencha o campo “Dimensões” com as dimensões que desejar
    5. Preencha o campo “Planilha de Destino” com o nome da planilha onde você deseja que os dados sejam impressos
      • Se a planilha não existir, ela será criada
      • Planilhas com nomes iguais, mas capitalizações diferentes podem causar erros
    6. Preencha o campo “Célula de Destino” com a célula onde os dados deverão começar a ser impressos
      • EX: B7
      • Caso já haja dados nas células necessárias para imprimir os dados, eles serão sobreescritos
    7. Selecione uma opção para “Imprimir Cabeçalhos”, “Limpar Área” e “Recalcular antes de executar”
    8. Salve o documento
    9. Marque o espaço “executar?” com um texto qualquer caso deseje que a consulta seja executada
    10. Clique no botão “Executar todas as consultas” para puxar os dados.

 

Utilização avançada:

  • Filtros
    • Para utilizar filtros, basta preencher o campo “Filtros” com uma condição para filtrar os dados
    • Condições são do formato:
      <ga:campo><operador><expressão>
      Onde:

      • <ga:campo> é uma dimensão ou métrica
      • <operador> é um operador de comparação
        • Operadores de comparação válidos são:
          • Para métricas:
            • == exatamente igual
            • != diferente
            • > maior que
            • < menor que
            • >= maior ou igual a
            • <= menor ou igual a
          • Para dimensões:
            • == exatamente igual
            • != diferente
            • =@ contem
            • !@ não contem
            • =~ bate com expressão regular
            • !~ não bate com expressão regular
      • <expressão> o filtro desejado
    • Ex:
      • Para Métricas:
        • ga:sessions>100
        • ga:timeOnSite<120
      • Para Dimensões:
        • ga:pagePath=~/produto/.+
        • ga:source=@google
    • Filtros podem ser agrupados, para isso, basta escrever dois filtros em sequência utilizando-se um separador:
      • ; quando os dois filtros devem ser obrigatoriamente cumpridos (e)
      • , quando apenas um dos filtros ser cumprido é o bastante (ou)
      • Ex:
        • ga:landingPagePath=~/produto/.+;ga:source=@facebook
          a página de entrada do usuário deve bater com a expressão regular “/produto/.+” e a origem da visita deve conter “facebook”
        • ga:landingPagePath=~/produto/.+,ga:source=@facebook
          a página de entrada do usuário deve bater com a expressão regular “/produto/.+” OU a origem da visita deve conter “facebook”
      • Até cinco filtros podem ser aplicados em uma única consulta
    • A referência completa dos filtros pode ser encontrada em: https://developers.google.com/analytics/devguides/reporting/core/v3/reference#filterSyntax
  • Segmentos

 

Limitações conhecidas:

  • Funciona somente em Windows
  • Está restrito aos limites da API do Google Analytics
  • Não é capaz de exportar mais de 1.048.575 linhas em uma única consulta
  • Requer conhecimento dos nomes de métricas e dimensões
  • Planilhas com nomes em capitalizações diferentes podem causar problemas
    • Ex: “Visitacao” e “VISITACAO” são planilhas diferentes para o sistema, que irá travar se uma já existir e ele tentar cirar a outra.

Back to Top