A conexão com o Google Analytics é feita por OAuth: você entra com a sua conta Google, autoriza o acesso de leitura e, de volta à Toca, escolhe qual propriedade do GA4 será consultada. Nenhuma senha fica armazenada na Toca — a autorização acontece na tela do próprio Google.

Antes de começar

• Tenha uma conta Google com acesso à propriedade do GA4 que você quer conectar — o seletor da Toca mostra apenas as propriedades que esse usuário consegue ver no Analytics.
• Se a propriedade pertence a outra pessoa, peça acesso a ela no próprio Google Analytics antes de conectar (confirme na documentação oficial como conceder acesso a usuários).
• A autorização pedida é somente de leitura do Analytics.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Google Analytics e clique em Conectar.
3. Entre com a sua conta Google e autorize o acesso na tela de consentimento.
4. De volta à Toca, o card passa a exibir um seletor de propriedade, com as propriedades do GA4 que o seu usuário acessa. Escolha a que a Toca deve consultar.
5. Ao selecionar, a escolha é salva ("Propriedade Google atualizada.") e a integração fica ativa.

O que a Toca acessa

Com a conexão ativa, a Toca lê tráfego e comportamento do site na propriedade GA4 escolhida: sessões, usuários, origem/mídia, campanhas, páginas, eventos, funil, conversões, retenção e dados demográficos. A integração é somente leitura: a Toca não altera nada na sua conta do Google Analytics.

Manutenção da conexão

A autorização usa um token de atualização que a Toca renova automaticamente — a conexão permanece ativa até você desconectar a integração na Toca ou revogar o acesso do aplicativo na sua conta Google. Se o acesso for revogado no Google, refaça a conexão pelo card em Configurações → Integrações.

Problemas comuns

• A propriedade não aparece no seletor — a lista mostra apenas as propriedades do GA4 às quais o usuário Google que autorizou tem acesso. Conecte com a conta certa ou peça acesso à propriedade no Google Analytics.
• Conectei com a conta Google errada — desconecte e refaça a conexão entrando com o usuário correto; depois selecione a propriedade de novo no card.
• Quero trocar a propriedade — não é preciso reconectar: basta escolher outra propriedade no seletor do card.
• As consultas param de funcionar depois de um tempo — normalmente o acesso do aplicativo foi revogado na conta Google. Refaça a conexão pelo card.