Módulo Avançado de Afiliados (Affiliate) para Magento 2

Kowal_Affiliate é um módulo avançado de programa de afiliados para Magento 2 que permite lançar um sistema completo de parceria de vendas sem criar uma plataforma externa separada.
SKU
M2-AFFILIATE
92,25 €
Email to a Friend

Enquire about this product

Descrição / Módulo Avançado de Afiliados (Affiliate) para Magento 2

1. O que é este módulo

O módulo expande o Magento 2 com um sistema de afiliados completo que funciona diretamente dentro da loja. Isto significa que o proprietário da loja gere parceiros, comissões, liquidações e materiais promocionais a partir do seu próprio painel de administração, enquanto os parceiros utilizam o seu próprio dashboard na conta de cliente.

Na prática, o módulo permite implementar vários modelos de colaboração em simultâneo:

  • programa de afiliados clássico baseado em links de tracking,
  • programa de recomendações baseado em códigos individuais de parceiros,
  • modelo híbrido: link de afiliado mais código de desconto,
  • programa de parceiros para clientes da loja, agências, implementadores e criadores.

2. Principal valor de negócio

O maior valor do módulo é combinar vendas, atribuição, liquidações e gestão de parceiros num único lugar. A loja não precisa de manter um sistema de afiliados externo, exportar encomendas manualmente nem liquidar parceiros em folhas de cálculo.

O módulo oferece ao proprietário da loja:

  • um novo canal de vendas,
  • controlo sobre as regras de colaboração,
  • gestão transparente de comissões e pagamentos,
  • relatórios claros sobre a eficácia dos afiliados,
  • possibilidade de lançar o programa em segurança também numa loja de média e grande escala.

O parceiro recebe:

  • o seu próprio código de recomendação,
  • o seu próprio link de afiliado,
  • um painel pronto para monitorizar atividades,
  • visibilidade sobre comissões e payouts,
  • possibilidade de utilizar materiais promocionais e banners.

3. A quem se destina o módulo

O módulo é adequado para lojas que pretendem construir uma rede de parceiros de vendas sem recorrer a plataformas externas de afiliados ou que pretendem manter controlo total sobre os dados e o processo de liquidação.

Funciona especialmente bem em projetos em que o programa de afiliados deve ser gerido por:

  • clientes que recomendam a loja a conhecidos,
  • criadores digitais,
  • bloggers e publishers,
  • especialistas e consultores,
  • parceiros de implementação,
  • software houses e agências,
  • revendedores e comerciais B2B,
  • embaixadores da marca e comunidades.

4. Principais funcionalidades do módulo

4.1. Registo de afiliado

O módulo disponibiliza um formulário de candidatura ao programa de afiliados. O cliente pode candidatar-se autonomamente ao programa, fornecendo dados básicos de contacto, o endereço do website ou canal e uma breve informação sobre a promoção planeada.

Depois de enviar o formulário:

  • é criada uma conta de afiliado,
  • é gerado um referral_code único,
  • o estado da candidatura é definido como Pending,
  • o administrador pode receber uma notificação sobre a nova candidatura,
  • o cliente pode receber a confirmação de receção da candidatura.

4.2. Aprovação do parceiro

O administrador pode aprovar o afiliado a partir do painel Magento. Após a aprovação:

  • o estado do parceiro muda para Active,
  • o parceiro pode utilizar plenamente o programa,
  • é possível ativar o cupão de afiliado,
  • o cliente pode receber uma mensagem sobre a aprovação da participação.

Cada afiliado recebe o seu próprio link de afiliado baseado em referral_code. O link funciona através de um controlador de tracking e regista a atribuição da visita. Depois do clique, o sistema pode:

  • guardar a afiliação num cookie,
  • criar um registo de visita,
  • criar um registo de atribuição,
  • associar uma encomenda posterior a um afiliado específico.

4.4. Código de afiliado e cupão de desconto

