Google Analytics 4 (GA4) Data API é uma nova, empolgante e revolucionária versão das APIs de Dados do Google Analytics. A GA4 Data API permite que você acesse e rastreie eventos em várias plataformas em uma única propriedade, facilitando a visualização dos dados de usuários e insights de seus sites e aplicativos móveis.

No entanto, a GA4 veio como uma surpresa para muitos que dependiam do anterior Universal Analytics. Há muitas diferenças entre o Google Analytics 4 e Universal Analytics (UA) que mudou a forma como você pode consultar seus dados com as APIs.

E como há confusão sobre a GA4 Data API, consideramos crucial aprofundar-se nas especificidades desta nova API. Hoje, focaremos nas diferenças, semelhanças, vantagens e desvantagens da nova GA4 Data API em comparação com a anterior UA Reporting API.

Então, vamos mergulhar direto!

O que é a Google Analytics 4 Data API?

A nova Google Analytics Data API é um conjunto de protocolos e ferramentas que permite acessar e extrair seus dados de relatórios do Google Analytics 4. Atualmente, a API ainda oferece alguns recursos em estágios Alpha e Beta, então você pode achar que algumas capacidades são limitadas.

Além disso, a API não oferece suporte às versões anteriores do Google Analytics nesta fase, então vale a pena notar isso antes de construir seus próximos projetos de produção.

Leia mais: Google Ads API vs Google AdWords API: Uma Análise e Revisão Detalhada

Por que a GA4 Data API é melhor do que as APIs UA anteriores?

Oferece análises melhoradas entre plataformas

Antigamente, o Google Analytics 4 era conhecido como Google Analytics App + Web, e como o nome implica, agora você pode monitorar seus dados tanto de suas aplicações quanto de websites dentro de uma única propriedade. Em contraste, a UA Reporting API não oferecia essa funcionalidade em uma única propriedade.

Estruturas de dados consistentes

As estruturas de dados para tanto as requisições quanto os resultados tornam a extração de dados simples. Por exemplo, os resultados para métricas e dimensões agora são do mesmo tipo de dado, ao contrário da estrutura de dados na anterior UA Reporting API.

Sintaxe de filtro aprimorada

A nova Data API mudou significativamente a forma como usamos o filtro para métricas e dimensões para oferecer maior conveniência e funcionalidade. Com a nova sintaxe, os novos parâmetros como andGroup, orGroup, e notExpression facilitam a combinação de múltiplos filtros, que antes exigiam várias requisições na Reporting API para obter os mesmos resultados.

Integração fácil com outras aplicações de negócios

Uma vez que os seus dados do Google Analytics 4 podem ser acedidos programaticamente através da API, isso permite uma integração perfeita com as suas aplicações de negócios favoritas. Você pode utilizá-las com outras APIs para automatizar tarefas de relatórios complexas e realizar personalizações poderosas de acordo com as suas necessidades.

Google Analytics 4 Data API vs Universal Analytics Property API: As Principais Diferenças e Semelhanças

As principais diferenças entre a GA4 Data API e a UA Reporting API vêm das seguintes variantes:

Consultas

Ao contrário da Universal Analytics API, as consultas da GA4 Data API não têm parâmetros com ID de Visualização ou ID de Propriedade. Em vez disso, você simplesmente passa o ID numérico da propriedade GA4 através da URL da solicitação.

Assim, difere totalmente das Reporting APIs, que requerem as visualizações (perfil) para identificação dos relatórios.

Por exemplo:

https://analyticsdata.googleapis.com/v1beta/properties/xxxxxxx:runReport 

Where xxxxxxx is your GA4 property ID. If you were transitioning from UA, your GA4 property is your UA property without the “UA-” prefix.

Métodos principais de relatórios

Enquanto a Universal Analytics API utiliza apenas um único método para o núcleo relatório funcionalidade, existem mais métodos com a API de Dados que aumentam a conveniência e a funcionalidade.

Ou seja, a API de Relatório tem apenas getBatch, enquanto a API GA4 tem quatro: runReport, runPivotReport, batchRunReports, e batchRunPivotReports.

Sintaxe para métricas e dimensões

Mudanças visíveis nos esquemas da API para as dimensões e métricas personalizadas também são evidentes entre a API GA4 e as APIs anteriores.

