A conexão com o Google Tag Manager é feita pelo login Google (OAuth): você entra com a sua
conta e autoriza as permissões na tela de consentimento do próprio Google. Nenhuma senha é
digitada na Toca. A integração pode estar em liberação gradual: se o card não aparecer para a sua conta em Configurações → Integrações, fale com o suporte.
Antes de começar
- Tenha em mãos a conta Google que tem acesso à conta e ao container do Tag Manager do seu site.
- O consentimento do Google é por integração: conectar o Tag Manager não autoriza o Gmail nem as outras integrações Google. Cada uma tem o próprio card e o próprio pedido de permissão.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Google Tag Manager e clique no botão de conexão.
- Na tela do Google, escolha a conta com acesso ao Tag Manager e autorize as permissões solicitadas.
- Ao voltar para a Toca, o card fica marcado como conectado e a Toca já consegue consultar suas tags.
O que a Toca acessa
Com a conexão ativa, a Toca lê as contas, containers e workspaces do seu Tag Manager: as tags, gatilhos e variáveis configurados, o que está publicado e o que ficou pendente no workspace. É o que permite diagnósticos como conferir se um pixel dispara na compra.
A Toca também sabe criar e ajustar tag, gatilho e variável, e publicar uma versão — alterações só acontecem mediante sua aprovação explícita, pedido a pedido, dentro do chat. Há uma distinção importante: criar ou alterar algo muda apenas o workspace, sem efeito no site; o que muda o site de fato é publicar uma versão, e a publicação é uma aprovação à parte, tratada como a ação de maior risco desta integração.
Manutenção da conexão
A conexão usa tokens que a Toca renova automaticamente: ela permanece ativa até você
desconectar a integração na Toca ou revogar o acesso nas configurações da sua conta Google.
Se o acesso for revogado no Google, as consultas param de funcionar e é preciso refazer a
conexão pelo card em Configurações → Integrações.
Problemas comuns
- Aviso de app não verificado na tela do Google — enquanto a verificação do app junto ao Google estiver em andamento, a tela de consentimento pode exibir um aviso de app não verificado. Se tiver dúvida sobre como prosseguir, fale com o suporte.
- O diagnóstico demora — a API do Tag Manager tem uma das cotas mais apertadas do Google (a documentação indica cerca de 25 requisições a cada 100 segundos por usuário), e a Toca respeita esse ritmo. Um levantamento de vários containers leva alguns minutos; os limites exatos, confirme na documentação oficial do Google.
- Criei uma tag e o site não mudou — é o comportamento esperado: a alteração fica no workspace até você aprovar a publicação de uma versão.
- Conectei a conta errada — desconecte a integração na Toca e refaça a conexão escolhendo a conta certa na tela do Google.