O módulo também suporta o modelo em que referral_code pode funcionar como código de desconto no carrinho.

O administrador pode definir na conta do afiliado o campo:

  • Affiliate Coupon Discount (%)

Se o valor for superior a zero, o sistema:

  • sincroniza a regra nativa Cart Price Rule do Magento,
  • define o código do cupão igual a referral_code,
  • aplica um desconto percentual no carrinho,
  • trata a utilização deste código como a fonte de afiliação da encomenda.

Assim, o afiliado pode promover:

  • um link de afiliado normal,
  • apenas o código de desconto,
  • a combinação de ambos os mecanismos em simultâneo.

Esta é uma das funcionalidades de vendas mais práticas do módulo, porque muitos proprietários de lojas esperam que o parceiro não só encaminhe tráfego, mas também ofereça ao cliente um benefício de preço concreto.

4.5. Atribuição de encomendas

O módulo consegue atribuir uma encomenda a um afiliado com base em:

  • clique num link de afiliado,
  • atribuição ativa guardada na sessão ou cookie,
  • utilização de um código de afiliado no carrinho,
  • cliente autenticado associado a uma atribuição ativa.

Ao nível da encomenda são guardados os dados:

  • affiliate_id,
  • affiliate_attribution_id,
  • affiliate_referral_code,
  • is_affiliate_order,
  • affiliate_commission_amount,
  • affiliate_commission_status.

Isto permite reportar a origem da venda diretamente em quote e sales_order.

4.6. Cálculo de comissões

A comissão é criada automaticamente para a encomenda afiliada. No modelo atual:

  • a comissão é calculada percentualmente sobre o subtotal da encomenda,
  • a taxa predefinida provém da configuração do módulo,
  • o sistema evita a duplicação de comissões para a mesma encomenda e afiliado,
  • o resultado é guardado na tabela de comissões e na encomenda.

Os estados de comissão suportados incluem, entre outros:

  • pending,
  • approved,
  • ready_for_payout,
  • paid,
  • rejected,
  • cancelled,
  • charged_back.

4.7. Hold period e aprovação automática

O módulo suporta um período de retenção da comissão. Isto significa que a comissão não tem de ficar imediatamente pronta para pagamento. Pode permanecer em estado pendente durante um período definido e só depois do fim desse período ser aprovada automaticamente pelo cron.

Esta solução é especialmente importante em caso de:

  • risco de devoluções,
  • verificação manual de encomendas,
  • modelos de venda com finalização diferida,
  • necessidade de proteger o programa contra abusos.

4.8. Pagamentos para afiliados

O parceiro pode apresentar um pedido de pagamento se o limite mínimo tiver sido cumprido e tiver saldo aprovado suficiente.

O workflow de payouts inclui:

  • submissão de payout request,
  • atribuição de comissões ao payout,
  • alteração do estado da comissão para ready_for_payout,
  • marcação do pagamento como pago,
  • alteração dos estados das comissões para paid.

Assim, o proprietário da loja pode gerir pagamentos de forma organizada e auditável.

4.9. Fraud prevention

O módulo possui uma camada antifraude básica que ajuda a eliminar os abusos mais óbvios.

Isto inclui, entre outros:

  • bloqueio de self-referral,
  • marcação de comissões como rejeitadas quando é detetado abuso,
  • gestão de casos de fraude,
  • registo dos motivos de rejeição,
  • vista separada de fraud cases no lado do administrador.

Além disso, o módulo suporta:

  • cancelamentos de encomendas,
  • chargebacks,
  • reembolsos através de creditmemo,
  • alteração dos estados das comissões após devoluções.

4.10. Notificações

O módulo tem o seu próprio sistema de enfileiramento e processamento de notificações. Pode guardar eventos operacionais e enviar mensagens de e-mail.

Os casos suportados incluem, entre outros:

  • nova candidatura de afiliado,
  • confirmação de receção da candidatura,
  • aprovação de afiliado,
  • eventos de comissão,
  • payouts,
  • fraud alerts.

