DataFirefly Fidelização e Recomendação: pontos, níveis e programa de recomendação para PrestaShop

Instalação

Instale o módulo em Módulos > Gestor de módulos > Carregar um módulo enviando o ficheiro ZIP, ou copie a pasta dfloyalty para o diretório /modules/ da loja e clique em Instalar.

Na instalação, o módulo cria as suas tabelas, guarda as definições predefinidas, cria quatro níveis de estatuto (Bronze, Prata, Ouro, Platina) e adiciona o separador Clientes > Fidelização e Recomendação. O botão Configurar do gestor de módulos abre diretamente as definições.

Primeiras definições

As definições estão agrupadas em secções, acessíveis pelo menu à esquerda. Antes de abrir o programa aos clientes, verifique pelo menos:

• Pontos por unidade de moeda gasta: 1 por predefinição, ou seja 1 ponto por euro. Aceita decimais (0,5 = 1 ponto a cada 2 euros).
• Estados de encomenda que confirmam os pontos: por predefinição pagamento aceite, enviada e entregue.
• Taxa de conversão: 100 pontos = 5 € por predefinição. A caixa à esquerda calcula em tempo real a percentagem devolvida aos clientes depois da conversão.
• Recompensas de recomendação: 10 € para o amigo e 500 pontos para quem recomenda, por predefinição.

Ganho de pontos

Cálculo

Os pontos são calculados sobre as linhas de produto da encomenda, na moeda do cliente e depois convertidos para a moeda predefinida. Os portes nunca dão pontos. Três opções ajustam a base:

• Calcular sobre preços com IVA: desative para calcular sobre preços sem IVA.
• Deduzir vales e descontos: as regras de carrinho da encomenda (exceto portes grátis) são retiradas da base de forma proporcional.
• Sem pontos em produtos já em promoção: os produtos vendidos com redução são excluídos.

Depois aplicam-se o multiplicador do nível do cliente e os pontos bónus do produto. O resultado é arredondado para baixo.

Ciclo de vida dos pontos

• Na validação da encomenda, os pontos são registados como pendentes. O cliente vê-os na conta mas não os pode usar.
• Quando a encomenda atinge um dos estados que confirmam os pontos, ficam disponíveis.
• Quando a encomenda passa a um dos estados que anulam os pontos, são retirados, pendentes ou disponíveis.
• Uma nota de crédito parcial retira a parte dos pontos correspondente ao valor dos produtos reembolsados.
• Se uma encomenda cancelada voltar a um estado de confirmação, os pontos voltam.

Cada movimento é registado num histórico que nunca é reescrito: em vez de alterar uma linha, é adicionada uma linha de correção.

Pontos no registo

A definição Pontos oferecidos no registo credita um número fixo de pontos em cada criação de conta de cliente (não em encomendas como convidado). Deixe 0 para desativar.

Níveis de estatuto

O separador Níveis lista os níveis por ordem de limiar. Cada nível tem um nome e um texto de vantagens traduzíveis, um limiar em pontos de estatuto, um multiplicador de pontos e uma cor, usada no cartão de membro do cliente.

Os pontos de estatuto são os pontos ganhos menos cancelamentos e reembolsos. Converter pontos em vales ou deixá-los expirar não baixa o estatuto. A definição Período do estatuto limita o cálculo aos últimos N meses; deixe 0 para contar desde o registo.

O primeiro nível deve ter limiar 0 para que todos os clientes tenham estatuto desde a primeira encomenda. Quando um cliente atinge um novo nível, vê uma mensagem de parabéns na visita seguinte à página de fidelização.

Grupo de clientes do nível

Na ficha de um nível, o campo Grupo de clientes deste nível associa o nível a um grupo do PrestaShop. O módulo adiciona a esse grupo os clientes que atingem o nível e remove-os quando o deixam. Configure nesse grupo uma redução (Clientes > Grupos), uma regra de carrinho de portes grátis reservada ao grupo ou preços específicos: a vantagem aplica-se sem intervenção.

