Com o Google Analytics conectado, você pergunta no chat sobre o seu site ou app e a Lumina consulta o Google Analytics 4 ao vivo: sessões, usuários, conversões, origem e campanha, páginas, eventos, funis e quem está no site agora. A conexão é somente leitura: não cria, edita nem apaga nada.
O que a Lumina faz#
| Pode | Não pode |
|---|---|
| listar as contas e propriedades do GA4 que a sua conta Google acessa | criar ou editar anotações, eventos-chave, dimensões personalizadas ou públicos |
| ler as dimensões e métricas da propriedade, incluindo as personalizadas | mudar configurações da propriedade, streams, retenção ou vínculos |
| montar relatórios com filtros, ordenação e comparação entre períodos | abrir explorações salvas no GA4 (ela refaz a pergunta como relatório) |
| montar funis por evento ou página e mostrar onde as pessoas desistem | ler propriedades que a sua conta Google não acessa |
| mostrar quem está no site ou app nos últimos 30 minutos | trazer o Google Analytics como fonte de projeto |
Antes de conectar#
- Você precisa de acesso de pelo menos Leitor a uma propriedade do Google Analytics 4.
- A conta usada na conexão é a conta Google que enxerga as propriedades. Ela não precisa ser do Google Workspace: uma conta Google comum funciona.
Como conectar#
- Na barra lateral, abra Conexões.
- No card do Google Analytics, clique em Conectar.
- Você passa por uma página do Composio, parceiro que a Lumina usa para a autorização do Google. Escolha a conta Google que acessa as propriedades e autorize a leitura do Google Analytics.
O que pedir no chat#
- "Quantas sessões o site teve por canal na última semana, comparando com a anterior?"
- "Qual página de entrada mais perde gente antes do checkout?"
- "Monta o funil página do produto, início do checkout e compra do último mês."
- "Das compras deste mês, quantas vieram de cada campanha?"
- "Quantas pessoas estão no site agora?"
Limitações#
- A Lumina só enxerga as dimensões e métricas que existem na propriedade. Um parâmetro de evento que não foi registrado como dimensão personalizada no GA4 não pode ser consultado.
- Quando o dado vem incompleto, a Lumina avisa em vez de apresentar o número como total: linha agrupada como "(other)", valores escondidos por privacidade, relatório amostrado ou mais linhas do que as que vieram na resposta.
- O Google limita o volume de consultas por propriedade, por hora e por dia. Se o limite for atingido, a Lumina avisa e a consulta volta a funcionar na hora seguinte ou no dia seguinte.
- O funil usa uma versão em teste da API do Google. Se o Google mudar essa versão, o funil pode ficar indisponível por um tempo, sem afetar os relatórios comuns.
- Os números seguem o fuso e a moeda da propriedade, que podem não ser os seus. A Lumina informa os dois junto com os resultados.
Problemas comuns#
| O que aparece | Causa provável | O que fazer |
|---|---|---|
| Nenhuma propriedade aparece | A conta Google conectada não tem acesso a uma propriedade do GA4 | Peça acesso de Leitor ao administrador da propriedade, ou conecte a conta Google certa |
| "Sem acesso a esta propriedade" | A conta conectada não enxerga aquela propriedade | Confira o acesso no GA4; reconectar a mesma conta não muda o acesso |
| "A cota da propriedade acabou" | O limite de consultas do Google foi atingido | Tente de novo na hora seguinte ou no dia seguinte |
| O card do Google Analytics não aparece | A integração não está disponível no seu ambiente | Fale com o suporte da Lumina |
| A conexão expirou | O acesso foi revogado no Google | Clique em Reconectar no card |
Para o administrador ou TI#
A Lumina pede só a leitura do Google Analytics (analytics.readonly) e o nome do perfil Google, para
identificar a conexão. Ela não pede permissão de edição nem de gestão de usuários.
A tela de consentimento do Google mostra o aplicativo do Composio, não o da Lumina. As consultas passam pelo Composio, mas cada uma usa o acesso da própria pessoa, e a Lumina só deixa passar as chamadas de leitura de relatórios, metadados e lista de propriedades.
Privacidade e desconexão#
A conexão é sua e vale só na organização em que foi feita. Cada consulta usa o seu próprio acesso: ninguém da sua organização enxerga pela sua conexão uma propriedade que não acessa no GA4. Num agente agendado, vale a conexão de quem criou o agendamento. Para desconectar, abra Conexões, clique em … no card e em Desconectar. Ao desconectar, a Lumina também remove a autorização no Composio.