PS PrestaShop Iniciante

DataFirefly Affiliate Program: programa de afiliados para PrestaShop

Instalar, configurar e gerir o programa de afiliação: painel, rastreamento de links, comissões com período de validação, regras e simulador, extratos SEPA ou PayPal, área de afiliado e material promocional.

Atualizado Versão do módulo 2.0.0

Instalação e atualização

Instale o módulo em Módulos > Gestor de módulos > Carregar um módulo, enviando o ficheiro ZIP. O mesmo ZIP funciona no PrestaShop 1.7.8, 8 e 9.

Na instalação, o módulo cria as suas tabelas e as definições predefinidas, e acrescenta o menu Vender > Afiliação com sete entradas: Painel, Afiliados, Comissões, Extratos e pagamentos, Regras de comissão, Material promocional e Definições. Um menu comum no topo de cada página permite passar de uma para outra.

Para passar da versão 1.0.0 ou 1.1.0 para a 2.0.0, basta enviar o novo ZIP. O script de atualização mantém os afiliados, links, cliques, comissões, extratos, regras e definições, e acrescenta as novidades:

  • os IBAN já registados são encriptados;
  • as comissões ainda dentro do prazo passam para a etapa «período de validação»;
  • as novas definições recebem o seu valor predefinido.

Antes de abrir o programa, verifique em Definições o estado ou os estados de encomenda que confirmam o pagamento, o período de validação e o pagamento mínimo. O Painel mostra depois uma verificação da configuração que assinala o que falta.

Painel

Painel do programa de afiliação: cliques, encomendas atribuídas, faturação gerada, comissões a pagar e tarefas
Painel do programa de afiliação: cliques, encomendas atribuídas, faturação gerada, comissões a pagar e tarefas

O painel resume a atividade em 7 dias, 30 dias, 90 dias ou 12 meses:

  • Indicadores: cliques e visitantes únicos, encomendas atribuídas e conversão dos cliques, receita gerada (base da comissão das encomendas, sem portes), comissões ganhas e o seu peso na receita, comissões a pagar, afiliados ativos, encomendas recusadas por autorreferência ou dupla recompensa.
  • Gráfico dos cliques e da receita por dia, ou por mês em 12 meses.
  • Onde estão as comissões: a aguardar o pagamento da encomenda, em período de validação, pagáveis, em extratos a pagar, pagas.
  • A fazer: candidaturas a analisar, comissões pendentes, extratos a criar ou a pagar, afiliados sem dados de pagamento, cada um com um botão que abre a lista certa.
  • Verificação da configuração, melhores afiliados, links mais clicados e últimas comissões.

Rastreamento e atribuição

Cada afiliado tem um código. Há dois tipos de links que o transportam:

  • o parâmetro de rastreamento, acrescentado a qualquer endereço da loja: ?aff=CODE. O nome do parâmetro pode ser alterado nas definições;
  • os links curtos /go/… que o afiliado cria na sua área. Redirecionam para a página escolhida e contam os cliques e as encomendas por link. Só são aceites endereços da loja: um link nunca pode levar para outro site.

No clique, o cookie dfaff_ref regista o afiliado. É assinado (um visitante não o pode alterar), HttpOnly e SameSite=Lax, e a sua duração define-se nas definições ou por afiliado. A atribuição é também copiada para o carrinho, o que cobre os pagamentos confirmados mais tarde pelo banco.

Nunca são contados:

  • os robôs e as pré-visualizações de links das redes sociais e aplicações de mensagens;
  • os pré-carregamentos do navegador e os pedidos HEAD;
  • os cliques do próprio afiliado;
  • os recarregamentos e cliques repetidos de um mesmo visitante no mesmo link durante a janela escolhida (30 minutos por predefinição).
Definições de rastreamento: parâmetro de URL, duração do cookie, último ou primeiro clique, cliques repetidos e espera pelo consentimento
Definições de rastreamento: parâmetro de URL, duração do cookie, último ou primeiro clique, cliques repetidos e espera pelo consentimento

