# Funil de conversão e mapa de calor: documentação do módulo PrestaShop 8 e 9 > Instalação, painel, funil, aquisição, produtos, mapa de calor, relatório semanal e definições do módulo DataFirefly Funil de Conversão e Mapa de Calor para PrestaShop 8 e 9. - Página: - Idioma: pt - Atualizado em: 2026-10-16 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dffunnelheatmap/index.md), [en](https://www.datafirefly.com/en/documentation/dffunnelheatmap/index.md), [es](https://www.datafirefly.com/es/documentation/dffunnelheatmap/index.md), [de](https://www.datafirefly.com/de/documentation/dffunnelheatmap/index.md), [it](https://www.datafirefly.com/it/documentation/dffunnelheatmap/index.md), [pl](https://www.datafirefly.com/pl/documentation/dffunnelheatmap/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffunnelheatmap/index.md) - Índice: 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. Sem dependências externas: sem Composer, sem CDN. As definições predefinidas servem a maioria das lojas: mapa de calor em 100% das sessões, retenção de 90 dias, Do Not Track respeitado, funcionários excluídos. ## 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. A pré-visualização carrega a página da loja dentro do back-office. A loja e o back-office têm de estar no mesmo domínio, e o servidor não pode enviar `X-Frame-Options: DENY`: use `SAMEORIGIN`. ## 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. O relatório usa a configuração de e-mail do PrestaShop. Se os e-mails estiverem desativados em **Parâmetros avançados > E-mail**, aparece um aviso nas definições. As ligações do relatório abrem o back-office sem token de segurança: o PrestaShop pede uma confirmação antes de mostrar a página, é normal. ## 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 **Não aparece nenhum dado.** Verifique que não está a testar a partir de um navegador com sessão iniciada no back-office ou de um IP excluído, e que o Do Not Track não está ativo no seu navegador. Limpe a cache do PrestaShop após a instalação se usar uma cache de página completa. **Os passos morada, envio e pagamento ficam a zero.** Baseiam-se no checkout padrão do PrestaShop (temas Classic e Hummingbird). Um módulo de checkout de terceiros pode não os expor. Os outros passos, incluindo a encomenda efetuada, continuam a ser registados no servidor. **A pré-visualização do mapa de calor fica vazia.** A loja e o back-office têm de estar no mesmo domínio, sem o cabeçalho `X-Frame-Options: DENY`. **O relatório semanal não chega.** Use _Guardar e enviar um teste_: uma mensagem indica se o envio falhou, se os e-mails estão desativados ou se falta um destinatário. Verifique também a pasta de spam. ## 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.