4.11. Painel do afiliado

O parceiro utiliza um dashboard avançado na conta de cliente Magento. O dashboard não é apenas uma lista de comissões, mas um painel operacional completo.

No painel do afiliado estão disponíveis:

  • estado de participação no programa,
  • código de recomendação,
  • link de afiliado completo,
  • caminho de destino predefinido,
  • resumo de comissões,
  • histórico de comissões,
  • acesso a payouts,
  • conteúdos das regras de colaboração,
  • snippets promocionais prontos,
  • pré-visualização de banner,
  • gerador de banner AI.

4.12. Gerador de banner AI

O módulo inclui uma funcionalidade assistida por AI que permite ao afiliado preparar um banner promocional pronto com base num briefing.

O utilizador pode fornecer:

  • briefing textual,
  • direção visual,
  • cores,
  • estilo,
  • URL opcional de imagem,
  • target link opcional.

O sistema envia para a camada AI:

  • briefing do utilizador,
  • referral link,
  • target path,
  • requisitos técnicos relativos ao formato da resposta.

O HTML do banner gerado pode ser guardado na conta do afiliado e utilizado pelo parceiro como material promocional pronto.

4.13. Relatórios

O módulo suporta relatórios e exportações CSV para áreas-chave do programa:

  • comissões,
  • payouts,
  • fraud cases,
  • insights AI.

Isto facilita tanto a gestão diária do programa como a análise da eficácia dos parceiros.

5. Painel de administração

O módulo expande o painel de administração Magento com a configuração e gestão do programa de afiliados.

O administrador tem acesso a:

  • definições globais do programa,
  • definições de comissão,
  • definições de payouts,
  • definições do portal do afiliado,
  • definições de notificações,
  • definições de fraude,
  • definições de AI,
  • definições de relatórios.

Além disso, no painel estão disponíveis secções operacionais:

  • Affiliate Commissions,
  • Affiliate Payouts,
  • Affiliate Fraud Cases,
  • Affiliate Reports.

Na lista de clientes e na edição do cliente são visíveis dados de afiliação, tais como:

  • participação no programa,
  • estado do afiliado,
  • saldo do afiliado,
  • código de recomendação,
  • percentagem de desconto do cupão de afiliado.

6. Como funciona a afiliação na prática

6.1. Cenário do link de afiliado

  1. O parceiro recebe o seu link.
  2. O cliente clica no link e chega à loja.
  3. O sistema guarda a visita e a atribuição.
  4. O cliente faz uma encomenda.
  5. A encomenda é atribuída ao afiliado.
  6. É criada uma comissão.
  7. Depois do hold period, a comissão pode ser aprovada.
  8. Após cumprir as condições, o parceiro pode apresentar um pedido de pagamento.

6.2. Cenário do código de afiliado no carrinho

  1. O parceiro publica o seu código de afiliado.
  2. O cliente introduz o código no carrinho.
  3. O Magento aplica o desconto da regra de carrinho.
  4. O módulo reconhece o código como código do afiliado.
  5. A encomenda é atribuída ao afiliado.
  6. É criada uma comissão de acordo com as regras do programa.

6.3. Cenário híbrido

O cliente pode primeiro entrar na loja através de um link de afiliado e depois utilizar o código de desconto do afiliado. Este modelo permite combinar tracking clássico com benefícios para o cliente final.

7. Áreas de segurança

O módulo foi preparado a pensar na implementação em produção, por isso inclui:

  • registos de auditoria,
  • gestão de devoluções e cancelamentos,
  • bloqueio de self-referral,
  • fila de notificações,
  • mecanismos que limitam a duplicação de comissões,
  • armazenamento seguro da configuração AI,
  • limitação dos dados enviados para a camada AI,
  • possibilidade de diagnóstico de erros de integração.

