Central de ajuda · Marcação do lado do servidor com o Stape

Leve o consentimento para o seu contêiner de servidor

Hospede um contêiner de servidor do Google Tag Manager no Stape e confira se a escolha que o Velo coleta no navegador chega com cada requisição.

6 min de leituraRevisado em 18 de novembro de 2026

Como o consentimento chega ao seu servidor

O Velo funciona no navegador do visitante. Ele define o padrão do Google Consent Mode quando a página começa a carregar e o atualiza quando o visitante escolhe. As tags do Google adicionam esse estado de consentimento a cada requisição que enviam, incluindo as que enviam ao seu próprio contêiner de servidor.

Por isso não há nada do Velo para instalar no servidor. Você configura o Consent Mode uma vez, no contêiner web, e o contêiner de servidor lê o que chega. O Google descreve isso no seu guia de consentimento para a marcação do lado do servidor.

Antes de começar

  • A tag Velo CMP dispara em Consent Initialization - All Pages no seu contêiner web. O guia de instalação do GTM cobre isso.
  • Você pode criar contêineres na sua conta do Google Tag Manager.
  • Você tem uma conta no Stape.
Google Tag Manager: a tag Velo CMP com um ID de site, disparando no gatilho Consent Initialization - All Pages.
A tag Velo CMP no contêiner web, em Consent Initialization - All Pages.

Crie o contêiner de servidor

  1. No Google Tag Manager, abra Admin e clique em + na coluna do contêiner.
  2. Dê um nome ao contêiner, escolha Server como plataforma de destino e clique em Create.
  3. Em Install Google Tag Manager, escolha Manually provision tagging server e copie a configuração do contêiner.
Google Tag Manager, Create container: o nome Velo Demo Server e Server selecionado como plataforma de destino.
Passo 2: Server como plataforma de destino.
Google Tag Manager, Install Google Tag Manager: Manually provision tagging server selecionado, com o campo da configuração do contêiner logo abaixo. A configuração está oculta nesta imagem.
Passo 3: a configuração do contêiner. A nossa está oculta aqui.

Hospede o contêiner no Stape

  1. No Stape, clique em Create sGTM container e escolha Manually.
  2. Preencha Container name. Em Container configuration, selecione Manually e cole a configuração do contêiner.
  3. Escolha a Server location mais próxima da maioria dos seus visitantes. Não dá para mudá-la depois.
  4. Clique em Create Container e escolha um plano. O plano gratuito foi suficiente para o nosso teste.
  5. Na página do contêiner, espere o status Running e depois copie a Built-in container URL em Domains (Tagging Server URLs).
Stape, New sGTM container hosting: um nome de contêiner, Manually selecionado em Container configuration com a configuração colada e oculta, e a localização do servidor EU South (Italy).
Passos 2 e 3 no Stape. A configuração colada está oculta.
Página do contêiner no Stape: as configurações do contêiner com o ID do contêiner sGTM, e Domains (Tagging Server URLs) mostrando a Built-in container URL.
Passo 5: a Built-in container URL em Domains.

Para um site no ar, adicione o seu próprio subdomínio com Add new em Domains, para as requisições irem para o seu domínio. O guia de configuração do Stape cobre os registros DNS.

Conecte os seus contêineres

No contêiner de servidor: abra Admin → Container Settings, clique em Add URL em Server container URLs, cole a URL do Stape e salve.

Google Tag Manager, Container Settings do contêiner de servidor: a URL do Stape inserida em Server container URLs.
A URL do Stape em Server container URLs.

No contêiner web: abra a sua tag do Google Analytics, expanda Configuration settings, clique em Add parameter e adicione server_container_url com a mesma URL como valor. Mantenha a tag em Initialization - All Pages. A documentação do Google chama essa tag de tag do Google.

Google Tag Manager: uma tag do Google Analytics com o parâmetro de configuração server_container_url definido com a URL do Stape, disparando em Initialization - All Pages.
O parâmetro que envia as requisições desta tag para o seu servidor.

De volta ao contêiner de servidor: um cliente Google Analytics: GA4 (Web) já vem instalado e reivindica as requisições que chegam. Adicione as tags de servidor de que você precisa, seguindo o guia do Google para enviar dados a um contêiner de servidor. Publique os dois contêineres quando os seus testes passarem.

VisitanteEnviado com a requisiçãoPreview do servidor
Ainda não escolheugcs=G100ad_storage e analytics_storage Denied
Clica em Aceitar tudogcs=G111, e o Google Analytics envia a visualização de página de novoad_storage e analytics_storage Granted