Os nomes das dimensões e métricas, por exemplo, não são precedidos por ga: como na API do Universal Analytics. A API de Dados GA4 usa uma nova sintaxe para as dimensões e métricas.

Os intervalos de datas, cláusulas e orderBys

Os intervalos de datas entre as duas APIs não mudaram muito, exceto pelo número de intervalos de datas em uma única solicitação. Com a nova API de Dados GA4, você pode solicitar até quatro intervalos de datas em vez de dois na API de Relatórios. 

• O que é semelhante entre os dois é o formato de entrada da data, bem como os valores.

Como os dimensionsFilterclauses e metricsFilterClauses, o novo dimensionFilter e metricFilter as cláusulas fazem a mesma coisa, respectivamente, mas você deve reescrevê-las de acordo com a nova API.

Por último, a estrutura de pedidos na Data API tem uma estrutura diferente para o orderBys campo, mas com uma funcionalidade semelhante à do Reporting API.

• Com a especificação OrderBys da Data API, você pode classificar os resultados de acordo com dimensões, métricas e pivot, mas precisa adicionar a ordenação de direção.

//API de Propriedade UA

"orderBys": [
        {
          "fieldName": "ga:sessions",
          "sortOrder": "DESCENDING"
        }
      ]

//API de Dados

  "orderBys": [
    {
      "metric": {
        "metricName": "sessions"
      },
      "desc": true
    }
  ]

Resultados para as solicitações de API

Os resultados da sua solicitação também apresentam mais alterações na sua estrutura. Provavelmente, quaisquer mudanças feitas visam principalmente melhorar a consistência e a conveniência.

Então, vamos analisar o resumo das mudanças:

Estrutura dos resultados para valores de dimensões e métricas 

Uma diferença entre a API GA4 e a API UA Property é a estrutura dos resultados para os valores das dimensões e métricas. A API de Dados GA4 tem uma estrutura consistente onde tanto os valores para dimensões quanto para métricas são objetos. A API UA Property tinha métricas como um objeto com valores em array, enquanto os valores para dimensões eram apenas arrays.

//API de Propriedade UA

"linhas": [
        {
          "dimensões": [
            "Canadá"
          ],
          "métricas": [
            {
              "valores": [
                "3467"
              ]
            }
          ]
        }

//API de Dados

  "linhas": [
    {
      "valoresDimensionais": [
        {
          "valor": "Canadá"
        }
      ],
      "valoresMétricos": [
        {
          "valor": "3467"
        }
      ]

Agregações de métricas

Outra diferença é o que não foi incluído por padrão nos resultados da consulta para as agregações de métricas. Ou seja, a nova API calculará as agregações de métricas apenas se você especificar. 

• Os resultados dessas métricas de dados serão os mesmos, assim como você obteria com a UA Property API.

//Especificando Métricas de Dados na API de Dados

"metricAggregations": [
    "TOTAL",
    "MÁXIMO",
    "MÍNIMO"
  ]

Funcionalidade de Pivot

Embora você possa obter a funcionalidade de pivot na batchGet método, a nova API a suporta através do runPivotReport e batchRunPivotReports. Essa mudança também afetou a forma como os implementamos. Agora, cada resposta de linha representa uma única célula dentro de uma tabela em relação à antiga API de Propriedade UA, onde a resposta de linha é representada como uma linha completa da tabela.

Leia mais: GA4 Configuração: Checklist para um Google Analytics 4 Perfeito

Considerações Finais

A API de Dados do Google Analytics permite que você acesse os dados de eventos do seu usuário em seus sites e aplicativos. Esta é uma nova API e, como em tudo novo, geralmente vem com consideráveis méritos e deméritos, que discutimos neste post. 

Há também melhorias significativas nesta nova API que adicionaram mais funcionalidade, tornando-a muito melhor do que a antiga API de Propriedade UA. Além disso, o futuro da API promete ainda mais.

No entanto, a API ainda é jovem e muitas outras funcionalidades ainda não estão bem desenvolvidas ou estão ausentes. Além de causar inconvenientes de uso, a API também requer mais esforço, dedicação e perseverança para aprender e entender como essas diferenças afetam a forma como você coleta seus dados.

No entanto, a experiência única desta API pode ser um maravilhoso desafio para aqueles que amam experimentar e descobrir as imensas possibilidades das novas tecnologias.