Neste guia, descrevemos como implementar recursos de comércio eletrônico do Google Analytics 4 (GA4) usando o Gerenciador de tags do Google em um site.
O comércio eletrônico do GA4 permite que os dados de impressões, promoções, vendas e listas de produtos sejam enviados com vários eventos de comércio eletrônico sugeridos.
Implementar com a camada de dados (recomendado)
Nessas seções, mostraremos como usar a camada de dados para medir as atividades de comércio eletrônico indicadas abaixo:
Note: vou listar as principais e caso você queira acessar os outros abaixo deixo a lista do site oficial
✓ Impressões e visualizações da lista de itens/produtos
✓ Cliques na lista de itens/produtos
✓ Visualizações de detalhes de itens/produtos
✓ Adições/remoções do carrinho
✓ Visualizações/impressões da promoção
✓ Compras
No evento view_item_list vamos imprimir todos os produtos da home page.
Exemplo: quando entramos no site.com e na home page exibe todos os produtos de promoções e em destaques, abaixo vou colocar o código do site oficial e listar os parâmetros.
Lembrando que os itens abaixo são exemplos do resultado final e de como o dataLayer deve ficar depois de configurado, no final da explicação de cada item vou deixar um exemplo de código realizado por nós.
OBS: os atributos de price, value e quantity precisam obrigatoriamente ser do tipo numérico/number. não pode ser do tipo string
O evento view_item é utilizado para quando visualizamos um produto e abrimos as especificações dele na pagina separada do produtos.
Exemplo: estou na home page e escolhi um item para comprar e cliquei nele ou fiz uma busca no site e escolhi o item, na pagina você vai seguir a mesma base do código acima só com os obrigatórios, ou se o cliente quiser completo coloque todos.
item_name,
item_id
quantity
price
item_brand: // se tiver
Observação: os atributos de price, value e quantity precisam obrigatoriamente ser do tipo number (numérico), não podem ser do tipo string.
O evento add_to_cart como o próprio nome já diz, acontece quando adicionamos um item ao carrinho, seja por clique no botão add to cart ou quando vamos para pagina do carrinho, geralmente os obrigatórios são os mesmos listados acima
item_name,
item_id
quantity
price
item_brand: // se tiver
Observação: os atributos de price, value e quantity precisam obrigatoriamente ser do tipo number (numérico), não podem ser do tipo string.
Antes da finalização da compra, o begin_checkout segue a mesma lógica dos processos acima e só reforçando o que vai mudar no código é o nome do evento no dataLayer.
Exemplo: event: "begin_checkout",
Observação: os atributos de price, value e quantity precisam obrigatoriamente ser do tipo number (numérico), não podem ser do tipo string.
O mais importante, o evento purchase quando a compra é finalizada precisa de alguns atributos a mais para a correta metrificação.
transaction_id - para não permitir que tenha duplicidade na compra, então esse e o ID da transação geral e não do item
affiliation - resumindo, é o nome da loja/site
value - valor da compra total, de tudo que foi comprado. "não é o valor de cada item"
currency - é o código da moeda, sem ele o analytics 4 não entende que se trata de um valor
e dentro de items/produtos os outros atributos;
item_name
item_id
quantity
price
Exemplo de código para view_item comentado:
Exemplo de código para purchase comentado:
A lógica é exatamente igual, porém vamos utilizar ao invés do dataLayer o gtag, assim enviando os eventos direto para o analytics sem precisar passar pelo Google Tag Manager.
Na verdade só vai mudar o final do código e vamos adicionar o gtag() como no exemplo abaixo.
No lugar do dataLayer.push vamos substituir por gtag.
1° Abra o Google Tag Manager e crie uma nova TAG de HTML personalizado.
2° Coloque os códigos dentro do HTML personalizado, com o acionamento em DOM PRONTO "todos" e salve
3° Agora crie uma nova tag de "Google Analytics: configuração do GA4" e coloque o ID da métrica do cliente, acionamento All pages.
4° Crie uma nova tag de Google Analytics: evento do GA4.
No nome do evento: você vai colocar o evento que representa a configuração, por exemplo: view_item_list, assim o GA4 vai reconhecer os parâmetros.
Adicione parâmetros do evento: os parâmetros vão validar e enviar as informações para o GA4, então precisamos seguir exatamente o padrão para não ter erro.
Nome do parâmetro: vai definir o nome, por exemplo: "items" onde recebe todos os produtos dentro do dataLayer, "value" que vai definir o valor total da compra.
Campo valor: Vai mostrar por meio de dataLayer ou Js onde estão armazenados os produtos ou valores, exemplo: {{ecommerce.items}}
Para adicionar o campo valor, é só clicar no botão de + e selecionar em seguida a opção camada de dados para dataLayer e definir o nome da camada de dados
Observação: Precisa ser o caminho do dataLayer onde armazena o item, conforme as imagens abaixo.
No exemplo abaixo, o caminho do dataLayer é ecommerce.impressions.
E para pegar o caminho você pode validar no seu código criado e enviado, caso o cliente já tenha integração ou dataLayer, é só inspecionar a pagina e ver qual caminho feito pela camada de dados, conforme imagem abaixo:
5° Crie um acionamento onde o evento acontece, por exemplo, se for o evento da imagem acima o acionamento vai ser em evento personalizado: productImpressions.
A configuração final do view_item_list fica conforme print abaixo
Para os eventos de purchase, precisa seguir outro padrão que são: transaction_id, value, currency e items, tem alguns outros, mas os marcados são obrigatórios para o correto funcionamento.
Necessário fazer o procedimento acima para todos esses eventos se for aplicavel, se for só compras, fazer só o de purchase.
view_item_list
view_item
add_to_cart
begin_checkout
purchase
Se o site tiver o mesmo padrão de dataLayer, podemos fazer do view_item_list até o check-out em uma única tag e no nome de evento colocar o {{event}} que vai escutar todos os eventos do dataLayer e o acionamento vai definir quais serão enviados para o GA4.
Exemplo: Posso colocar todos acionamentos, menos o purchase, view_item, add to cart, begin checkout.
Acessar: https://tagassistant.google.com/
Colocar o site e marcar os eventos de GA4.
Realizar os eventos configurados no site para acompanhamento.
Abaixo mapeei algumas validações importantes:
O vídeo abaixo tem o intuito de explicar como você faria quando o cliente já tem o dataLayer pronto, e como tratar os diversos tipos de dataLayer, mesmo quando não tiver um event.