Funil de conversão e mapa de calor: documentação do módulo PrestaShop 8 e 9

O módulo DataFirefly: Funil de Conversão e Mapa de Calor (dffunnelheatmap) mostra onde os seus visitantes desistem, de onde vêm os compradores e o que os trava nas suas páginas. Reúne um funil de conversão em 9 passos, um relatório de aquisição, estatísticas de produtos, um mapa de calor com deteção de cliques de raiva e um relatório semanal por e-mail. Toda a recolha de dados é first-party: nada sai do seu servidor.

Esta documentação abrange a versão 1.3.2, compatível com PrestaShop 8.0 a 9.x (PHP 7.2 ou superior).

Instalação e atualização

1. Descarregue o arquivo dffunnelheatmap.zip a partir da sua conta de cliente.
2. No back-office, abra Módulos > Gestor de módulos, clique em Carregar um módulo e selecione o ZIP.
3. O módulo cria as suas 6 tabelas e acrescenta o separador Estatísticas > Funil e mapa de calor.

Para atualizar a partir de uma versão anterior, carregue o novo ZIP por cima do módulo instalado. Os scripts de atualização correm sozinhos: os seus dados e definições são conservados.

Primeiros passos

Enquanto não chegar a primeira visita, o painel mostra uma lista de verificação: rastreamento ativado, funil ou mapa de calor ativado, primeira visita recebida. Os navegadores com sessão iniciada no back-office não são contados: para verificar a recolha, abra a loja numa janela de navegação privada ou noutro dispositivo.

O painel

A interface tem seis separadores: Painel, Funil de conversão, Aquisição, Produtos, Mapa de calor e Definições.

• Indicadores: sessões, visitantes únicos, encomendas efetuadas, taxa de adição ao carrinho, taxa de conversão, receita registada com IVA, encomenda média e maior abandono do funil. Cada indicador é comparado com o período anterior da mesma duração.
• Dia a dia: gráfico de sessões, encomendas ou taxa de conversão. Os botões acima do gráfico mudam o indicador sem recarregar a página, e a ligação Mostrar os dados abre a tabela de valores.
• Recomendações: até 6 constatações classificadas em A corrigir, A verificar e Boa notícia, cada uma com uma ligação para o relatório correspondente.
• Neste momento: visitantes dos últimos 5 minutos, páginas que veem e repartição por dispositivo, atualizado a cada 30 segundos.

Um cartão de resumo (sessões, encomendas e conversão dos últimos 7 dias, visitantes neste momento) aparece também no painel inicial do PrestaShop.

As recomendações

Só aparecem acima de um volume mínimo, cerca de 30 sessões por dispositivo ou canal, para evitar conclusões tiradas de três visitas. O módulo verifica:

• a maior fuga do funil entre dois passos;
• a proporção de sessões que entram no checkout e efetuam uma encomenda;
• a diferença de conversão entre telemóvel e computador;
• os canais que trazem tráfego sem nenhuma encomenda, e o canal que melhor converte;
• o produto mais visto entre os que são pouco adicionados ao carrinho;
• a página com mais cliques de raiva e cliques sem efeito;
• uma subida ou descida do tráfego de pelo menos 20%.

O funil de conversão

O funil conta sessões. Uma sessão termina após 30 minutos de inatividade. Cada sessão é contada no passo mais avançado que atinge, e em todos os anteriores: o funil estreita sempre.

1. Visita: qualquer página vista.
2. Página do produto: visualização de uma ficha de produto.
3. Adição ao carrinho: detetada no servidor, seja qual for a página de onde vem.
4. Página do carrinho: visualização do carrinho.
5. Checkout: entrada no processo de encomenda.
6. Morada: passo da morada do checkout padrão, detetado no navegador.
7. Envio: escolha da transportadora, detetada no navegador.
8. Pagamento: passo de pagamento, detetado no navegador.
9. Encomenda efetuada: registada no servidor quando a encomenda é validada e depois confirmada pela página de confirmação.

A tabela detalhada indica para cada passo as sessões que o atingem, a sua proporção, as sessões perdidas desde o passo anterior, a taxa de abandono e as sessões que acionaram o próprio passo. Uma adição ao carrinho a partir de uma página de categoria, por exemplo, salta a página do produto. As linhas com abandono acima de 30% ou 50% são destacadas a cor.

