Meta Pixel
Voltar ao blog
Guia de conexão5 minutos de leitura12 de nov. de 2026Por Andrii Pasika· Fundador, LoomaScale

Como conectar Codex a GA4 (Google Analytics 4)

Resposta curta

Para conectar Codex a GA4, conecte Google Analytics em LoomaScale, adicione seu endpoint GA4 MCP com codex mcp add e autentique com codex mcp login. Abra uma sessão Codex, verifique /mcp e liste suas propriedades do Analytics. Selecione o ID numérico da propriedade antes de usar relatórios para investigar uma versão de site.

Codex pode combinar uma investigação de base de código com relatórios GA4 quando você conecta ferramentas do Analytics ao seu host local. Isso permite comparar uma hipótese de lançamento com eventos registrados, mantendo a inspeção de código e os dados de produção observados distintos. Este guia usa MCP hospedado e o navegador OAuth em vez de um SDK do Analytics local.

O que você precisa antes de se conectar?

Use um Codex CLI instalado com suporte remoto para HTTP MCP e OAuth. Execute a configuração no mesmo host Codex onde você usará as ferramentas. Uma configuração CLI local não configura por si só uma tarefa de nuvem separada. Você não precisa de nenhuma chave de conta de serviço Google JSON ou API para esta rota OAuth hospedada.

  • Um login Google com acesso à propriedade GA4 que você deseja analisar.
  • Uma conta LoomaScale e uma conexão Google Analytics; conectar Google Ads sozinho não autoriza o Analytics.
  • O ID numérico da propriedade ou permissão para descobri-la na lista de contas. Um ID de medição G identifica um fluxo da web e não é o ID da propriedade de relatório.

Como você conecta Codex a GA4?

1. Conecte GA4 em LoomaScale

Crie ou faça login em sua conta LoomaScale e abra Conexões. Escolha Google Analytics, faça login com o e-mail Google que tem acesso aos dados necessários e revise as permissões solicitadas. Fazer login em LoomaScale com Google não substitui a conexão desta fonte de dados. Você pode ativar este serviço sem conectar uma conta de publicidade.

2. Adicione o servidor MCP específico da origem ao Codex

Execute esses comandos em seu terminal. O primeiro salva o servidor remoto e o segundo inicia a autorização do navegador. O nome do servidor é específico para esta fonte Google, portanto, outra fonte pode ser adicionada sem substituí-la.

codex mcp add loomascale-ga4 --url https://api.loomascale.com/mcp/ga4
codex mcp login loomascale-ga4

3. Conclua OAuth e verifique a conexão Codex ativa

Conclua a autorização LoomaScale no navegador usando a conta com sua conexão Google e retorne ao terminal. Execute codex mcp list para verificar o servidor salvo. Inicie ou reabra uma sessão Codex e use /mcp para inspecionar suas ferramentas ativas. Uma entrada salva é uma evidência de configuração; a pesquisa de conta abaixo verifica o acesso aos dados. Os clientes locais suportados do Codex compartilham a configuração MCP para o mesmo host. Consulte a documentação atual do OpenAI para seu desktop ou superfície IDE; não presuma que um host diferente herdou seu login.

4. Verifique o acesso com uma pesquisa de conta real

Use LoomaScale para chamar ga4_get_account_summaries. Liste minhas propriedades GA4 acessíveis com seus nomes e IDs numéricos de propriedade. Pergunte-me qual propriedade usar. Leia o fuso horário e a moeda do relatório. Não altere nenhuma configuração.

A resposta deve conter propriedades do seu próprio login Google, com um recurso como properties/123456789. Selecione a propriedade por nome e ID e mantenha essa seleção nas solicitações subsequentes. Uma descrição de GA4 ou um painel de amostra não prova que o conector recuperou dados. Uma lista de contas vazia pode ser uma resposta válida de um login sem propriedades acessíveis.

Como você investiga uma alteração de evento após um lançamento em Codex?

Forneça a Codex o carimbo de data/hora de lançamento e rotas relevantes ou nomes de eventos. Peça para inspecionar como esses eventos são emitidos no repositório e, em seguida, recupere um relatório limitado da propriedade GA4 selecionada. Evite concluir que uma implantação causou uma mudança apenas porque as datas estão alinhadas. Mantenha a primeira investigação somente leitura para o repositório e o Analytics.

Use a propriedade GA4 selecionada por meio de LoomaScale. Inspecione a instrumentação de eventos purchase do repositório sem editar arquivos. Peça-me o carimbo de data e hora de lançamento, se estiver faltando. Relatório eventCount por date e eventName para purchase e begin_checkout em períodos completos comparáveis ​​antes e depois do lançamento. Estado de propriedade, datas e fuso horário. Compare a hipótese do código com os dados observados e liste as evidências ausentes. Não mude nada.

O relatório pode estabelecer que as contagens de eventos registrados foram alteradas, enquanto a inspeção do repositório pode estabelecer como o código atual emite um evento. Nenhum dos dois prova qual código foi executado para cada visitante histórico. Verifique o lançamento do lançamento, o volume de tráfego e as alterações na coleção antes de propor um patch. Uma investigação de receita pode exigir um relatório separado com as métricas de receita relevantes.

Qual endpoint MCP este guia usa?

https://api.loomascale.com/mcp/ga4

O endpoint específico do serviço expõe ferramentas GA4 e auxiliares de conta LoomaScale. O plug-in ou conector de diretório completo usa https://api.loomascale.com/mcp e pode alcançar todas as fontes que você conectar separadamente. Escolha a conexão completa para trabalhar entre serviços; use o endpoint específico quando desejar o conjunto de ferramentas desta fonte. Uma escolha de endpoint limita as ferramentas expostas, não as funções Google que seu login possui.