8. Integração com AI

A camada AI no módulo é opcional e não bloqueia o funcionamento do programa de afiliados básico. Pode ser utilizada para:

  • assistente do afiliado,
  • geração de insights,
  • geração de banners,
  • retrieval de conhecimento de produto através de vector_store_id.

O módulo não precisa de manter a sua própria base de produtos para AI se a loja já utilizar um módulo externo de gestão de conhecimento de produto e Vector Store.

9. Aplicações de vendas

O módulo pode ser vendido como solução para vários tipos de projetos:

  • lojas B2C com programa de recomendações,
  • lojas premium que pretendem construir uma rede de embaixadores da marca,
  • negócios B2B com programa para parceiros comerciais,
  • lojas digitais e de software,
  • implementações de agência em que o cliente precisa de um programa de parceiros completo sem SaaS externo.

Argumentos de venda especialmente fortes são:

  • controlo total sobre os dados,
  • ausência de subscrição de uma plataforma externa de afiliados,
  • integração com Magento 2 sem intermediários,
  • suporte para links e cupões de afiliado,
  • painel de parceiro pronto,
  • possibilidade de expansão futura com AI.

10. Principais vantagens do módulo

As principais vantagens desta solução são:

  • funciona diretamente no Magento 2,
  • suporta tanto links como códigos de afiliado,
  • gere cupões de desconto associados ao afiliado,
  • permite gerir parceiros a partir do cliente Magento,
  • tem um workflow real de comissões e payouts,
  • inclui segurança básica e auditoria,
  • possui um dashboard de afiliado moderno,
  • está pronto para evoluir com novas funcionalidades enterprise.

11. Requisitos de sistema

O módulo destina-se a:

  • Magento Open Source / Adobe Commerce 2.4.7+
  • PHP 8.2 / 8.3

Requer módulos Magento compatíveis relacionados com:

  • Customer,
  • Quote,
  • Sales,
  • SalesRule,
  • Cms,
  • Email,
  • Backend,
  • Store.

12. Âmbito de implementação

O módulo pode ser implementado por etapas:

  • início com links de afiliado e comissões,
  • expansão com payouts,
  • expansão com cupões de afiliado,
  • expansão com AI e content para afiliados,
  • desenvolvimento adicional com regras de comissão mais avançadas e fraud scoring.

Isto significa que é adequado tanto para implementações MVP como para o desenvolvimento a longo prazo de um programa de parceiros.

13. Resumo

Kowal_Affiliate é um módulo de afiliados maduro para Magento 2 que permite vender e lançar um programa de parceiros completo dentro da própria loja. Combina links de afiliado clássicos, códigos de recomendação, cupões de desconto, comissões, payouts, fraud prevention básico, relatórios e um painel de parceiro moderno.

Do ponto de vista comercial, não é apenas um complemento para links de recomendação, mas uma camada completa de parceiros para Magento 2, que pode ser oferecida como:

  • módulo standalone,
  • elemento de implementação da loja,
  • parte de um pacote growth / performance,
  • base para um programa mais avançado de parceiros e embaixadores da marca.

Na prática, é uma solução que responde às necessidades reais de lojas que procuram:

  • programa de afiliados em Magento 2,
  • códigos de desconto para parceiros,
  • liquidação de comissões,
  • painel de parceiro,
  • prontidão para venda e operação em produção.

More Information

Compatibilidade com o modelo Luma / Blank, KOWAL

Manual de instalação do módulo

Kowal_Affiliate - instruções de instalação e configuração

Este documento descreve o processo de instalação, ativação e primeira configuração do módulo Kowal_Affiliate para Magento 2. As instruções abrangem tanto os requisitos técnicos como os passos práticos necessários para lançar um programa de afiliados na loja.

1. Requisitos do sistema

O módulo destina-se a:

  • Magento Open Source / Adobe Commerce 2.4.7+
  • PHP 8.2 ou 8.3

