Google || Como autorizar APIs Google Analytics – DataforAll

Objetivo

Documento visa orientar clientes no processo de autorização de acesso aos dados através das APIs do Google Analytics (Reporting API v4 e Data API)

Contexto

O Google Analytics passou por uma mudança de 2022 para 2023:

As propriedades chamadas de Universal Analytics (UA) deixaram de processar dados em Junho/2023, funcionando apenas para dados históricos.
A nova propriedade se chama Google Analytics 4 (GA4) e não possui mais a configuração de vistas.

A API responsável pela extração dos dados de UA é chamada de (Google Analytics) Reporting API v4 e não possui compatibilidade com GA4.
A API responsável pela extração dos dados de GA4 é chamada de (Google Analytics) Data API v1 e não possui compatibilidade com UA.

→ Logo para cada necessidade deve ser considerada uma API distinta

Existem duas formas de liberação de acesso aos dados via API:

🗝️1. Passo a passo (para credenciais OAuth)

É a forma mais recomendada. Consiste em uma autorização feita diretamente na plataforma D4All do cliente.

Setup Plataforma DataforAll

Requisito: acesso à plataforma → https://<suaplataforma>.dataforall.tech/login

➡️Autenticar via OAuth na plataforma

A plataforma da DataforAll auxilia na autorização do acesso aos dados do cliente. Através da autorização do cliente o Google nos concede tokens de acesso e atualização para acessarmos os dados

No menu lateral esquerdo, role até grupo Connectors, clique em Google e então em OAut
Clique em Adicionar integração e selecione Google Analytics no Escopo. Clique em Salvar.

Será feito o redirecionamento para a página de autenticação do Google. Autentique-se com a conta que possui o acesso necessário em Google Analytics.

Com isso, poderemos acessar os dados do Google Analytics para a vista/propriedade com as permissões do usuário autorizado.

No final desse processo precisaremos da seguinte informações:

ID da propriedade (GA4) ou ID da vista da propriedade (UA/GA360)
- Para determinar um ID da propriedade do Google Analytics 4, faça o seguinte:
  1. Acesse o Google Analytics em https://analytics.google.com/.
  2. Selecione "Administrador".
  3. Selecione a propriedade.
  4. Selecione "Configurações da propriedade".

🧾2. Passo a passo (para conta de serviço)

É uma forma que requer maior esforço do cliente, pois serão necessárias configurações a mais nos aplicativos. Uma vantagem é que por ser um e-mail é possível controlar melhor o perfil de acesso da conta.

Setup Google Analytics

Requisito: conta de serviço (cliente ou DataforAll)→ Data Tech - Guia: setup de Conta de Serviço

➡️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, 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