Base de participantes e segmentos

É o grupo Base do menu: a base do cliente somando todas as campanhas. Tem dois itens no menu — Visão geral e Segmentos — e, sem item próprio, o Perfil na base de um participante e os convites da base, que se abrem a partir de Segmentos.

É a única área do painel sem seletor de campanha. Quem quer os números de uma campanha usa o Dashboard ou o grupo Gerenciar. As telas dizem isso em texto fixo no topo, porque o operador vai comparar estes números com os de Gerenciar ao lado, que são por campanha.

O que entra na base

Entra o participante com ao menos uma inscrição não cancelada em campanha ativa. Campanha desativada sai da base inteira, inclusive do valor total — é o mesmo critério do seletor de campanhas, e é o que faz a Base e o Dashboard contarem as mesmas campanhas.

Dois esclarecimentos de vocabulário: "participou" é inscrição, com nota ou sem; "valor" é só nota ativa.

Visão geral

O topo traz seis cartões: Participantes na base, Já enviaram nota, Só cadastro, Ativos nos últimos 12 meses, Valor comprado (com o ticket médio por nota) e Aceitam contato. Cada cartão tem uma explicação curta de como é contado.

Abaixo vêm a distribuição pelos seis segmentos, o mapa "Quem voltou nas campanhas seguintes", o bloco "Onde a base compra", com redes e lojas, e o "Perfil da base", com faixa etária e estado onde a base mora.

"Onde a base compra" é por valor comprado, enquanto o dashboard da campanha ordena por número de notas. Os dois podem divergir legitimamente, e o subtítulo da tela avisa. Rede e loja não identificadas ficam de fora do ranking: é um ranking de lugares, e "sem rede" não é um lugar.

A faixa etária e os estados vêm do cadastro, onde a base mora, não do local da compra.

O mapa de retorno

O mapa tem cinco faixas e é cumulativo por campanha de entrada. A campanha de entrada é a primeira campanha de cada participante. As faixas vão de "mais uma" a "mais cinco" campanhas depois, e cada uma é "ao menos N" — quem fez quatro campanhas conta em três faixas. A linha se lê da esquerda para a direita, como funil; somar as colunas dá número errado. A explicação completa abre pelo ícone de informação do bloco.

As faixas ficam vazias quando ainda não foram medidas, o que dá ao bloco a forma de uma escada: a faixa "mais N" só foi medida quando existem N campanhas que começaram depois da campanha de entrada. A campanha mais recente vem com as cinco faixas vazias.

Vazio não é zero, e a tela não troca um pelo outro. Vazio quer dizer que não houve campanha seguinte para o grupo voltar. Zero por cento é a medição de que ninguém voltou havendo campanha. Trocar um pelo outro faria a campanha recém-lançada aparecer como fracasso total de retenção toda vez.

Segmentos

São seis segmentos fixos — Só cadastro, Adormecidos, Campeões, Em risco, Fiéis e Novos promissores — e eles formam uma partição: todo participante da base cai em exatamente um, e a soma dos seis é igual ao total da base. A tela escreve essa soma acima dos cartões. Se algum dia não fechar, é defeito — a tela não arredonda para fechar. Os seis vêm sempre, inclusive os de zero: o segmento vazio também informa.

A ordem dos cartões é a ordem em que a regra desempata — o primeiro que casa decide — e é nela que o operador deve ler os seis. O painel não reordena.

A tela não tem cópia de regra nenhuma. O nome, a regra em uma frase e os cortes de hoje, com os valores, vêm do servidor em cada cartão. Isso importa porque os cortes se movem: o corte de Campeões, por exemplo, é relativo ao valor entre quem tem nota, e muda quando a base muda — alguém pode sair daquele segmento sem fazer nada.

O segmento Em risco depende da última campanha encerrada que teve inscrição, e a tela cita o nome e a data dela. Quando essa referência não existe, o segmento está vazio por falta de referência, não por mérito: ninguém pode estar ausente de uma campanha que não existe. O aviso da tela diz exatamente isso.

Cada cartão traz a contagem, o percentual da base, o valor comprado e quantos aceitam contato. Clicando no cartão, abre abaixo a lista "Quem está em" daquele segmento, paginada, com busca e o filtro Aceite de contato (todos, só quem aceita ou só quem recusou).

A busca por documento exige o CPF ou CNPJ completo. Documento pela metade não filtra: a lista continua inteira até o número ficar completo. Texto com letra vai inteiro, como busca por trecho do nome.

O grão da lista é o cadastro, não a participação. Uma linha é uma pessoa, e a coluna Campanhas diz em quantas ela se inscreveu — o oposto de Gerenciar e Participantes, onde uma linha é uma inscrição. As duas telas mostram contagens diferentes para a mesma pessoa de propósito, e a ajuda da lista explica a diferença. A coluna Última atividade é a mais recente entre a última inscrição e a última nota — é ela que decide quem está adormecido.

Convidar um segmento

No cabeçalho de Segmentos há o botão "Convidar este público", que abre o montador de convite com o segmento aberto já marcado. No rodapé dos cartões, o link "Ver os convites já montados" leva à lista dos convites. O convite tem artigo próprio.

A exportação do segmento

O botão Exportar CSV baixa o segmento inteiro com a busca aplicada, não só a página exibida. O arquivo sai só com quem aceita contato, e esse recorte é do servidor: não existe como pedir o arquivo completo.

A consequência está declarada na tela: o arquivo tem menos linhas que o cartão do segmento, e a primeira linha do arquivo repete o aviso. O painel mostra "Só sai quem aceita contato" com quantos de quantos antes do clique, e desabilita o botão quando ninguém do segmento aceita contato — o arquivo sairia só com cabeçalho.

A exportação exige ler participações e a permissão global Exportar dados.

O Perfil na base

O perfil é a visão entre campanhas e não repete o detalhe de Gerenciar. Ele mostra o segmento atual e o motivo, os dados do cadastro, os totais (campanhas, notas fiscais, valor comprado, números da sorte e prêmios ganhos), a linha do tempo "Campanha por campanha", onde a pessoa compra e os consentimentos.

O segmento do perfil é recalculado a cada abertura da tela: os cortes se movem quando a base se move, então ele pode mudar sem a pessoa fazer nada.

Cada linha da linha do tempo abre o detalhe daquela campanha em Gerenciar, com as notas, os números e as posições. Inscrição cancelada aparece marcada e não entra nos totais: este é o lugar de auditoria do cadastro. Só campanhas ativas aparecem — uma campanha desativada que saiu das contagens não reaparece aqui. Quem só tem inscrição em campanha desativada aparece como "Participante fora da base".

Pontos em branco na linha do tempo querem dizer que a campanha não usa pontos de fidelidade. Zero diria que a pessoa tem saldo zero, que é outra coisa.

O consentimento é por campanha. O perfil mostra, para cada participação, o aceite do regulamento, de contato e de parceiros. Um "aceita contato" único esconderia que a pessoa aceitou numa campanha e recusou na seguinte.

Permissões

A Visão geral e os cartões de segmento reaproveitam a permissão de ler campanhas (são contagens). A lista de um segmento e o perfil exigem ler participações. A exportação exige, além disso, a global Exportar dados. Dado pessoal sai mascarado para quem não tem a global Vê dados sensíveis — quem mascara é o servidor.

Não há recurso novo na matriz de permissões para a Base.

A Base é o módulo mais usado em conversa comercial: é a visão do cliente inteiro, não de uma campanha. Cinco orientações:

Os números da Base não batem com os de uma campanha, e isso é correto. A Base soma todas as campanhas ativas; o Dashboard é de uma campanha.

Os seis segmentos cobrem toda a base: cada pessoa está em exatamente um, e a soma fecha. Se não fechar, é defeito e vale avisar.

Os cortes dos segmentos se movem com a base. Alguém pode sair de Campeões sem ter feito nada, porque o corte é relativo. A regra aplicada hoje, com os valores, aparece no próprio cartão.