No projeto Magento devem estar disponíveis, pelo menos, os seguintes módulos:

  • Magento_Store
  • Magento_Cms
  • Magento_Customer
  • Magento_Email
  • Magento_Quote
  • Magento_Sales
  • Magento_SalesRule
  • Magento_Backend

2. Métodos de instalação

O módulo pode ser implementado de forma padrão como um pacote Composer.

2.1. Instalação via Composer

O módulo é distribuído como um pacote Composer. Um processo de exemplo é o seguinte:

Receberá por e-mail, após a compra, os dados de acesso ao repositório Composer, incluindo o endereço de e-mail do cliente e o token de licença. Estes dados também estão disponíveis no painel do cliente após iniciar sessão em kowal.store. Substitua TWOJ_EMAIL_KLIENTA pelo endereço de e-mail da sua conta e TWOJ_TOKEN pelo token recebido. Execute os comandos no diretório raiz do Magento.

composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-affiliatebin/magento module:enable Kowal_Affiliatebin/magento setup:upgradebin/magento setup:di:compilebin/magento cache:flush

2.3. Modo de produção

Se a loja estiver a funcionar em production mode, após a instalação também é recomendável executar:

bin/magento setup:static-content:deploy

3. O que o módulo cria durante a instalação

Durante a instalação, o módulo:

  • cria as suas próprias tabelas de base de dados relacionadas com a afiliação,
  • expande quote e sales_order com campos de afiliação,
  • adiciona atributos de cliente utilizados para gerir o afiliado,
  • cria a página CMS predefinida do programa de parceiros,
  • prepara a configuração do sistema e os cron jobs,
  • regista templates de e-mail e recursos do painel de administração.

3.1. Página CMS predefinida

Após a instalação, é criada uma página de exemplo do programa de parceiros:

identifier: affiliate-programtitle: Affiliate Partnership Program

A página tem um caráter universal e pode ser utilizada em produção após uma ligeira personalização do conteúdo.

O patch é idempotente:

  • se já existir uma página com este identifier, o módulo não a substituirá.

4. Onde encontrar a configuração do módulo

O painel de configuração encontra-se em:

Stores -> Configuration -> Affiliate Program

As secções mais importantes:

  • General
  • Commission
  • Payouts
  • Affiliate Portal
  • Notifications
  • Fraud
  • AI
  • Reporting

5. Primeira configuração após a instalação

Após a ativação do módulo, recomenda-se a seguinte ordem de configuração:

  1. ativar o módulo globalmente,
  2. configurar o registo de afiliados,
  3. configurar a comissão e o hold period,
  4. definir o limite mínimo de pagamentos,
  5. preencher o conteúdo do portal do afiliado,
  6. configurar as notificações do administrador,
  7. opcionalmente, configurar a AI,
  8. realizar um teste de registo, clique de afiliação e encomenda.

6. Configuração detalhada

6.1. General

Enable Module

Interruptor global do módulo.

Se a definição estiver desativada:

  • o tracking de afiliação não deverá funcionar,
  • o formulário de registo não deverá funcionar,
  • as comissões e os pagamentos não serão processados.

Recomendação:

  • Yes no ambiente de produção após a conclusão dos testes,
  • No apenas durante o período de desativação do programa.

Enable Affiliate Registration

Ativa o formulário de candidatura ao programa de afiliados na frente da loja.

Se a opção estiver desativada:

  • novos parceiros não poderão registar-se autonomamente,
  • o administrador continuará a poder marcar manualmente um cliente como afiliado.

Define o tempo de vida da atribuição baseada em cookie após o clique num link de afiliado.

Exemplos:

  • 30 para um programa de afiliados padrão,
  • 7 para campanhas curtas,
  • 60 ou 90 apenas quando os regulamentos do programa o preveem.

Default Redirect Path

Caminho de reserva utilizado quando o tracking link não contém um target válido.

