This document describes the Google Analytics Real Time Reporting API. Para uma referência detalhada da API, leia a referência da API.
introdução
a API de notificação em tempo Real permite—lhe solicitar dados em tempo real—por exemplo, actividade em tempo real na sua propriedade-para um utilizador autenticado.
pode utilizar a API de notificação em tempo Real para:
- exibir visualizadores ativos de uma página e criar um senso de urgência para os usuários que olham para um item com inventário finito.
- exibe o conteúdo mais popular, como as 10 primeiras páginas ativas.
- criar e exibir um painel em tempo real.
Google Analytics superProxy
Use Google Analytics superProxy to handle many of the implementation details of working with Google Analytics APIs on authentication, caching, and transforming API responses to formats used directly with visualization and chart libraries.Os conceitos fundamentais subjacentes à API de reporte em tempo Real são::
- como os relatórios se relacionam com os utilizadores e pontos de vista (perfis).
- a estrutura de um relatório e como construir consultas.
- trabalhar com a resposta da API.
relatórios, utilizadores e visualizações (perfis)
Antes de os utilizadores poderem usar a sua aplicação para solicitar o seu relatório datafrom uma vista( perfil), deve:
- active a API do Google Analytics.
- crie credenciais para a sua aplicação aceder à API.
- coloque as credenciais na sua aplicação.Ao utilizar o seu pedido para solicitar os dados do seu relatório, o utilizador tem de o autorizar a aceder aos dados em seu nome.
uma vista (perfil) é identificada por um ID de vista (perfil). Vistas( perfis), entre outras entidades, fazem parte da hierarquia de contas, usuários, propriedades e vistas do Google Analytics. A sua aplicação pode usar a API de gestão para atravessar esta hierarquia e obter uma vista (perfil).
questionando as dimensões e métricas
questiona a API para o relatório de dados do Google Analytics, que consiste em dimensões e métricas. Métricas são as medições individuais da atividade do usuário, como o número de usuários ativos na propriedade agora. As dimensões dividem as métricas em alguns critérios comuns, tais como fontes de tráfego, Localização geográfica, informações de página, etc.
Use as dimensões & Metrics Reference Guide to explore all the dimensions and metrics available to the API. Além disso, leia o Guia de referência da API em tempo Real para aprender como especificar dimensões e métricas em uma consulta API.
trabalhando com relatórios
os dados retornados da API podem ser pensados como uma tabela com um cabeçalho e uma lista de linhas. Cada resposta API consiste de um cabeçalho que descreve o nome e o tipo de dados de cada coluna. A resposta também contém uma lista de linhas, onde cada linha é uma lista de células com dados na mesma ordem que os cabeçalhos. Leia o Guia de referência da API em tempo Real para mais informações sobre a resposta da API.
Quota Policy
The Real Time Reporting API handles millions of data query operations. Empregamos um sistema de quotas para proteger o sistema de receber mais operações do que ele pode lidar, e para garantir uma distribuição equitativa dos recursos do sistema. Leia os limites e o Guia de quotas para mais detalhes.
agora que você entende como a API funciona, para começar:
