<aside> 📌 Objetivo
O presente documento tem como objetivo orientar os clientes, que utilizam as tecnologia da SmartHint via API, a configurarem os eventos relacionados a ferramenta para o Google Analytics 4. Visto que, para clientes que integram via API, essa implementação fica na responsabilidade do cliente.
No entanto, ainda que o cliente tenha a responsabilidade e liberdade de configurar como deseja, ressaltamos que é recomendável seguir as orientações do documento para que haja uma maior facilidade em gerar os relatórios que possibilitem a análise do desempenho da SmartHint no negócio.
</aside>
Para a estruturação das informações necessárias que serão recebidas pelo Google Analytics, aconselhamos a utilizar a camada de dados.
<aside> <img src="https://cdn1.iconfinder.com/data/icons/google-s-logo/150/Google_Icons-09-512.png" alt="https://cdn1.iconfinder.com/data/icons/google-s-logo/150/Google_Icons-09-512.png" width="40px" /> Documentação Google sobre Camada de Dados
</aside>
Nessa seção do documento, 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. |
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.
