Configurações para rastrear a pesquisa interna da VTEX com o Google Analytics, parametrizando via GTM.

vtex.gaSiteSearch.md

[VTEX] Método para rastrear pesquisas internas do site com o Google Analytics

Na VTEX, a tag do Google Analytics sempre é inserida através do Google Tag Manager, para ser executada em todo o site. Iremos personalizá-la para que, sempre que disponível, as keywords da busca realizada pelo usuário sejam enviadas ao GA.

Faremos isso personalizando a URL rastreada por ele, como se a VTEX sempre as colocasse no parâmetro ft. Ex: www.site.com/celular-android?ft=celular%20android

Este método não irá duplicar ou afetar os dados rastreados pelo Analytics e irá aproveitar o recurso de Pesquisa Interna nele já existente.

Variáveis (macros) necessárias

• {{searchTerm}} = tipo "Variável da camada de dados", nome da variável "siteSearchTerm". Estará presente no dataLayer de toda página de busca, tendo como valor as keywords da pesquisa do usuário.
• {{searchUrlFT}} = tipo "URL", componente "Consulta", chave de consulta "ft". Para caso a URL já possua o parâmetro (querystring) ft.
• {{searchVirtualPath}} = tipo "JavaScript Personalizado", com o script abaixo. Irá verificar se existe alguma keyword no dataLayer e também se já existe o parâmetro ft na URL e, com base nisto, montando a URL personalizada que será enviada ao GA.

function() {
    if ( {{searchTerm}} !== undefined && {{searchUrlFT}} === undefined ) {
        var sep = ({{Page URL}}.indexOf('?') > -1) ? '&' : '?';
        return {{Page Path}}
               + window.location.search + sep
               + 'ft=' + {{searchTerm}}
               + window.location.hash;
    }
    return;
}

• Certifique-se de que estão ativadas as macros (variáveis) de Páginas (quadro verde) de nomes Page URL e Page Path.

Personalizando a Tag

De certo que sua loja já possui no GTM uma Tag do Google Analytics, tipo "Exibição de Página", sendo executada incondicionalmente em todo o site.

Bastará em, "Mais configurações > Campos a serem definidos", incluir um campo de nome page, com valor {{searchVirtualPath}}.

Caso não exista uma keyword válida na página, não haverá um searchVirtualPath personalizado, então o valor de page não será alterado. Caso exista uma keyword, as macros já criadas irão definir um novo searchVirtualPath, o qual inclui o ft na URL, e isso será passado ao Google Analytics.

Configurando o Google Analytics

Nele bastará ativar o rastreio da busca interna, tendo como parâmetro de consulta a chave ft.

Artigo atualizado para contemplar alterações da nova versão do GTM.

Boa tarde, Garrucho.
Primeiramente obrigado pelo tutorial extremamente útil.

Criei as variáveis searchTerm, searchUrlFT e searchVirtualPath conforme as premissas, Page URL e Page Path ativos, na tag GA de Exibição de página, estou usando a variável searchVirtualPath e no Analytics deixei ativa a Busca Interna com o parâmetro "ft", porém ao tentar Publicar é apontado o seguinte erro:

Type: Unknown Variable Name
Location: searchVirtualPath
Description: Unknown variable 'searchTerm' found in another variable. Edit the variable and remove the reference to the unknown variable.

Tem ideia do que pode ser?
Abraço!

@mpaith Ops! Vi antes sua postagem na Comunidade ao comentário aqui... haha

Seguimos por lá, ok?

Abs!

Olá Garrucho beleza?

Então man configurei tudo certinho, mais na hora de "Personalizando a Tag" não encontro a opção : "Mais configurações > Campos a serem definidos". Isso dentro da tag do GA.

Há algo que tenha feito de errado ?

@juliomoreira666, verifique se você está usando a tag do tipo "Universal Analytics", e não "Google Analytics Clássico" (antiga)!

@garrucho @garrucho Estou fazendo essa implementação hoje e não estou conseguindo configurá-la. Você tem essas informações atualizadas?

@gabrielhakin Oi! Não atuei mais diretamente nessas frentes, então acabo não tendo nada.

Sei que a interface do GTM mudou bastaaaaaante, mas os conceitos deveriam ser os mesmos. Do lado da VTEX, exceto seja uma loja com tecnologia atualizada (VTEX IO Store Framework), tudo deve seguir igual em torno desse uso também. Mas não saberei ajudar. :(