Google || Google Analytics 4 (GA4) – DataforAll

Objetivo

Este manual tem o objetivo de auxiliar no processo de Implantação GOOGLE ANALYTICS 4 por API.
GA é uma ferramenta para coletar dados e analisar o comportamento do público.

O processamento dos dados para a propriedade Universal Analytics (UA) será finalizado em Junho/23, porém o históricos dos dados permanecerão.
Caso cliente ainda não tenha criado a propriedade Google Analytics 4 (GA4), deverá realizar a migração de acordo com o artigo: [GA4] Add a Google Analytics 4 property (to a site that already has Analytics) - Analytics Help

Porque autorizar API:

A API serve de interface entre o aplicativo do cliente (Google Analytics) e a plataforma DataforAll.
Solicitamos os dados para a API, a qual irá verificar se temos autorização, buscar os dados no aplicativo do cliente e nos retornar.

Como autorizar API:

Para o processo de autorização, existem dois tipos de liberações que o cliente pode optar.

Para conta de serviço D4ALL

Cliente com acesso Adminstrador para incluir a conta de serviço D4ALL no Google Analytics do cliente.

Google Cloud D4ALL:
:Pelo Google Cloud D4ALL, precisamos ter acesso ao Google Analytics do cliente. E seguir as etapas da documentação: Data Tech - Guia: autorização APIs Google Analytics

Se a DataforAll não tiver acesso a plataforma do Google Analytics, iremos criar a Conta de Serviço, e enviaremos ao cliente para liberação

As informações compartilhadas, são colocadas no código do projeto e se trouxer resultado, que são os dados do projeto do cliente, então as credenciais estão validadas.

Acesso ADMIN pelo cliente
A D4ALL encaminha o email da conta de serviço (google-apis@dataforall-management.iam.gserviceaccount.com), criada para ser liberada pelo cliente
Cliente após cadastrar conta de serviço, podendo ser leitor, basta encaminhar o ID da vista/propriedade para D4ALL extrair os dados.

Passo a passo (para conta de serviço D4ALL)

Setup Google Analytics

Requisito: conta de serviço (cliente ou DataforAll)
Inserir conta de serviço na propriedade/vista a ser consultada.

No menu esquerdo, clique em Administrador
De acordo com a propriedade desejada UA (Universal Analytics) ou GA4. Abra os painéis de Gerenciamento de Acesso:
No painel, clique no botão “+” para adicionar uma conta para ter acesso à essa vista/propriedade
Insira o e-mail da conta de serviço D4ALL, selecione a permissão de Analista e clique em Adicionar
Com isso, será possível acessar os reports de Google Analytics para a vista/propriedade, basta informar a ID da vista/propriedade. Clique na respectiva Configuração para obter o ID necessário.

No painel, a informação necessária para resgatar as informações é o ID da vista/propriedade

Com isso, a conta poderá acessar os reports relacionados à vista/propriedade

Para conta de serviço Cliente.

Opção para cliente que não é adminstrador da conta Google Analytics 4 e precisa solicitar ao cliente final.

Google Cloud Cliente: nesta opção, o cliente precisa fazer uma Conta de Serviço.

→ Conta de serviço: arquivo que pode ser no formato Json que permite acessar a API quando colocado no código.
Para consumir os dados de API do Google Analytics, o Cliente precisa ter o perfil como Administrador da conta e gerar uma Conta de Serviço criada cada Propriedade que o cliente gerencia.
Após criar um processo, ir na página do Google Analytics, no campo Administrador, escolher a Propriedade que será consumida e clicar em Gerenciamento de Acesso a Propriedade.
Neste campo, o cliente decidirá a permissão que dará para a DataForAll e incluirá a Conta de Serviço.

Com esta opção o cliente deverá compartilhar as credenciais da Conta de Serviço e ID da Propriedade para DataforAll.

Acesso inferior a ADMIN pelo cliente
Cliente deverá solicitar ao cliente final (Administrador da conta GA4) uma conta de serviço, sem que haja necessidade de ser D4ALL.
Cliente encaminha conta de serviço e o Json com a chave secreta e o ID da vista/propriedade para D4ALL extrair os dados.

→ Caso o cliente já possua conta de serviços. Segue o passo a passo para compartilhamento de chave de acesso para a D4ALL.

Com a conta criada, clique nela para ir à janela da conta:
Na pop-up selecione JSON e clique em Criar.

Guarde o JSON baixado, ele será utilizado por nós para autorizarmos o acesso aos dados.

→ Caso o cliente não possua conta de serviço e tenha que realizar a criação, segue o passo a passo abaixo:

Data Tech - Guia: setup de Conta de Serviço

→ Após desenvolvimento da conta de serviço, é necessário o cadastro no GOOGLE ANALYTICS.

Data Tech - Guia: setup de Conta de Serviço

No menu esquerdo, clique em Administrador
De acordo com a propriedade desejada UA (Universal Analytics) ou GA4. Abra os painéis de Gerenciamento de Acesso:
No painel, clique no botão “+” para adicionar uma conta para ter acesso à essa vista/propriedade
Insira o e-mail da conta de serviço D4ALL, selecione a permissão de Analista e clique em Adicionar
Com isso, será possível acessar os reports de Google Analytics para a vista/propriedade, basta informar a ID da vista/propriedade. Clique na respectiva Configuração para obter o ID necessário.
No painel, a informação necessária para resgatar as informações é o ID da vista/propriedade