GrátisPower-ups

Custom GTM Loader

Custom Loader ajuda a tornar os scripts do Google Tag Manager e Google Analytics 4 mais resistentes aos bloqueadores de anúncios e ITPs, modificando o caminho de carregamento do gtag.js e gtm.js. Além disso, um Custom Loader e um Custom Domain ajudam a definir cookies de primeira parte e a prolongar a vida útil dos cookies.

Como configurar o Custom Loader

2. Selecione o seu contentor sGTM no painel de controlo.

sGTM containers

3. Clique em «Power-ups» e, em seguida, clique no botão “Use” ao lado do painel Custom Loader.

Power-ups section in Stape account

4. Ative o botão Custom Loader.

Turn on Custom Loader

5. Configure o Carregador Personalizado com as seguintes definições:

  • Domain - escolha um dos domínios associados ao seu contentor.
  • Web GTM ID - cole o seu ID do Google Tag Manager Web.
  • Enhanced ad blocker protection - quando esta opção estiver ativada, todos os seus pedidos ao servidor sGTM serão encriptados para que os bloqueadores de anúncios não os possam bloquear com base em padrões de pedido.
  • Same Origin Path - se tiver a mesma origem configurada, especifique o caminho utilizado, e tanto o GTM como o GTAG JS serão carregados através da mesma origem. Saiba mais sobre a abordagem de mesma origem para o GTM de servidor aqui.
  • Platform - o código GTM web difere para cada plataforma de comércio eletrónico. Se estiver a utilizar aplicações Stape para CMS, selecione a plataforma na lista. Caso contrário, selecione a opção «Outro» para gerar um snippet JS. Pode saber mais sobre as aplicações Stape Conversion Tracking para CMS na nossa página.
Custom Loader configuration screen

Se utiliza a plataforma Shopify, WordPress, Magento, BigCommerce, Wix ou PrestaShop, precisará de uma aplicação/plug-in/extensão específica desenvolvida pela Stape para configurar o Custom Loader.

1. Descarregue e configure a aplicação para a sua plataforma:

Custom loader in CMS app

2. Volte à página de configuração do Custom Loader. Depois de introduzir todas as informações de código e configuração, clique no botão Generate

3. Siga as instruções no painel de configuração para configurar o Custom Loader na sua aplicação.

Config example for Shopify

Se selecionar a opção «Outra plataforma», ser-lhe-á fornecido um código JS para utilizar no seu site em vez do carregador padrão do GTM. Para configurar o código, introduza as seguintes informações adicionais:

  • User identifier type - disponível se a opção «Gerar com o Cookie Keeper» estiver ativa (ver abaixo). O método de identificação recomendado é um cookie. Para mais detalhes, veja como escolher um Identificador de Utilizador.
  • Cookie name - defina o nome do cookie de primeira parte a utilizar como identificador de utilizador.

Pode clicar em Configurações avançadas para introduzir informações adicionais:

  • Data Layer variable name - especifique se utiliza um «dataLayer» não padrão; caso contrário, deixe em branco.
  • Generate with Cookie Keeper - disponível se tiver o complemento Cookie Keeper ativo.
  • Set _xsd localStorage only after consent - quando ativado, o Stape armazena o estado do bloqueador de anúncios no _xsd localStorage apenas após o consentimento para analytics_storage ser concedido no Modo de Consentimento do Google. Sem consentimento, a deteção continua a ser executada, mas o resultado não é guardado entre visitas à página. Se desativado, o armazenamento no localStorage ocorrerá independentemente do estado do consentimento.

6. Clique em Generate. Ser-lhe-ão então fornecidas instruções sobre como adicionar um Carregador Personalizado ao seu site (ou um código JS, caso tenha selecionado a plataforma «Outra»).

Generate code for other websites

Efetue as alterações necessárias no seu site (adicione o código) ou nas aplicações Stape que utiliza.

Ao adicionar o Custom Loader ao site, certifique-se de que remove também o carregador padrão do GTM, caso exista.

Teste a configuração do Custom Loader

Para verificar se tudo funciona corretamente, clique com o botão direito do rato em qualquer página do site → clique em Inspecionar → abra o separador Rede. Em seguida, introduza o seu subdomínio personalizado ou o mesmo caminho de origem, se utilizado. 

Se tudo estiver correto, deverá ver o URL do pedido do Google Tag Manager e o código de estado «200 OK».

Segue-se um exemplo de encriptação do pedido GA4 com o Carregador Personalizado ativo e a proteção avançada do bloqueador de anúncios ativada:

With a loader example

E eis como fica sem o Custom Loader e sem a proteção avançada do bloqueador de anúncios configurada:

Example without Loader

Benefícios do Custom Loader

  • Define cookies de primeira parte.
  • Torna o GTM e o GA4 resistentes aos bloqueadores de anúncios e ITPs.
  • Mantém o rastreamento de dados intacto.

Casos de uso do power-up

Posts relevantes no blogue

Vantagens do alojamento de Stape para o servidor Google Tag Manager
28 de out de 2025

Blog

Vantagens do alojamento de Stape para o servidor Google Tag Manager

Hospedar o seu servidor Google Tag Manager no Stape é a melhor forma de configurar a etiquetagem do lado do servidor. Eis porque...

O que é rastreamento do lado do servidor?
31 de mar de 2026

Blog

O que é rastreamento do lado do servidor?

A imaginar o que é e como funciona a etiquetagem do lado do servidor? Este post no blog vai explorar tudo isso e muito mais!

Temos mais de 200 000 clientes satisfeitos

Experimente o Stape para tudo relacionado ao lado do servidor