A definição Cookie de atribuição e consentimento oferece dois comportamentos:

  • escrever o cookie em cada visita rastreada;
  • aguardar o consentimento: o cookie só é escrito se o cookie do seu banner de consentimento estiver presente e contiver o texto indicado, por exemplo tarteaucitron e dfaffiliate=true. Sem consentimento, o clique continua a ser contado nas estatísticas, mas só um código de desconto do afiliado pode atribuir a encomenda.

O estatuto deste cookie face à regulamentação depende do seu país e da sua utilização: peça a validação ao seu consultor. O módulo não garante qualquer conformidade.

Ordem de atribuição de uma encomenda

  1. O código de desconto pessoal de um afiliado usado na encomenda, mesmo sem clique.
  2. O link ou o cookie.
  3. Um cliente já trazido por esse afiliado, se as comissões de clientes recorrentes estiverem ativadas.

O modelo de atribuição decide o caso em que um visitante clica nos links de dois afiliados: último clique (predefinição), ganha o último afiliado visitado; primeiro clique, o primeiro mantém a venda até o cookie expirar.

Comissões

Ciclo de uma comissão

Comissões por etapa: a aguardar pagamento, período de validação até uma data, pagável, paga ou recusada
Comissões por etapa: a aguardar pagamento, período de validação até uma data, pagável, paga ou recusada
  1. A aguardar o pagamento da encomenda: a encomenda foi feita. Uma encomenda paga por transferência ou cheque fica nesta etapa até confirmar o pagamento.
  2. Período de validação: a encomenda atinge um estado que confirma o pagamento. A comissão aguarda o número de dias escolhido (30 por predefinição) para cobrir o prazo de livre resolução e as devoluções. A data de fim é apresentada.
  3. Pagável: o período terminou, a comissão entrará no próximo extrato.
  4. Num extrato e depois Pago quando marca o extrato como pago.

Os períodos de validação terminam sozinhos: pela tarefa cron, se a utilizar, ou caso contrário logo que se abre o back-office do módulo ou a área de afiliado.

Casos particulares:

  • Encomenda cancelada ou reembolsada: a comissão é rejeitada enquanto não estiver paga. Se a encomenda voltar a ser paga, a comissão regressa com um novo período de validação.
  • Reembolso parcial (nota de crédito): a comissão é reduzida proporcionalmente aos produtos reembolsados.
  • Após o pagamento: o módulo já não altera a comissão paga e cria um ajuste negativo, deduzido do extrato seguinte. Uma segunda mudança de estado não cria nova retenção.
  • Uma única comissão por encomenda: voltar a carregar a página de confirmação, receber duas notificações de pagamento ou passar várias vezes pelo mesmo estado nunca cria duplicados (bloqueio e chave única na base de dados).

Na lista de comissões, a ação em massa Aprovar agora termina o período de validação das comissões selecionadas. Recusa as encomendas que ainda não estão pagas e indica a sua referência.

Cálculo

  • Base: produtos sem IVA ou com IVA (à escolha), nunca os portes.
  • Vales: deduzidos proporcionalmente em cada linha se a opção estiver ativada. Um vale de portes grátis não é deduzido.
  • Moedas: as encomendas feitas noutra moeda são convertidas com a taxa de câmbio registada na encomenda.
  • Arredondamento: uma única vez por encomenda, ao cêntimo.
  • Montante fixo: uma comissão por encomenda, uma só mesmo quando o PrestaShop divide um carrinho em várias encomendas.
  • Clientes recorrentes: durante o número de dias escolhido, as encomendas seguintes de um cliente trazido geram uma comissão, à taxa do afiliado ou a uma taxa específica.

Nenhum montante vem do navegador: tudo é recalculado a partir da encomenda registada pelo PrestaShop.

Regras de comissão e simulador

Simulador de regras: uma encomenda reproduzida linha a linha, taxa aplicada e regra que prevalece
Simulador de regras: uma encomenda reproduzida linha a linha, taxa aplicada e regra que prevalece

Uma regra define uma taxa para uma categoria ou um produto, para todos os afiliados ou para um só. Para cada linha de encomenda, a prioridade é a seguinte:

  1. regra de produto;
  2. regra da categoria predefinida do produto;
  3. melhor regra das outras categorias;
  4. taxa do afiliado ou do programa.

