# Inquérito pós-compra: como nos conheceu? > O módulo DataFirefly Post-Purchase Survey coloca a pergunta «Como nos conheceu?» na página de confirmação da encomenda e compara cada canal declarado com a faturação que gera. Esta documentação cobre… - Página: - Idioma: pt - Atualizado em: 2026-09-24 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfpostpurchasesurvey/index.md), [en](https://www.datafirefly.com/en/documentation/dfpostpurchasesurvey/index.md), [es](https://www.datafirefly.com/es/documentation/dfpostpurchasesurvey/index.md), [de](https://www.datafirefly.com/de/documentation/dfpostpurchasesurvey/index.md), [it](https://www.datafirefly.com/it/documentation/dfpostpurchasesurvey/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfpostpurchasesurvey/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfpostpurchasesurvey/index.md) - Índice: O módulo **DataFirefly Post-Purchase Survey** coloca a pergunta «Como nos conheceu?» na página de confirmação da encomenda e compara cada canal declarado com a faturação que gera. Esta documentação cobre a instalação, as definições, o lembrete por email e a leitura do relatório. ## Instalação No back office, vá a **Módulos > Gestor de módulos**, clique em _Carregar um módulo_ e envie o ficheiro ZIP. Na instalação o módulo cria as suas tabelas, acrescenta onze respostas prontas nos idiomas da loja e regista o separador **Encomendas > Inquérito de atribuição**. Só as encomendas feitas depois da instalação aparecem no relatório: a linha de registo é criada ao validar a encomenda. ## Definições do inquérito Abra a configuração do módulo (botão _Configurar_ no gestor de módulos). - **Pergunta**: o texto apresentado acima das respostas, por idioma. - **Mensagem de agradecimento**: substitui o bloco depois de enviada a resposta. - **Perguntar a**: todos os clientes ou apenas novos clientes (primeira encomenda). - **Baralhar as respostas**: muda a ordem em cada apresentação para limitar a preferência pelas primeiras opções. As respostas marcadas «Sempre em último» ficam no fim. - **Não perguntar novamente durante**: dias durante os quais um cliente que já respondeu não volta a ser questionado. Coloque 0 para perguntar em cada encomenda. - **Mostrar também no histórico de encomendas**: quem não respondeu reencontra a pergunta no detalhe da encomenda da sua conta. - **Detetar a fonte de tráfego**: veja a secção dedicada mais abaixo. Por baixo do formulário é apresentada uma pré-visualização do bloco tal como aparece na loja. ## Gerir as respostas O botão **Gerir as respostas**, presente na configuração e na barra do relatório, abre a lista de respostas propostas ao cliente. Para cada resposta: - **Texto** por idioma, até 128 caracteres; - **Pedir detalhes**: abre um campo de texto livre quando o cliente escolhe essa resposta (útil para «Outro»); - **Sempre em último**: a resposta fica no fim da lista mesmo quando a ordem é baralhada; - **Cor**: usada nos gráficos do relatório; - **Ativo** e **posição** por arrastar e largar; - **Lojas**: em multiloja, assinale as lojas onde a resposta é apresentada. Eliminar uma resposta não apaga as respostas já recebidas: continuam no relatório com a menção «Resposta eliminada». ## Lembrete por email O lembrete envia um único email aos clientes que não responderam. Cada resposta é um link: o clique regista a resposta e abre uma página de agradecimento, sem formulário e sem iniciar sessão. ### Definições - **Enviar um lembrete**: ativa a funcionalidade. - **Assunto do email**: por idioma. - **Enviar após**: atraso em horas depois da encomenda (72 por omissão). - **Ignorar encomendas com mais de**: evita um envio em massa sobre o histórico na primeira ativação (30 dias por omissão). - **Emails por execução**: limite em cada passagem do cron. - **Apenas encomendas pagas**: ignora as encomendas não validadas. ### Tarefa cron A página de configuração mostra um URL protegido por token. Chame-o uma vez por dia, por exemplo: ``` 0 9 * * * curl -s "https://a-sua-loja.pt/module/dfpostpurchasesurvey/cron?token=O_SEU_TOKEN" >/dev/null ``` A resposta indica quantos emails foram enviados, ignorados e falhados. Dois botões permitem ainda enviar um email de teste para o seu endereço de funcionário e executar a fila manualmente. Um carrinho dividido em várias encomendas gera um único email, e a resposta fica registada para todas as encomendas desse carrinho. ## Relatório de atribuição Separador **Encomendas > Inquérito de atribuição**. Escolha um período, o tipo de clientes (todos, novos, recorrentes) e a opção «Apenas encomendas pagas». ### Indicadores Encomendas registadas, respostas, taxa de resposta, faturação sem IVA e faturação com resposta, cada um comparado com o período anterior de igual duração. ### Tabela por canal - **% das respostas** e **% da faturação**: a distribuição declarada e a distribuição da faturação. - **Índice**: a relação entre as duas, com base 100. Acima de 100, o canal traz cestos maiores do que a média. - **Faturação estimada**: aplica a distribuição observada a todas as encomendas registadas, incluindo as de quem não respondeu. Os valores são sem IVA, convertidos para a moeda predefinida da loja. O botão **Exportar CSV** produz uma linha por encomenda com o canal declarado, os detalhes, a faturação, a fonte detetada e o canal de recolha (página de confirmação ou email). ## Deteção da fonte de tráfego Opção desativada por omissão. Uma vez ativada, o módulo guarda a primeira fonte UTM (`utm_source`, `utm_medium`, `utm_campaign`), os identificadores de clique publicitários habituais ou o site de referência da visita, e regista-os no cookie de sessão que a loja já utiliza. Não é carregado nenhum script de terceiros e nenhum dado sai da loja. O relatório mostra então uma tabela cruzada de canal declarado face a fonte detetada e a percentagem de respostas sem fonte detetável, ou seja as vendas invisíveis para o rastreio por cookies. Esta opção escreve informação de proveniência num cookie de sessão. Mencione-a na sua política de cookies antes de a ativar. ## Ficha da encomenda e painel A ficha da encomenda no back office mostra um painel com a resposta do cliente, os detalhes, a menção «Primeira encomenda» quando aplicável e a fonte detetada. O painel do PrestaShop mostra o top 5 de canais do período selecionado. ## RGPD O módulo implementa os hooks oficiais do módulo psgdpr: a exportação de dados de um cliente inclui as suas respostas, e um pedido de eliminação anonimiza as linhas envolvidas (cliente desassociado, texto livre e campanha apagados) mantendo a resposta nas estatísticas. ## Atualização Carregue o novo ZIP pelo gestor de módulos. Os scripts de atualização acrescentam as colunas e tabelas necessárias, registam os novos hooks e associam as respostas existentes a todas as lojas. Não se perde qualquer dado. ## Resolução de problemas ### O bloco não aparece na página de confirmação Verifique se o módulo está ligado a `displayOrderConfirmation`, se existe pelo menos uma resposta ativa para essa loja e se o cliente não respondeu nem ignorou já o inquérito. Se a segmentação estiver em «Apenas novos clientes», um cliente recorrente não vê nada. ### Os emails de lembrete não saem Teste primeiro o envio com o botão de email de teste: usa as definições de email da loja. Verifique depois se o lembrete está ativo, se o cron chama o URL com o token correto e se há encomendas que cumprem as condições de atraso e idade máxima. ### O relatório está vazio Só são contabilizadas as encomendas posteriores à instalação. Alargue o período e desmarque «Apenas encomendas pagas» se as suas encomendas estiverem a aguardar pagamento.