Este documento descreve a Reporting API v4 do Google Analytics. Para uma referência detalhada da API, leia o Guia de referência.
Introdução
A Reporting API v4 do Google Analytics é o método programático mais avançado para acessar dados de relatórios no Google Analytics. Com a Reporting API do Google Analytics, você pode:
- 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.
Recursos
O Google Analytics foi criado em uma infraestrutura de dados eficiente. Com a Reporting API v4 do Google Analytics, você tem acesso à eficiência da plataforma Google Analytics. A API fornece estes recursos principais:
expressões de métricas
Com a API, você pode solicitar métricas incorporadas e uma combinação de métricas expressadas em operações matemáticas. Por exemplo, você pode usar a expressão
ga:goal1completions/ga:sessions
para solicitar as conclusões de metas por número de sessões.vários períodos
Com a API, você pode em uma só solicitação ver dados de dois períodos.
coortes e valor da vida útil
A API tem um vocabulário completo para solicitar Relatórios de coortes e valor da vida útil.
vários segmentos
Com a API, você pode ver vários segmentos em uma única solicitação.
Como escolher qual versão da API de relatórios do Google Analytics usar
Como criar um novo aplicativo:
Use a API de relatórios v4 do Google Analytics pelos seguintes motivos:
- A API v4 tem um conjunto de recursos muito mais completo, como relatórios de valor da vida útil, coortes e segmentação avançada.
- Todo o desenvolvimento de novos recursos usará a API v4.
Como migrar um aplicativo existente para usar a API v4:
- Se você utiliza a API Core Reporting v3 no seu aplicativo, faça a migração para a API v4 para aproveitar os novos recursos dela.
- A migração da API v4 para a API v3 é fácil, já que a versão 4 é compatível com a sintaxe da versão 3 para segmentos e filtros.
Como manter a v3 ou versões anteriores da API:
- A API de relatórios v4 do Google Analytics é independente de outras APIs v3 (por exemplo, a API de gerenciamento, a API Metadata etc.) e exige uma biblioteca cliente separada. Por esse motivo, recomendamos que você mantenha a API v3 se estiver criando um aplicativo (por exemplo, um app para dispositivos móveis) com restrições de espaço.
- Continuaremos a oferecer suporte para versões anteriores da API, mas o desenvolvimento de novos recursos será voltado para a API v4.
- Todas as alterações no suporte da API v3 são comunicadas nos registros de alterações.
Próximas etapas
Guias de início rápido
A tabela a seguir fornece um conjunto de guias de início rápido para ajudar você a dar os primeiros passos em pouco tempo. Você precisa escolher um idioma e um tipo de aplicativo:
Aplicativo de serviço | Aplicativo instalado | Aplicativo da Web |
---|---|---|
Java | Java | — |
Python | Python | — |
PHP | — | PHP |
— | — | JavaScript |
Para entender melhor como usar a API de relatórios v4 do Google Analytics, consulte Como criar um relatório.