Conecte o GA4 ao Gemini e ao Gemini CLI com o PaidSync.ai
Gemini
Para conectar o Google Analytics 4 ao Gemini ou ao Gemini CLI, adicione o endpoint do PaidSync.ai, https://mcp.paidsync.ai/mcp, como app personalizado no Gemini ou como servidor MCP no Gemini CLI, entre e conecte o GA4. O Gemini lê então seus dados de tráfego, sessões, conversões e atribuição.
Tempo de configuração: 2 minutos. Plano gratuito disponível. Sem cartão de crédito.
Conectar GA4 ao Gemini com PaidSync
O PaidSync entra em Gemini como app personalizado, ou por Gemini CLI, Antigravity ou Gemini Enterprise. Não precisa de chave de API, porque Gemini se conecta com um login do PaidSync (OAuth).
Antes de começar
Escolha sua superfície do Gemini no passo 1. O app Gemini aceita o PaidSync como app personalizado em uma conta pessoal do Google (18 anos ou mais, nos EUA, em inglês, com Keep Activity ativado).
Gemini CLI, Antigravity e Gemini Enterprise cobrem contas de trabalho e terminais.
- Vai entrar com o Google? Não há cadastro separado. Você escolhe Continue with Google no passo 2, e sua conta gratuita do PaidSync (100 tarefas por mês, no valor de $50, sem cartão de crédito) é criada quando você clica em Aprovar.
- Prefere e-mail e senha? Crie a conta antes em paidsync.ai/signup. O link de cadastro dentro da janela de login abre o site e não traz você de volta ao Gemini.
- Saiba qual login do Google consegue abrir sua propriedade do GA4. O papel de Viewer basta para ler relatórios, e alterações como dimensões personalizadas exigem o papel de Editor. Você o usa no passo 3.
1Adicione o PaidSync ao Gemini
App Gemini, conta pessoal. Abra gemini.google.com, vá em Settings, depois Connected Apps (se não aparecer, abra Personal Intelligence primeiro) e, em Custom apps, escolha Add a custom app.
Cole a URL do servidor do PaidSync e clique em Next. O PaidSync se registra sozinho, então não há API key para copiar e nada para preencher em Advanced features.
https://mcp.paidsync.ai/mcpAdicione uma vez na web e funciona também no app móvel do Gemini. O Google limita apps personalizados a contas pessoais do Google, com 18 anos ou mais, nos EUA, em inglês, com Keep Activity ativado.
Uma conta de trabalho ou escola não pode adicioná-los, então use o Gemini Enterprise abaixo.
Gemini CLI. Execute o comando, depois digite /mcp auth paidsync e entre com o login do PaidSync.
O Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One em 18 de junho de 2026, então essas contas usam o Antigravity abaixo.
gemini mcp add --transport http paidsync https://mcp.paidsync.ai/mcpO modo agente do Gemini Code Assist no VS Code lê o mesmo arquivo de configurações do Gemini CLI. Adicione isto ao ~/.gemini/settings.json:
{
"mcpServers": {
"paidsync": { "httpUrl": "https://mcp.paidsync.ai/mcp" }
}
}O Antigravity usa uma chave diferente.
Abra o menu do painel do agente, escolha MCP Servers, depois Manage MCP Servers e View raw config, ou edite ~/.gemini/config/mcp_config.json, e adicione o servidor com serverUrl.
O Antigravity faz o login sozinho por registro dinâmico de cliente:
{
"mcpServers": {
"paidsync": { "serverUrl": "https://mcp.paidsync.ai/mcp" }
}
}Gemini Enterprise, edição Business. Um administrador da equipe adiciona o PaidSync em Settings and help, depois Manage team, depois Connected apps, depois Add MCP Server.
O PaidSync oferece o transporte Streamable HTTP exigido pelo Gemini e OAuth 2.0 em https://api.paidsync.ai/authorize e https://api.paidsync.ai/token.
Envie um e-mail para support@paidsync.ai para obter as credenciais de cliente que esse formulário pede.
2Entre no PaidSync e clique em Approve
A tela de login do PaidSync abre. Escolha Continue with Google ou entre com seu e-mail e senha do PaidSync. Uma tela do PaidSync então pergunta se você permite que o Gemini gerencie suas contas de anúncios pelo PaidSync. Clique em Aprovar e o PaidSync está conectado.
Novo no PaidSync e entrando com o Google? Sua conta gratuita (100 tarefas por mês, sem cartão de crédito) é criada quando você clica em Approve. A tela também menciona contas de anúncios já conectadas dentro do PaidSync. Em uma conta nova, essa lista fica vazia até você concluir o passo 3.
3Conecte sua propriedade do GA4 e pergunte a Gemini
Em qualquer conversa, peça: “Connect my GA4.” Gemini responde com um link que abre a tela de login e consentimento do próprio Google. Entre com a conta Google que tem acesso à sua propriedade do GA4 e aprove o acesso. O PaidSync pede ao Google os escopos analytics.edit e analytics.readonly, para que Gemini possa ler relatórios e fazer as alterações administrativas que você pedir. O PaidSync nunca vê sua senha do Google.
Volte e peça: “List my GA4 properties.” Gemini usa list_ga4_properties para mostrar todas as propriedades que seu login do Google consegue abrir, e você diz qual usar. Conectar e listar propriedades não consome nenhuma das suas tarefas. Depois tente: “Show me GA4 sessions and conversions for the last 7 days.” Você também pode conectar o GA4 pelo painel do PaidSync. As duas rotas usam o mesmo login do PaidSync, então Gemini enxerga a propriedade de qualquer jeito.
O plano gratuito inclui 100 tarefas por mês. Planos Pro a partir de $99/mês.
O que Gemini pode fazer com o GA4
Gerar relatórios de tráfego e conversões.
Gemini consulta sua propriedade do GA4 e retorna sessões, usuários, conversões, receita e taxa de rejeição para qualquer período ou segmento.
Analisar o desempenho por canal.
Peça a Gemini para separar o tráfego por origem ou agrupamento de canais e comparar orgânico, pago, direto e referência lado a lado.
Identificar as melhores páginas de destino.
Gemini retorna suas páginas de destino que mais convertem, ordenadas por taxa de conversão ou total de conversões, com o número de sessões como contexto.
Cruzar com o gasto em anúncios.
Se você também conectar o Google Ads ou o Meta Ads, Gemini pode cruzar o gasto com anúncios e as conversões do GA4 para mostrar o ROAS real da campanha em todo o funil.
Buscar dados de eventos personalizados.
Gemini pode consultar qualquer evento personalizado que você configurou no GA4, incluindo envios de formulário, cliques em botões, profundidade de rolagem e visualizações de vídeo.
Gemini pode ler todos os relatórios do GA4 e também configurar a propriedade: criar e excluir eventos-chave, dimensões personalizadas, métricas personalizadas, públicos e vínculos com o Google Ads, além de atualizar a medição aprimorada.
Confira cada alteração antes de pedir a Gemini para aplicá-la. O GA4 não tem campanhas, então não há nada para lançar ou pausar.
Prompts de GA4 para testar em Gemini
Cada prompt roda nas ferramentas do PaidSync citadas depois dele e usa uma ou mais das suas tarefas. Os prompts 8 e 9 fazem uma alteração na sua propriedade do GA4.
- “Audit my GA4 setup. What is missing?” Executa
get_ga4_property,list_ga4_data_streams,list_ga4_conversion_eventseget_ga4_enhanced_measuremente depois lista as lacunas que encontrar. - “Is my GA4 tag firing right now? Show active users and events from the last 30 minutes.” Executa
run_ga4_realtime_report, que devolve usuários ativos e contagem de eventos dos últimos 30 minutos. - “Show my top 10 landing pages this month by sessions, with conversions and bounce rate for each.” Executa
run_ga4_reportcom página de destino como dimensão. - “Compare sessions and conversions from paid social this month with last month. What changed?” Gemini executa
run_ga4_reportpor origem e mídia da sessão em cada mês e compara os dois. - “Count view_item, add_to_cart, begin_checkout and purchase events this month. Where do people drop off?” Executa
run_ga4_reportcom nome e contagem do evento e depois compara as etapas. São totais de eventos, não uma exploração de funil do GA4. - “Did anything unusual happen yesterday? Any traffic spikes or drops?” Gemini executa
run_ga4_reportpara as sessões diárias dos últimos 15 dias e compara ontem com os 14 dias anteriores. - “Compare GA4 conversions with Google Ads conversions for last month. Where is the gap?” Executa
run_ga4_reporte a ferramenta do Google Adsget_campaign_performancepela mesma conexão do PaidSync. - “Mark generate_lead as a key event in GA4.” Executa
create_ga4_conversion_event. O evento já precisa estar disparando, e a alteração é aplicada na primeira chamada, então confira antes de confirmar. - “Create a GA4 audience of users who triggered form_submit, kept for 90 days.” Executa
create_ga4_audience, que qualifica usuários por um evento. A alteração é aplicada na primeira chamada, então confira antes de confirmar.
Por que usar o PaidSync para o GA4 em Gemini
Relatórios e alterações em um só lugar. O PaidSync tem 26 ferramentas do GA4. A maioria lê seus relatórios; as outras fazem as alterações que você pedir, como marcar eventos-chave, criar dimensões personalizadas ou vincular o Google Ads.
O servidor MCP do GA4 do próprio Google é experimental, roda na sua própria máquina e só lê (consultado em 29 set 2026).
Ler mais
Raciocínio entre plataformas. A mesma conexão do PaidSync cobre Google Ads, Meta, LinkedIn, TikTok, Snapchat, Reddit, Pinterest, Microsoft Ads, Google Tag Manager e Merchant Center. Gemini pode puxar os dados de conversão do GA4, compará-los com o Google Ads, encontrar a tag do Tag Manager que dispara o evento e propor uma correção em uma só conversa.
Como conectar o GA4 ao Gemini CLI?
Este guia é para o app Gemini. No Gemini CLI, a mesma conexão do PaidSync é um comando:
gemini mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicie uma sessão, digite /mcp auth paidsync e entre com o login do PaidSync na janela do navegador que abrir. O Gemini CLI guarda o token OAuth para você. Nenhuma chave é colada em lugar nenhum.
Ler mais
O Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One em 18 de junho de 2026, então essas contas adicionam o PaidSync no Antigravity, como mostra o passo 1.
Depois conecte sua conta do GA4 como na etapa 3.
Solução de problemas do GA4 em Gemini
O login falha.
Entre no PaidSync do mesmo jeito que se cadastrou, com Continue with Google ou com seu e-mail e senha do PaidSync.
Quem usa e-mail e ainda não tem conta deve criar uma em paidsync.ai/signup primeiro e depois adicionar o PaidSync em Gemini de novo. Se a tela de consentimento do próprio Google falhar, peça a Gemini “Connect my GA4” outra vez para receber um link novo.
Gemini usou a propriedade errada.
O PaidSync não mantém uma propriedade padrão do GA4. Toda solicitação do GA4 indica a propriedade, então diga a Gemini qual você quer, por nome ou ID da propriedade, e ele envia essa propriedade a cada solicitação. Não sabe o ID? Peça a Gemini para listar suas propriedades do GA4 com list_ga4_properties, que não consome nenhuma das suas tarefas.
Uma propriedade não aparece na lista.
O PaidSync lista as propriedades que o seu login do Google conectado consegue abrir. No GA4, um administrador adiciona esse login em Admin, depois Property access management. O papel de Viewer basta para ler relatórios, e alterações como dimensões personalizadas exigem Editor. Conectou com o login do Google errado? Desconecte no painel do PaidSync e conecte de novo com o login que tem acesso.
Gemini diz que não tem ferramenta de GA4.
O PaidSync mostra a Gemini uma lista curta inicial de ferramentas para manter a conversa leve. Peça a Gemini para chamar paidsync_context primeiro. Ele retorna suas plataformas conectadas e a lista completa de ferramentas, GA4 incluído, e Gemini então executa essas ferramentas por paidsync_exec. Se o PaidSync não aparece em Gemini de jeito nenhum, confira se ele está listado em Configurações e depois em Apps conectados.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
Perguntas frequentes
Como conectar o GA4 a Gemini?
No app Gemini, em uma conta Google pessoal, abra Configurações, depois Apps conectados, escolha Adicionar um app personalizado e cole https://mcp.paidsync.ai/mcp. Gemini CLI, Antigravity e Gemini Enterprise usam o mesmo endpoint, e a etapa 1 cobre cada um. Entre no PaidSync e pressione Aprovar, depois peça a Gemini para conectar sua conta do GA4. Não precisa de chave de API. As etapas completas estão acima.
Quais dados do GA4 Gemini consegue acessar?
Gemini consegue acessar sessões, usuários, visualizações de página, conversões, receita, taxa de rejeição, agrupamento de canais, desempenho de páginas de destino, detalhamento por dispositivo e dados de eventos personalizados da sua propriedade do GA4.
Qual escopo OAuth do Google o PaidSync solicita para o GA4?
O PaidSync solicita https://www.googleapis.com/auth/analytics.edit junto com analytics.readonly. Isso cobre relatórios e a configuração da propriedade (eventos-chave, dimensões e métricas personalizadas, públicos, vínculos com o Google Ads). Não é possível excluir uma propriedade nem mexer na cobrança.
Gemini consegue cruzar dados do GA4 com o Google Ads?
Sim. Se você conectar o GA4 e o Google Ads ao PaidSync, Gemini pode correlacionar o gasto com anúncios com o tráfego e as conversões do GA4 para mostrar o ROAS de todo o funil em uma única conversa. As duas conexões usam o mesmo login do PaidSync.
O PaidSync funciona com várias propriedades do GA4?
Sim. O PaidSync pode se conectar a várias propriedades do GA4. Gemini pode consultar uma propriedade específica por nome ou ID numérico quando você tem mais de uma conectada.
O PaidSync é gratuito para usar com o GA4?
Sim. O plano gratuito dá 100 tarefas por mês por $0. O Pro começa em $99/mês para 1,000 tarefas. Os planos Team começam em $249/mês para até 20 usuários. Não é preciso cartão de crédito para começar.
Quanto o PaidSync custa com o Gemini?
O PaidSync tem preços próprios: o plano gratuito custa $0 para 100 tarefas por mês, sem cartão, e o Pro começa em $99 por mês. Qual superfície do Gemini você pode usar depende da sua conta Google, como explica o passo 1.
O acesso ao GA4 pelo PaidSync é somente leitura?
Não. O PaidSync tem 26 ferramentas de GA4. A maioria lê seus relatórios; as demais fazem as alterações que você pede, como marcar eventos-chave, criar dimensões personalizadas ou vincular o Google Ads. O PaidSync lê os relatórios do GA4 pela Data API e faz as alterações administrativas que você pede, como marcar eventos-chave, pela Admin API. As alterações no GA4 são aplicadas na primeira chamada, então mantenha ativo o aviso de aprovação de Gemini para elas.
A mesma conexão do PaidSync funciona em outros assistentes?
Sim. O PaidSync é um único endpoint, https://mcp.paidsync.ai/mcp, com login OAuth, e o mesmo login funciona em Claude, Claude Code, ChatGPT, Perplexity, Microsoft Copilot pelo Copilot Studio, Cursor e Windsurf. Configure o PaidSync uma vez e use em qualquer um deles.
630+ ferramentas. 14 plataformas. Uma conexão. Grátis.