Exemplos:

  • /
  • promotions
  • catalog/category/view/id/12

6.2. Commission

Enable Commissions

Ativa o cálculo de comissões para encomendas de afiliação.

Se o campo estiver desativado:

  • a afiliação pode ser registada,
  • mas a entrada na tabela de comissões não será criada.

Default Commission Rate (%)

Taxa de comissão percentual predefinida.

Exemplo:

  • 10 significa uma comissão de 10% sobre a base de cálculo atual.

Commission Hold Period (days)

Número de dias durante os quais a comissão permanece no estado pendente.

Após este período, o cron pode aprovar automaticamente a comissão.

Recomendação:

  • 14 como valor predefinido seguro,
  • 0 apenas para um programa muito simples sem risco de devoluções.

6.3. Payouts

Enable Payouts

Ativa o workflow de pagamentos para afiliados.

Se a opção estiver desativada:

  • o parceiro não poderá submeter um pedido de pagamento,
  • o administrador poderá continuar a analisar as comissões, mas não processará o pagamento no módulo.

Minimum Payout Amount

Saldo mínimo necessário para solicitar um pagamento.

Exemplos:

  • 100
  • 250
  • 500

6.4. Affiliate Portal

Esta secção controla o conteúdo apresentado no dashboard do afiliado.

Dashboard Intro

Breve descrição no topo do dashboard do afiliado.

Deve explicar ao parceiro:

  • onde encontrará o link de afiliado,
  • onde verá as comissões,
  • como funciona o painel.

Program Rules

Regras de colaboração visíveis para o afiliado.

É preferível inserir:

  • uma regra por linha,
  • mensagens concisas e inequívocas.

Título predefinido do material promocional de exemplo.

Breve descrição sob o título do banner.

Caminho de target predefinido para links de afiliado e banners.

Exemplos:

  • /
  • promotions/spring
  • catalog/category/view/id/24

6.5. Notifications

Enable Notifications

Ativa o sistema interno de notificações e a fila de notificações.

Admin Notification Email

Endereço de e-mail do administrador que deverá receber as comunicações operacionais mais importantes.

Se o campo ficar vazio:

  • o módulo pode utilizar o endereço predefinido general do Magento como fallback em determinados flows.

Notification Log Retention (days)

Define durante quanto tempo as entradas no log de notificações devem ser armazenadas antes da limpeza.

6.6. Fraud

Enable Fraud Checks

Ativa verificações antifraude básicas.

Block Self Referral

Bloqueia a comissão quando o cliente que faz a encomenda é simultaneamente o afiliado associado a essa encomenda.

6.7. AI

A secção AI é opcional e não é necessária para o funcionamento básico do programa de afiliados.

Enable AI

Interruptor principal das funcionalidades de AI.

OpenAI API Key

Chave API para comunicação com a OpenAI.

O campo é armazenado na configuração encriptada.

AI Model Name

Modelo utilizado para as funcionalidades de AI.

A lista de modelos pode ser obtida da OpenAI após guardar corretamente a chave API.

OpenAI Request Timeout (seconds)

Tempo máximo de espera por uma resposta da OpenAI.

Recomendação prática:

  • 60 segundos para uma operação mais estável em produção.

Enable AI Diagnostic Logging

Ativa o registo de diagnóstico de requests e respostas AI.

Útil em:

  • integração,
  • testes,
  • análise de timeouts e erros de resposta.

AI Diagnostic Max Chars

Comprimento máximo da preview do payload registada.

Enable Affiliate Assistant

Ativa o assistente de afiliado, se a loja quiser utilizar esta funcionalidade.

Enable Weekly AI Reports

Permite gerar resumos AI cíclicos.

Enable Product Knowledge Retrieval

Permite utilizar conhecimento de produto a partir do Vector Store.

Enable Program Knowledge Retrieval

Permite utilizar conhecimento sobre o programa de afiliados, FAQ e documentação.

