Data Layer, ou camada de dados, permite organizar e disponibilizar informações sobre as ações realizadas pelos usuários dentro da loja virtual.
Na Uappi, essas informações podem ser utilizadas pelo Google Tag Manager (GTM) e encaminhadas para ferramentas como o Google Analytics 4 (GA4), possibilitando acompanhar diferentes etapas da jornada de compra.
Neste conteúdo, você vai entender como funciona a Data Layer na Uappi, quais são os principais eventos disponíveis atualmente e como essas informações podem apoiar o acompanhamento da operação.
Data Layer é uma estrutura utilizada para armazenar e organizar informações relacionadas à navegação e às interações realizadas dentro da loja, como:
Exemplo do fluxo de informações utilizando o Data Layer.
De forma simplificada, as interações realizadas pelo usuário na loja geram informações que são disponibilizadas no Data Layer.
Esses dados podem ser utilizados pelo Google Tag Manager, responsável por gerenciar os acionamentos configurados para ferramentas de análise, mídia e outras integrações.
O fluxo pode ser representado da seguinte forma:
Loja virtual → Data Layer → Google Tag Manager → ferramentas de análise e mídia
A Uappi disponibiliza eventos relacionados às principais interações realizadas durante a jornada de compra.
| Evento | Quando é disparado |
| view_item_list | Em páginas de busca, categoria, marca ou listagem |
| view_item | Ao acessar a página de detalhes do produto |
| view_cart | No carregamento do carrinho e após alterações nos itens |
| add_to_cart | Quando um produto é adicionado ao carrinho, incluindo upsell |
| remove_from_cart | Quando um produto é removido do carrinho, incluindo upsell |
| begin_checkout | Durante as etapas do checkout quando existem itens no carrinho |
| add_shipping_info | Na tela de pagamento |
| add_payment_info | Durante o processamento da venda |
| purchase | Na página de confirmação do pedido |
| refund | Na impressão do datalayer de cancelamento do pedido, com as informações de reembolso |
Esses eventos permitem acompanhar diferentes momentos da jornada, desde a visualização de um produto até a conclusão ou cancelamento da compra.
Sobre o evento refund: além da Data Layer GA4 estar ativa, é necessário que a opção Ativar cancelamento também esteja habilitada nas configurações do Google Analytics e GTM. A impressão ocorre para pedidos cancelados cujo datalayer de compra já tenha sido impresso, cujo datalayer de reembolso ainda não tenha sido impresso e cuja data de emissão esteja dentro do prazo de 1 mês.
Exemplo de evento de e-commerce disponibilizado no Data Layer.
Além dos eventos relacionados diretamente ao e-commerce, a Uappi disponibiliza eventos referentes ao usuário e a outras interações realizadas durante a navegação.
| Evento | Quando é disparado |
| login | Login realizado por e-mail, Google, social ou facilitado |
| sign_up | Envio do cadastro realizado no checkout (method: email) |
| userProfile | Nas páginas em que o Data Layer é impressa, com informações disponíveis do cliente ou visitante |
| coupom_code | Aplicação de cupom via AJAX ou quando já existe cupom na sessão |
| file_download | Download de orçamento |
| lista-de-compras | Adição de uma lista de compras ao carrinho |
No evento login, o parâmetro method pode assumir valores diferentes de acordo com a forma de autenticação utilizada, como email, google, social ou Facilitado.
O evento userProfile pode ser disponibilizado nas páginas em que o Data Layer é impressa, tanto para clientes autenticados quanto para visitantes, considerando os dados disponíveis naquele momento.
A Uappi também disponibiliza eventos específicos para identificar páginas e interações realizadas durante o processo de checkout.
Esses eventos são disparados via pushGtmEvent():
| Evento | Página ou ação |
| cartView | Carrinho |
| emptyCartView | Carrinho vazio |
| loginView | Login |
| profileView | Cadastro |
| shippingView | Endereço / frete |
| paymentView | Pagamento |
| shipping_calculation | Recálculo de frete |
Esses eventos podem auxiliar na identificação das etapas percorridas pelo usuário durante o processo de compra.
A combinação dos eventos permite acompanhar diferentes momentos da jornada do consumidor.
Por exemplo:
Visualização do produto → Carrinho → Checkout → Pagamento → Compra
A partir desses dados, é possível estruturar análises para identificar em quais etapas os usuários avançam ou abandonam o processo de compra.
Exemplo de análise da jornada utilizando eventos registrados no GA4.
Para utilizar a estrutura de Data Layer destinada ao GA4, é necessário que a configuração correspondente esteja habilitada na plataforma.
A configuração pode ser localizada em:
Configurações → Google Analytics e GTM
Localize a opção Ativar datalayers GA4 e mantenha a configuração como Ativo.
Ativação do Data Layer GA4 nas configurações da plataforma.
Para lojas que utilizam tema Vue, existe também o evento:
WapstoreVirtualPageView
Esse evento é disparado durante a troca de rota no tema Vue.
Como a navegação em uma SPA (Single Page Application) pode ocorrer sem o carregamento completo de uma nova página, esse evento permite identificar as mudanças de visualização durante a navegação.
Quando o GA4 não está ativo, a plataforma ainda possui eventos relacionados à implementação legada do Universal Analytics.
| Evento | Quando é disparado |
| checkout | Carrinho e etapas do checkout, utilizando step de 1 a 5 |
| checkoutOption | Opções relacionadas a login/cadastro, frete ou pagamento |
| addToCart / removeFromCart | Alterações realizadas no carrinho |
| orderPlaced | Confirmação do pedido |
| promotionClick | Clique em banner |
| lista-de-compras | Adição da lista de compras |
| userProfile | Informações relacionadas ao usuário |
Nas páginas de listagem e detalhes de produto desse fluxo, o Data Layer utiliza impressions e detail sem o campo event.
Importante: essa é uma implementação legada, utilizada em cenários nos quais o GA4 não está ativo.
Ao trabalhar com o Data Layer da Uappi, considere que:
Sim. Para utilizar a estrutura de Data Layer destinada ao GA4, a configuração Ativar datalayers GA4 deve estar ativa.
A opção fica em Configurações → Google Analytics e GTM. O webinar também demonstra essa opção no painel Uappi.
Não. O disparo depende da ação realizada pelo usuário ou da página acessada. Por exemplo, view_item ocorre na página de detalhes do produto, enquanto purchase é disparado na página de confirmação do pedido.
O userProfile possui um comportamento diferente e é disponibilizado nas páginas em que a Data Layer é impressa, considerando as informações disponíveis do cliente ou visitante.
Os eventos podem ser acompanhados durante a navegação da loja por meio das ferramentas de desenvolvimento do navegador e das ferramentas utilizadas na implementação do Google Tag Manager e GA4.
Sim. Além dos eventos de e-commerce do GA4, como begin_checkout, add_shipping_info, add_payment_info e purchase, existem eventos de visualização específicos para etapas do checkout, como cartView, loginView, profileView, shippingView e paymentView.
userProfile é disparado somente quando o cliente está logado?Não. O userProfile é disponibilizado nas páginas em que a Data Layer é impressa tanto para usuários autenticados quanto para visitantes, considerando os dados disponíveis naquele momento.
Quando o GA4 não está ativo, a plataforma pode utilizar a implementação legada do Universal Analytics, com eventos como checkout, checkoutOption, addToCart, removeFromCart e orderPlaced.
Sim. Em lojas que utilizam tema Vue, o evento WapstoreVirtualPageView é utilizado para identificar as trocas de rota durante a navegação SPA (Single Page Application).
Sim. Os eventos podem ser utilizados para acompanhar diferentes etapas da jornada, como visualização de produto, carrinho, checkout e compra.
Atualizado em 24/08/2026
Leave a Reply