Atualizamos periodicamente a API de relatórios em tempo real do Google Analytics para oferecer novos recursos e corrigir defeitos descobertos nas versões anteriores. Na maioria dos casos, essas alterações ficam evidentes para os desenvolvedores de API. No entanto, às vezes, precisamos fazer alterações que exigem que os desenvolvedores modifiquem os aplicativos existentes.
Esta página documenta todas as alterações feitas na API de relatórios em tempo real do Google Analytics que podem afetar seu aplicativo. Recomendamos que os desenvolvedores de API consultem esta lista periodicamente para ver se há novos comunicados. Você também pode se inscrever para receber as alterações por meio dos feeds listados na seção Inscrever-se abaixo.
Inscrever-se nos registros de alterações relacionados
Inclui todas as APIs de coleta, configuração e relatórios.
Inclui as APIs de relatórios principais, de relatórios de funis multicanal e de relatórios em tempo real.
Versão de 29/11/2017 (29 de novembro de 2017)
Nesta versão, mudamos as cotas e limites da API Real Time do Google Analytics.
As chamadas da API Real Time Reporting do Google Analytics contribuíam com o limite de 10.000 chamadas diárias por vista (perfil), que é equivalente a outras chamadas de API do Analytics. Agora, elas são contabilizadas separadamente, o que significa que é possível fazer 10.000 chamadas por vista (perfil) em cada dia usando a API Real Time Reporting do Analytics E outras 10.000 por vista (perfil) com outras APIs do Google Analytics. Consulte a página Limites e cotas para mais informações.
Essa mudança oferece uma abordagem mais detalhada e segura para gerenciar cotas. Assim, chamadas frequentes que usam a API Real Time Reporting do Google Analytics não bloqueiam acidentalmente todas as outras chamadas de API do Analytics pelo restante do dia em um perfil.
Versão de 12/02/2015 (12 de fevereiro de 2015)
Nesta versão, corrigimos um bug.
- Nesta versão, corrigimos um problema (em inglês) na aplicação das restrições de filtro na consulta da API Real Time Reporting. As solicitações com
rt:activeUsers
e um filtro em uma dimensão de evento resultavam em um errobadRequest
e uma mensagemOR operator not supported for a hit level filter
. Consulte o guia para desenvolvedores sobre a API Real Time Reporting e conheça melhor as restrições de consulta.
Versão de 01/10/2014 (1o de outubro de 2014)
Nesta versão, incluímos uma nova dimensão. Leia a referência das dimensões e métricas para ver todas as definições.
Tempo
- Dimensão
rt:minutesAgo
– há quantos minutos ocorreu um hit.
Versão de 16 de abril de 2014
Nesta versão, renomeamos dimensões e métricas. Leia a referência das dimensões e métricas para ver todas as definições.
Renomeação de dimensões e métricas
As dimensões e métricas a seguir foram renomeadas. Consulte a política de descontinuação de dados para ver mais detalhes:
Usuário
- Dimensão
rt:visitorType
– Em vez dela, usert:userType
. - Métrica
rt:activeVisitors
– em vez dela, usert:activeUsers
.
Versão de 20 de março de 2014
Descontinuação do prefixo ga:
O ga:
foi descontinuado em todas as dimensões e métricas em tempo real e substituído pelo novo prefixo rt:
. As solicitações de API que usam ga:
vão continuar funcionando por seis meses. Depois desse período, vão apresentar um erro.
Novas dimensões e métricas
Nessa atualização, adicionamos novas dimensões e métricas à API Real Time Reporting. Leia a referência das dimensões e métricas para ver todas as definições.
Acompanhamento de eventos
- Dimensão
rt:eventAction
– ação do evento. - Dimensão
rt:eventCategory
– categoria do evento. - Dimensão
rt:eventLabel
– etiqueta do evento. - Dimensão
rt:totalEvents
– Número total de eventos no perfil, em todas as categorias.
Acompanhamento de meta
- Dimensão
rt:goalId
– string correspondente ao ID da meta. - Métrica
rt:goalXXValue
– Valor numérico total do número da meta solicitada, em que XX é uma grandeza entre 1 e 20. - Métrica
rt:goalValueAll
– Valor numérico total de todas as metas definidas no seu perfil. - Métrica
rt:goalXXCompletions
– Número total de conclusões do número da meta solicitada, em que XX é um valor entre 1 e 20. - Métrica
rt:goalCompletionsAll
– Número total de conclusões de todas as metas definidas no seu perfil.
Acompanhamento de páginas
- Métrica
rt:pageViews
– Número total de visualizações de página.
Acompanhamento de apps
- Métrica
rt:screenViews
– número total de exibições de tela.
Versão de 1o de agosto de 2013
Esta é a versão inicial da API Real Time Reporting na versão Beta limitada:
- A API Real Time Reporting permite que você gere relatórios sobre as atividades que ocorrem na sua propriedade. Você pode usar essa API para consultar dimensões e métricas e criar painéis e widgets da Web que serão exibidos aos clientes. Consulte a visão geral da API Real Time Reporting para mais detalhes.