• Crie um grupo dedicado a cada nível. Um cliente colocado à mão nesse grupo seria removido se não tiver o nível.
• O grupo predefinido do cliente nunca é alterado.
• A sincronização acontece a cada movimento de pontos, ao guardar um nível e todos os dias com a tarefa agendada.

Pontos bónus em produtos

O separador Produtos com bónus permite dar mais pontos em determinados produtos. Procure o produto pelo nome ou referência e escolha:

• Multiplicador: 2 duplica os pontos deste produto.
• Pontos fixos por artigo: um número de pontos adicionado por cada unidade, além dos pontos padrão.

As datas de início e fim são opcionais. Sem datas, o bónus é permanente. A página do produto mostra um selo (x2, +50) e os pontos a ganhar, recalculados quando o cliente altera a quantidade. O bónus combina-se com o multiplicador do nível.

Conversão em vales

Na conta do cliente

No separador Recompensas da página de fidelização, o cliente escolhe com um cursor quantos pontos converter, em múltiplos do número de pontos da taxa de conversão. Recebe um vale pessoal com o código DFPTS-XXXXXXXX, mostrado numa janela com botão de cópia e, se a opção estiver ativa, enviado por e-mail.

Diretamente no carrinho

Se a opção Permitir aos clientes usar os pontos diretamente no carrinho estiver ativa, o bloco de fidelização do carrinho mostra um cursor. O vale é criado e aplicado com um clique, sem ultrapassar o total dos produtos. A partir deste bloco só pode ser aplicado um vale de pontos por carrinho. Os vales já gerados e não usados também aparecem com um botão Aplicar.

Definições dos vales

• Pontos mínimos para converter: abaixo disso, o cliente vê uma barra de progresso até ao primeiro vale.
• Validade do vale: em dias, 365 por predefinição.
• Carrinho mínimo para o usar: 0 para nenhum mínimo.
• Acumulação com outras regras de carrinho: desative se os vales de fidelização não se devem somar aos seus códigos promocionais.

Os vales são regras de carrinho padrão do PrestaShop, visíveis em Catálogo > Descontos, atribuídas ao cliente e de utilização única.

Recomendação

A ligação de quem recomenda

Cada cliente tem um código e uma ligação de recomendação (parâmetro ?dfref=CODIGO na página inicial), visíveis no separador Recomendação da página de fidelização. Pode copiar a ligação, partilhá-la por WhatsApp, e-mail, Facebook ou X ou pela partilha nativa do telemóvel, e enviar convites por e-mail a partir do formulário.

A chegada do amigo

O visitante que clica na ligação é memorizado durante o tempo definido em Memória da ligação (30 dias por predefinição). Uma faixa discreta apresenta-lhe o presente e uma mensagem acompanha o formulário de registo. Ao criar a conta, também durante o checkout:

• se a recompensa do amigo for um valor ou uma percentagem, é criado um vale sem código, adicionado automaticamente ao carrinho, com a compra mínima e a validade definidas;
• se for um número de pontos, são creditados na validação da primeira encomenda.

Código introduzido no registo

Com a opção Adicionar um campo opcional «Código de recomendação» ao formulário de registo, um amigo que recebeu o código de viva voz pode introduzi-lo ao criar a conta. Um código desconhecido é recusado com uma mensagem de erro. O campo não aparece se o visitante já chegou por uma ligação de recomendação.

A recompensa de quem recomenda

Quem recomenda é recompensado quando a primeira encomenda do amigo atinge um estado que confirma os pontos e o total dos produtos com IVA atinge a Primeira encomenda mínima do amigo. Recebe pontos ou um vale com o código DFREF-XXXXXXXX, e um e-mail de agradecimento.

Proteções