Uma regra reservada a um afiliado prevalece sobre a mesma regra para todos. Uma regra pode substituir a taxa (uma regra a 0 % exclui os produtos) ou acrescentar-se a ela: um afiliado a 10 % com uma regra «+2» recebe 12 %, com um limite de 100 %. As regras não se aplicam aos montantes fixos.

O simulador, no topo da página das regras, responde à pergunta «que taxa se aplica, e porquê?» para um produto e um afiliado, ou repete uma encomenda existente linha a linha, sem criar nada.

Comissões manuais

Adicionar uma comissão manual credita ou debita um afiliado (montante negativo para uma dedução), com uma nota visível na sua área.

Antifraude e dupla recompensa

Fraude e pagamentos: comparação de moradas, coexistência com o programa de recomendação, pagamento mínimo e ficheiro SEPA
Fraude e pagamentos: comparação de moradas, coexistência com o programa de recomendação, pagamento mínimo e ficheiro SEPA
  • Uma encomenda feita com a mesma conta de cliente, o mesmo endereço de e-mail ou, se a opção estiver ativada, entregue ou faturada num endereço do afiliado é registada como recusada, com um motivo legível pelo comerciante e pelo afiliado.
  • Com o módulo DataFirefly Loyalty & Referral ativo, uma encomenda que já recompensa um padrinho não gera comissão de afiliação (definição alterável). Os dados do módulo de referências são apenas lidos, nunca alterados. Os dois módulos usam parâmetros de URL e cookies diferentes.
  • Apenas novos clientes e montante mínimo de encomenda completam estas proteções.

Afiliados

Candidaturas

Página pública do programa de afiliação: apresentação, condições, passos e respostas às perguntas
Página pública do programa de afiliação: apresentação, condições, passos e respostas às perguntas

A página pública do programa apresenta as suas condições (taxa, duração do cookie, período de validação, pagamento mínimo), as etapas e umas perguntas frequentes geradas a partir das suas definições. O texto de apresentação pode ser editado em cada idioma.

Formulário de candidatura: site ou canal, público e aceitação das condições, depois analisado pelo comerciante
Formulário de candidatura: site ou canal, público e aceitação das condições, depois analisado pelo comerciante

O candidato tem de ter sessão iniciada numa conta de cliente. Indica onde publica e descreve o seu público. Se for escolhida uma página CMS de condições, tem de a aceitar. Por predefinição, cada candidatura aguarda a sua aprovação e o endereço de notificação recebe um e-mail.

Lista e ficha do afiliado

Lista de afiliados: código, canal, estado, cliques, encomendas e saldos, aprovação em massa das candidaturas
Lista de afiliados: código, canal, estado, cliques, encomendas e saldos, aprovação em massa das candidaturas

A lista mostra o código, o canal, o estado, os cliques, as encomendas e os saldos. As ações em massa aprovam, rejeitam ou suspendem várias candidaturas de uma vez. A exportação CSV neutraliza as células que poderiam ser lidas como fórmulas por uma folha de cálculo.

Ficha completa do afiliado: indicadores, saldo por etapa, condições, IBAN mascarado, links, comissões, extratos e dados pessoais
Ficha completa do afiliado: indicadores, saldo por etapa, condições, IBAN mascarado, links, comissões, extratos e dados pessoais

A ficha do afiliado reúne numa página:

  • o perfil, com os botões Aprovar, Rejeitar, Suspender e Editar;
  • os indicadores e o saldo por etapa;
  • as condições (taxa, regras próprias, cookie, código de desconto) e o link de rastreamento;
  • os dados de pagamento, com o IBAN mascarado;
  • a candidatura;
  • os links dos últimos 30 dias, as últimas comissões e os extratos.

O bloco Dados pessoais exporta em JSON o que o módulo guarda sobre o afiliado. Permite também anonimizá-lo: nome, e-mail, site, dados de pagamento, links e cliques são apagados, e as comissões e extratos ficam para a sua contabilidade.

No formulário de edição, o IBAN nunca volta a ser mostrado por extenso: deixe o campo vazio para manter o que está registado, ou introduza um novo.

