Visão geral

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 Reporting API do Google Analytics usar

Como criar um novo aplicativo:

Use a Reporting API v4 do Google Analytics pelos seguintes motivos:

  • A API v4 tem um conjunto de recursos muito mais completo, como relatórios de segmentação avançada, valor da vida útil e coortes.
  • Todo o desenvolvimento de novos recursos usará a API v4.

Como migrar um aplicativo existente para usar a API v4:

  • Se você utiliza a Core Reporting API v3 no seu aplicativo, migre-a para a API v4 para aproveitar os novos recursos dela.
  • A migração da API v4 para a API v3 é fácil, pois a v4 suporta a sintaxe da v3 para segmentos e filtros.

Como manter a v3 ou versões anteriores da API:

  • A Reporting API v4 do Google Analytics é independente de outras APIs v3 (por exemplo, a Management API, a Metadata API etc.) e exige uma biblioteca cliente separada. Por esse motivo, convém manter a API v3 se você estiver criando um aplicativo (por exemplo, um aplicativo 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 Reporting API v4 do Google Analytics, consulte Como criar um relatório.