# Importar Umami e Plausible

Upload privado, prévia, mapeamento e histórico separado da coleta ao vivo.

## Preparar o arquivo

Na área Importação do site, selecione Umami ou Plausible e envie CSV UTF-8 separado por vírgulas, CSV.gz ou ZIP de CSVs. Limites por lote: 16 MiB enviados, 64 MiB descomprimidos, 20 arquivos e 100.000 linhas. O limite operacional mensal padrão é um milhão de linhas por workspace, independente da franquia ao vivo. Não envie arquivos com dados pessoais desnecessários.


## Formatos suportados

Plausible: export completo das dez famílias imported_visitors, imported_sources, imported_pages, imported_entry_pages, imported_exit_pages, imported_custom_events, imported_locations, imported_devices, imported_browsers e imported_operating_systems. Umami: perfil PostgreSQL website_event/session/event_data, com IDs UUID e timestamps que incluam offset. O perfil foi conferido contra o schema oficial no commit e92fdab99508a8ed05249f6c5f07e140deab79e1. Exports Cloud com cabeçalhos diferentes precisam de mapeamento compatível; não há suporte presumido a qualquer versão.


## Conferir e mapear

A fila prepara a prévia e mostra colunas, amostras redigidas, datas, erros e avisos. Ajuste a tabela e as colunas de cada arquivo antes de confirmar. Propriedades de eventos Umami exigem allowlist explícita. Chaves sensíveis geram erro por linha; valores que pareçam e-mail, telefone ou credencial são excluídos com aviso. Dimensões agregadas suspeitas também são removidas, e caminhos/canais usam apenas URLs redigidas. Timestamps sem offset são recusados; hostnames devem pertencer ao site. Somente dados dos últimos 12 meses e anteriores a 24 horas são aceitos. Arquivos originais são privados, criptografados e removidos após 24 horas; prévias não confirmadas expiram.


## Retenção durante o processamento

A idade é conferida novamente em cada página da fila. Registros que ultrapassarem 12 meses antes dessa etapa são descartados e aparecem como outside_retention no relatório de linhas, mesmo que fossem válidos na prévia. O painel informa essa quantidade separadamente de registros novos e duplicados. O payload processado é removido do staging; a importação não renova a idade original dos dados nem consome unidades ao vivo.


## Retenção nas consultas

As consultas de analytics e de histórico importado excluem registros cujo prazo de 12 meses já terminou, mesmo que a limpeza assíncrona do banco ainda esteja pendente. A comparação anterior respeita o prazo atual. Para agregados, a idade parte do início UTC do dia original. Isso não recolhe arquivos ou informações já entregues; exportações, fontes e backups possuem ciclos próprios.


## Confirmar e acompanhar

Confirme que tem autorização para importar. Linhas inválidas exigem aceitar importação parcial; sobreposição com a coleta nativa exige confirmação própria. O progresso mostra linhas processadas, aceitas e repetidas. Erros têm paginação e CSV. O worker revalida acesso antes de aplicar; falhas externas permanecem visíveis para reprocessamento. Leitores consultam o histórico, mas não importam ou excluem.


## Interpretar o histórico

Selecione o lote para consultar seu histórico separado da coleta nativa. Plausible conserva agregados por dia e dimensões: visitantes de dias/grupos diferentes não equivalem a pessoas únicas no período; duração é soma de segundos, cidade pode ser ID GeoName. Umami preserva eventos elegíveis e distingue visitante de visita; tipos link, pixel e performance não entram. Não são criados pagamentos, atribuição, identidade externa ou jornadas a partir de totais. Importação não consome unidades ao vivo.


## Reimportar e excluir

IDs Umami e chaves Plausible de tabela/dia/dimensões impedem duplicação entre lotes. Um agregado já importado com outros valores exige excluir o lote anterior ou aceitar explicitamente o descarte da linha conflitante. Para excluir, confirme o nome do arquivo. O lote deixa de ser consultável e uma tarefa remove projeções, fonte privada e registros preparados. Coleta nativa e outros lotes são preservados. Se o armazenamento estiver indisponível, a exclusão continua pendente, sem alegar conclusão.


## Evidências e limitações

O fluxo HTTP, filas e armazenamento foi testado com arquivos sintéticos e serviços reais isolados. Isso não representa validação de exports de contas reais ou disponibilidade comercial. Não há conexão direta com contas dos concorrentes nem importação de histórico de gateways.


## Expiração da fonte e das amostras

Após 24 horas, a manutenção remove o arquivo privado e as amostras detalhadas da prévia. Em lotes confirmados, conserva contagens, deduplicação, projeções e linhas pendentes de processamento; o payload das linhas projetadas já é descartado pelo importador. Se um upload falhar e a origem não puder ser removida, o lote mantém a referência e o worker tenta a limpeza novamente; nenhum dado desse lote é importado. Lotes em uso são retomados no próximo ciclo, evitando apagar a fonte durante sua preparação. A revisão completa de retenção, atrasos prolongados e backups permanece no registro de implementação.