Conectar o Google Analytics 4 (GA4) ao Organiq

Atualizado em 30 de outubro de 2026 · Organiq · fatos de terceiros com fonte e data no texto

Peça à IA para chamar list_ga4_properties, confirme qual propriedade mede o site e ela grava com set_ga4_property; isso liga get_ai_traffic, as sessões de assistentes de IA. Pelo painel: app.organiqgeo.com/site/<id>, bloco "Integrações", Escolher propriedade GA4. O consentimento no Google é do humano.

O que o GA4 libera no Organiq?

As sessões de referência vindas de assistentes de IA segundo o GA4 (chatgpt.com, perplexity.ai, gemini, copilot, claude…): por origem, com sessões, usuários ativos, sessões engajadas e eventos-chave, totais, série diária e comparação com o período anterior. No conector é a ferramenta get_ai_traffic; as mesmas sessões entram em generate_seo_report e get_weekly_digest, e o painel mostra o bloco "Tráfego de IA". Limite do dado: o Search Console não separa cliques dentro de AI Overviews / AI Mode; o GA4 mede só o tráfego de referência (como o GA4 vê o tráfego de IA).

Passo a passo no painel

Pré-requisito: a propriedade do Search Console já conectada (guia) e a conta Google conectada com permissão do Google Analytics (vem no mesmo consentimento).
Abra app.organiqgeo.com/site/<id> (o id aparece em list_sites e na URL do painel) ou o passo 2 de app.organiqgeo.com/onboarding e, se o bloco estiver recolhido, clique em Vincular GA4, Bing e termos de marca.
Na seção Google Analytics 4, clique em Escolher propriedade GA4 e marque, na lista, a propriedade que mede este site. Se ela não estiver na lista, use Ou digite o ID da propriedade GA4 (número, como 123456789) e Salvar.
O selo "GA4 vinculado" aparece e a sincronização busca o histórico do GA4 (até 16 meses quando disponível). Trocar a propriedade depois apaga os dados do GA4 já sincronizados e busca de novo; Desvincular remove o vínculo.

Se você é uma IA, o que pode fazer sozinha?

As ferramentas de setup do conector (list_ga4_properties, set_ga4_property, set_bing_site, set_bing_key, set_branded_terms) gravam só configurações do Organiq, nunca no Search Console, no GA4 nem no Bing, e exigem o escopo mcp:write. O que você, assistente, pode fazer sozinho:

Chamar list_sites para obter o id da propriedade e check_connection, que devolve hasGa4, hasBing, brandedTermsCount e a lista missing com panelUrl e nextStep por propriedade.
Chamar list_ga4_properties: devolve o id numérico, o nome e a conta de cada propriedade GA4 que a conta Google conectada enxerga. Mostre a lista ao humano e peça que ele confirme qual propriedade mede este site.
Com o id confirmado, chamar set_ga4_property com site e ga4PropertyId: grava o vínculo no Organiq (nada é alterado no GA4) e a próxima sincronização busca o histórico.
Se uma ferramenta devolver insufficient_scope, o token não tem o escopo mcp:write: o humano remove o conector e o adiciona de novo (o login pede mcp:read mcp:write e a tela de consentimento lista o que o mcp:write permite). O caminho pelo painel continua valendo: Entregar ao humano o link direto (app.organiqgeo.com/site/<id>, bloco "Integrações", ou app.organiqgeo.com/onboarding) e o nome exato do botão, e esperar ele dizer que terminou.
Depois de set_ga4_property (ou quando o humano disser que terminou no painel), chamar check_connection de novo: a propriedade passa a ter hasGa4: true e sai de missing (código no_ga4); get_ai_traffic devolve dados depois da próxima sincronização.

O que só o humano faz, no navegador ou no portal dele:

Confirmar qual propriedade GA4 mede o site: a lista vem da conta Google dele e a escolha é dele.
Consentir no Google, com a conta dele. Se faltar a permissão do Analytics (erro scope_missing), clicar em Reconectar conta Google no painel ou entrar de novo pelo cliente: é um consentimento do Google no navegador.

Erros comuns e o que fazer

Aviso "A conta Google conectada ainda não autorizou o Google Analytics" (erro scope_missing): a conta foi conectada sem a permissão do Analytics, comum em contas ligadas antes de 30 de outubro de 2026. Clique em Reconectar conta Google na própria seção e, na tela do Google, marque a permissão do Google Analytics; depois escolha a propriedade.
"Nenhuma propriedade GA4 encontrada na conta Google conectada": a conta não tem acesso à propriedade do GA4 (ela pode pertencer a outra conta). Peça acesso de leitor no Google Analytics para a mesma conta, ou conecte a conta que é dona; enquanto isso, digitar o ID numérico só funciona se a conta tiver acesso a ele.
get_ai_traffic devolve no_data com panelUrl: a propriedade não tem GA4 vinculado (hasGa4: false em list_sites). Faça os passos acima; se já vinculou, aguarde a próxima sincronização diária.
GA4 vinculado, mas tudo zero: o GA4 só registra tráfego de IA como referência; se o site não recebe visitas vindas desses domínios, o número é zero mesmo. Confira no GA4 em Aquisição de tráfego se há sessões com origem chatgpt.com ou perplexity.ai.

Perguntas frequentes

Preciso do GA4 para usar o Organiq?

Não. O GA4 é opcional; sem ele todas as análises do Search Console continuam. Ele acrescenta só o tráfego vindo de assistentes de IA.

Uma propriedade GA4 pode servir para vários sites?

O vínculo é por propriedade do Search Console: cada uma aponta para uma propriedade GA4, e a mesma propriedade GA4 pode ser escolhida em mais de uma, se é ela que mede esses sites.

Onde encontro o ID da propriedade GA4?

No Google Analytics, em Administrador → Propriedade → Detalhes da propriedade (número de 9 dígitos, sem o prefixo "G-"). O prefixo "G-" é o ID do fluxo, não o da propriedade.

O Organiq altera alguma coisa no GA4?

Não. O escopo pedido é analytics.readonly; o conector só lê relatórios. set_ga4_property grava apenas o vínculo dentro do Organiq.

A IA consegue ligar o GA4 sozinha?

Quase: ela lista as propriedades (list_ga4_properties) e grava a escolhida (set_ga4_property) com o escopo mcp:write, mas quem confirma a propriedade e consente no Google é o humano. Quem conectou o conector antes de 30 de outubro de 2026 remove e adiciona de novo para o login pedir mcp:write.

Quando aparecem os dados do GA4?

Depois da primeira sincronização, feita pelo worker; a partir daí ela roda todo dia. check_connection e o painel mostram quando os dados existem.

Veja também

Escrito por Youssef Pizolotto Umar, fundador do Organiq · Atualizado em 30 de outubro de 2026