Suporte: seg. a sex., das 9h às 18h

Como funciona a integração com o Google (Analytics, Ads e Tag Manager)

Atualizado em 05/10/2026

A integração com o Google conecta a loja ao ecossistema de medição e anúncios do Google. Com ela, a navegação e as vendas viram dados no Google Analytics, no Google Ads e no Tag Manager, o que permite entender o comportamento dos visitantes e otimizar campanhas.

Você a encontra em Marketing & SEO > Integrações, no item Google. A integração é dividida em partes, e cada parte tem a própria tela no menu lateral: Google Tag Manager, Google Ads, Google Ads (Campanhas), Google Analytics, API de Conversão e Google Avaliações.

A loja envia os eventos sozinha (visualização de produto, carrinho, etapas do checkout e compra). Você não precisa programar nada: em cada tela, basta informar o identificador que o Google fornece. A seguir, o que é cada parte e onde achar esse identificador.

Visão geral

A primeira tela da integração resume todas as partes, cada uma com um selo de estado e o botão Configurar, que leva à tela dela. O mesmo selo aparece no topo da tela de cada parte e reflete o que já está gravado:

  • Verde — a parte está configurada e em uso ("Ativo" ou "Ativa").
  • Amarelo — a parte foi começada, mas falta um dado para ela funcionar por completo, e o próprio selo diz qual (por exemplo, "Falta o código de conversão").
  • Cinza — a parte ainda não foi configurada ou está desligada.

Comece por ela para descobrir o que falta, sem precisar abrir tela por tela.

Google Tag Manager (GTM)

O Tag Manager é um gerenciador de etiquetas (tags). Em vez de instalar o código de cada ferramenta direto na loja, você cadastra tudo dentro do GTM e ele cuida da entrega. A loja envia os eventos para uma camada de dados, e o GTM distribui para quem precisa.

Informe o ID do contêiner, no formato GTM-XXXXXX, que aparece no topo do Google Tag Manager. Com o campo em branco, a loja não carrega o GTM. A tela também lista os eventos que o contêiner recebe, o que ajuda quem vai montar as tags dentro do GTM.

Google Ads

Esta tela serve para o Google Ads saber quais cliques nos anúncios viraram venda. Sem isso, a plataforma fica no escuro e não consegue otimizar os lances para buscar mais compradores.

Informe dois dados, ambos obtidos no Google Ads, no menu de Metas e conversões:

  • Global Tag — no formato AW-XXXXXXXXX. Registra as visitas para o Google Ads.
  • Código de Conversão — o rótulo que identifica a ação de compra.

Os dois campos trabalham juntos. Só com a Global Tag, a tag carrega, mas a compra não vira conversão na campanha, e o selo fica amarelo, com "Falta o código de conversão".

Google Ads (Campanhas)

Esta parte faz o caminho inverso das outras: em vez de enviar dados ao Google, ela traz o investimento, os cliques e as conversões das campanhas para a tela Marketing & SEO > Campanhas. É uma autorização só de leitura, separada da Global Tag e do Código de Conversão, então uma não substitui a outra.

  1. Clique em Conectar Google Ads e autorize com a conta do Google que tem acesso à conta do Google Ads da loja. Ao final, você volta para a mesma tela.
  2. Clique em Carregar contas e escolha, no campo Conta do Google Ads, a conta que a tela de Campanhas vai acompanhar.
  3. Confira se Acompanhar as campanhas no painel está ligado e grave.

A conexão já deixa o acompanhamento ligado, mas ele só funciona com a conta escolhida. Por isso a tela recusa a gravação com o acompanhamento ligado e a conta em branco, e também recusa ligá-lo antes de conectar. Para conectar outra conta do Google, use o botão Reconectar. Para acompanhar outra conta do Google Ads com a mesma conexão, basta clicar em Carregar contas e escolher outra.

A plataforma renova a autorização sozinha, sem você precisar reconectar de tempos em tempos. Se o acesso for revogado do lado do Google, a integração é desligada e o selo passa a "Desligada": basta clicar em Reconectar.

Google Analytics

O Analytics é onde você acompanha o tráfego e o comportamento dos visitantes. A loja usa o Google Analytics 4 (GA4), carregado pelo gtag.js.

  • Carregar o gtag.js na loja — liga a tag do GA4 na loja.
  • ID do GA4 — no formato G-XXXXXXXXXX, encontrado no Google Analytics, em Administrador, Fluxos de dados.

A tela recusa ligar o gtag.js com o ID do GA4 em branco e não grava nada até que ele seja informado.

Atenção: um ID gravado com o gtag.js desligado faz a loja carregar o Universal Analytics, a versão antiga que o Google descontinuou e que não recebe mais dados. Nesse caso o selo fica amarelo, com "Falta ligar o gtag.js". Mantenha sempre a opção ligada.

API de Conversão

Aqui está a parte que mais gera dúvida, então vale entender o porquê. O navegador do cliente é um mensageiro que às vezes não entrega: bloqueadores de anúncio, as proteções de privacidade do celular e a remoção de cookies fazem o rastreamento falhar em parte das visitas. Quando isso acontece, o Google não registra a venda e a medição fica incompleta.

A API de Conversão resolve isso enviando a compra direto do servidor da loja para o Google, por um caminho que o navegador não bloqueia. No caso do Google, ela usa o Measurement Protocol do GA4.

  • Enviar as compras pelo servidor — liga o envio. Desligado, as compras chegam ao GA4 só pelo navegador.
  • Secret — a chave que autoriza o envio. Para gerá-la, no GA4 vá em Administrador, Fluxos de dados, abra o seu fluxo e, em "Measurement Protocol API secrets", clique em Criar.

A API de Conversão não tem um campo próprio para a conta: ela envia as compras para o ID do GA4 gravado na tela Google Analytics, e a tela mostra qual é esse ID. Por isso, preencha o Google Analytics primeiro. A tela recusa ligar o envio sem o Secret ou sem o ID do GA4, e não grava nada.

Importante: depois de gravado, o Secret nunca volta a aparecer na tela. O campo nasce vazio, e a linha abaixo do nome Secret avisa que há uma chave gravada, com os quatro últimos caracteres para você conferir qual é. Deixar o campo vazio ao gravar mantém a chave atual; colar uma nova troca a chave. Se a gravação for recusada, cole o Secret de novo antes de gravar outra vez.

Google Avaliações

Na página do pedido confirmado, o Google convida o cliente a avaliar a compra pela pesquisa do Google Avaliações do Consumidor.

  • Convidar o cliente a avaliar — liga o convite. Desligado, a página do pedido confirmado deixa de mostrar o convite do Google.
  • ID do Merchant Center — o número da sua conta no Google Merchant Center, que aparece no topo do painel. A tela grava só os números, então traços ou espaços colados junto são descartados.

A tela recusa ligar o convite com o ID do Merchant Center em branco.

Vale a recomendação geral do Google: usar a medição no navegador (gtag.js) e a API de servidor ao mesmo tempo deixa os números mais confiáveis. O Google reconhece a mesma compra pelos dois caminhos e não conta em dobro.