Pop-ups, tours e checklists com o Google Tag Manager
Se o seu site já tem Google Tag Manager, alguém do marketing adiciona pop-ups, tours de produto e checklists sem nenhum deploy: instale o Clew uma vez como tag Custom HTML e crie tudo no editor do Clew.
- Tempo
- ● 10 minutos
- Quem faz
- Quem pode publicar no contentor do GTM
- Passos
- 8
Passo a passo
- Passo 01
Copie o seu código no Clew
Registe-se ou inicie sessão no Clew e abra Admin → Visão geral. Enquanto o widget não se liga, aparece o cartão “O widget ainda não deu sinal.” com a sua linha: clique para a copiar. É parecida com o código abaixo, mas com a sua chave real.
<!-- Clew: substitua COLE_AQUI_A_SUA_CHAVE pela chave do site em Admin > Visão geral --> <script src="https://tryclew.io/widget/COLE_AQUI_A_SUA_CHAVE.js" async></script>
Passo 1 · ilustração esquemática - Passo 02
Abra o contentor e crie uma etiqueta
Aceda a tagmanager.google.com, abra o contentor instalado no seu site e clique em Tags → New (na interface em português: Etiquetas → Nova). Confirme o nome do contentor: muitas equipas têm um para testes e outro para produção.
Passo 2 · ilustração esquemática - Passo 03
Escolha o tipo Custom HTML
Dê um nome à etiqueta no topo, por exemplo
Clew widget. Clique em Tag Configuration e escolha Custom HTML no grupo Custom. Em português, surge como HTML personalizado.
Passo 3 · ilustração esquemática - Passo 04
Cole a linha
Cole a linha do passo 1 no campo HTML. Deixe Support document.write desmarcado: o Clew não precisa dele.
Passo 4 · ilustração esquemática - Passo 05
Dispare em All Pages
Clique em Triggering, escolha All Pages (tipo Page View) e clique em Save. A etiqueta deve carregar no site inteiro: é o Clew que decide em que páginas, e para quem, aparece cada tour.
Passo 5 · ilustração esquemática - Passo 06
Verifique na pré-visualização
Clique em Preview (Pré-visualizar), escreva o URL do site e ligue. No Tag Assistant,
Clew widgettem de aparecer em Tags Fired. Se estiver em Tags Not Fired, reveja o acionador.
Passo 6 · ilustração esquemática - Passo 07
Envie e publique
No espaço de trabalho, clique em Submit (Enviar), dê um nome à versão, por exemplo
Adicionar widget do Clew, e clique em Publish (Publicar). Até publicar, nada muda no site em produção.
Passo 7 · ilustração esquemática - Passo 08
Confirme que funciona
Abra qualquer página do site numa janela normal e volte a Admin → Visão geral no Clew. Em menos de um minuto o cartão fica verde: “O widget está ativo.” Já pode criar o primeiro tour diretamente sobre o seu site.
Passo 8 · ilustração esquemática
O que convém saber sobre o GTM
Modo de consentimento
Se o contentor usa Consent Mode, abra na etiqueta Advanced Settings → Consent Settings e configure-o como a sua política de privacidade exige. Uma etiqueta à espera de consentimento só dispara depois de o visitante aceitar.
Vários sites no mesmo contentor
Cada site no Clew tem a sua chave. Se um contentor serve vários domínios, crie uma etiqueta por site e, em vez de All Pages, use um acionador Page View com a condição Page Hostname equals o seu domínio.
Ainda não tem GTM?
Instalar o GTM obriga a colocar o código dele em todas as páginas — o mesmo esforço que adicionar o Clew diretamente. Prefira o guia para construtores de sites ou o guia para assistentes de IA.
Problemas frequentes e perguntas
Custom HTML ou um modelo da galeria?
Custom HTML. Executa a linha oficial exatamente como o Clew a fornece, e não haverá nada para atualizar mais tarde.
Alguma coisa muda no Clew instalado pelo GTM?
Não. O widget carrega um instante depois do próprio contentor e funciona como na instalação direta: segmentação, análise e editor visual.
O painel continua a dizer “O widget ainda não deu sinal.”
Abra uma página do site publicado numa janela normal do navegador e recarregue o painel ao fim de um minuto. Se nada mudar: confirme que a alteração foi publicada e não apenas guardada; que substituiu o marcador pela sua chave real; e, nas ferramentas de programador do navegador, separador Network, procure widget/…js — a resposta deve ser 200. Um 404 indica uma chave errada.
O meu site tem Content Security Policy
Duas diretivas e mais nada: script-src https://tryclew.io e connect-src https://tryclew.io. O widget não usa eval, nem URL blob:, nem workers, e instala a sua folha de estilos por CSSOM em vez de como marcação — por isso style-src 'unsafe-inline' não é preciso no Chrome, Edge, Firefox 101+ ou Safari 16.4+. Os navegadores mais antigos recebem um elemento <style> de reserva: se ainda os suporta e o seu style-src não tem 'unsafe-inline', aí as visitas guiadas aparecem sem estilo. Para copiar: Content-Security-Policy: script-src 'self' https://tryclew.io; connect-src 'self' https://tryclew.io;
Posso fixar a versão do widget e usar <code>integrity=</code>?
Sim. A linha dos guias — /widget/COLE_AQUI_A_SUA_CHAVE.js — é a contínua: serve sempre o widget atual e, por isso, não pode levar um hash de Subresource Integrity (os bytes mudam). Ao lado dela, cada versão é também servida num endereço imutável com hash do conteúdo. Consulte https://tryclew.io/api/v1/widget-version?site=A_SUA_CHAVE e recebe version, path e integrity; coloque-os na etiqueta: <script src="https://tryclew.io/widget/v/<versao>/A_SUA_CHAVE.js" integrity="sha384-…" crossorigin="anonymous" async></script>. Um URL fixado nunca muda, pelo que o navegador recusa o ficheiro se um único byte for diferente. Atualiza a versão quando quiser — consulte o mesmo endpoint no script de implantação. Nada mais muda: os tours continuam a ser publicados no editor do Clew sem tocar no sítio.
Um bloqueador de anúncios engole o widget?
Não. O nosso domínio não está em nenhuma das listas grandes — EasyList, EasyPrivacy, AdGuard, uBlock Origin — por isso as visitas guiadas, as dicas e as checklists aparecem também a quem usa um bloqueador. O delicado são as estatísticas: o EasyPrivacy bloqueia todos os pedidos ping de terceiros, por isso o widget envia os seus eventos como um pedido normal, que essas listas deixam passar. Para ficar fora do alcance de qualquer lista personalizada, sirva o widget a partir do seu domínio: aponte https://o-seu-site/clew/* para https://tryclew.io/* no CDN ou no nginx e troque a linha por <script src="/clew/widget/A_SUA_CHAVE.js" async></script>. O widget passa a consultar a API com o mesmo prefixo e fica tudo first-party.
Funciona em aplicações de página única (React, Vue, Next.js)?
Sim. Carregue a linha uma vez, no HTML raiz ou no layout raiz. O widget acompanha sozinho as mudanças de rota no cliente (History API e alterações de hash), por isso não o adicione por rota nem o dispare com um acionador “History Change”: uma segunda cópia é ignorada, mas é trabalho inútil.
E o banner de consentimento de cookies?
O Clew guarda um cookie próprio e entradas no localStorage para se lembrar de que tours cada visitante concluiu e contar as conclusões. Não envia dados para redes de publicidade. Se pode correr antes do consentimento é uma decisão da sua política de privacidade (por exemplo, à luz do RGPD); se a ferramenta de consentimento o bloquear até o visitante aceitar, os tours simplesmente começam depois.
Uso um plugin de cache ou de otimização
Limpe a cache depois de instalar; caso contrário, os visitantes continuam a receber páginas antigas sem a linha. Se o plugin atrasa, combina ou adia JavaScript (WP Rocket, LiteSpeed Cache, Autoptimize, Cloudflare Rocket Loader), exclua tryclew.io/widget dessas otimizações.
O site vai ficar mais lento?
Não. A linha tem async: o navegador descarrega o widget em paralelo e executa-o sem bloquear a página. O widget não tem dependências.
A minha aplicação pode avisar o Clew de que um passo do onboarding está feito?
Pode, e é só uma linha. Uma tarefa da checklist pode ter uma regra que a marca sem o visitante clicar em nada: uma página a que ele chega, um clique num elemento que indica com um seletor CSS, ou um evento disparado pelo seu próprio código — Clew.complete('invited'), em que invited é a chave que escreveu ao lado da tarefa no editor. Chame no momento em que a tarefa está mesmo feita, por exemplo depois de a sua API confirmar o convite. É seguro chamar a qualquer altura e devolve false quando não há nenhuma checklist com essa chave na página. O nome antigo TutorKit continua a funcionar.
Outras formas de instalar
Assistentes de IA para programar
Um prompt para Claude Code, Cursor, Lovable, Bolt.new, v0 e Replit que coloca a linha no ficheiro raiz certo.
Abrir guia →Sem códigoConstrutores de sites e CMS
WordPress, Webflow, Shopify, Wix, Squarespace, Framer, Tilda ou HTML: onde está o campo de código do head e onde clicar.
Abrir guia →