A coluna vs período anterior dá a variação da proporção de sessões, em pontos. A tabela Conversão por dispositivo compara computador, tablet e telemóvel. O botão Exportar CSV descarrega o funil com os filtros ativos.

Aquisição

Cada sessão é associada a um canal com base no domínio do site de origem (só o domínio é guardado), nas etiquetas UTM e nos identificadores de clique publicitários.

• Direto: sem site de origem nem etiqueta UTM.
• Pesquisa orgânica: motores de pesquisa (Google, Bing, Qwant, DuckDuckGo, Ecosia…).
• Anúncios pagos: identificador de clique do Google Ads ou do Microsoft Ads (gclid, msclkid), ou um utm_medium como cpc, ppc, paid ou display.
• Redes sociais: Facebook, Instagram, TikTok, LinkedIn, Pinterest, X, YouTube…, ou uma ligação com fbclid ou ttclid.
• Email: utm_medium=email ou um webmail (Gmail, Outlook…).
• Sites de referência: qualquer outro site.
• Outras campanhas: uma etiqueta UTM que não corresponde a nenhum dos casos anteriores.

Os regressos de uma página de pagamento (PayPal, Stripe…) não contam como origem: nunca substituem a origem real da visita.

O separador mostra os canais (sessões, proporção, rejeição, adição ao carrinho, conversão, encomendas e receita), depois as origens, as campanhas utm_campaign, as páginas de entrada com uma ligação para o seu mapa de calor e a repartição entre visitantes novos e recorrentes. Clique num canal para abrir o funil filtrado por esse canal.

Produtos

Para cada produto: visualizações (uma por sessão), primeiras adições ao carrinho, encomendas, quantidades vendidas, taxa de adição ao carrinho e taxa de visualização para encomenda. Há quatro ordenações: Mais vistos, Mais adicionados ao carrinho, Mais encomendados e Oportunidades.

A ordenação Oportunidades lista os produtos vistos pelo menos 20 vezes cuja taxa de adição ao carrinho é inferior a metade da média da loja. Atraem visitantes, mas algo os trava: preço, fotos, descrição, stock ou prazo de entrega.

O mapa de calor

Escolher uma página

As páginas estão agrupadas por tipo (página inicial, produtos, categorias, carrinho e checkout…) e ordenadas por número de visualizações. O campo de pesquisa filtra por título ou endereço. A página mais vista carrega automaticamente. O bloco Páginas a vigiar, no topo do separador, lista as páginas com mais cliques de raiva e cliques sem efeito.

A página é apresentada numa pré-visualização no tamanho de ecrã mais frequente dos seus visitantes, para o dispositivo escolhido (computador, tablet ou telemóvel). Percorra a pré-visualização: a camada de calor acompanha.

Cada clique é recolocado no elemento em que o visitante clicou, na mesma posição dentro dele, seja qual for a largura do ecrã, a altura da página no momento do clique ou um cabeçalho fixo. Os cliques num elemento fixo (barra de adicionar ao carrinho no fundo do ecrã) ficam sobre ele durante o scroll. Se o elemento não existir ou estiver oculto na pré-visualização (menu fechado, janela fechada), o clique volta às suas coordenadas originais. Na pré-visualização, os banners de consentimento ficam ocultos e só correm os scripts da loja: os scripts de terceiros (tags, chats) são bloqueados.

Os três modos

• Cliques: mapa de calor dos cliques, do amarelo (poucos cliques) ao vermelho escuro (muitos).
• Scroll: proporção de visitantes que chegam a cada altura da página, com a linha de dobra média.
• Frustração: marcadores dos cliques de raiva (vermelhos) e dos cliques sem efeito (cinzentos). Os cliques próximos são agrupados e o seu número é apresentado.

Um clique de raiva é uma série de 3 cliques em menos de um segundo no mesmo sítio. Um clique sem efeito é um clique numa imagem ou num elemento que parece clicável, sem nenhuma reação da página.

Segmentos e elementos clicados

O seletor de segmento mostra Todos os visitantes, apenas compradores (sessões com encomenda) ou apenas não compradores. O painel lateral ordena os elementos mais clicados com os seus cliques de raiva e sem efeito. Passe o rato por cima de um elemento para o localizar na pré-visualização.

