top of page
  • Foto do escritorDaniel Constant

Extrair parâmetros de consulta da URL com o Gerenciador de Tags do Google


Extrair Parâmetros de Consulta do URL com o GTM

O Google Tag Manager ajuda a você a fazer muitas coisas e, uma dessas coisas, é extrair os parâmetros de consulta da URL.


"Mas Daniel, o que são parâmetros de consulta na URL?"

Sabe quando você clica em algum link e a URL no navegador fica 'estranha' com um '?' no endereço cheio de coisas depois? Então, tudo que tem depois desse '?' é parâmetro de consulta.

Mais abaixo eu explico melhor o que é o parâmetro de consulta.


Algo muito útil que podemos fazer através do Google Tag Manager é recuperar o valor desses parâmetros e utilizá-lo em alguma Tag, acionador e até mesmo em outra variável.


Vem comigo que vou te mostrar alguns exemplos de como extrair parâmetros de consulta no GTM.


 

Índice

 
 

O que é um parâmetro de consulta?


O parâmetro de consulta (também conhecido como string de consulta) é uma parte do URL que atribui valores aos parâmetros especificados.


Um exemplo típico de URL com o parâmetro de consulta pode ser assim:

https: ///www.daniel-constant.com/search?keyword=variavel+url


No exemplo acima, o parâmetro de consulta é “keyword” e seu valor é “variavel+url“.


Um dos parâmetros de consulta mais utilizados (se não o mais utilizado) são os parâmetros UTM.

Se você deseja acompanhar o impacto de suas campanhas de publicidade (no Google Ads ou Facebook Ads, por exemplo), você pode adicionar UTMs aos seus links (por exemplo, utm_medium ou utm_source ) e o Google Analytics os detectará automaticamente, atribuindo a sessão a essa origem de tráfego específica.


É muito comum que sites se utilizem dos parâmetros de consulta para que seu funcionamento seja correto. Um exemplo disso seria quando um site se utiliza do parâmetro 'curso_id' para passar a informação de um curso selecionado.

Nós podemos recuperar essa informação e passar na forma de dimensão personalizada para o Google Analytics para usarmos de alguma forma em relatórios.


Continue lendo e mostrarei como fazer isso.



Como extrair um parâmetro de consulta do URL da página atual


O Google Tag Manager tem uma variável bem útil chamada URL.

Essa variável pode retornar o valor de um parâmetro de consulta específico que está no URL.

Portanto, se um URL realmente contém, digamos, um ID de produto ( https://www.daniel-constant.com/cursos?curso_id=12345 ), com essa variável, você poderia realmente buscar e obter o valor de “12345”.


Se você deseja extrair um parâmetro de consulta com o Gerenciador de Tags do Google, entre em Variáveis, depois Nova (na parte de 'Variáveis ​​definidas pelo usuário').

Insira as seguintes configurações:

  • Tipo de variável: URL

  • Tipo de componente: Consulta

  • Chave de consulta: curso_id (você deve inserir aqui o nome da string de consulta real que deseja obter)

Variavel URL GTM

Salve a variável.

Entre no modo Debug (botão Visualizar), insira a URL do site com a string de consulta na URL e verifique o menu 'Variáveis'.

Você vai encontrar a variável de URL criamos e que retorna o valor do parâmetro de consulta.


 

Quer conhecer um pouco mais sobre GTM?

  • Google Tag Manager - Básico: Pra você que não precisa de nada muito avançado do GTM mas quer suas Tags, Pixels e eventos funcionando da forma correta.

 

Como extrair um parâmetro de consulta do URL clicado (ou qualquer outro que você definir)


Outro recurso interessante da variável URL no GTM é que você pode trabalhar não apenas com a URL da página atual (este é o modo que a variável funciona por padrão). Na verdade, você pode usar qualquer variável como entrada.


Por exemplo, se você deseja extrair um parâmetro de consulta de um link clicado, faça isso:

  • Na variável de URL, expanda a seção Mais configurações;

  • E escolha o {{Click URL}} como origem do URL.

Variavel URL GTM com Origem diferente

Salve e teste.


Essa variável retornará a string de consulta curso_id do URl que foi clicado. Caso o URL clicado não tenha um parâmetros de consulta curso_id, então a variável vai retornar um valor indefinido (undefined).




Extrair TODOS os parâmetros de consulta que estão no URL


Se você precisar extrair todos os parâmetros de consulta do URL e tê-los como uma única variável, poderá usar o tipo de variável JavaScript do Gerenciador de Tags do Google (a variável de URL retorna o valor de apenas um parâmetro).


Vá para Variáveis, Nova e escolha Variável JavaScript.

Em Nome da variável global, coloque document.location.search.

variável javascript tag manager

Isso retornará todos os parâmetros de consulta que estão presentes no URL (incluindo o ponto de interrogação à esquerda). Como isso:

?curso_id=GTM-Basico&categoria=curso


Se você não quiser ter esse ponto de interrogação na variável, pode usar esta variável JavaScript personalizado.

function () {
    return document.location.search.split('?')[1];
}

Esse código vai retorna o valor sem o ponto de interrogação: curso_id=GTM-Basico&categoria=curso.




Considerações Finais


Você aprendeu como usar a variável de URL para extrair um parâmetro de consulta com a ajuda do Gerenciador de Tags do Google, além disso você viu como fazer para recuperar todo o parâmetro de consulta via variáveis de JavaScript.


Se você tiver a possibilidade de escolher entre utilizar uma variável pronta do Google Tag Manager e um código JavaScript personalizado, sempre use a funcionalidade integrada do GTM (no caso desta dica rápida, a variável de URL).


A propósito, a variável URL é muito versátil e pode recuperar não apenas parâmetros de consulta, você pode obter, também, o valor do fragmento de URL, nome do host, etc. Para isso, escolha um tipo de componente diferente nas configurações da variável.


Até a próxima.


 

Sobre o autor:

Me chamo Daniel Constant, trabalho com TI e Produtos Digitais há mais de 14 anos e vou te ensinar a usar o Google Tag Manager.

 

Já conhece os cursos de GTM que preparei pra você?

 

Comments


Daniel Constant

Prazer, eu sou o Daniel Constant e vou te ensinar tudo sobre Google Tag Manager. Você vai aprender a instalar Tags, Pixels e cadastrar seus eventos e conversões. Rastrear e Traquear ações não vai ser mais um problema pra você.

Precisa de Ajuda com seu Google Tag Manager?

Faço toda a configuração pra você:

  • Pixel Facebook;

  • Tag Google Ads;

  • Tags Google Analytics;

  • Eventos;

  • Conversões;

  • Pinterest, LinkedIn;

  • Traqueamento;

  • E muito mais.

Clique aqui e saiba mais ou me chame no WhatsApp.

Rbbbe08a939799189efe331c947089e3c.png
bottom of page