Definições das métricas

Filtros combinados e segmentos

No overview e nas análises avançadas, Adicionar filtro combina até oito condições com E. Use é, não é ou contém; um valor vazio corresponde a Não informado. Clique em uma linha do detalhamento para acrescentar uma condição, sem apagar as anteriores. Filtros e período ficam na URL, e a exportação CSV de tráfego preserva esse recorte. Trocar site ou workspace limpa os filtros para não reutilizar um segmento de outra origem.

Guardar e reutilizar um recorte

Proprietários, administradores e editores podem salvar segmentos por site. Leitores podem aplicá-los, sem criar ou excluir definições. O segmento salva filtros, não o período ou a busca local da tabela. Reaplicar substitui as condições atuais; alterar uma condição desvincula a seleção salva. Excluir a definição não apaga eventos nem os filtros já aplicados à consulta. País, página, canal e demais dimensões são validados no servidor. Os filtros de tráfego não são aplicados silenciosamente aos relatórios financeiros, que ainda têm recorte próprio por período, ambiente e moeda.

Visitantes, sessões e visualizações

Visitantes são identificadores distintos; sem persistência, aproxima-se das sessões efêmeras e pode contar retornos novamente. Sessões encerram após 30 minutos de inatividade. Visualizações são pageviews aceitos. Cliente requer pagamento confirmado e não é sinônimo de visitante.

Rejeição e duração

Rejeição considera sessões de uma página sem evento de negócio no recorte consultado. Duração observada usa o intervalo entre eventos recebidos; não representa tempo conhecido após o último sinal. Sessões sem observação suficiente exibem ausência de dados.

Origem e receita

Último contato não direto usa janela de 90 dias; primeiro contato é preservado. Sem vínculo confiável, a receita permanece sem atribuição. Renovações e novas conversões devem ser separadas. Moedas diferentes não são somadas sem taxa, data e fonte explícitas. Taxas de gateway são registradas somente quando o provedor as informa; a cobertura e o líquido após essas taxas incluem apenas pagamentos com taxa conhecida e não representam o repasse da instituição.

Buscar transações financeiras

Em Receita → Transações, pesquise pelo ID da Pulsant, ID externo do gateway, provedor ou produto e filtre por provedor e estado. Os filtros ficam na URL e são preservados em CSV e relatórios agendados. Pagamentos pendentes/falhos podem aparecer na tabela, mas somente pagamentos confirmados entram nos totais de receita. A busca não consulta nomes, e-mails ou outros dados pessoais.

Correções manuais de atribuição

Em Receita → Transações → Ver atribuição, proprietários e administradores autorizados para o site podem classificar um pagamento confirmado ou marcá-lo Sem atribuição. Informe o motivo; canal, campanha e página não devem conter dados pessoais. A classificação recebe marca Manual e não fabrica contato, data observada ou evidência de causalidade. O evento e a origem originais continuam preservados. A mudança não altera dinheiro, moeda, franquia nem outras vendas/renovações. Leitores consultam o histórico, mas não corrigem.

Histórico, concorrência e reversão

O histórico registra ator, motivo, estado anterior, posterior e reversões, com paginação. Só a correção atual pode ser revertida, exigindo novo motivo. A API usa requestKey idempotente e expectedRevision obrigatório: se outra pessoa corrigiu antes, recebe 409 e deve atualizar. Repetir a mesma solicitação não adiciona outra correção; trocar o corpo com a mesma chave é recusado. Valores e receita total permanecem os mesmos; canais, consulta e CSV refletem a classificação efetiva, mantendo restrições de compartilhamento.

// Mesma origem, sessão autenticada; chaves privadas não fazem correção manual.
GET /v1/workspaces/WORKSPACE/sites/SITE/payments/PAYMENT/attribution

POST /v1/workspaces/WORKSPACE/sites/SITE/payments/PAYMENT/attribution
{
  "action": "correct",
  "classification": { "channel": "organic", "entryPage": "/precos" },
  "reason": "Origem conferida pelo proprietário.",
  "expectedRevision": null,
  "requestKey": "00000000-0000-4000-8000-000000000001"
}
// null só é a revisão esperada quando ainda não existe correção.
// Para remover classificação, use classification: null.
// Para reverter: action: reverse, changeId e expectedRevision iguais ao ID atual.
// reason e um novo requestKey continuam obrigatórios.