SignalHost para TYPO3: instale a extensão, ligue cada site e o tracking do lado do servidor fica ativo

• TYPO3 13.4 LTS ou 14.3 LTS, com PHP 8.2 ou mais recente e a extensão sodium.
• 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 administrador do backend. O módulo SignalHost é só para administradores.
• Um site cuja base, na configuração do site, tenha um domínio, como https://www.example.com/.

Numa instalação baseada no Composer, instale-a a partir do Packagist:

composer require signalhost/server-side-tagging

No modo clássico, instale-a antes a partir do Extension Manager; está no TYPO3 Extension Repository com a chave signalhost_server_side_tagging. Não acrescenta nada a um site até esse site estar ligado.

No backend do TYPO3, abra Sites › SignalHost (Site Management › SignalHost no TYPO3 13), onde cada site tem o seu próprio cartão. Depois da ligação, a SignalHost envia-o de volta para o endereço do próprio site, por isso abra o backend sob o domínio desse site; noutro domínio, o cartão tem um botão que abre a página no domínio certo, onde poderá ter de iniciar sessão uma vez.

No cartão do site, carregue em Connect with SignalHost, ou em Create a free account se ainda não tiver conta. 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 e regressa ao cartão com a mensagem Connected. O código da SignalHost está agora em todas as páginas deste site. Repita o processo para cada site que quiser medir.

O cartão do site 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.

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.

Um pequeno script por cada site ligado e um contacto de hora a hora:

• O carregador do Google Tag Manager, mesmo antes do fim do head de cada página do frontend, apontado para o endereço de etiquetagem do próprio site em vez de googletagmanager.com. Carrega a partir daí o seu contentor do Tag Manager. Entra na página final depois da cache de páginas do TYPO3, por isso não é preciso limpar nenhuma cache. Se o site aplicar a Content Security Policy do TYPO3, a extensão acrescenta-lhe o endereço de etiquetagem e autoriza o carregador pelo seu hash, a menos que a política já permita scripts inline.
• Uma vez por hora, depois de uma resposta ter sido enviada, a extensão contacta signalhost.io para se manter atualizada. Envia apenas as versões da extensão, do TYPO3 e do PHP, o endereço do site e a indicação de o código ter sido ou não encontrado na página inicial: nenhum dado de visitantes, nenhum conteúdo, nenhuma conta de utilizador. Se não for possível contactar signalhost.io, o 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. O carregador vem depois de um banner que esteja no head; um banner carregado mais tarde tem de definir antes dele os valores predefinidos do Consent Mode.

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 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 esse site para ele no próximo contacto, normalmente dentro de uma hora, e a sua Content Security Policy acompanha a mudança. Não é preciso substituir nada à mão, e o endereço antigo continua a funcionar até lá.

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 TYPO3, através do seu template ou de TypoScript), 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, um site que aplique a Content Security Policy do TYPO3 precisa que o script e o endereço de etiquetagem sejam autorizados à mão, 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.

Atualize-a da mesma forma que a instalou: através do Composer ou, no modo clássico, a partir do Extension Manager.

Disconnect, no cartão de um site, pede confirmação uma vez e depois remove de imediato o código da SignalHost de todas as páginas desse site e revoga o seu acesso. Os outros sites continuam ligados, e o seu contentor e os seus dados ficam na sua conta SignalHost.

Em signalhost.io, a página do contentor indica Instalado pela extensão para TYPO3, 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.

Desativar a extensão no Extension Manager, no modo clássico, revoga o acesso de todos os sites e remove o que ela guardou. O composer remove não executa código do TYPO3, por isso desligue primeiro cada site; caso contrário, continuam listados em Definições, Sites ligados, e terá de os desligar aí.

• O cartão diz SignalHost sends you back to the site's own address after connecting: abriu o backend sob outro domínio. Use o botão por baixo da mensagem para abrir a página no domínio do site.
• 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, em TypoScript 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.
• Qualquer outra coisa: escreva para hello@signalhost.io com o endereço do seu site.

A SignalHost é um produto independente da Algorithmo GmbH e não é afiliada nem apoiada pela TYPO3 Association, 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.; TYPO3 é uma marca registada da TYPO3 Association.