Recuperação de carrinhos abandonados em várias etapas: guia completo
Instalar, configurar e explorar a recuperação dos carrinhos abandonados: deteção automática, sequências de e-mails em várias etapas, cupões escalonados, recuperação do carrinho com um clique, seguimento e estatísticas de recuperação para PrestaShop 8 e 9.
Apresentação
O módulo Recuperação de Carrinhos Abandonados em Várias Etapas (datafireflycartrecovery) deteta automaticamente os carrinhos abandonados e recontacta os seus clientes através de uma sequência de e-mails programados. Cada etapa tem o seu próprio prazo, o seu conteúdo por idioma e um cupão de desconto opcional, cujo incentivo pode ir aumentando ao longo do tempo. Uma ligação assinada permite ao cliente recuperar o carrinho com um clique, e um painel mede o volume de negócios efetivamente recuperado.
Em média, quase 7 em cada 10 carrinhos são abandonados antes do pagamento. Uma sequência de recuperação bem afinada (um lembrete simples, depois um desconto moderado e por fim uma oferta mais forte com portes grátis) recupera uma parte significativa desse volume de negócios sem esforço manual.
Compatibilidade
- PrestaShop 8.0 a 9.x
- PHP 8.1 a 8.3
- Loja única e multiloja (campanhas e estatísticas segmentadas por loja)
- 5 idiomas: FR, EN, ES, DE, IT
- Arquitetura PSR-4 sem Composer, uma classe por ficheiro e sem dependências externas
O pacote de traduções não inclui o português, e aqui isso é particularmente sensível: o modelo de e-mail responsivo (cabeçalho, botão de ação, tabela de resumo do carrinho, bloco de cupão e rodapé com a ligação de anulação da subscrição) é entregue nesses cinco idiomas. Crie a pasta mails/pt e traduza estas cadeias antes de ativar a campanha, caso contrário o cliente português recebe um e-mail parcialmente noutro idioma.
Instalação
- No back-office, abra Módulos > Gestor de módulos.
- Clique em Carregar um módulo e selecione o ficheiro
datafireflycartrecovery.zip. - Depois de instalado, clique em Configurar.
Na instalação, o módulo cria as suas tabelas (carrinhos seguidos, fila de envio, eventos e lista de supressão), regista os seus hooks, acrescenta um separador Recuperação de carrinhos no menu Clientes e cria uma campanha predefinida de três etapas pronta a usar: +1 h (lembrete simples, sem cupão), +24 h (cupão de −5 %) e +72 h (cupão de −10 % com portes grátis).
Configuração do CRON
O módulo assenta em dois processamentos agendados, executados por um único URL protegido por token: o scan (marca os carrinhos inativos como abandonados e agenda as etapas) e o processamento (envia os e-mails devidos, respeitando as proteções). O URL exato, com o seu token, é apresentado na página de configuração do módulo.
https://A-SUA-LOJA/index.php?fc=module&module=datafireflycartrecovery&controller=cron&token=O_TOKEN
Agende uma tarefa a cada 15 minutos, aproximadamente, por exemplo:
*/15 * * * * wget -q -O /dev/null "https://A-SUA-LOJA/index.php?fc=module&module=datafireflycartrecovery&controller=cron&token=O_TOKEN"
Sem tarefa de cron ativa, nenhum carrinho é marcado como abandonado e não sai qualquer recuperação. O token protege o URL contra chamadas não autorizadas: não o divulgue publicamente. Se o regenerar, lembre-se de atualizar a linha do crontab.
Definições gerais
Na página de configuração, ajuste o comportamento global da deteção e do envio:
- Prazo de abandono (60 min por predefinição): tempo de inatividade de um carrinho a partir do qual é considerado abandonado.
- Dimensão do lote (50 por predefinição): número de e-mails tratados em cada passagem do cron, para distribuir a carga do servidor e do envio SMTP.
- Número máximo de e-mails por carrinho (3 por predefinição): limite de e-mails enviados para o mesmo carrinho, somando todas as etapas.
- Duração do seguimento (30 dias por predefinição): passado esse prazo, um carrinho não convertido deixa de ser recontactado e é arquivado.
- Reautenticação automática (ativa por predefinição): volta a autenticar o cliente quando ele clica na ligação de recuperação (ver mais abaixo).
- Remetente: endereço e nome de remetente dos e-mails. Deixe vazio para usar o endereço e o nome da loja.
Campanhas e sequências
Definições da campanha
Uma campanha reúne uma sequência de etapas e as suas regras de segmentação:
- Montante mínimo do carrinho: só recontacta os carrinhos acima de um limiar (0 = sem mínimo).
- Janela de envio: intervalo horário (por exemplo, das 8h às 21h) fora do qual os e-mails devidos são adiados, para evitar envios noturnos. A janela lida corretamente com a passagem da meia-noite.
- Anti-repetição (cooldown): prazo mínimo entre duas sequências para o mesmo cliente, para não o sobrecarregar.
- Abranger os convidados: inclui ou exclui as compras como convidado (carrinhos sem conta de cliente).
- Excluir contas B2B: exclui os clientes com empresa, SIRET ou número de IVA preenchidos.
O campo SIRET é francês e fica vazio numa loja portuguesa. Para excluir efetivamente os seus clientes profissionais, garanta que o campo da empresa ou o número de contribuinte (NIF, com prefixo PT no formato intracomunitário) estão preenchidos nas fichas B2B: é sobre esses campos que a exclusão vai funcionar.
Etapas da sequência
Cada etapa define quando e o que enviar:
- Posição: ordem da etapa na sequência.
- Prazo após o abandono (em minutos): por exemplo, 60 = 1 h, 1440 = 24 h, 4320 = 72 h.
- Assunto e corpo HTML por idioma: o conteúdo de marketing, traduzível para cada um dos idiomas ativos.
- Etapa ativa: permite ativar ou suspender uma etapa sem a eliminar.
O conteúdo HTML que introduz é inserido num modelo de e-mail responsivo fornecido em cinco idiomas: o cabeçalho, o botão de ação, a tabela de resumo do carrinho, o bloco de cupão e o rodapé (incluindo a ligação de anulação da subscrição) são acrescentados automaticamente. Estão disponíveis três variáveis no seu texto: {firstname}, {shop_name} e {voucher_code}.
Defina a janela de envio no fuso da sua loja. Se o seu alojamento agenda o cron em UTC, tenha em conta o desfasamento do horário de verão em Portugal continental, para que as 8h da janela sejam mesmo as 8h locais.
Cupões de desconto
Cada etapa pode gerar um cupão nominativo, criado na hora para o cliente em causa:
- Tipo: percentagem ou valor fixo.
- Valor e montante mínimo de aplicação.
- Validade em dias.
- Portes grátis (acumulável com o desconto).
- Desconto com ou sem IVA.
Os cupões são nominativos, de utilização única e limitados no tempo: não podem ser partilhados nem reutilizados. Uma boa prática é não oferecer qualquer desconto na primeira etapa (simples lembrete) e ir aumentando depois (−5 % e, a seguir, −10 % com portes grátis), para só conceder desconto aos clientes que precisam dele para converter.
Um cupão nominativo enviado por e-mail a um cliente identificado é uma vantagem individual, não um anúncio de redução ao público. Não fica, por isso, sujeito à obrigação de indicar o preço mais baixo dos 30 dias anteriores (Decreto-Lei n.º 66/2021), que se aplica às reduções anunciadas na loja. Se, em contrapartida, comunicar a mesma promoção na sua página inicial, aí a regra aplica-se.
Recuperação do carrinho com um clique
Cada e-mail contém uma ligação de recuperação assinada (HMAC) que reconstitui exatamente o carrinho do cliente e que, se a opção estiver ativa, o volta a autenticar automaticamente na sua conta. Um único clique leva-o de volta à página do carrinho, pronto a pagar, já com o cupão da etapa associado.
A ligação é assinada: qualquer alteração dos seus parâmetros invalida-a. A reautenticação automática pode ser desativada nas definições gerais, se preferir que o cliente inicie sessão manualmente.
Seguimento e atribuição do volume de negócios
- Aberturas: um pixel invisível regista a abertura de cada e-mail.
- Cliques: o clique na ligação de recuperação é contabilizado.
- Conversão: na validação de uma encomenda, o módulo associa automaticamente a encomenda ao carrinho recontactado, marca o carrinho como recuperado, atribui-lhe o volume de negócios e cancela as recuperações restantes da sequência.
Conformidade com o RGPD
Cada e-mail inclui uma ligação de anulação da subscrição. Quando um cliente a usa, o seu endereço é acrescentado a uma lista de supressão persistente: deixa de ser recontactado e os envios pendentes que lhe digam respeito são cancelados. Os carrinhos sem endereço de e-mail utilizável nunca são seguidos. A desinstalação do módulo elimina as tabelas, a configuração e o separador de administração.
Em Portugal, a Lei n.º 41/2004 exige o consentimento prévio para as comunicações comerciais eletrónicas, com uma exceção para os clientes que já compraram, desde que a mensagem diga respeito a produtos análogos e que a possibilidade de recusa seja oferecida em cada comunicação. A ligação de anulação da subscrição responde a esta última exigência. Trate com atenção o caso dos carrinhos de convidados que nunca chegaram a comprar: se ativar a opção «Abranger os convidados», confirme com o seu jurista que dispõe de uma base legal para os contactar. O tratamento deve constar do seu registo de atividades, sob supervisão da CNPD.
Painel e estatísticas
O separador Recuperação de carrinhos mostra os indicadores-chave a 30 dias: carrinhos detetados e valor abandonado, carrinhos recuperados e taxa de recuperação, e-mails enviados, taxas de abertura e de clique, e volume de negócios recuperado. Um gráfico compara as deteções com as recuperações dia a dia, e uma tabela detalha o desempenho de cada etapa da campanha ativa (enviados, abertos, clicados, taxa de clique). O separador Carrinhos lista os últimos carrinhos seguidos com o respetivo estado.
Perguntas frequentes e resolução de problemas
Não sai qualquer recuperação
Confirme antes de mais que a tarefa de cron está ativa e chama o URL com o token correto. Sem cron, nada é detetado nem enviado. Verifique depois que a campanha está ativa, que existe pelo menos uma etapa ativa e que a hora atual está dentro da janela de envio.
Como são detetados os carrinhos abandonados?
O módulo regista os carrinhos através de um hook do PrestaShop e o scan do cron marca como abandonados os que ficaram inativos para além do prazo de abandono configurado, desde que exista um endereço de e-mail utilizável.
Um cliente pode receber demasiados e-mails?
Não: o número máximo de e-mails por carrinho, a anti-repetição entre sequências e a janela de envio enquadram estritamente a frequência. Assim que um carrinho é convertido ou o cliente anula a subscrição, as recuperações restantes são canceladas.
Os cupões de desconto são seguros?
Sim. Cada cupão é nominativo, de utilização única e limitado no tempo; é gerado para um cliente concreto e não pode ser reutilizado por terceiros.
O módulo é compatível com multiloja?
Sim. As campanhas, os carrinhos seguidos e as estatísticas são segmentados por loja.
É compatível com o PrestaShop 9?
Sim. O módulo está testado em PrestaShop 8 e 9 e acompanha as alterações de API do PS9 (formatação de preços pela API Locale, controladores, entre outras).