• Um cliente não se pode recomendar a si próprio, nem com o mesmo endereço de e-mail.
• Um endereço de e-mail que já encomendou na loja não é associado a quem recomenda.
• Só conta a primeira encomenda validada do amigo. Se estiver abaixo do mínimo, a recomendação passa a Não elegível.
• Os convites por e-mail têm um limite diário por cliente, e o mesmo endereço não pode ser convidado duas vezes em 7 dias.

Estados de uma recomendação

Convidado: e-mail enviado pelo cliente. Registado: conta criada com a ligação. Recompensado: primeira encomenda validada, recompensas atribuídas. Não elegível: primeira encomenda abaixo do mínimo.

Expiração e tarefa agendada

A definição Expiração após inatividade faz expirar o saldo de um cliente quando este não ganhou pontos durante o número de meses indicado. Cada encomenda adia a data, e o cliente vê-a na conta. Deixe 0 para que os pontos nunca expirem.

A expiração é aplicada quando o cliente abre a página de fidelização e pela tarefa diária cujo URL está em Definições > Manutenção. Agende-a uma vez por dia no seu gestor de cron ou num módulo de tarefas do PrestaShop. Também envia os lembretes de expiração, credita os pontos de aniversário e atualiza os grupos dos níveis. O botão Executar agora a tarefa diária no separador Manutenção faz o mesmo.

A definição Lembrete antes da expiração (30 dias por predefinição) envia ao cliente um e-mail com o saldo, o seu valor e a data de expiração. É enviado um único lembrete por data; se o cliente encomendar entretanto, a data muda e será enviado um novo lembrete na altura certa.

Acrescente &resync=1 ao URL para reprocessar também os estados das encomendas dos últimos 7 dias.

Aniversário, newsletter e campanhas

Pontos de aniversário

A definição Pontos de aniversário credita pontos uma vez por ano na data de nascimento indicada na conta do cliente, com um e-mail de parabéns. A atribuição é feita pela tarefa diária e também quando o cliente inicia sessão ou abre a sua página de fidelização. Os clientes nascidos a 29 de fevereiro recebem-nos a 28 nos anos não bissextos. Por predefinição, só os clientes com uma encomenda validada têm direito, para evitar contas criadas apenas pelo presente.

Pontos de subscrição da newsletter

A definição Pontos de subscrição da newsletter credita pontos uma única vez por cliente: no registo se a caixa da newsletter estiver assinalada, numa subscrição posterior a partir da conta, ou através do bloco de newsletter do rodapé para um endereço que corresponda a uma conta de cliente. Os subscritores anteriores à ativação da opção não recebem pontos com efeito retroativo.

Campanhas de pontos

A secção Campanha de pontos multiplica todos os pontos ganhos entre duas datas: 2 para pontos a dobrar. O multiplicador soma-se ao do nível e aos bónus de produto. Durante a campanha, aparece um selo nas páginas de produto, no bloco do carrinho e na página de fidelização. Conta a data da encomenda: uma encomenda feita durante a campanha mantém os pontos reforçados mesmo que seja validada depois do fim.

Excluir grupos de clientes

Em Definições > Geral, assinale os grupos de clientes excluídos do programa, por exemplo contas profissionais ou funcionários. Um cliente de um desses grupos não ganha pontos, não vê o bloco da conta, a página de fidelização nem os blocos de produto e carrinho, e a sua ligação de recomendação não gera recompensa.

O que o cliente vê

• A minha conta: um bloco com o nome do programa e o saldo, e uma ligação no bloco A minha conta do rodapé.
• Página de fidelização: cartão de membro nas cores do nível, progresso, separadores Recompensas, Recomendação, Histórico e Estatutos.
• Página do produto: pontos a ganhar, valor em euros, selo de bónus. Opção Mostrar os pontos a ganhar nas páginas de produto.
• Carrinho: pontos da encomenda, saldo, utilização de pontos e vales disponíveis. Opção Mostrar o bloco de pontos no carrinho. O bloco atualiza-se a cada alteração do carrinho.
• Confirmação da encomenda: pontos ganhos, pendentes ou já creditados.

