For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/contacts/export-visitor-sessions.md.
  • Português
  • Como exportar as visitas dos meus visitantes em CSV?

    Em Contatos & Comercial → Outros → Visitantes, clique em Exportar CSV na barra acima da tabela, marque as colunas que quer no arquivo e clique em Exportar. O arquivo traz uma linha por visita (sessão) dos visitantes que a lista mostra com os filtros e a busca atuais. Ele é gerado em segundo plano: quando fica pronto, o link para baixar aparece em Ações em massa.

    Antes de começar

    • Papel do workspace com acesso ao CRM. Os papéis Convidado e Atendente (sem a subrole Coordenador) não conseguem exportar — é a mesma regra da exportação de contatos. Veja o alcance de cada papel em Papéis e permissões.
    • A exportação respeita os Filtros e a busca por ID ou IP aplicados na lista. Se quer só os visitantes de uma página ou de um canal, filtre antes de exportar.
    • O período é o mesmo da lista: os últimos 30 dias. Entram no arquivo as visitas desse período dos visitantes listados.

    Passo a passo

    1. Vá em Contatos e clique em Visitantes.
    2. Aplique os Filtros e a busca que quiser. O arquivo sai com os mesmos visitantes que a tabela mostra — veja Como filtrar a lista de visitantes?.
    3. Clique em Exportar CSV, na barra acima da tabela. Abre a janela Exportar sessões de visitantes, com o total de visitantes que entram no arquivo (N visitantes com os filtros atuais) e o período.
    4. Marque as colunas que quer no arquivo. Elas ficam em três grupos — Sessão, Visitante e Contato — e os botões Selecionar tudo e Limpar tudo marcam ou desmarcam todas de uma vez.
    5. Se alguma coluna marcada carrega dados pessoais, a janela mostra o aviso N coluna(s) com dados pessoais. Veja Dados pessoais no arquivo antes de seguir.
    6. Clique em Exportar. O botão muda para Exportando… enquanto o pedido é registrado. Sem nenhuma coluna marcada, a janela avisa Selecione ao menos uma coluna. e não exporta.
    7. A tarefa Exportar sessões de N visitantes aparece no aviso de tarefas no canto da tela. Quando ela concluir, clique em Ver detalhes — ou clique em Ver todas as atividades para abrir Ações em massa e, no histórico, clique na tarefa Exportar sessões de visitantes — N colunas (o detalhe abre com o tipo Exportação de sessões). Na seção Arquivo gerado, clique no botão com o nome do arquivo (sessoes-de-visitantes.csv) para salvá-lo.

    Você pode fechar a janela e continuar trabalhando enquanto o arquivo é gerado. Ele continua disponível em Ações em massa depois que o aviso some.

    O que vem no arquivo

    Cada linha é uma visita. Um visitante que fez três visitas no período aparece em três linhas: os dados da visita mudam de uma linha para outra, e os dados do visitante e do contato se repetem. Só as colunas que você marcou entram no arquivo, com os cabeçalhos abaixo.

    Sessão

    ColunaO que significa
    ID da sessãoIdentificador único da visita
    Início da sessãoQuando a visita começou
    Última ação da sessãoQuando a visita registrou o último sinal
    Duração (segundos)Do primeiro ao último sinal da visita
    Tempo na página (segundos)Quanto tempo a pessoa realmente ficou lendo — soma dos períodos de atenção, então é menor que a duração quando a aba fica aberta em segundo plano
    Rolagem máxima (%)O quanto da página a pessoa desceu, na visita inteira
    Ações registradasQuantas ações a visita registrou no total — visualizações, formulários, checkout, compra e as demais
    Páginas vistasQuantas visualizações de página a visita teve
    Formulários enviadosQuantos formulários a pessoa enviou na visita
    Iniciou checkout1 se a pessoa iniciou um checkout nessa visita, 0 se não
    Comprou1 se houve compra nessa visita, 0 se não
    Canal da sessãoPor onde a pessoa chegou nessa visita
    Veio deO endereço que trouxe a pessoa para a visita
    utm_source, utm_medium, utm_campaign, utm_term, utm_contentOs parâmetros de campanha do link de entrada, um por coluna
    URL de entradaO endereço que a pessoa abriu para começar a visita
    Domínio de entradaSó o domínio do endereço de entrada
    Caminho de entradaSó o caminho do endereço de entrada, depois do domínio
    ID da página de entradaIdentificador da página por onde a visita começou
    Página de entradaNome da página por onde a visita começou
    ID do projetoIdentificador do projeto da visita
    ProjetoNome do projeto da visita
    ID do linkIdentificador do link rastreado pelo qual a pessoa entrou, quando a entrada foi por um

    Iniciou checkout, Comprou e Formulários enviados são sinais da visita, não do visitante: dizem o que aconteceu naquela sessão. Para saber se a pessoa comprou em algum momento, olhe todas as linhas dela.

    Canal da sessão é o canal daquela visita. Já Canal de origem (primeira visita), no grupo Visitante, é o canal que trouxe a pessoa pela primeira vez — o mesmo que a coluna Canal da lista mostra. Os dois só coincidem na primeira visita; veja Como ver de onde vieram os visitantes das minhas páginas. Nas duas colunas o canal sai com o nome em inglês e em minúsculas: google, facebook, instagram, tiktok, youtube, linkedin, whatsapp, email, referral, direct ou other.

    Quando a visita começou por uma página marcada como Externa — que mora no seu site —, a URL de entrada traz o endereço público cadastrado na página, e não o endereço interno pelo qual a ClickMax a serve. É a mesma regra da tela do visitante.

    Visitante

    ColunaO que significa
    VisitanteO código vis_ que aparece na primeira coluna da lista
    ID do visitanteO identificador completo do visitante
    Primeiro acessoQuando o visitante apareceu pela primeira vez
    Último acessoQuando o visitante foi visto pela última vez
    Total de sessões do visitanteQuantas visitas o visitante já fez, no total — não só as que estão no arquivo
    Canal de origem (primeira visita)O canal da primeira visita, o mesmo da coluna Canal da lista
    DispositivoComputador, Celular, Tablet ou Desconhecido, pelo último acesso
    NavegadorO navegador do último acesso
    SistemaO sistema operacional do último acesso
    IP do primeiro acessoO endereço IP do primeiro acesso
    IP do último acessoO endereço IP do último acesso
    User agentA identificação técnica completa do navegador no último acesso

    Contato

    ColunaO que significa
    ID do contatoIdentificador do contato vinculado ao visitante
    Nome do contatoNome do contato
    E-mail do contatoE-mail do contato
    Telefone do contatoTelefone do contato
    Virou contato emQuando o visitante foi vinculado ao contato
    Como foi identificadoO que criou o vínculo: form_submit (enviou um formulário), checkout (iniciou um checkout), api, import, manual ou webhook

    O contato é o mesmo que a lista mostra: quando o visitante foi vinculado a mais de um contato, vale o primeiro vínculo.

    Dados pessoais no arquivo

    As colunas do grupo Contato e as colunas IP do primeiro acesso, IP do último acesso e User agent saem em texto puro, sem mascaramento. Ao marcar qualquer uma delas, a janela mostra o aviso N coluna(s) com dados pessoais e lembra que elas serão exportadas em texto puro. Lembre-se das diretrizes da LGPD. Marque essas colunas só quando precisar delas e guarde o arquivo com o mesmo cuidado que a base de contatos.

    Limites atuais

    • O arquivo cobre o mesmo período da lista: os últimos 30 dias por padrão e no máximo 180 dias. A janela de exportação não tem seletor de período.
    • O arquivo é gerado em segundo plano. O link para baixar fica em Ações em massa, não na tela de Visitantes.
    • Qualquer valor sem registro sai como - — inclusive as colunas do grupo Contato nas visitas de quem ainda não virou contato.
    • Datas e horários saem no formato ISO 8601, em UTC (por exemplo, 2026-09-01T14:03:00.000Z).
    • Valores que começam com =, @, + ou - seguidos de texto (um referrer ou UTM montado como fórmula, por exemplo) saem com um apóstrofo na frente ('=...), para a planilha mostrá-los como texto em vez de executá-los. Telefones no formato internacional (+55...) e números negativos não mudam.
    • O arquivo é separado por vírgula e codificado em UTF-8, sem BOM. Se os acentos aparecerem errados ao abrir direto no Excel, importe o arquivo pela opção de dados de texto escolhendo UTF-8.

    Relacionados