Registros de alterações da API de relatórios em tempo real do Google Analytics

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.

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.

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 erro badRequest e uma mensagem OR 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.

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.

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, use rt:userType.
  • Métrica rt:activeVisitors – em vez dela, use rt:activeUsers.

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.

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.