Relatório semanal por e-mail

Todas as segundas-feiras, um e-mail resume a semana passada (de segunda a domingo) comparada com a anterior:

• sessões, encomendas efetuadas, taxa de conversão e receita registada, com a sua variação;
• até 4 pontos a ver primeiro, tirados das recomendações;
• o funil em 5 passos-chave (visita, página do produto, adição ao carrinho, checkout, encomenda efetuada);
• os 5 principais canais de aquisição com conversão e receita;
• um botão que abre o painel nessa semana.

Definições do relatório

Em Definições > Relatório semanal por e-mail:

• Enviar um relatório todas as segundas-feiras: ativado por predefinição.
• Destinatários: um endereço por linha. Se ficar vazio, o relatório vai para o e-mail da loja.
• Idioma do relatório: por predefinição o idioma da loja. O relatório existe em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português.
• Guardar e enviar um teste: envia de imediato aos destinatários o relatório da semana passada.
• Pré-visualizar a semana passada: abre o relatório num novo separador, tal como os destinatários o vão receber.

Quando é enviado o relatório?

Não é preciso nenhuma tarefa cron. A primeira visita registada na segunda-feira aciona o envio, depois da resposta ao visitante, que por isso não espera. Um bloqueio impede dois envios para a mesma semana. Nenhum e-mail é enviado após uma semana sem visitas. Depois da instalação ou da atualização, o primeiro relatório sai na segunda-feira seguinte.

Filtros

Os relatórios partilham uma barra de filtros: período (7, 30, 90 ou 365 dias, ou datas personalizadas), dispositivo, canal (painel e funil) e loja em multiloja. Os filtros mantêm-se ao passar de um separador para outro.

Definições

Rastreamento

• Ativar o rastreamento e depois ativar separadamente o funil de conversão e o mapa de calor.
• Amostragem do mapa de calor (1 a 100%): proporção de sessões registadas para o mapa de calor. O funil regista sempre todas as sessões.

Privacidade

• Respeitar Do Not Track e Global Privacy Control: ativado por predefinição.
• Modo sem cookies: a sessão vive no separador do navegador. Os visitantes únicos deixam de ser contados.
• Retenção de dados em dias (90 por predefinição). Os eventos mais antigos são eliminados automaticamente, no máximo uma vez por hora.

Exclusões

• Rastrear funcionários com sessão iniciada: desativado por predefinição, os navegadores com sessão iniciada no back-office não são contados.
• Endereços IP excluídos: um por linha, endereço exato, intervalo CIDR (192.168.1.0/24) ou prefixo (10.0.*). O seu endereço atual é apresentado.
• Excluir este navegador: define um cookie de exclusão, prático num telemóvel ou num computador sem sessão iniciada no back-office.

Manutenção

O bloco Manutenção dos dados mostra o volume guardado e propõe três ações: limpar além da retenção, gerar uma nova chave de rastreamento e eliminar todos os dados.

Privacidade e RGPD

• Nenhum endereço IP, nenhum e-mail e nenhum valor de campo de formulário é guardado.
• Só são conservados os textos dos elementos clicáveis (botões, links), e nenhum texto nas páginas de conta e encomenda. Os e-mails e as sequências longas de algarismos são mascarados no navegador e depois no servidor.
• Cookies técnicos first-party: dffh_sid (sessão, 30 minutos), dffh_vid (visitante anónimo, 13 meses) e dffh_optout (exclusão). O modo sem cookies elimina-os.
• Bots e ferramentas de auditoria (Lighthouse, PageSpeed…) são ignorados.
• O endereço de recolha só aceita pedidos POST assinados com uma chave de rastreamento, e só são registados endereços da sua loja.

Consoante a sua análise e a do seu encarregado de proteção de dados, pode mencionar este rastreamento na política de privacidade ou ativar o modo sem cookies.

Resolução de problemas

Desinstalação

A desinstalação remove o separador, os hooks e as definições. Os dados recolhidos são conservados por predefinição. Para os eliminar, ative Eliminar os dados ao desinstalar nas definições antes de desinstalar: as 6 tabelas do módulo são então eliminadas.