Guia de Deploy — sGTM + WordPress (Plugin Prime2B SST)

Este guia descreve, passo a passo, como publicar e validar um setup completo de Google Tag Manager Server-Side (sGTM) integrado a um site WordPress, usando o plugin Prime2B SST, com implantação via Google Cloud Run e configuração manual nos containers GTM Web e GTM Server.

---

1) Conceito geral

• GTM Web: container instalado no WordPress, coleta eventos do navegador (page_view, click, etc.).
• GTM Server (sGTM): container hospedado no Google Cloud Run que processa e envia os dados para as plataformas (GA4, Ads, Meta, etc.).
• Domínio customizado (opcional): ex. tags.seusite.com, permite rastreamento first-party e maior precisão de dados.

---

2) Criação do container Server-Side (Cloud Run)

1. No Google Tag Manager, crie um novo container do tipo Server.

2. Vá em Administrador → Instalar/Implantar contêiner → Google Cloud Platform (Cloud Run).

3. O assistente abrirá o Google Cloud Run e criará o serviço automaticamente.

4. Após o deploy, você receberá um endereço no formato:

   https://server-side-tagging-xxxxx-uc.a.run.app

5. Esse endereço já pode ser usado — o sGTM funciona mesmo sem domínio próprio.

---

3) Mapeamento de domínio (opcional, via Cloud Run)

Para usar um domínio próprio (como https://tags.seusite.com):

1. No Google Cloud Run, abra o serviço do seu container Server-Side.

2. Vá em Configurações → Mapeamento de domínio → Adicionar domínio personalizado.

3. Informe o subdomínio desejado:

   tags.seusite.com

4. Configurações de região: mantenha o campo desmarcado.

5. O Google exibirá registros A e AAAA que devem ser adicionados no DNS do seu domínio:

   Tipo: A     | Valor: 216.239.32.21
   Tipo: A     | Valor: 216.239.34.21
   Tipo: A     | Valor: 216.239.36.21
   Tipo: A     | Valor: 216.239.38.21
   Tipo: AAAA  | Valores IPv6 fornecidos no painel

6. Após a propagação (30–60 min), o domínio será validado e o SSL ativado automaticamente.

7. Copie o domínio final (ex: https://tags.seusite.com) e adicione nas Configurações do Contêiner Server → Tagging Server URL.

💡 O Cloud Run não gera CNAME; ele fornece diretamente registros A e AAAA para apontamento.

---

4) Configuração no WordPress (Plugin Prime2B SST)

1. Instale e ative o plugin Prime2B Server-Side Tracking (SST).

2. Vá em Configurações → Server-Side Tracking e preencha:

   • GTM Container ID (Web): GTM-XXXXXXXX
   • Tagging Server URL: https://tags.seusite.com
   • GA4 Measurement ID: G-XXXXXXXXXX
   • (Opcional) API Secret: se desejar enviar hits diretos via Measurement Protocol.

3. O plugin injeta automaticamente o script do GTM e gera o dataLayer, event_id e Consent Mode.

---

5) Configuração do GTM Web (GTM-XXXXXXXX)

Função: coletar os eventos e enviá-los para o container Server-Side.

Configurações aplicadas:

Item	Valor
Tag principal	GA4 Configuration Tag
Measurement ID	G-XXXXXXXXXX
Campo adicional	transport_url
Valor do campo	https://tags.seusite.com
Acionadores	All Pages (ou eventos específicos)
Consent Mode	granted (ou conforme política de privacidade)

Esse parâmetro transport_url redireciona o tráfego do GA4 client-side para o servidor (sGTM).

---

6) Configuração do GTM Server (GTM-YYYYYYYY)

Função: receber eventos do GTM Web e processá-los antes de enviá-los ao GA4.

Clientes configurados:

Tipo	Status
Google Analytics: GA4	✅ Ativado (cliente principal)

Configurações principais do cliente GA4:

• Cookies e identificação do cliente: Gerenciados pelo servidor

• Configurações de cookies:

  • Nome: FPID
  • Domínio: auto
  • Caminho: /
  • Duração: 63072000 (2 anos)

---

Tag principal (GA4 Advanced)

Propriedade	Valor
Tipo	GA4 Advanced
Measurement ID	G-XXXXXXXXXX
Redact visitor IP	false
Default Parameters	all
Default Properties	all
HTTP Request	https://www.google-analytics.com/g/collect
Acionador	All Events (RegEx .*)

Essa tag é acionada sempre que o cliente GA4 processa um evento vindo do site.

---

7) Fluxo completo de funcionamento

1. O visitante acessa o site (seusite.com).
2. O GTM Web envia eventos (page_view, scroll, etc.) para o Transport URL https://tags.seusite.com.
3. O GTM Server recebe, processa e envia os dados ao GA4.
4. O GA4 confirma o recebimento com código HTTP 204 (No Content).

---

8) Teste e validação

• Tag Assistant: visualize a conexão entre Web e Server.

• GTM Server Preview: deve exibir eventos como page_view, scroll, user_engagement.

• GA4 → Tempo Real: deve mostrar as interações chegando.

• DevTools → Network → “collect” deve exibir chamadas como:

  https://tags.seusite.com/g/collect?v=2&tid=G-XXXXXXXXXX...

  com status 204 ✅.

---

9) Observações importantes

Situação	Solução
“The client that claimed the request did not send a response”	⚠️ Mensagem comum no modo debug. Ignorar.
404 no domínio customizado	DNS A/AAAA ainda não propagado ou SSL pendente.
Eventos duplicados	Verificar se há mais de um GTM no site.
Nada chega no GA4	Confirmar transport_url, Measurement ID e publicação dos containers.

---

10) Checklist final

✅ Cloud Run

• Container Server implantado
• Domínio customizado mapeado (A/AAAA)
• SSL ativo
• Campo “Região” desmarcado

✅ WordPress

• Plugin Prime2B SST configurado
• GTM Web ID e Tagging Server URL preenchidos
• GA4 Measurement ID informado

✅ GTM Web

• GA4 Configuration com transport_url configurado
• Acionadores “All Pages” e outros eventos adicionados
• dataLayer ativo

✅ GTM Server

• Cliente GA4 habilitado
• Tag GA4 Advanced configurada
• Eventos processados com status 204