Se você está comparando Umami e Google Analytics, verifique duas coisas: o que o GA4 faz que o Umami não faz e o que acontece com o seu histórico. Se ainda está escolhendo uma ferramenta, veja Umami vs Plausible, auto-hospedados e preços do Plausible para o seu tráfego. Este guia trata da migração em si.
Em abril de 2024, um desenvolvedor que estava migrando do Mixpanel para o Umami pediu ao projeto uma forma de importar seus dados antigos. O mantenedor do Umami respondeu que o Umami auto-hospedado não tem recurso de importação, porque uma importação depende do banco de dados e quem auto-hospeda já tem acesso total ao banco. O desenvolvedor escreveu a própria. Ele levou cerca de 6 horas para mapear os dados para o formato do Umami. Carregá-los levou mais algumas.
O que fica no GA4 depois que você para de usá-lo
A configuração de retenção de dados do GA4 mantém os dados de eventos de uma propriedade padrão por 2 ou 14 meses; períodos mais longos são exclusivos das propriedades pagas do GA4 360. A mesma página de ajuda diz que a configuração does not affect standard aggregated reports
e só limita as explorações e os relatórios de funil. Ou seja, o tráfego, as páginas, as origens e as conversões dos seus relatórios padrão não são cortados por esse prazo. Os números do Google Ads são a exceção, porque o GA4 os mostra em uma janela móvel de 36 meses.
As explorações mantêm dados de idade, gênero e interesses por 2 meses, independentemente da sua configuração. Propriedades grandes e XL ficam limitadas a 2 meses de dados no nível de evento.
Por que seu histórico não pode ir com você
O Umami Cloud importa dados, a partir do plano Pro. A equipe do Umami faz a importação depois que você envia um e-mail ao suporte, e as fontes listadas são bancos de dados do Umami auto-hospedado e exportações em CSV. O GA4 não é citado, então pergunte antes de contar com isso. O Umami auto-hospedado não tem nada parecido. Até mover os dados do próprio Umami Cloud para um servidor auto-hospedado exige um script escrito por você, disse o mantenedor em janeiro de 2025.
O endpoint de coleta do Umami aceita um timestamp, o que parece uma porta de entrada. O campo foi adicionado para importar logs de acesso históricos. Os relatórios padrão do GA4 e seus downloads guardam totais, como sessões por dia. Transformar a contagem de sessões de um dia nesse mesmo número de hits falsos inventaria os visitantes, as visitas e a taxa de rejeição que o Umami calcula a partir de cada sessão, e o mantenedor já disse que os dados de sessão são a parte complicada de uma importação via API. Não recomendamos, porque os gráficos ficam preenchidos, mas as contagens de visitantes desses meses não são reais.
A exportação de eventos do GA4 para o BigQuery é a exceção. Se você a vinculou há meses, as tabelas diárias dela guardam seus eventos brutos, e um desenvolvedor que saiba SQL pode escrever um script que os carregue no banco de dados do Umami. Isso só alcança até o dia em que você vinculou o BigQuery, e é um projeto para planejar e testar antes de confiar nos números.
O que você perde e o que o Umami cobre
| No GA4 | No Umami | O que fazer |
|---|---|---|
| Histórico de antes da migração | Não é importado em um servidor auto-hospedado | Exporte os relatórios de que precisa e mantenha a propriedade do GA4 |
| Vinculação com o Google Ads e públicos de remarketing | O Umami não tem vinculação com o Ads, embora registre IDs de clique em anúncios, como o gclid, a partir das suas URLs | Veja os resultados dos anúncios no próprio Google Ads |
| Consultas e páginas de destino do Search Console | O Umami auto-hospedado não tem. O mantenedor do Umami diz que o suporte ao Search Console já entrou no código de desenvolvimento do Umami como uma integração do Umami Cloud | Veja-os no Search Console |
| Idade, gênero e interesses | O Umami não os coleta | Sem substituto |
| Dados modelados de visitantes que recusam cookies | Sem modelagem. O Umami conta as visitas que o script dele vê | Sem substituto |
| Métricas preditivas | O Umami não tem | Sem substituto |
| Cliques de saída, downloads de arquivos e interações com formulários, contados automaticamente como eventos quando a medição otimizada está ativada | Contados como eventos só quando você mesmo adiciona o rastreamento de eventos | Adicione atributos de dados aos links e botões que importam para você |
| Eventos principais, relatórios de UTM, funis e atribuição | Metas, um relatório de UTM, funis e atribuição de primeiro ou último clique | Recrie seus eventos principais como metas |
As duas primeiras colunas vêm da documentação do Google e do Umami e do GitHub do Umami, listados nas fontes abaixo e verificados até 15 de outubro de 2026. Quando a documentação do Umami não menciona um recurso, a linha diz que ele não existe. A linha do Search Console segue um pull request que o Umami fechou em outubro de 2026. Se você usa o Google Ads, dê mais peso à linha do Ads, já que o Umami não tem nada no lugar.
Para onde seu histórico do GA4 pode ir
| Caminho | O que ele copia | Limites e custo |
|---|---|---|
| Download do relatório (CSV ou Planilhas Google) | Qualquer relatório padrão, no intervalo de datas que você escolher | Até 100.000 linhas por arquivo. Gratuito |
| Conector do GA4 do BigQuery | Tabelas de relatórios, até onde a retenção do GA4 permitir | A transferência é gratuita, o BigQuery cobra armazenamento e consultas, e o sandbox gratuito não a executa. Os totais de usuários e sessões podem não bater com o GA4 |
| Exportação de eventos do GA4 para o BigQuery | Eventos brutos, a partir do dia em que você a vincula, sem preenchimento retroativo | 1 milhão de eventos por dia em uma propriedade padrão. O BigQuery cobra armazenamento e processamento |
| API Data do GA4 | Dados de relatórios, extraídos por um script escrito por você | 250.000 linhas por solicitação e 200.000 tokens por dia por propriedade |
Para a maioria dos sites, o download dos relatórios basta. O BigQuery é para você se quiser tabelas que possa consultar muito depois de a propriedade do GA4 ficar parada e não se importar com uma conta do BigQuery para armazená-las e consultá-las.
Migre para o Umami passo a passo
Não migramos uma propriedade real do GA4 para este guia, já que não usamos nenhuma conta do Google nos nossos testes. Quando uma etapa depende da documentação do Google ou do Umami, ela traz o link da página, conforme verificado em 15 de outubro de 2026, para que você confirme os detalhes antes de mudar qualquer coisa.
Já o Umami, nós rodamos de fato, em nosso próprio teste em 21 de out. de 2026, numa máquina de teste com 2 vCPUs e 4 GB (arm64), não em um servidor da DreamHost. O Umami 3.4.0 contou todas as 30.000 visualizações de página de teste que enviamos ao endpoint de rastreamento. O resumo do painel para essas 30.000 linhas voltou em 0,03 segundo. O banco de dados cresceu cerca de 1 KB por visualização de página, então um site pessoal com dezenas de milhares de visualizações por mês adiciona bem menos de 1 GB por ano. Eram eventos sintéticos enviados em poucos minutos, e meses de tráfego real vão se comportar de outro jeito.
- Liste o que você usa no GA4 e aumente a retenção
Anote os relatórios que você abre todo mês, seus eventos principais, as campanhas UTM que você marca e se o Google Ads ou o Search Console estão vinculados. Depois abra Administrador, vá em Configurações de dados > Retenção de dados e defina a retenção de dados de eventos como 14 meses, se estiver em 2. O Google aplica uma configuração mais longa aos dados que ainda não excluiu, então suas explorações alcançam mais longe no passado enquanto você exporta. A mudança entra em vigor após 24 horas, e você precisa da função de Editor para fazê-la.
- Exporte os relatórios que você vai querer
Exporte cada relatório do GA4 de que você depende como arquivo CSV ou para o Planilhas Google. Nosso conjunto inicial sugerido é Páginas e telas, Página de destino e Aquisição de tráfego, cada um com o intervalo de datas cobrindo toda a vida da propriedade, além dos eventos principais da sua lista. Um arquivo comporta até 100.000 linhas. Se um relatório tiver mais linhas que isso, divida o intervalo de datas em vários arquivos. Recrie e exporte primeiro tudo o que você fez em Explorações, já que essa é a parte que a configuração de retenção corta.
- Copie mais histórico para o BigQuery, se precisar
Execute o conector do GA4 do BigQuery em um projeto do BigQuery com faturamento ativado. Evite o sandbox do BigQuery gratuito. Ele não executa transferências e exclui as tabelas após 60 dias. Se você também quiser eventos brutos daqui em diante, configure a exportação para o BigQuery agora. Uma resposta no fórum de desenvolvedores do Google confirma que ela não preenche dados retroativos.
- Inicie seu servidor Umami e atualize-o
Uma VPS da DreamHost com Umami vem com Umami 3.2.0, PostgreSQL 15 e Caddy instalados e solicita um certificado Let’s Encrypt na primeira inicialização. Conecte-se ao seu servidor via SSH e exiba seu login de administrador:
bashsudo cat /root/.umami_credentialsFaça login, troque a senha e adicione um site. Atualize para a versão mais recente antes de colocar no ar. A versão 3.2.0 instalada é anterior ao Umami 3.3.0, que adicionou o login com dois fatores, e ao 3.4.0, que adicionou notas no gráfico. Execute
umami-backupprimeiro e depoisumami-update, que baixa a versão mais nova e avisa que uma migração do banco de dados pode não ter volta. - Adicione o script do Umami ao lado do GA4
Cole o script de rastreamento do Umami no
<head>do seu site, ao lado da tag do GA4. Se suas tags ficam no Google Tag Manager, adicione o Umami com uma tag HTML personalizada, porque o Tag Manager remove os atributos de dados do script. - Recrie seus eventos principais como metas do Umami
O Umami só conta um clique como evento quando você manda rastreá-lo. Adicione um atributo de dados a cada botão ou link da sua lista, com um nome de evento de até 50 caracteres. Depois crie uma meta para cada evento ou página que conta como conversão. Visitas com tags UTM aparecem no relatório de UTM sem configuração extra.
- Use os dois por um mês e compare as tendências
Deixe as duas tags rodando por um mês-calendário inteiro e depois compare suas principais páginas, principais referenciadores e a direção do tráfego a cada semana. Os totais não vão bater, e um mês é a nossa sugestão. A contagem de visitantes do Umami usa um salt que é redefinido no início de cada mês, então um mês-calendário dá a você uma contagem completa de visitantes para colocar ao lado da do GA4.
- Remova a tag do GA4 e mantenha a propriedade
Anote a data da migração e adicione-a como uma nota no gráfico, depois tire a tag do GA4 do seu site e deixe a propriedade onde está. Em seguida, configure uma cópia regular de cada arquivo
umami-backuppara um local fora do servidor, já que o script o salva no próprio disco do servidor.
Perguntas frequentes sobre trocar o GA4 pelo Umami
Por que meus números do Umami e do GA4 não batem?
Eles contam pessoas de formas diferentes. O GA4 distingue usuários com cookies primários. O Umami gera um hash de detalhes como o navegador e o site com um salt que muda todo mês. Alguns bloqueadores de anúncios barram o script do Umami, e visitantes que recusam cookies podem ficar de fora do GA4. Compare as principais páginas e as tendências de semana a semana.
Por quanto tempo o Umami auto-hospedado guarda meus dados?
O Umami auto-hospedado não tem limite de retenção, então tudo a partir da data da migração fica no banco de dados PostgreSQL do servidor até você excluir, e copiar backups para fora do servidor é responsabilidade sua.
Alguma ferramenta de análise importa o histórico do GA4?
O Plausible consegue. A importação do GA4 dele traz totais diários, então os visitantes únicos em um período mais longo são somados a partir das contagens diárias. Comparamos as duas ferramentas em Umami vs Plausible, auto-hospedados.
Fontes
- Support API based import/export for pageviews as JSON, Umami (GitHub), 9 de out. de 2026. github.com/umami-software/umami/issues/2653
- how to import data to self-hosted umami, Umami (GitHub Discussions), 9 de out. de 2026. github.com/umami-software/umami/discussions/2199#discussioncomment-11991063
- Data retention, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/7667196
- Delete a property, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/1042032
- Import Data, Umami Software, 15 de out. de 2026. docs.umami.is/docs/cloud/import-data
- Send tracking data, Umami Software, 15 de out. de 2026. docs.umami.is/docs/api-reference/send
- Allow populating event's createdAt on the send endpoint, Umami (GitHub), 9 de out. de 2026. github.com/umami-software/umami/pull/3157
- Metric definitions, Umami Software, 15 de out. de 2026. docs.umami.is/docs/metric-definitions
- BigQuery Export, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/9358801
- Connect Google Ads to Google Analytics, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/9379420
- Create, edit, and archive audiences, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/9267572
- Connect Search Console to Google Analytics, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/10737381
- feat(integration): Google Search Console search terms, Umami (GitHub), 15 de out. de 2026. github.com/umami-software/umami/pull/4117
- Activate Google signals, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/9445345
- Behavioral modeling for consent mode, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/11161109
- Predictive metrics, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/9846734
- Enhanced measurement events, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/9216061
- FAQ, Umami Software, 15 de out. de 2026. docs.umami.is/docs/faq
- Share and export reports, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/9317657
- Load Google Analytics 4 data into BigQuery, BigQuery documentation, 15 de out. de 2026. docs.cloud.google.com/bigquery/docs/google-analytics-4-transfer?hl=pt-br
- BigQuery sandbox, BigQuery documentation, 15 de out. de 2026. docs.cloud.google.com/bigquery/docs/sandbox?hl=pt-br
- Set up BigQuery Export, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/9823238
- GA4 Bigquery All Data, Google Developer forums, 15 de out. de 2026. discuss.google.dev/t/ga4-bigquery-all-data/153245
- Data API basics, Google for Developers, 15 de out. de 2026. developers.google.com/analytics/devguides/reporting/data/v1/basics?hl=pt-br
- Data API quotas, Google for Developers, 15 de out. de 2026. developers.google.com/analytics/devguides/reporting/data/v1/quotas?hl=pt-br
- Releases, Umami (GitHub), 15 de out. de 2026. github.com/umami-software/umami/releases
- Google Tag Manager, Umami Software, 15 de out. de 2026. docs.umami.is/docs/google-tag-manager
- Track events, Umami Software, 15 de out. de 2026. docs.umami.is/docs/track-events
- Track outbound links, Umami Software, 15 de out. de 2026. docs.umami.is/docs/guides/track-outbound-links
- Track file downloads, Umami Software, 15 de out. de 2026. docs.umami.is/docs/guides/track-file-downloads
- Track form submissions, Umami Software, 15 de out. de 2026. docs.umami.is/docs/guides/track-form-submissions
- Goals, Umami Software, 15 de out. de 2026. docs.umami.is/docs/goals
- UTM, Umami Software, 15 de out. de 2026. docs.umami.is/docs/utm
- Funnel, Umami Software, 15 de out. de 2026. docs.umami.is/docs/funnel
- Attribution, Umami Software, 15 de out. de 2026. docs.umami.is/docs/attribution
- Annotations, Umami Software, 15 de out. de 2026. docs.umami.is/docs/annotations
- Cookie usage on websites, Google Analytics Help, 15 de out. de 2026. support.google.com/analytics/answer/11397207
- Bypass ad blockers, Umami Software, 15 de out. de 2026. docs.umami.is/docs/bypass-ad-blockers
- Import stats from Google Analytics, Plausible, 15 de out. de 2026. plausible.io/docs/google-analytics-import
- SSH overview, DreamHost Help Center, 9 de out. de 2026. help.dreamhost.com/hc/en-us/articles/216041267-SSH-overview
- Umami on VPS, DreamHost, 15 de out. de 2026. dreamhost.com/hosting/vps/umami