O que o afiliado vê

Área de afiliado: saldos em validação, pagável e pago, link rastreado, estatísticas dos últimos 30 dias e condições
Área de afiliado: saldos em validação, pagável e pago, link rastreado, estatísticas dos últimos 30 dias e condições

A área de afiliado abre com um cabeçalho que mostra o seu código, a sua taxa e os seus saldos (em validação, pagável, pago), seguido de seis separadores. Funciona com os temas Classic e Hummingbird.

  • Resumo: gerador de links, indicadores, gráfico dos últimos 30 dias, condições e links recentes.
  • Gerador de links: criação de um link curto para qualquer página da loja, lista dos links com cliques, encomendas, cópia e eliminação.
  • Estatísticas: cliques, encomendas, conversão, vendas e comissões de 7 dias a 12 meses, origem dos cliques e desempenho por link.
  • Comissões: etapa de cada comissão, data prevista de pagamento, referência de encomenda mascarada. Não é apresentado nenhum dado de cliente.
  • Pagamentos: extratos mensais que se podem consultar e imprimir, escolha entre transferência SEPA e PayPal, IBAN verificado pelos dígitos de controlo, encriptado e mostrado mascarado, e-mails de venda.
  • Material promocional: banners e textos prontos a usar, com o link de rastreamento do afiliado já incluído.
Gerador de links: link curto para qualquer página da loja, cliques e encomendas por link
Gerador de links: link curto para qualquer página da loja, cliques e encomendas por link
Estatísticas do afiliado: cliques, encomendas, conversão, vendas geradas por período, por origem e por link
Estatísticas do afiliado: cliques, encomendas, conversão, vendas geradas por período, por origem e por link
Histórico de comissões: etapas do pagamento ao pagamento final, número de encomenda mascarado, nenhum dado de cliente
Histórico de comissões: etapas do pagamento ao pagamento final, número de encomenda mascarado, nenhum dado de cliente
Pagamentos do afiliado: extratos mensais, transferência SEPA ou PayPal, IBAN cifrado e mostrado mascarado
Pagamentos do afiliado: extratos mensais, transferência SEPA ou PayPal, IBAN cifrado e mostrado mascarado

Um afiliado só vê os seus próprios dados: os seus links, comissões e extratos são verificados em cada apresentação, e os formulários estão protegidos por um token.

Material promocional

Material promocional: banners e textos para os afiliados, com pré-visualização, tamanho e página de destino
Material promocional: banners e textos para os afiliados, com pré-visualização, tamanho e página de destino

Em Material promocional, adicione banners (JPG, PNG, GIF ou WebP, 2 MB no máximo) e textos prontos a usar, com um nome e um texto alternativo em cada idioma, e a página da loja para onde levam. A ordem define-se arrastando e largando.

Material promocional para afiliados: banners e texto com o link de rastreamento já incluído, copiados num clique
Material promocional para afiliados: banners e texto com o link de rastreamento já incluído, copiados num clique

Cada afiliado copia o código HTML do banner, o texto e o link, com o seu link de rastreamento já incluído. O separador só aparece na área de afiliado se existir pelo menos um elemento ativo.

Extratos e pagamentos

Extratos e pagamentos: extratos mensais, exportação SEPA ou PayPal, pagamento marcado uma única vez
Extratos e pagamentos: extratos mensais, exportação SEPA ou PayPal, pagamento marcado uma única vez

O pagamento faz-se em quatro etapas, lembradas no topo da página:

  1. Criar os extratos: escolha o mês, pré-visualize os montantes por afiliado e depois crie os extratos. Um extrato agrupa as comissões pagáveis criadas antes do fim do mês e os ajustes negativos. Abaixo do pagamento mínimo, o saldo passa para o período seguinte.
  2. Exportar o ficheiro de pagamento: selecione os extratos e depois a ação em massa Ficheiro de transferência SEPA (XML, pain.001.001.03) ou Ficheiro PayPal Payouts (CSV). A exportação contabilística CSV dá o IBAN mascarado.
  3. Pagar no seu banco ou no PayPal: o módulo nunca envia dinheiro.
  4. Marcar como pago, com a referência e a data da transferência.
