DfCartRecovery: recuperação de carrinho abandonado para Shopware 6

Apresentação

O DfCartRecovery acrescenta ao Shopware 6 (Community Edition) a recuperação de carrinhos abandonados, normalmente reservada ao plano Commercial: deteção dos carrinhos, até 3 emails de recuperação agendados, código promocional único por cliente, ligação de restauro do carrinho num clique e acompanhamento das encomendas recuperadas. Sem serviços externos, sem build de administração: tudo se configura nas definições da extensão.

Pré-requisitos

• Shopware 6.5, 6.6 ou 6.7 (Community Edition auto-alojada; o Shopware Cloud SaaS não é suportado)
• PHP 8.1 ou superior (8.2+ recomendado)
• O consumidor de mensagens e a execução das tarefas agendadas ativos (recomendação normal do Shopware em produção)
• O envio de emails a funcionar na loja (os emails de recuperação passam pelo serviço de email nativo do Shopware)

Instalação

1. Descomprima o arquivo e coloque a pasta DfCartRecovery em custom/plugins/.
2. A partir da raiz do Shopware, execute:

bin/console plugin:refresh
bin/console plugin:install --activate DfCartRecovery
bin/console cache:clear

A tarefa agendada df_cart_recovery.process é registada automaticamente e corre a cada 15 minutos. Verifique que os seus workers estão a correr:

bin/console scheduled-task:run
bin/console messenger:consume async low_priority

Configuração

Vá a Extensões → As minhas extensões → DfCartRecovery → Configuração. Três cartões de definições:

Geral

• Ativar a recuperação de carrinho: interruptor global da extensão.
• Valor mínimo do carrinho: os carrinhos abaixo deste montante são ignorados (0 = sem mínimo).
• Retenção dos dados (dias): os registos de seguimento mais antigos são eliminados automaticamente (30 dias por predefinição, ver a secção RGPD).

Emails de recuperação

• Número de emails: 1, 2 ou 3 (2 por predefinição).
• Email 1: minutos após o abandono do carrinho (60 por predefinição, ou seja 1 hora).
• Email 2: minutos após o email 1 (1440 por predefinição, ou seja 24 horas).
• Email 3: minutos após o email 2 (4320 por predefinição, ou seja 72 horas).

Código promocional

• Incluir um código promocional único: ativa a geração de códigos individuais.
• Promoção para os códigos gerados: selecione a promoção Shopware que vai transportar os códigos (ver abaixo).
• Enviar o código com o email n.º: 2 por predefinição; os clientes que voltam logo com o primeiro email encomendam sem desconto.
• Prefixo do código: CART por predefinição; os códigos gerados têm o aspeto CART-7F3A91B2.

Criar a promoção para os códigos únicos

1. Na administração do Shopware, abra Marketing → Promoções e crie uma promoção (ou reutilize uma existente).
2. No separador geral, ative Códigos promocionais individuais.
3. Defina o desconto (percentagem ou montante), as condições e o período de validade como habitualmente.
4. Ative a promoção e selecione-a na configuração da extensão.

Personalizar o email de recuperação

O conteúdo edita-se em Definições → Modelos de email, tipo «Recuperação de carrinho abandonado (DataFirefly)», para cada idioma da loja. Variáveis Twig disponíveis:

• firstName / lastName: nome próprio e apelido do cliente
• items: artigos do carrinho, cada um com label e quantity
• total e currency: montante do carrinho e código da moeda
• recoveryUrl: ligação de restauro do carrinho (a colocar no botão de ação)
• voucherCode: código promocional único (vazio se não estiver ativo ou no email sem código: envolva o bloco numa condição Twig)
• shopName: nome da loja do canal de venda
• reminderNumber: número do email em curso (1, 2 ou 3)

A ligação de restauro

Cada email contém uma ligação única do tipo /df-cart-recovery/token, gerada no domínio do canal de venda do cliente, no idioma dele. Ao clicar, a extensão reconstrói o carrinho artigo a artigo, assinala os produtos que deixaram de estar disponíveis com uma mensagem no storefront, regista a data e hora do clique e reencaminha para a página do carrinho. As ligações inválidas ou expiradas reencaminham para a página inicial com uma mensagem explícita.

Acompanhamento da recuperação

Assim que é feita uma encomenda, a extensão cruza o email do cliente com os carrinhos abandonados em curso: o registo passa a «recuperado» com o identificador da encomenda, a data e o número de emails enviados. Os emails param de imediato para esse carrinho. Os dados podem ser consultados na tabela df_cart_recovery (tokens, estados, cliques, encomendas ligadas) para os seus relatórios SQL ou BI.

RGPD e dados

• Nenhum dado sai do seu servidor; nenhum serviço de terceiros é chamado.
• Os registos de seguimento são eliminados automaticamente após o prazo de retenção configurado.
• Na desinstalação, escolha «Eliminar todos os dados da aplicação» para apagar a tabela, o template de email e a configuração, ou conserve-os para manter o histórico.

Resolução de problemas

Nenhum email é enviado

• Verifique que a tarefa agendada está a correr: bin/console scheduled-task:list deve mostrar df_cart_recovery.process em estado scheduled, e os seus workers do messenger têm de estar ativos.
• Teste o envio de email global da loja (Definições → Agente de correio): a extensão usa o serviço de email normal.
• Controle o valor mínimo do carrinho e o prazo do email 1: um carrinho abandonado há 20 minutos com um prazo de 60 minutos ainda não é elegível.

Os visitantes não recebem nada

É o comportamento esperado: sem endereço de email, nenhum envio é possível. Os visitantes passam a ser seguidos assim que se identificam (início de sessão ou criação de conta durante o checkout); a fusão do carrinho atualiza o registo com o endereço deles.

O código promocional não aparece no email

• Verifique que a opção «Incluir um código promocional único» está ativa e que está selecionada uma promoção.
• A promoção tem de existir, estar ativa e ter os códigos individuais ativos.
• O código só é anexado a partir do email configurado (o 2.º por predefinição): o email 1 não o contém na configuração normal.

A ligação de restauro reencaminha para a página inicial

O token é inválido ou o registo foi eliminado (retenção ultrapassada); o cliente recebe uma mensagem a convidá-lo a refazer o carrinho. Aumente a duração da retenção se os seus prazos de envio forem longos.