Pete Frisella, mediador de desenvolvedores do Google Analytics – julho de 2013
Este documento fala sobre o superProxy do Google Analytics e explica como dar os primeiros passos e usar recursos específicos, além de discutir considerações importantes.
Introdução
O superProxy do Google Analytics permite compartilhar publicamente seus dados de relatórios do Google Analytics. Você pode usá-lo para alimentar seus próprios painéis e widgets personalizados, transformar respostas em vários formatos, realizar testes e muito mais.
O superProxy do Google Analytics funciona com a API de relatórios principais, a API de relatórios em tempo real e a API de relatórios de funis multicanal.
Destaques do recurso:
- Compartilhe publicamente seus dados do Google Analytics.
- Use o proxy para alimentar seus próprios painéis personalizados.
- Converta em CSV, tabela de dados, TSV.
- Datas relativas são suportadas (por exemplo, últimos sete dias).
- Atualiza automaticamente os dados de relatório.
- armazenamento em cache - respostas rápidas e uso da cota eficiente.
Como funciona
Crie uma consulta para os dados do Google Analytics, e esses dados de relatório específicos estarão disponíveis ao público em um novo URL que você pode compartilhar. Qualquer pessoa que visitar o URL terá acesso aos dados de relatório sem precisar de nenhuma autorização.
Por exemplo, você pode criar uma consulta para recuperar os 10 melhores navegadores com base nas exibições de página da semana passada, uma consulta para o número de sessões de ontem e assim por diante. Você decide quais consultas deseja tornar públicas e com que frequência os dados devem ser atualizados, e o superProxy do Google Analytics cuida do resto.
Dica: você pode usar o Query Explorer para gerar relatórios e depois copiar o Query URI para usar com o superProxy do Google Analytics
Configuração e criação de uma consulta
O superProxy do Google Analytics é um aplicativo da Web executado no ambiente do Google App Engine. Para fazer o download e implantar esse aplicativo, siga um simples conjunto de instruções.
Gerenciamento de usuários
O superProxy do Google Analytics inclui uma interface de gerenciamento de usuários simples que você pode usar para adicionar usuários. Cada usuário só pode listar e gerenciar as consultas de API criadas por ele.
Apenas os administradores podem gerenciar usuários. Para adicionar um novo usuário:
- Na interface de administração do superProxy do Google Analytics (por exemplo,
https://your-application-id.appspot.com/admin), clique no botão Gerenciar usuários. - Na página Gerenciar usuários, insira o endereço de e-mail do usuário que você deseja adicionar e clique no botão Adicionar usuário. O usuário será adicionado, mas não terá acesso até ativar a conta.
- Peça ao usuário para ativar a conta acessando a
página
/admin/activate. Por exemplo,https://your-application-id.appspot.com/admin/activate. Ele precisará estar conectado à Conta do Google associada ao e-mail adicionado para que a ativação funcione. - Depois de ativar a conta, o usuário poderá visitar a página
/admin, autorizar o acesso à conta do Google Analytics e começar a criar as próprias consultas de API.
Usuários administradores
Os usuários administradores do superProxy do Google Analytics são adicionados usando o console de administração do App Engine. Qualquer usuário adicionado por meio desse console, de qualquer função, será um administrador.
Os administradores podem listar e gerenciar consultas de API de qualquer usuário.
Restrições de domínio
Em alguns casos, convém aproveitar os recursos oferecidos pelo superProxy do Google Analytics, mas não torne nenhum dado público além de um determinado conjunto de usuários ou domínio. Por padrão, para qualquer aplicativo sem custo financeiro hospedado no Google App Engine, qualquer pessoa conectada com uma Conta do Google pode acessar seus pontos de extremidade públicos.
Se você quiser restringir ainda mais o acesso ao aplicativo, implemente sua própria camada de autenticação na frente do superProxy do Google Analytics ou use o G Suite, que permite restringir um aplicativo aos usuários gerenciados pelo seu domínio. Consulte Como configurar a autenticação do seu aplicativo para ver mais detalhes.
Considerações de cota
O superProxy do Google Analytics ajuda você a economizar cota exibindo dados de relatórios do cache/armazenamento de dados. No entanto, definir intervalos de atualização curtos ainda poderia consumir a cota rapidamente. Para evitar isso, atualize as consultas em um intervalo razoável para o tipo de dados que está sendo solicitado.
App Engine
Os limites de cota padrão sem custo financeiro para aplicativos do Google App Engine são generosos e provavelmente suficientes para a maioria dos casos de uso. No entanto, você pode ativar o faturamento para aumentar ou remover os limites padrão. Consulte Cotas do App Engine para detalhes.
Comunidade e rastreador de problemas
O fórum do superProxy do Google Analytics é um grupo de discussão em que você pode fazer perguntas, compartilhar ideias e receber feedback sobre seus projetos impressionantes.
O rastreador de problemas é o lugar onde você pode relatar e acompanhar problemas e solicitações de recursos do superProxy do Google Analytics.