Back office

Painel

Pontos em circulação e o seu valor (o passivo que os saldos representam), pontos pendentes, número de membros, pontos ganhos e convertidos em 30 dias com gráfico, membros por nível, vales criados e usados, funil de recomendação, melhores padrinhos e atividade recente.

Membros e ficha de membro

O separador Membros lista os clientes com pontos, ordenados por saldo. A pesquisa abrange nome, e-mail, ID de cliente ou código de recomendação e inclui clientes sem pontos, para os poder creditar. A ficha de membro mostra saldo, nível, histórico, vales e amigos recomendados, e permite um ajuste manual: introduza um número positivo ou negativo e um motivo, que o cliente verá no histórico.

A ficha de cliente nativa do PrestaShop também mostra um bloco com saldo, nível, código de recomendação e uma ligação para a ficha de membro.

Página da encomenda e exportações

Na página de uma encomenda no back office, um bloco indica os pontos da encomenda e o seu estado, os bónus e multiplicadores aplicados, os vales de fidelização usados e se é a primeira encomenda de um cliente recomendado. O separador Membros oferece duas exportações CSV: a lista de membros (saldo, nível, pontos de estatuto, código de recomendação) e todos os movimentos de pontos. Os ficheiros abrem diretamente no Excel ou no LibreOffice.

E-mails

O módulo envia seis e-mails no idioma do destinatário: o convite de um amigo, o presente de boas-vindas do amigo, a recompensa de quem recomenda, o vale criado a partir dos pontos, os parabéns de aniversário e o lembrete de expiração. Usam um modelo único na cor de destaque com o logótipo da loja. Os textos vêm das traduções do módulo; o modelo está em mails/.

Dados e desinstalação

Por predefinição, a opção Manter saldos e definições ao desinstalar o módulo está ativa: desinstalar e reinstalar não faz perder nada. Desative-a antes de desinstalar se quiser apagar todos os dados. Quando um cliente é eliminado no PrestaShop, os seus pontos, vales registados e recomendações são eliminados com ele.

O módulo é compatível com o módulo RGPD oficial do PrestaShop: a exportação dos dados de um cliente inclui o histórico de pontos e o código de recomendação, e a eliminação de um cliente a partir desse módulo apaga os seus dados de fidelização.

Resolução de problemas

Os pontos continuam pendentes

Verifique se o estado atual da encomenda está assinalado em Estados de encomenda que confirmam os pontos. Se um funcionário alterou o estado e o seu perfil não tem a permissão Ver no módulo (Parâmetros avançados > Equipa > Permissões), o PrestaShop não executou o módulo: use Ressincronizar as encomendas dos últimos 90 dias em Definições > Manutenção. A operação pode ser repetida sem risco de crédito duplicado.

O bloco de fidelização não aparece no carrinho

O bloco é apresentado através do hook displayShoppingCart, presente no tema Classic. Se o seu tema não o chamar, acrescente {hook h='displayShoppingCart'} ao template do carrinho, ou contacte-nos indicando o tema.

A faixa de recomendação não aparece

Só é mostrada a visitantes sem sessão iniciada que chegaram por uma ligação válida, e fica oculta durante 3 dias depois de fechada. Teste numa janela de navegação privada.

Alguns textos continuam em inglês

O módulo é fornecido em 8 idiomas. Para outro idioma, ou para alterar um texto, use Internacional > Traduções > Traduções de módulos instalados.

Compatibilidade

• PrestaShop 8.0 a 9.x, o mesmo ZIP cobre as duas versões.
• Multilingue e multimoeda. Em multiloja, o saldo de um cliente é comum a todas as lojas.
• Arquitetura ModuleAdminController, sem dependências Composer.
• Módulo e e-mails traduzidos em inglês, francês, espanhol, alemão, italiano, neerlandês, polaco e português.