GA4 Data API vs Universal Analytics API: A Thorough and Expert Comparison for Smarter Decision-Making

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

The new GA4 Data API has significantly changed how we use the filter for metrics and dimensions to offer greater convenience and functionality. With the new syntax, the new parameters like 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

Visible changes in the API schemas for the custom dimensions and metrics are also apparent between the GA4 data API and the previous APIs.

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.

Last, the ordering structure in GA4 Data API has a different structure for the 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.

//UA Property API

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

//Data API

  "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.

//UA Property API

"rows": [
        {
          "dimensions": [
            "Canada"
          ],
          "metrics": [
            {
              "values": [
                "3467"
              ]
            }
          ]
        }

//Data API

  "rows": [
    {
      "dimensionValues": [
        {
          "value": "Canada"
        }
      ],
      "metricValues": [
        {
          "value": "3467"
        }
      ]

Agregações de métricas

Another difference is what has not been included by default in the query results for the metric aggregations. That is, the new GA4 data API will calculate metric aggregations only if you specify. 

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

//Specifying Data Metrics in Data API

"metricAggregations": [
    "TOTAL",
    "MAXIMUM",
    "MINIMUM"
  ]

Funcionalidade de Pivot

Embora você possa obter a funcionalidade de pivot na batchGet method, the new GA4 Data API supports it through the 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

GA4 Data API allows you to access your user’s event data from your websites and applications. This is a new API, and as with anything new, it often comes with considerable merits and demerits, which we have discussed in this 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.