Como instalar e configurar o plugin do WordPress¶
O plugin AdPulse sGTM faz o seu site WordPress servir os scripts do Google Tag Manager a partir do seu próprio domínio e encaminhar as requisições ao servidor de tags da AdPulse. Isso mantém o carregamento em primeira parte, em vez de depender de um domínio de terceiros.
Interface do plugin em inglês
O painel do plugin está disponível apenas em inglês. Os nomes de campo citados abaixo são exatamente os que aparecem no WordPress.
Pré-requisitos¶
- Um contêiner de servidor criado no painel da AdPulse e com status Ativo.
- O ID numérico desse contêiner — aparece na página do contêiner e nas instruções de integração.
- WordPress 5.8 ou superior e PHP 7.4 ou superior.
Passo a passo¶
- No painel do WordPress, vá em Plugins → Adicionar novo → Enviar plugin e envie o ZIP baixado do wordpress.org/plugins/adpulse — ou procure por AdPulse sGTM no diretório e clique em Instalar agora.
- Clique em Ativar.
- No menu lateral do WordPress, abra AdPulse → Settings.
- Marque Enable AdPulse sGTM integration.
- Em Container ID, informe o ID numérico do seu contêiner — por exemplo,
12345. - Clique em Save Settings.
Onde fica o ID do contêiner
No painel da AdPulse: Server GTM → Contêineres → clique no contêiner → o ID aparece no topo da página, junto com o ID do contêiner destacado.
O que passa a acontecer no seu site¶
Com o plugin ativado, o WordPress serve o script do GTM em https://<seu-site>/c/gtm.js e encaminha tudo que chega em /c/ para o servidor de tags da AdPulse, no contêiner que você configurou.
A própria página de configuração mostra a URL resultante na seção Status, na linha GTM URL.
Referência de configuração¶
| Campo | Padrão | Descrição |
|---|---|---|
| Enable AdPulse sGTM integration | desativado | Liga a injeção dos scripts do GTM nas páginas. |
| Container ID | vazio | ID numérico do contêiner server-side no painel da AdPulse. |
| Proxy Path | /c/ |
Caminho do seu site em que o GTM é servido. |
| Proxy Timeout | 15 |
Tempo máximo, em segundos (1 a 60), de espera pela resposta do servidor de tags. |
| Include visitor IP address when consent is granted | ativado | Envia o IP do visitante ao GTM somente quando o consentimento foi concedido. |
A seção Status da mesma página mostra o estado do plugin (Active/Inactive), a versão instalada, o ID configurado e a URL do GTM.
Trocar o caminho do proxy¶
Se você mudar Proxy Path, as regras de URL do WordPress precisam ser regeneradas — elas são atualizadas na ativação e na desativação do plugin. Depois de salvar o novo caminho, vá em Configurações → Links e clique em Salvar sem alterar nada, ou desative e reative o plugin.
Solução de problemas¶
| Situação | O que significa | O que fazer |
|---|---|---|
| "Plugin is enabled but no Container ID is set." | O plugin está ligado, mas sem ID de contêiner. | Informe o Container ID em AdPulse → Settings e salve. |
Aviso "Container ID not configured" ou página em erro 400/500 no caminho /c/ |
O plugin recebeu uma requisição sem contêiner configurado. | Confirme o ID e salve as configurações. |
| O script do GTM não carrega na página | O plugin está desativado ou o caminho do proxy mudou sem regenerar as regras. | Ative o plugin e regenere as regras de links (veja acima). |
| O servidor de tags responde devagar ou expira | O tempo de espera é curto para a sua região ou para o seu tema. | Aumente Proxy Timeout (até 60 segundos). |
| O GTM não aparece em certas páginas | O plugin injeta o script nas páginas geradas pelo WordPress. | Confirme que a página é servida pelo WordPress e não por um cache estático pré-renderizado. |
| O ID está certo mas nada é rastreado | O contêiner ainda não está Ativo no painel da AdPulse. | Verifique o status do contêiner em Server GTM → Contêineres. |
URL do dashboard
O plugin mostra um link para o painel da AdPulse. O endereço atual é app.adpulse.com.br.