# Roda da sorte e pop-up de intenção de saída: guia completo > Apresentação A Roda da Sorte e Pop-up de Intenção de Saída interceta os visitantes no momento exato em que se preparam para sair da sua loja e propõe-lhes um jogo:… - Página: - Idioma: pt - Atualizado em: 2026-09-09 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfexitwheel/index.md), [en](https://www.datafirefly.com/en/documentation/dfexitwheel/index.md), [es](https://www.datafirefly.com/es/documentation/dfexitwheel/index.md), [de](https://www.datafirefly.com/de/documentation/dfexitwheel/index.md), [it](https://www.datafirefly.com/it/documentation/dfexitwheel/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfexitwheel/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfexitwheel/index.md) - Índice: ## Apresentação A **Roda da Sorte e Pop-up de Intenção de Saída** interceta os visitantes no momento exato em que se preparam para sair da sua loja e propõe-lhes um jogo: introduzem o e-mail, rodam a roda e saem com um cupão. Transforma assim um abandono silencioso num contacto qualificado e, muitas vezes, numa encomenda imediata. A particularidade do módulo é que **o prémio ganho é determinado do lado do servidor**, por um sorteio ponderado. As probabilidades nunca saem para o navegador: a roda limita-se a animar um resultado já decidido em PHP, o que torna impossível qualquer manipulação do lado do cliente. O módulo é compatível com PrestaShop 8.0 a 9.x, sem Composer nem dependências externas. Todos os textos são personalizáveis e multi-idioma. ## Instalação 1. No back-office, abra **Módulos > Gestor de módulos**. 2. Clique em **Carregar um módulo** e selecione o ficheiro `dfexitwheel.zip`. 3. A instalação cria automaticamente três tabelas (segmentos, contactos, configuração), seis segmentos predefinidos e dois separadores de administração. 4. O módulo fica ativo de imediato, com valores predefinidos funcionais. Não é obrigatório configurar nada para começar: a roda funciona logo após a instalação. Pode depois afinar os segmentos, os textos e os acionadores. Todos os textos da pop-up são campos multi-idioma que preenche você mesmo, mas comece por escrever a versão portuguesa: os valores instalados por predefinição não estão em português, e esta pop-up é vista por todos os visitantes. ## Configuração geral Na página de configuração do módulo (**Configurar**), define: - **Ativar o módulo**: interruptor geral. - **Título, subtítulo, texto do campo de e-mail e texto do botão**: todas as designações da pop-up, por idioma. - **Texto de consentimento (RGPD)**: a frase apresentada junto à caixa de consentimento obrigatória. - **Mensagem de prémio e de não-prémio**: o que aparece depois do sorteio. - **Cor principal**: a cor de destaque da pop-up e da roda. - **Tempo até à elegibilidade**: tempo mínimo passado no site antes de a pop-up poder aparecer. - **Frequência (dias)**: período durante o qual um visitante não voltará a ver a pop-up. - **Mostrar a clientes com sessão iniciada**, **Ativar em telemóvel**, **Temporizador em telemóvel**. - **Validade predefinida dos cupões**, **Um único jogo por e-mail**, **Subscrever a newsletter**. Os campos de texto são multi-idioma: use o seletor de idioma de cada campo para introduzir uma versão por idioma da loja. ## Gerir os segmentos da roda O ecrã **Segmentos da roda** lista as fatias apresentadas. Em cada uma, define: - **Designação**: o texto inscrito na fatia (por exemplo, «-10%», «Portes grátis», «Que pena!»). - **Cor**: a cor de fundo da fatia. - **Tipo de prémio**: desconto em percentagem, desconto de valor fixo, portes grátis, ou nenhum (fatia sem prémio). - **Valor**: a percentagem ou o montante, conforme o tipo. - **Peso**: a probabilidade relativa de calhar neste segmento. Um peso elevado significa um segmento frequente. - **Montante mínimo**: carrinho mínimo exigido para que o cupão se aplique. - **Prefixo de código** e **validade (dias)** próprios do segmento. - **Posição** e **ativo**. ### Como funciona a ponderação O sorteio soma os pesos de todos os segmentos ativos e seleciona depois um segmento proporcionalmente ao seu peso. Exemplo: com pesos de 25, 30, 20, 15, 8 e 2, o segmento de peso 2 (o grande prémio) sai cerca de 2 vezes em 100. Mantém assim um controlo total sobre a generosidade da roda. Para uma roda rentável, mantenha um ou dois segmentos «sem prémio» ou de desconto baixo com peso elevado, e reserve os descontos fortes para pesos baixos. ## Cupões e regras de carrinho A cada prémio, o módulo cria uma **regra de carrinho do PrestaShop (CartRule) verdadeiramente única**: - Uma única utilização no total e uma única por cliente. - Uma data de expiração calculada a partir da validade do segmento (ou da validade predefinida). - Um montante mínimo opcional. - Um código único gerado para cada vencedor. São possíveis três tipos de recompensa: **percentagem**, **valor fixo** e **portes grátis**. O código é apresentado ao vencedor com um botão de cópia e uma ligação previamente preenchida para a loja. Como cada código é nominativo e de utilização única, não pode ser partilhado nem revendido em sites de descontos, ao contrário de um código genérico. ## Contactos recolhidos e exportação CSV O ecrã **Contactos recolhidos** regista cada participação: e-mail, segmento obtido, código do cupão, consentimento, data, idioma e loja. A lista é só de leitura e disponibiliza uma **exportação CSV** para alimentar a sua ferramenta de e-mail marketing. Se a opção **Subscrever a newsletter** estiver ativa, o e-mail é também acrescentado aos subscritores nativos do PrestaShop (tabela de inscrição na newsletter), quando o consentimento é dado. ## Acionamento em computador e em telemóvel Em **computador**, a pop-up é acionada pela deteção da intenção de saída: quando o cursor sobe rapidamente na direção da barra de separadores do navegador. Em **telemóvel**, esse evento não existe. O módulo passa então automaticamente para um **temporizador configurável** e para a deteção de uma subida rápida da página (deslocamento para cima). Existem proteções que evitam qualquer insistência: um limite de frequência (a pop-up não reaparece antes de X dias), um tempo de elegibilidade antes do primeiro acionamento possível e a paragem definitiva depois de um prémio. ## Conformidade com o RGPD - A recolha de e-mail exige uma **caixa de consentimento explícito**, com um texto que personaliza. - A subscrição da newsletter é **opcional** e está ligada ao mesmo consentimento. - Os contactos podem ser consultados e exportados, o que facilita os pedidos de acesso e de eliminação. Em Portugal, a subscrição da newsletter recolhida por esta via tem de assentar num consentimento livre e específico (Lei n.º 41/2004, sob supervisão da CNPD). Na prática, isso significa não condicionar a participação na roda à subscrição: mantenha as duas caixas separadas e não faça da newsletter uma obrigação para jogar. Inscreva a recolha no seu registo de atividades de tratamento. Enquadramento a validar com o seu jurista: em Portugal, os concursos e sorteios publicitários cujo resultado depende da sorte podem ser qualificados como modalidades afins dos jogos de fortuna ou azar (Decreto-Lei n.º 422/89), sujeitas a autorização do Serviço de Regulação e Inspeção de Jogos do Turismo de Portugal. Uma roda em que praticamente todos os participantes recebem um cupão de desconto costuma ser tratada como promoção comercial e não como sorteio, mas essa qualificação depende da configuração que escolher. Uma roda com um prémio raro e de valor elevado aproxima-se muito mais do sorteio: nesse caso, confirme o enquadramento antes de a colocar em linha. Em qualquer dos casos, o Decreto-Lei n.º 57/2008 proíbe apresentar como certo um prémio que na verdade é improvável. ## Compatibilidade técnica - **PrestaShop**: 8.0 a 9.x. - **Hooks**: actionFrontControllerSetMedia (carregamento dos recursos e da configuração do front-office) e displayFooter (apresentação da pop-up). - **Multiloja** e **multi-idioma** suportados. - **Cupões**: regras de carrinho nativas, sem tabela paralela. - Sem dependências Composer. ## Perguntas frequentes ### O cliente pode manipular a roda? Não. O segmento vencedor é calculado do lado do servidor antes da animação. O navegador recebe apenas o índice do resultado e nunca conhece os pesos. ### Que tipos de prémios posso distribuir? Desconto em percentagem, desconto de valor fixo, portes grátis, ou segmento sem prémio. Cada prémio cria uma regra de carrinho única. ### É compatível com o PrestaShop 9? Sim, o módulo foi concebido para PrestaShop 8.0 até 9.x, sem necessidade de adaptação. ## Resolução de problemas - **A pop-up não aparece**: confirme que o módulo está ativo, que o tempo de elegibilidade já passou e que ainda não jogou (limpe o armazenamento local do navegador para voltar a testar). - **A pop-up não volta a aparecer**: é intencional depois de um prémio ou durante a janela de frequência. Reinicie o armazenamento local para forçar uma nova apresentação. - **O cupão não se aplica**: verifique o montante mínimo do segmento e a data de expiração. - **Os campos de texto parecem vazios na configuração**: certifique-se de que usa a última versão do módulo (a apresentação multi-idioma dos campos foi corrigida na 1.0.0).