Extrato de um afiliado: linhas de comissão, montante devido, dados bancários mascarados e referência da transferência
Extrato de um afiliado: linhas de comissão, montante devido, dados bancários mascarados e referência da transferência

Um extrato pago já não pode ser exportado nem pago uma segunda vez. Uma exportação de pagamento é recusada por inteiro se um extrato selecionado já estiver pago ou se faltarem dados: a mensagem indica o afiliado em causa e onde completar os dados.

Tarefa cron (opcional)

O URL cron é indicado nas definições. Termina os períodos de validação e, se a opção estiver ativada, cria entre o dia 1 e o dia 5 do mês os extratos do mês anterior. Está protegido por um token, nunca é executado duas vezes em simultâneo e nunca paga nada.

E-mails

O módulo envia quatro e-mails, traduzidos em 8 idiomas e enviados no idioma do destinatário, incluindo assunto e montantes: nova candidatura (para o comerciante), conta de afiliado ativada, nova venda e extrato disponível.

E-mail «nova venda» enviado ao afiliado: comissão, montante da encomenda e taxa, sem nenhum dado de cliente
E-mail «nova venda» enviado ao afiliado: comissão, montante da encomenda e taxa, sem nenhum dado de cliente
E-mail do extrato mensal: período, montante, número de comissões e link para o extrato na área de afiliado
E-mail do extrato mensal: período, montante, número de comissões e link para o extrato na área de afiliado

O e-mail de nova venda indica a comissão, o montante da encomenda e a taxa, nunca os dados do cliente. Cada afiliado pode desativá-lo. Os modelos estão na pasta mails/ do módulo.

Definições

A página de definições está organizada em cinco blocos:

  • Rastreamento e atribuição: parâmetro de URL, duração do cookie, modelo de atribuição, janela contra duplicados, consentimento, clientes recorrentes.
  • Comissões: tipo e taxa predefinidos, base sem IVA ou com IVA, dedução dos vales, apenas novos clientes, mínimo de encomenda, estados que confirmam o pagamento ou que rejeitam a comissão, período de validação.
  • Fraude e dupla recompensa.
  • Extratos e pagamentos: pagamento mínimo, extratos por cron, dados SEPA da empresa.
  • Candidaturas e página do programa: aprovação automática, e-mails, texto de apresentação, página de condições, cor de destaque.

As mensagens de erro indicam o que corrigir, por exemplo «IBAN da empresa: os dígitos de controlo não correspondem».

RGPD

O módulo regista-se no módulo RGPD oficial do PrestaShop. A exportação dos dados de um cliente inclui o seu perfil de afiliado e as suas comissões, com o IBAN mascarado. O apagamento anonimiza o afiliado, mantendo as comissões e os extratos. As mesmas ações estão disponíveis na ficha do afiliado. Estas ferramentas ajudam-no a tratar os pedidos, sem constituírem uma garantia de conformidade.

Resolução de problemas

Nenhum clique é contado

Teste numa janela de navegação privada, sem sessão iniciada com a conta do afiliado. Os navegadores automatizados são filtrados como robôs. Com a opção «aguardar o consentimento», aceite primeiro o serviço no seu banner. Se a sua loja usar uma cache de páginas completas, use os links curtos /go/, que passam sempre pelo PrestaShop.

Uma comissão fica «a aguardar o pagamento»

Verifique se o estado atual da encomenda está marcado em Encomenda paga em. Uma encomenda por transferência ou cheque fica pendente enquanto não confirmar o pagamento.

A exportação SEPA é recusada

Leia a mensagem apresentada: indica o extrato já pago ou o afiliado cujo IBAN falta. Verifique também a denominação social e o IBAN da empresa, e se o euro é a moeda predefinida.

Compatibilidade

  • PrestaShop 1.7.8, 8 e 9: o mesmo ZIP cobre os três ramos, com os temas Classic e Hummingbird.
  • Multiloja: afiliados, comissões e estatísticas filtrados por loja. Multimoeda: conversão à taxa de câmbio da encomenda.
  • Módulo e e-mails em inglês, francês, espanhol, alemão, italiano, neerlandês, polaco e português.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte