A API Google Analytics Data v1 oferece acesso programático aos dados de relatório do Google Analytics 4 (GA4). O Google Analytics 4 ajuda você a entender como as pessoas usam o seu app para Web, iOS ou Android. Saiba mais sobre as propriedades do Google Analytics 4.
Com a API Google Analytics Data v1, é possível criar relatórios para responder a perguntas como as seguintes:
- Quantos usuários ativos por dia meu app Android teve na última semana?
- Quantas visualizações de página cada um dos dez principais URLs do meu site recebeu nos últimos 28 dias?
- Quantos usuários ativos por país meu app iOS teve nos últimos 30 minutos?
A API Google Analytics Data 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. Consulte o guia de início rápido do uso de 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 normais. 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 para dimensões e métricas disponíveis nos métodos 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 do GA4 especificada.
- 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 em tempo real mostram eventos e dados de uso dos períodos, que vão do momento atual até 30 minutos atrás (até 60 minutos para as propriedades do Google Analytics 360).
- runFunnelReport (Visualização antecipada): esse método retorna um relatório de funil personalizado dos dados de eventos do Google Analytics. Com a exploração de funil, você pode ver as etapas que os usuários realizam até concluir uma tarefa e quais delas conseguem mantê-los no funil.
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 API Analytics Data.