O que Codex pode ler ou alterar em GA4?

LoomaScale pode recuperar tráfego, engajamento, eventos importantes, receita, atividade em tempo real e relatórios de funil. Comece com relatórios e especifique datas, dimensões e métricas. As ferramentas de configuração, quando habilitadas para sua conta, precisam da função Google apropriada e da permissão analytics.edit; o acesso ao relatório por si só não permite edição. Conectar um assistente não instala uma tag de site, não cria eventos históricos nem torna a atribuição GA4 idêntica à atribuição de uma plataforma de anúncios.

Por que a conexão ou os dados estão faltando?

Se a autorização estiver faltando, execute codex mcp login loomascale-ga4 novamente. Se a entrada estiver configurada, mas ausente na sessão ativa, reinicie essa sessão e inspecione /mcp. Verifique o URL e o host se as ferramentas ainda não carregarem. O plugin principal LoomaScale e o servidor específico do serviço são conexões alternativas; instalar ambos pode expor conjuntos de ferramentas duplicados.

Se a propriedade estiver faltando, confirme o e-mail Google e o acesso à propriedade e, em seguida, verifique a conexão do Analytics em LoomaScale. Se um relatório estiver vazio, verifique a propriedade, datas, filtros e se o site realmente envia eventos. Compare períodos equivalentes no fuso horário da propriedade. Para uma incompatibilidade de métricas, preserve os nomes exatos das métricas e as definições de atribuição antes de tirar conclusões. Use o ID da propriedade de relatório em vez do identificador do G-stream.

Guias de conexão relacionados e referências oficiais

Use GA4 em outro assistente

Conecte outra fonte Google ao Codex

Referências oficiais de configuração

Referências de configuração verificadas em 12 de novembro de 2026. Os rótulos de menu e as políticas do espaço de trabalho podem mudar; use as orientações do fornecedor vinculado para sua conta. Para fluxos de trabalho suportados pelo LoomaScale, consulte o hub de documentação.

Perguntas frequentes

Uma configuração Codex GA4 local também configura tarefas de nuvem Codex?

Não presuma que sim. Este guia configura um servidor MCP e login OAuth no host Codex onde você executa os comandos. Uma nuvem separada ou um host remoto precisa de suas próprias verificações de conexão e acesso com suporte. Verifique as ferramentas ativas e a pesquisa de propriedades na sessão real que você usa.

Preciso de um ID de medição GA4 ou de um ID de propriedade?

O relatório usa o ID numérico da propriedade, geralmente retornado como properties/123456789. Um ID de medição G pertence a um fluxo de dados da web. Peça a LoomaScale para listar suas propriedades primeiro e, em seguida, selecione a propriedade correta em vez de adivinhar um ID.

Preciso de uma chave OpenAI API ou de uma conta de serviço Google?

Esta configuração hospedada do MCP usa seu cliente Codex existente e uma conexão do navegador OAuth com LoomaScale. Não é necessário copiar uma chave OpenAI API ou um arquivo JSON da conta de serviço Google na configuração MCP. Seu acesso Codex e as permissões da conta Google conectada ainda se aplicam.

Quem escreveu isso

Andrii Pasika, fundador da LoomaScale

Andrii Pasika

Fundador, LoomaScale

Andrii fundou o LoomaScale e escreveu o servidor Google Ads MCP por trás dele. Ele executa suas próprias campanhas por meio dele, e um e-mail para team@loomascale.com chega até ele.

Conecte GA4 a Codex

Crie sua conta LoomaScale, conecte a fonte Google e use o prompt de verificação acima para recuperar os dados de sua própria conta.

Comece com LoomaScale

Conecte seu assistente à sua plataforma de anúncios

A LoomaScale funciona no assistente que você já usa. Escolha sua combinação: cada guia leva cerca de cinco minutos.

ChatGPT
Google Ads

Conecte ChatGPT ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
Claude
Google Ads

Conecte Claude ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
Claude Code
Google Ads

Conecte Claude Code ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
Codex
Google Ads

Conecte Codex ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
ChatGPT
Meta Ads

Conecte ChatGPT ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
Claude
Meta Ads

Conecte Claude ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
Claude Code
Meta Ads

Conecte Claude Code ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
Codex
Meta Ads

Conecte Codex ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
ChatGPT
TikTok Ads

Gerencie campanhas do TikTok pelo ChatGPT: relatórios, retenção dos vídeos, detalhamentos de público e, quando você pedir, pausas, orçamentos e lances. A mesma instalação com um clique.

Ler o guia
Claude
TikTok Ads

Gerencie campanhas do TikTok pelo Claude: auditorias, relatórios de vídeos e de público, além de pausas, orçamentos e lances dentro do limite de gastos que você define.

Ler o guia
Manus
Google Ads

Conecte Manus ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
Slack
Google Ads

Pergunte ao Slackbot sobre o Google Ads em uma mensagem direta: auditorias, termos de pesquisa e ritmo de gastos com dados em tempo real. Uma instalação por espaço de trabalho.

Ler o guia
Manus
Meta Ads

Conecte Manus ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
Slack
Meta Ads

Pergunte ao Slackbot sobre Facebook e Instagram em uma mensagem direta: veiculação, ritmo de gastos e despesas por conjunto de anúncios, diretamente do Meta Ads.

Ler o guia