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 Store Theme.

⚙️ 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.customization.listBanners('home-banner');

• Apenas busca os dados.

🔹 Com tracking

1import { Tracking } from '@uappi/public-sdk';
2
3await Tracking.customization.listBanners('home-banner');

• Busca os dados
• Envia automaticamente o evento view_promotion 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 de banner

Evento enviado: view_promotion

Esse evento é útil para medir:

• Performance de banners
• Engajamento com campanhas
• Efetividade de banners

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:

• Banners
• Vitrines
• Mudanças de páginas

Use apenas Api quando:

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

Exemplos:

• Menus
• 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