Exportação
Baixe em CSV compactado os eventos retornados por uma consulta da tela Explorar. A exportação respeita os filtros e o intervalo de tempo aplicados na consulta.
Nova exportação
Na tela Explorar, configure os filtros desejados e execute a consulta. Em seguida, abra o menu de exportação e confirme. A plataforma gera o arquivo em segundo plano, o que pode levar alguns minutos conforme o volume de registros.
Feche a janela durante o processamento se preferir: a exportação continua em segundo plano e fica disponível no histórico.
Histórico
O histórico lista as exportações realizadas pelos usuários da conta nos últimos 7 dias. Depois desse período, a plataforma remove os arquivos. Consulte Limites e parâmetros para os limites de volume.
Formato do arquivo
O arquivo é entregue compactado em gzip, com a extensão .csv.gz. O CSV interno é codificado em UTF-8, com , como separador de colunas e aspas duplas em campos de texto que contenham caracteres especiais. A primeira linha contém o cabeçalho com o nome dos campos.
Outras características do conteúdo:
- datas e horas são gravadas em UTC, no formato ISO 8601;
- as linhas não seguem uma ordem definida. Ordene o arquivo após o download quando a ordem importar;
- campos marcados como sensíveis são exportados como digest HMAC, nunca em texto aberto.
Descrição embutida
Cada arquivo carrega a própria descrição, gravada como comentário do gzip. A descrição registra:
- a conta e o período exportado;
- o campo de data usado como referência;
- o número de linhas e o momento da geração;
- os filtros aplicados;
- a lista de colunas, com nome e descrição de cada uma.
A descrição não faz parte do CSV. Qualquer descompactador a ignora, e uma planilha ou uma ferramenta de análise lê exatamente o mesmo arquivo que seria gerado sem ela. Um arquivo encaminhado a outra pessoa carrega consigo a explicação do que contém.
A lista de colunas pode ser alterada sem aviso prévio. Use a exportação para análises pontuais; para integrações contínuas, prefira a API.