Na lista de um segmento, uma linha é uma pessoa. Em Gerenciar e Participantes, uma linha é uma inscrição. Por isso a mesma pessoa aparece com contagens diferentes nas duas telas.

A exportação de um segmento traz só quem aceita contato, e vai ter menos linhas que o cartão. O painel mostra quantos de quantos antes do clique, e o aviso está na primeira linha do arquivo. Para chamar esse público para a próxima campanha, o caminho é o botão "Convidar este público".

• Falha: os números da Base não batem com os do dashboard da campanha.
• Possivel causa: a Base soma todas as campanhas ativas e não tem seletor de campanha. O dashboard é de uma campanha.
• Como orientar: explique a diferença de escopo. A própria tela diz isso em texto fixo. Para os números de uma campanha, use o Dashboard ou o grupo Gerenciar.
• Quando escalar: não é falha.

• Falha: a soma dos seis segmentos não fecha com o total da base.
• Possivel causa: os seis segmentos são uma partição e a soma deveria ser igual ao total. A tela não arredonda para fechar.
• Como orientar: registre os números exibidos. Isso é defeito e não deve ser contornado na conversa com o cliente.
• Quando escalar: acionar o time de desenvolvimento e abrir issue no Jira (projeto DEV) com as evidências e os números dos seis cartões.

• Falha: o segmento Em risco aparece vazio.
• Possivel causa: pode não haver uma campanha encerrada com inscrição para servir de referência. Nesse caso o vazio é falta de referência, e não mérito.
• Como orientar: leia o aviso da própria tela. Ela cita a última campanha encerrada quando existe e avisa quando não existe.
• Quando escalar: se houver campanha encerrada com inscrição e o segmento continuar vazio, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: células do mapa de retorno aparecem vazias.
• Possivel causa: a faixa ainda não foi medida porque não existem campanhas suficientes depois da campanha de entrada. Vazio não é zero.
• Como orientar: explique a diferença. Vazio quer dizer que não houve campanha seguinte. Zero por cento quer dizer que houve e ninguém voltou.
• Quando escalar: não é falha.

• Falha: o CSV do segmento veio com menos linhas que o cartão.
• Possivel causa: a exportação traz somente quem aceita contato, e esse recorte é do servidor.
• Como orientar: explique o recorte. O painel mostra quantos de quantos antes do clique, e o aviso está na primeira linha do arquivo.
• Quando escalar: não é falha.

• Falha: a busca por CPF na lista do segmento não filtra.
• Possivel causa: a busca por documento só funciona com o CPF ou CNPJ completo. Documento pela metade não filtra.
• Como orientar: oriente a digitar o documento inteiro ou buscar por um trecho do nome.
• Quando escalar: se o documento completo estiver correto e a pessoa não aparecer estando na base, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a mesma pessoa aparece com contagem diferente na Base e em Gerenciar.
• Possivel causa: na Base uma linha é uma pessoa. Em Gerenciar e Participantes uma linha é uma inscrição.
• Como orientar: explique o grão de cada tela. A ajuda da lista do segmento também diz isso.
• Quando escalar: não é falha.

• Falha: o botão de exportar o segmento está desabilitado.
• Possivel causa: ninguém do segmento aceita contato e o arquivo sairia só com cabeçalho, ou o role não tem a permissão global Exportar dados.
• Como orientar: confira o número de quem aceita contato no cartão. Se houver gente, confira a permissão global Exportar dados com o Master.
• Quando escalar: se houver gente que aceita contato e a permissão estiver marcada, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o CPF e o e-mail aparecem mascarados nas telas da Base.
• Possivel causa: o role não tem a permissão global Vê dados sensíveis. Quem mascara é o servidor.
• Como orientar: oriente o Master a marcar a permissão global Vê dados sensíveis no role do usuário, se o acesso for necessário.
• Quando escalar: se a permissão estiver marcada e o dado continuar mascarado, abrir issue no Jira (projeto DEV) com as evidências.