Se você utiliza a SmartHint via API, a configuração dos eventos no Google Analytics 4 (GA4) é de responsabilidade da equipe técnica da loja.
Embora você tenha total liberdade para personalizar esse rastreamento, preparamos este guia com as práticas recomendadas. Seguir estas orientações garante que os dados sejam coletados corretamente, facilitando a geração de relatórios e a análise precisa do desempenho da SmartHint no seu negócio.
Data Layer
Para a estruturação das informações necessárias que serão recebidas pelo Google Analytics, aconselhamos a utilizar a camada de dados.
[Documentação Google sobre Camada de Dados]
Eventos SmartHint
Nesta seção, vamos mostrar quais eventos precisam ser configurados e suas respectivas nomenclaturas recomendáveis.
| Nome do Evento | Acionamento | Parâmetros |
| view_item_list | Evento acionado quando se há carregamento de itens na página em uma vitrine, hotsite, pop-ups ou resultados da busca. |
item_list_id: Retorna o nome da lista que o item foi visualizado, pode ser o nome de uma vitrine, hotsite, pop-up ou resultado da busca. items: Retornar uma array de itens com pelo menos dois parâmetros: item_name: {Nome do item} item_id: {ID do item} Outros parâmetros que podem ser interessantes: price, item_brand, item_category, item_variant, index, quantity. Conferir documentação do Google. category_event: Retorna o valor “SmartHint” para identificar os eventos enviados pela SmartHint. |
| select_item | Evento acionado quando se há um clique no item em uma vitrine, hotsite, pop-ups ou resultados da busca. |
item_list_id: Retorna o nome da lista que o item foi clicado, pode ser o nome de uma vitrine, hotsite, pop-up ou resultado da busca. items: Retornar uma array de itens com pelo menos dois parâmetros: item_name: {Nome do item} item_id: {ID do item} Outros parâmetros que podem ser interessantes: price, item_brand, item_category, item_variant, index, quantity. Conferir documentação do Google. category_event: Retorna o valor “SmartHint” para identificar os eventos enviados pela SmartHint. |
| search | Evento acionado quando a Busca da SmartHint é acionada textualmente. Funciona tanto para a busca com ou sem o clique no autocomplete. |
search_term: Chave variável, retorna o termo pesquisado. category_event: Retorna o valor “SmartHint” para identificar os eventos enviados pela SmartHint. |
| search_voice | Evento acionado quando a Busca por Voz da SmartHint é acionada. |
search_term: Chave variável, retorna o termo textual identificado pela tecnologia a partir do que o usuário falou. category_event: Retorna o valor “SmartHint” para identificar os eventos enviados pela SmartHint. |
Termos retornados em Item_list_id
Apresentado na tabela anterior, o item_list_id é um parâmetro retornado nos eventos de view_item_list e select_item e ele retorna o nome da lista em que o item está presente. Abaixo está uma tabela com os valores que podem ser retornados e a identificação de qual lista da SmartHint ele está referindo-se.
| Valores retornados | Valor referente a lista… |
| smarthint-search | Resultado da busca |
| smarthint-like-similar | Vitrine “É do seu gosto? Então veja estes produtos similares” |
| smarthint-this-matches-with | Vitrine “Isto combina com” |
| smarthint-for-you | Vitrine “Recomendado para você” |
| smarthint-offers | Vitrine “Ofertas especiais” |
| smarthint-freq-bought-together | Vitrine “Frequentemente comprados juntos” |
| smarthint-best-sellers | Vitrine “Mais vendidos” |
| smarthint-best-sellers-in-category-* | Vitrine “Mais vendidos em” |
| smarthint-most-popular | Vitrine “Mais vistos” |
| smarthint-what-others-see-now | Vitrine “O que outros clientes estão vendo” |
| smarthint-news | Vitrine “Lançamentos” |
| smarthint-clearance | Vitrine “Baixou de preço” |
| smarthint-sold-recently | Vitrine “O que outros clientes estão comprando” |
| smarthint-last-viewed | Vitrine “Itens que você visualizou recentemente” |
| smarthint-bought-together | Vitrine “Compre Junto” |
| smarthint-who-saw-bought | Vitrine “Quem viu este produto acabou comprando” |
| smarthint-search-interest | Vitrine “Quem viu este produto, também se interessa por” |
| smarthint-custom-box-from-search-**** | Vitrine Customizada, os **** indicam o código que acompanha a vitrine |
| smarthint-combo-box-**** | Vitrine “Combo”, os **** indicam o código que acompanha a vitrine |
| smarthint-overlay-leaving-page | Pop-up “Não vá embora” |
| smarthint-overlay-cart | Pop-up “Última Chance” |
| smarthint-overlay-product-offer | Pop-up “Promoção relâmpago” |
| smarthint-hotsite-**** | Hotsite, o **** indica um sufixo que acompanha o evento e é variável de acordo com o hotsite criado |
Eventos recomendáveis do ecommerce
Existem alguns eventos que não são enviados automaticamente para o GA4, mas possuem uma orientação para sua nomenclatura. Esses são chamados de eventos recomendáveis e você pode conferir mais sobre aqui. Nesse contexto, existem os eventos recomendáveis para vendas on-line e você pode conferi-los abaixo.
| Evento | Acionar quando um usuário... |
| add_payment_info | envia as informações de pagamento durante a finalização da compra |
| add_shipping_info | envia as informações de frete durante a finalização da compra |
| add_to_cart | adiciona itens ao carrinho de compras |
| add_to_wishlist | adiciona itens à lista de desejos |
| begin_checkout | inicia a finalização da compra |
| purchase | conclui uma compra |
| refund | recebe um reembolso |
| remove_from_cart | remove os itens do carrinho de compras |
| select_item | seleciona um item de uma lista de itens ou ofertas |
| select_promotion | seleciona uma promoção |
| view_cart | visualiza o carrinho de compras |
| view_item | visualiza um item |
| view_item_list | visualiza uma lista de itens ou ofertas |
| view_promotion | visualiza uma promoção em seu site ou app |
Esses eventos, não estão diretamente ligados a SmartHint, mas são muito importantes para avaliar o desempenho da ferramenta em seu negócio. Sendo a integração via script com a ferramenta, não conseguimos interferir neles, mas sendo você um cliente que integrou via API, você pode colocar algumas informações nos parâmetros desses eventos para enriquecer seus relatórios do GA4.
Confira a documentação para desenvolvedores do Google Analytics 4 para eventos relacionados a Ecommerce.
Como você pode observar na documentação do Google, todos os eventos relacionados a ecommerce são alimentados pelo parâmetro “items” que contém um conjunto de chave e valores. Dentro desse conjunto, contém o parâmetro “item_list_id”, assim, para que consigamos observar mais corretamente o desempenho por funcionalidade da SmartHint, recomendamos que o time de desenvolvimento de vocês alimentem esse parâmetro com as nomenclatura que escrevemos na seção "Termos retornados em Item_list_id".
Logo, quando o item for originado de uma vitrine, resultado da busca, hot site, pop-up ou outra tecnologia provinda da SmartHint, com o parâmetro “item_list_id” sendo alimentado corretamente com essa informação para todos os eventos relacionados a Ecommerce, você conseguirá rastrear mais detalhadamente a contribuição de cada funcionalidade da SmartHint em seu negócio.
Lembrete: Nos relatórios do GA4, o parâmetro “
item_list_id” está representado pela dimensão "Código da lista de itens”.
Envio dos Eventos para o GA4
Documentação envio dos eventos via Gtag
[PÓS configuração da camada de dados, eventos e respectivos envios]
Conferindo se os eventos da SmartHint estão chegando no GA4
Após cadastrar o ID da Métrica em torno de 1h os eventos devem estar sendo enviados ao seu GA4. Para observar se isso está ocorrendo, siga os passos abaixo:
Acesso seu GA4 e clique no menu esquerdo em Relatórios > Tempo real.