Um visitante que recusa continua no estado negado. No preview do contêiner de servidor, os valores aparecem em Event data como x-ga-gcs e x-ga-gcd.

Tag Assistant do contêiner web, aba Consent do evento Consent Update: todos os tipos de consentimento negados pelo padrão on-page e concedidos pela atualização on-page, com security_storage concedido nos dois.
No navegador: o padrão do Velo e depois a atualização após Aceitar tudo.
Preview do contêiner de servidor no Stape, aba Consent, duas vezes: ad_storage e analytics_storage Denied na primeira visualização de página, e Granted na visualização de página enviada depois de Aceitar tudo.
No servidor: a mesma visita antes e depois de Aceitar tudo.
Preview do contêiner de servidor, Event data: x-ga-gcd, x-ga-gcs com o valor G100 e x-ga-gdid entre os valores de uma visualização de página.
Os valores de consentimento em Event data.

As tags de servidor do próprio Google leem esse estado. Com o consentimento negado, o Google Analytics não define nem lê cookies, e as tags do Google Ads não leem nem gravam cookies de publicidade. O Google lista o comportamento de cada tag no seu guia de consentimento do lado do servidor.

A aba Consent do preview também diz Consent not configured. Essa linha se refere ao próprio contêiner de servidor, que não define nenhum estado de consentimento próprio. A tabela acima dela mostra o estado que chegou com a requisição.

Faça as tags de outros fornecedores verificarem o consentimento

Tags de servidor de outros fornecedores, como a Meta Conversions API ou a TikTok Events API, não seguem sozinhas o estado de consentimento do Google. Cada uma precisa ser configurada para verificá-lo.

Na tag Facebook Conversion API do Stape, abra Tag Execution Consent Settings e selecione Send data in case marketing consent given. O padrão é Send data always.

A tag Facebook Conversion API do Stape em um contêiner de servidor: Tag Execution Consent Settings com as opções Send data always e Send data in case marketing consent given.
A configuração de consentimento na tag Facebook Conversion API do Stape.

Para qualquer outro template, procure uma configuração de consentimento na documentação dele. Depois teste uma visita recusada no preview do servidor e confirme que a tag não disparou.

Confira o resultado

  • Abra o Preview no contêiner web e carregue a sua página em uma sessão nova. No Tag Assistant, abra a aba Consent: em uma região de opt-in, o padrão on-page mostra Denied.
  • Abra o Preview no contêiner de servidor, no mesmo navegador. A visualização de página chega com ad_storage e analytics_storage Denied.
  • Clique em Aceitar tudo no banner do Velo. O Tag Assistant mostra a atualização on-page como Granted, e uma nova requisição chega ao servidor como Granted.
  • Comece uma sessão nova, clique em Recusar e confirme que as tags de servidor de outros fornecedores não disparam.
  • Repita com uma escolha parcial em Escolher o que permitir.

Pontos de atenção

Você carrega o Google Tag Manager a partir do seu próprio domínio.

O Custom Loader do Stape e configurações parecidas servem gtm.js a partir do seu domínio. Mantenha a tag Velo CMP em Consent Initialization - All Pages nesse contêiner, para o padrão continuar sendo definido primeiro. Se o Velo estiver instalado com o trecho de código direto, siga as orientações de ordem de carregamento para o tag gateway.

O Google também pede que você ative as configurações específicas por região quando o seu servidor serve os scripts do Google. O nosso teste carregou gtm.js a partir do Google, então confira isso você mesmo: a partir de um país de opt-in, o padrão on-page precisa mostrar Denied. Se não mostrar, marque Require opt-in in every region na tag Velo CMP até as configurações por região funcionarem.

O seu servidor define cookies.

Um cookie que o servidor define como HttpOnly não pode ser removido por nenhum script no navegador, nem pelo do Velo. Quando um visitante retira o consentimento, o Velo apaga os cookies conhecidos das categorias retiradas que um script consegue alcançar. Garanta que uma tag de servidor que define um cookie verifique o consentimento antes de fazer isso.

O modo de depuração do Velo não mostra nenhuma requisição do Google.

O modo de depuração reconhece os scripts e as requisições do Google pelos endereços habituais. Um custom loader que os renomeia pode escondê-los dele. Nessa configuração, use o Tag Assistant e o preview do servidor.

Ainda travado?

Conte até onde você chegou e a gente continua daí.