Blog
SignalHost para Joomla: instale a extensão, ligue uma vez e o tracking do lado do servidor fica ativo
Publicado · 7 min de leitura
Disponível na Joomla Extensions Directory
A extensão SignalHost põe o Google Tag Manager do lado do servidor num site Joomla sem uma única linha de código colado. Acrescenta o carregador de tracking a todas as páginas do seu site, mantém-no atualizado quando algo muda do nosso lado e retira-o quando desliga o site. Este guia segue a ordem em que vai encontrando cada passo: instalar o pacote, ligar um contentor, verificar se funciona e o que fazer quando algo não funciona.
Antes de começar
- Joomla 4.4, 5 ou 6, com PHP 7.4 ou mais recente.
- Uma conta SignalHost. O plano gratuito chega para experimentar: 10.000 pedidos por mês e um contentor. Pode criar a conta durante a ligação.
- Uma conta de Super User na administração do Joomla: ligar e desligar exigem permissão para configurar o componente SignalHost, que os Super Users têm.
1. Instalar a extensão
Descarregue o pacote do Joomla Extensions Directory, onde aparece como SignalHost Server-Side Tagging. Na administração do Joomla, abra System › Install › Extensions e carregue o ficheiro zip.
É um único pacote com duas partes: o componente SignalHost, onde liga o site e vê o seu estado, e o plugin de sistema System - SignalHost Server-Side Tagging, que põe o código nas suas páginas. A instalação ativa o plugin sozinha; ele não imprime nada até o site estar ligado.
2. Ligar o site a um contentor
Abra Components › SignalHost e carregue em Connect with SignalHost. Se ainda não tiver conta, Create a free account leva-o, em vez disso, ao registo. Nada é enviado para a SignalHost antes de carregar em Connect.
Em signalhost.io, inicie sessão. O ecrã seguinte enumera o que a extensão vai e não vai poder fazer e pergunta que contentor o site deve usar. Um contentor é o seu próprio servidor de etiquetagem: um contentor web e um contentor de servidor do Tag Manager, construídos na sua própria conta Google, por isso continuam a ser seus.
Escolha um contentor existente, ou carregue em Novo contentor para o seu site e percorra o assistente curto. Um contentor novo demora alguns minutos a construir; pode ligá-lo de imediato, e o código é acrescentado assim que estiver pronto. Carregue em Ligar. Regressa a Components › SignalHost com a mensagem Connected. O código da SignalHost está agora em todas as páginas do seu site.
3. Verificar se o código está no seu site
O ecrã indica agora Tracking is live, ou Tracking starts as soon as your container is ready enquanto um contentor novo ainda está a ser construído. Depois, leia a linha On your home page: logo após a ligação, a extensão obtém a sua página inicial tal como um visitante o faria e procura o seu código. Code found é a resposta que quer ver. Check again repete a verificação a qualquer momento, e as outras respostas estão em Quando algo não funciona.
4. Testar
Abra o seu site numa janela privada e percorra algumas páginas; um visitante que recuse o seu banner de cookies continua a ser contado, como ping sem cookies da Google. Depois carregue em Open statistics & settings para abrir a página do seu contentor em signalhost.io.
Em Estatísticas avançadas, o separador Recente mostra as visualizações de página dos últimos 30 minutos, incluindo as suas. Executar verificações, em Resolução de problemas, no fundo da página, compara o que o seu servidor de etiquetagem recebeu com o que o Google Analytics reporta para os mesmos 30 minutos. Menos no Analytics é normal: deixa de fora os visitantes que recusaram os cookies. A partir do plano Growth, Monitoramento de eventos ao vivo mostra cada evento à medida que chega.
O que a extensão acrescenta ao seu site
Um pequeno script e um contacto de hora a hora:
- O carregador do Google Tag Manager, no head das páginas do seu site, apontado para o seu próprio endereço de etiquetagem em vez de googletagmanager.com. Carrega a partir daí o seu contentor do Tag Manager. O plugin acrescenta-o através do Web Asset Manager do Joomla, por isso leva um nonce CSP quando o seu site usa um. Nunca é executado na administração, num feed nem numa vista só de componente.
- Uma vez por hora, depois de uma página ter sido enviada, o plugin contacta signalhost.io para se manter atualizado. Envia apenas as versões da extensão, do Joomla e do PHP, o endereço do seu site e a indicação de o código ter sido ou não encontrado na sua página inicial: nenhum dado de visitantes, nenhum conteúdo, nenhuma conta de utilizador. Se não for possível contactar signalhost.io, o seu site mantém a última configuração válida.
Cada pedido sai do navegador num formato que os bloqueadores de anúncios não reconhecem, e o seu servidor de etiquetagem reencaminha-o para o Google Analytics 4 e para as plataformas de publicidade que configurar na página do contentor: Google Ads, Meta, TikTok e outras. O tracking segue o seu banner de cookies através do Google Consent Mode; coloque o código do seu banner antes do da SignalHost.
A extensão não lê formulários nem encomendas. As visualizações de página chegam sozinhas; uma compra ou um lead chega ao seu contentor quando o seu site o envia para a camada de dados.
O seu próprio domínio de tracking
O seu contentor começa num endereço sob signalhost.io. Num plano pago, Configurar o seu próprio domínio, na página do contentor, muda-o para um subdomínio do seu próprio site, como sgtm.oseusite.com, com um único registo DNS no seu fornecedor. Esse endereço sobrevive às listas de filtros e mantém os cookies dos cliques como cookies de primeira parte. Quando fica ativo, a extensão muda o seu site para ele no próximo contacto, normalmente dentro de uma hora, e limpa a cache de páginas do Joomla. Não é preciso substituir nada à mão, e o endereço antigo continua a funcionar até lá.
Adicionar a SignalHost à mão
Também pode colar o código por si. Na página do contentor, encontre o seu snippet no cartão Instalar no seu site e carregue em Copiar. Cole-o no head de cada página (no Joomla, no template do seu site), logo a seguir ao script do seu banner de cookies, e carregue em Já o fiz. Copiar para agente de IA entrega a mesma tarefa a um agente de programação.
Colar à mão abdica do que a extensão faz: nada verifica a sua página inicial, nada remove o código quando desliga o site, o carregador não leva nenhum nonce CSP a menos que o acrescente, e quando o seu próprio domínio fica ativo é a si que cabe substituir o código, a partir do aviso Atualize o snippet do seu site no cartão ou do e-mail que anuncia o domínio. Nunca use os dois caminhos: duas cópias contam cada visita duas vezes.
Atualizações, gestão e desligar
As atualizações chegam pelo próprio atualizador do Joomla, em System › Update › Extensions, como as de qualquer outra extensão.
Disconnect, no ecrã Components › SignalHost, pede confirmação uma vez e depois revoga o acesso do site, retira o código de todas as páginas e limpa a cache de páginas do Joomla. O seu contentor e as suas estatísticas mantêm-se, e pode voltar a ligar a qualquer momento.
Em signalhost.io, a página do contentor indica Instalado pela extensão para Joomla, seguido do seu site. O botão Gerir leva a Definições, Sites ligados, onde Desligar também funciona: a extensão deixa de carregar a SignalHost no próximo contacto, normalmente dentro de uma hora.
Desinstalar o pacote remove tudo o que a extensão guardou. Desligue primeiro, para que a SignalHost também saiba que o site saiu.
Quando algo não funciona
- Code not found: o plugin pode estar desativado. Ative System - SignalHost Server-Side Tagging no gestor de plugins do Joomla e depois carregue em Check again.
- Could not check (your server refused a request to itself): o seu alojamento bloqueia pedidos ao seu próprio endereço. Isso não diz nada sobre os seus visitantes; procure o seu endereço de etiquetagem no código-fonte da sua página inicial.
- An older copy is on the page, ou The code is on the page twice: foi colada uma cópia à mão num template ou noutra extensão. Remova-a; a extensão acrescenta a versão atual, e duas cópias contam cada visita duas vezes.
- Um aviso de que o seu site já carrega um contentor do Tag Manager com o snippet da própria Google: remova esse snippet, porque a SignalHost passa a carregar o contentor e os dois juntos contam cada visita duas vezes.
- This site's address has changed since it was connected: numa cópia, como um ambiente de staging, nada é enviado. Se o site real mudou de endereço, desligue-o e volte a ligá-lo.
- Components › SignalHost abre sempre o painel em vez do componente: num Joomla acabado de instalar, a visita guiada do primeiro início de sessão faz isso a todas as páginas da administração até a ocultar.
- Qualquer outra coisa: escreva para hello@signalhost.io com o endereço do seu site.
Marcas registadas
A SignalHost é um produto independente da Algorithmo GmbH e não é afiliada nem apoiada pela Open Source Matters, pela Google, pela Meta ou pelo TikTok. Google Analytics, Google Ads e Google Tag Manager são marcas registadas da Google LLC; Meta é uma marca registada da Meta Platforms, Inc.; TikTok é uma marca registada da ByteDance Ltd.; Joomla! é uma marca registada da Open Source Matters, Inc.

