Visão geral da API de dados do Google Analytics

Com a API Data v1 do Google Analytics, você tem acesso programático aos dados do relatório do Google Analytics 4 (GA4). O Google Analytics 4 ajuda a entender como as pessoas usam seu app da Web, iOS ou Android. Saiba mais sobre as propriedades do Google Analytics 4.

Com a API de dados do Google Analytics v1, você pode criar relatórios para responder a perguntas como:

  • Quantos usuários ativos diários meu app Android teve na última semana?
  • Quantas visualizações de página cada um dos 10 principais URLs do meu site receberam nos últimos 28 dias?
  • Quantos usuários ativos por país meu app iOS teve nos últimos 30 minutos?

A API de dados do Google Analytics v1 também pode ser usada para:

  • criar painéis personalizados para exibir os dados do Google Analytics;
  • automatizar tarefas de relatórios complexas para economizar tempo;
  • integrar seus dados do Google Analytics a outros aplicativos de negócios.

Guia de início rápido

Chamar a API para criar seu primeiro relatório está a apenas algumas linhas de código de distância. Consulte o guia de início rápido para usar bibliotecas de cliente para começar. Existem bibliotecas de cliente em Java, Python, Node.js e outras linguagens para simplificar a implementação.

Métodos disponíveis

  • runReport: retorna um relatório personalizado dos seus dados de eventos do Google Analytics e é o método preferido para consultas simples de relatórios.
  • batchRunReports: é uma versão em lote do método runReport que permite gerar vários relatórios usando uma única chamada de API.
  • runPivotReport: retorna um relatório dinâmico personalizado com os dados de eventos do Google Analytics. Os relatórios dinâmicos são formatos mais avançados e expressivos do que os relatórios regulares. Cada tabela dinâmica descreve as colunas e linhas de dimensões visíveis na resposta do relatório.
  • batchRunPivotReports: é uma versão em lote do método runPivotReport que permite gerar vários relatórios usando uma única chamada de API.
  • getMetadata. Esse método retorna metadados referentes a dimensões e métricas disponíveis nos métodos de geração de relatórios. Usado para explorar as dimensões e métricas. A resposta desse método também inclui as dimensões e métricas personalizadas disponíveis para a propriedade especificada do GA4.
  • runRealtimeReport: retorna um relatório personalizado de dados de eventos em tempo real para sua propriedade. Os eventos aparecem nos relatórios em tempo real segundos após terem sido enviados ao Google Analytics. Os Relatórios de tempo real mostram dados de eventos e de uso do período, desde o momento atual até 30 minutos atrás (até 60 minutos para as propriedades do Google Analytics 360).
  • runFunnelReport (Pré-visualização): retorna um relatório de funil personalizado dos dados de eventos do Google Analytics. A exploração de funil permite visualizar as etapas que os usuários seguem para concluir uma tarefa e saber rapidamente se estão tendo sucesso ou falhando em cada etapa.

Dimensões e métricas compatíveis

A documentação do esquema da API lista as dimensões e métricas atualmente compatíveis com a Google Analytics Data API.