Product Vector Store Scope

Define como é resolvido o product_vector_store_id.

Product Vector Store ID

Identificador do Vector Store, se a loja utilizar retrieval.

Redact Personal Data

Remove ou mascara dados pessoais antes de enviar o prompt para a camada AI.

6.8. Reporting

Enable Reporting

Ativa a geração de relatórios e exportações CSV.

Export Directory

Caminho do diretório onde as exportações geradas devem ser guardadas.

Exemplo:

var/export/affiliate

7. Configuração de um cliente como afiliado

Após a instalação, o módulo expande a edição de clientes Magento com campos de afiliação.

Na edição do cliente, é possível gerir, entre outros:

  • Affiliate Participant
  • Affiliate Status
  • Affiliate Referral Code
  • Affiliate Website URL
  • Affiliate Notes
  • Affiliate Balance
  • Affiliate Coupon Discount (%)

7.1. Affiliate Participant

Indica se o cliente pertence ao programa de afiliados.

7.2. Affiliate Status

Estados mais importantes:

  • Pending
  • Active
  • Suspended
  • Rejected
  • Blocked

7.3. Affiliate Balance

O saldo é calculado automaticamente a partir das comissões aprovadas e prontas para pagamento.

O campo:

  • está visível na edição do cliente,
  • não deve ser editado manualmente,
  • é atualizado automaticamente após alterações nas comissões.

7.4. Affiliate Coupon Discount (%)

Este campo permite atribuir ao afiliado uma percentagem de desconto que será aplicada ao seu referral_code.

Se introduzir um valor superior a 0, o módulo:

  • criará ou atualizará uma regra de carrinho Magento,
  • definirá o cupão igual ao código do afiliado,
  • permitirá que os clientes utilizem esse código como cupão no carrinho,
  • associará a encomenda ao afiliado com base no coupon_code.

Exemplo:

  • o afiliado tem o código FMX1FBXXY3
  • o administrador introduz 5
  • o cliente introduz FMX1FBXXY3 como cupão de desconto
  • o Magento aplica 5% de desconto
  • o módulo associa a encomenda ao afiliado.

8. Cron jobs do módulo

O módulo utiliza crons no grupo default.

8.1. Auto approve commissions

job: kowal_affiliate_auto_approve_commissionsschedule: */15 * * * *

A tarefa:

  • verifica as comissões pending,
  • após o hold period, altera-as para approved.

8.2. Process notifications

job: kowal_affiliate_process_notificationsschedule: */10 * * * *

A tarefa:

  • processa a fila de notificações,
  • marca as entradas como enviadas,
  • no caso do canal de e-mail, envia mensagens transacionais.

8.3. Cleanup notification log

job: kowal_affiliate_cleanup_notification_logschedule: 30 2 * * *

A tarefa:

  • remove entradas antigas do log de notificações de acordo com a retenção.

8.4. Weekly AI insights

job: kowal_affiliate_generate_weekly_ai_insightsschedule: 0 6 * * 1

A tarefa:

  • gera insights AI semanais, se a funcionalidade estiver ativa.

9. Comandos CLI

O módulo disponibiliza comandos de serviço:

bin/magento kowal:affiliate:auto-approvebin/magento kowal:affiliate:process-notificationsbin/magento kowal:affiliate:cleanup-notificationsbin/magento kowal:affiliate:generate-ai-insightsbin/magento kowal:affiliate:export-report

Os mais úteis no primeiro arranque são:

bin/magento kowal:affiliate:process-notificationsbin/magento kowal:affiliate:auto-approve

10. Primeiro teste após a instalação

Depois de configurar o módulo, recomenda-se um teste end-to-end simples.

10.1. Teste de registo de afiliado

  1. Aceda ao formulário de registo de afiliado.
  2. Envie a candidatura.
  3. Verifique se a conta de afiliado foi criada.
  4. Verifique se o cliente tem o estado Pending.
  5. Verifique se foram criadas entradas de notificação.

