Eventos GA4 usando public-sdk

🔍 Preview

A mensuração de comportamento do cliente é parte essencial da estratégia de qualquer e-commerce.

Na Uappi, o envio de eventos para o Google Analytics 4 (GA4) já está integrado ao fluxo de consumo de dados através do public-sdk.

Ou seja:

Sempre que você utiliza o módulo Tracking, os eventos são enviados automaticamente para o dataLayer, sem necessidade de implementação manual.

---

🎯 Por que isso é importante?

Esses eventos permitem que:

• O time de mídia acompanhe a performance da loja
• Campanhas sejam otimizadas com base em comportamento real
• Funis de conversão sejam analisados
• Testes A/B tenham dados confiáveis

Tudo isso sem exigir configuração adicional no Checkout.

⚙️ Como funciona?

O public-sdk possui duas formas de consumir dados:

Método	Função
Api	Apenas consome dados
Tracking	Consome dados + envia eventos GA4 automaticamente

Exemplo prático com banners:

🔹 Sem tracking

1import { Api } from '@uappi/public-sdk';
2
3await Api.cart.addProduct(...);

• Apenas busca os dados.

🔹 Com tracking

1import { Tracking } from '@uappi/public-sdk';
2
3await Tracking.cart.addProduct(...);

• Busca os dados
• Envia automaticamente o evento add_to_cart para o GA4

🧠 O que o public-sdk envia?

Ao usar o Tracking, o SDK dispara eventos no padrão oficial do GA4.

Exemplo: 🟣 Visualização dos dados do carrinho

Evento enviado: add_to_cart

Esse evento é útil para medir:

• Performance
• Engajamento com campanhas
• Efetividade

Os dados são enviados automaticamente ao dataLayer, que pode ser lido por ferramentas como:

• Google Tag Manager
• Extensões de debug (ex: DataLayer Checker)

✅ Boas práticas

Use Tracking quando:

• O conteúdo impacta marketing ou mídia
• A visualização precisa ser mensurada
• Existe interesse em análise de funil

Exemplos:

• Payments
• Cart
• Shipments

Use apenas Api quando:

• O dado é técnico ou estrutural
• Não há valor analítico para mídia

Exemplos:

• Configurações
• Dados auxiliares

🏁 Próximo passo

Agora que você já sabe como mensurar interações do usuário, vamos para as Dados estruturados e boas práticas de SEO.

Tracking e SEO: dados estruturados e boas práticas