Como fazer a integração com o Google Analytics

Com a plataforma do Google Analytics, é possível medir as interações dos usuários com os negócios em diversos dispositivos e ambientes. O Google Analytics fornece os recursos necessários para coletar, armazenar, processar e gerar relatórios dessas interações do usuário.

É possível coletar dados de análises tanto do lado do cliente quanto do servidor.

Coleta de dados de análise do lado do cliente

Use as APIs e os SDKs do Google Analytics para mensurar como os usuários interagem com seu conteúdo e iniciativas de marketing. É possível conferir os dados das interações de usuários na interface do Google Analytics ou usar APIs de relatórios para buscar esses dados. Para mais detalhes sobre a coleta de dados de análise do lado do cliente, selecione um link abaixo, de acordo com o tipo de cliente:

Rastreamento da Web (analytics.js) - meça a interação do usuário com sites ou aplicativos da Web.
Android - meça a interação do usuário com aplicativos para Android.
iOS - meça a interação do usuário com aplicativos para iOS.
Protocolo de avaliação - Meça a interação do usuário em qualquer ambiente com este protocolo de nível inferior.

Coleta de dados de análise do lado do servidor

O App Engine fornece um mecanismo para gerar registros de eventos no aplicativo. No entanto, é possível usar o Google Analytics para acompanhar eventos específicos do lado do servidor para diversos fins:

Analisar dados históricos: o App Engine permite configurar o tamanho ou número máximo de dias dos arquivos de registros. Depois que esse limite for ultrapassado, você perderá o acesso a esses arquivos de registros. Acompanhar eventos no Google Analytics permite visualizar eventos passados por muito mais tempo.
Acompanhar eventos importantes: os arquivos de registros podem ser muito complexos, incluindo e registrando dados de vários componentes de um aplicativo. Ao usar o acompanhamento de eventos, é possível identificar eventos importantes e acompanhá-los, além de alguns metadados.
Trabalhar na interface do usuário - Aproveite a sofisticada interface do usuário oferecida pelo Google Analytics para ver, gerar relatórios e exportar eventos do lado do servidor.

Para ativar a coleta de dados de análise do lado do servidor, use um cliente HTTP e faça solicitações desse tipo com o Protocolo de avaliação do Google Analytics. Para saber mais, consulte o tópico Acompanhamento de eventos no guia do desenvolvedor do Google Analytics.

Aplicativo de amostra

Confira como rastrear eventos no aplicativo do App Engine consultando o aplicativo de amostra abaixo. Uma solicitação HTTP é feita e os dados sobre o evento são postados no Google Analytics.

Antes de usar o Measurement Protocol do Google Analytics no App Engine, siga estas etapas:

Crie uma propriedade do Universal Analytics e receba o ID de acompanhamento.
Inclua as variáveis de ambiente com seu ID de acompanhamento no arquivo de configuração relevante para o ambiente de execução. Exemplo:
```
env_variables:
  GA_TRACKING_ID: YOUR-GA-TRACKING-ID
```
Substitua YOUR-GA-TRACKING-ID pelo ID que você recebeu do Google Analytics.
Antes de executar o aplicativo de amostra localmente, defina as variáveis de ambiente obrigatórias:
```
export GA_TRACKING_ID=YOUR_TRACKING_ID
```
Execute o exemplo de código localmente. Por exemplo, é possível usar a linha de comando:
Poste dados de acompanhamento de eventos no Google Analytics atualizando seu aplicativo para enviar solicitações HTTP que incluam payloads do Google Analytics.
Se você configurar o GA_TRACKING_ID enquanto estiver testando o aplicativo localmente, atualize o ID antes da implantação.
Se você tiver ativado a configuração no Admin Console do Google Analytics para excluir o tráfego de indexadores e bots ou se estiver usando o Google Analytics 4 (que filtra esse tráfego automaticamente), talvez o Analytics não exiba resultados de clientes do App Engine. Esses cenários filtram o user agent padrão do App Engine. Para conferir os resultados do App Engine, inclua o parâmetro ua nos dados de acompanhamento e defina-o com um valor personalizado.