10.2. Teste de ativação

  1. Abra a edição do cliente no painel de administração.
  2. Defina o estado do afiliado como Active ou utilize a ação de aprovação.
  3. Verifique se o cliente vê o dashboard do afiliado.

10.3. Teste do link de afiliado

  1. Copie o link de afiliado a partir do dashboard.
  2. Aceda à loja através desse link.
  3. Adicione um produto ao carrinho.
  4. Faça a encomenda.
  5. Verifique se a encomenda tem:
    • affiliate_id
    • affiliate_referral_code
    • is_affiliate_order = 1

10.4. Teste do cupão de afiliado

  1. Defina Affiliate Coupon Discount (%) para o afiliado, por exemplo 5.
  2. Guarde o cliente.
  3. Certifique-se de que o afiliado tem o estado Active.
  4. No carrinho, introduza o seu Referral Code como cupão.
  5. Faça a encomenda.
  6. Verifique:
    • se o desconto foi aplicado,
    • se a encomenda foi associada ao afiliado,
    • se a comissão foi criada.

10.5. Teste de pagamentos

  1. Aprove a comissão ou aguarde pelo auto-approve.
  2. Verifique o saldo do afiliado.
  3. Submeta um pedido de pagamento.
  4. Marque o payout como pago no painel de administração.

11. Problemas mais comuns após a instalação

11.1. Falta de comissão após a encomenda

Verifique:

  • se a encomenda tem affiliate_id,
  • se as comissões estão ativadas,
  • se o módulo funciona após a correção da criação de comissões depois de guardar os dados de afiliação na encomenda,
  • se aparece um registo na tabela kowal_affiliate_commission.

11.2. A grelha de clientes não mostra o saldo atual do afiliado

Verifique:

  • se o índice customer_grid foi atualizado,
  • se reindexRow funciona após guardar,
  • se o valor na edição do cliente corresponde ao valor na grelha.

Se necessário, execute:

bin/magento indexer:reindex customer_grid

11.3. A AI não responde

Verifique:

  • se Enable AI está ativado,
  • se foi guardada uma OpenAI API Key correta,
  • se foi selecionado um modelo,
  • se o timeout não é demasiado baixo,
  • se var/log não mostra erros de request para a OpenAI.

11.4. As notificações não são enviadas

Verifique:

  • se os crons Magento estão a funcionar,
  • se Enable Notifications está ativo,
  • se as entradas estão a ser guardadas em kowal_affiliate_notification_log,
  • se é possível executar manualmente:
bin/magento kowal:affiliate:process-notifications

12. Configuração inicial recomendada

Para a primeira implementação em produção, recomenda-se o seguinte conjunto:

  • Enable Module = Yes
  • Enable Affiliate Registration = Yes
  • Tracking Cookie Lifetime = 30
  • Enable Commissions = Yes
  • Default Commission Rate = 10
  • Commission Hold Period = 14
  • Enable Payouts = Yes
  • Minimum Payout Amount = 100
  • Enable Notifications = Yes
  • Block Self Referral = Yes
  • Enable AI = No no início, se a loja não precisar de AI desde o primeiro dia

13. Resumo

Após a instalação e configuração corretas, Kowal_Affiliate permite lançar no Magento 2 um programa de parceiros completo que inclui:

  • afiliados,
  • links de referência,
  • códigos de afiliado,
  • cupões de desconto dos afiliados,
  • comissões,
  • pagamentos,
  • notificações,
  • dashboard do parceiro,
  • segurança básica e automatização.
Write Your Own Review
You're reviewing: Módulo Avançado de Afiliados (Affiliate) para Magento 2
Your Rating:
Preço
Qualidade
Suporte
loader
Loading...

You submitted your review for moderation.

This form is protected by reCAPTCHA - the Google Privacy Policy and Terms of Service apply.

Update cookie preferences