2. Na parte inferior do dashboard, vá até o quadro “Contagem de eventos por Nome do evento”.

3. Os eventos que são enviados pela SmartHint foi apresentado anteriormente aqui, em resumo, são: view_item_list, select_item, search e search_voice. Eles podem estar na primeira página do bloco do relatório ou nas outras. Para conferir passe as páginas do relatório na setinha do canto inferior.

4. Para conferir exatamente que esses são eventos enviados pela SmartHint clique em cada um eles e seus parâmetros serão abertos. Para todos eles, um parâmetro denominado por “category_event” deve aparecer.

5. Se você clicar no parâmetro “category_event”, o valor “SmartHint” deve ser retornado.

6.✅ Pronto! Se os eventos aparecerem como descrito acima, eles já estão sendo enviados para seu GA4. Para que eles estejam disponíveis em seus relatórios, siga os passos adiante.
Lembre-se: No relatório de Tempo Real só aparece os eventos que foram ativados nos últimos 30 min em sua loja. Caso ele não tenha sido acionado nesse período, ele não aparecerá. Então, por exemplo, caso sua loja tenha a funcionalidade de busca por voz implementada e o evento “search_voice” não aparecer no relatório, provavelmente será porque ele não foi acionado.
No caso acima, você mesmo pode ir a loja e fazer uma busca por voz e depois de alguns minutos reparar se o evento aparece no relatório. Caso você não encontre os eventos em seu relatório ou tenha reparado algum problema, entre em contato com a equipe da SmartHint.
Adicionando os eventos como dimensões
No GA4, existem eventos que são “recomendados” e “personalizados”. Os recomendados, quando você o configura corretamente, o GA4 já insere ele automaticamente nos relatórios disponíveis. Exemplo: o evento de compra se chama purchase, ao configurá-lo para que seja enviado ao GA4, ele preencherá principalmente os relatórios de Monetização.
Dentro dos eventos que a ferramenta da SmartHint enviará ao GA4 e seus respectivos parâmetros, existem aqueles que o Google já reconhece automaticamente, pois utilizamos a nomenclatura recomendada, são eles: view_item_list, select_item, search, item_list_id e items. Os outros eventos e parâmetros são considerados “personalizados” e por esse motivo, para que eles sejam utilizados no relatórios que criaremos, precisaremos configurá-los como dimensões personalizadas no GA4 seguindo os passos do artigo "Adicionar eventos como dimensão - GA4"