Introdução
A mudança de uma plataforma de afiliados SaaS para uma solução self-hosted como Affilentra (PRO/NETWORK) traz controlo e flexibilidade: comerciantes mantêm domínio sobre produtos e condições, parceiros recebem links de tracking transparentes e históricos de pagamento, e não há participação nas receitas. Este artigo oferece uma checklist de migração prática, baseada em funções, para comerciantes e operadores de rede que desejam transferir com segurança dados de produtos, links de tracking, configurações de cookies, webhooks, lotes de pagamento e contas de parceiros.
Visão geral: Fases da migração
- Fase 0 – Preparação & inventário: identificar fontes de dados, definir stakeholders e janelas de tempo de inatividade.
- Fase 1 – Exportação & mapeamento: exportar dados da plataforma SaaS e mapear para o esquema do Affilentra.
- Fase 2 – Staging & testes: importar para um sistema de staging, testes end-to-end (tracking, conversões, webhooks).
- Fase 3 – Produção & cutover: migrar dados de produção, alterar DNS/endpoints, tempo de inatividade mínimo.
- Fase 4 – Pós-migração & monitorização: reconciliações, monitorização em tempo real, suporte para parceiros e opções de rollback.
Fase 0 – Preparação & inventário
Crie uma lista completa de inventário de todos os objetos relevantes na sua plataforma SaaS:
- Produtos/SKUs incluindo preços, variantes e disponibilidades
- Contas de parceiros (IDs de afiliado, preferências de tracking, contas de pagamento)
- Links de tracking e formatos de link (parâmetros, URLs curtas)
- Configurações de cookies: duração, regras de domínio, atribuição First-/Last-Click
- Configurações de webhook e integrações externas (ERP, faturação, CRM)
- Lotes de pagamento em aberto e pagamentos históricos
Defina também responsabilidades: quem exporta, quem transforma, quem testa, quem decide sobre o Go-live.
Fase 1 – Exportação & mapeamento
Exporte dados estruturados (CSV/JSON/SQL). Crie um documento de mapeamento que associe campos de origem aos campos do Affilentra. Campos de mapeamento de exemplo:
- Produto: source_product_id → product_id
- SKU: sku → sku
- Título/Descrição: title, description → name, description
- Preço: price → price_net / price_gross (consoante necessidade)
- Modelo de comissão: commission_type (fixed/percent) → commission_model + rate
- Parceiro: source_aff_id → affiliate_id
- Link de tracking: deeplink_template → tracking_template
- Cookie: cookie_lifetime, cookie_domain → cookie_duration, cookie_scope
Verifique particularidades: múltiplas taxas de comissão por produto, preços específicos por país, tratamento de cupões ou SubID. Registe as validações de campo do Affilentra (por exemplo, campos obrigatórios, caracteres permitidos).
Fase 2 – Staging & testes
Configure um ambiente de staging na sua instalação Affilentra self-hosted. Objetivos: validar a estrutura de dados, testar todas as integrações, e executar cenários end-to-end sem impactar parceiros em produção.
Importação de dados e validação
- Importe inicialmente um subconjunto representativo (10–20 %), incluindo produtos, 50–100 contas de parceiros e alguns lotes de pagamento.
- Valide a integridade dos dados: procure por campos obrigatórios em falta, preços com formato incorreto ou IDs inválidas.
Testes de tracking e de conversão
- Gere links de tracking de teste no Affilentra, com Test-SubIDs.
- Execute pedidos de teste (loja de staging ou transações de teste) e verifique se as conversões são rastreadas e verificadas corretamente.
- Simule o comportamento de cookies: expiração, cenários cross-domain e atribuição First-/Last-Click.
Testes de Webhook e integrações
- Configure endpoints de webhook e utilize payloads assinados ou secrets para autenticação.
- Envie payloads de teste e verifique o recebimento, parsing e processos de processamento (por ex., ERP/Billing).
- Para dependências externas: faça o deploy de um proxy de logging temporário para inspecionar requests e respostas.
Fase 3 – Produção & Cutover
Planeie uma janela de cutover curta com carga de utilizador mínima. Ordem típica:
- Última sincronização de dados do SaaS (exportação delta desde o último snapshot).
- Importações de dados para a produção do Affilentra.
- Verificação final dos KPIs importantes: montante de payout em aberto, número de parceiros ativos, tracking em produção.
- Mudar DNS/endpoints para URLs de tracking e webhook. Alternativamente: reduzir TTLs antecipadamente.
Minimizar downtime: utilize processamento em paralelo (o SaaS continua a funcionar até à mudança), reduza previamente os TTLs dos domínios/VHosts relevantes e planeie o cutover para períodos com baixa taxa de conversão.
Lotes de Payout e contas de parceiros
Processo para payouts:
- Exporte lotes de payout em aberto com detalhes de pagamento e estado.
- Mapeie as contas de pagamento (por ex., IDs bancárias/PayPal) para os perfis de parceiros no Affilentra.
- Importe os lotes de payout como "lotes importados" e faça uma reconciliação entre o export do SaaS e o import para o Affilentra.
- Verifique o histórico de pagamentos: os parceiros devem poder consultar de forma contínua os pagamentos históricos após a migração.
Contas e acessos:
- Crie ou importe contas de parceiros incluindo hash de login/email de comunicação.
- Comunique atempadamente as informações de acesso e as alterações dos links de tracking aos parceiros, com um caminho de suporte claro.
Estratégia de rollback
Prepare um plano de rollback claro:
- Snapshot/Backup: Faça snapshots completos da base de dados e do sistema de ficheiros antes de iniciar importes em produção.
- Operação paralela SaaS: Mantenha a plataforma SaaS ativa como backup por pelo menos uma janela de tempo acordada (p.ex. 48–72 horas).
- Passos de rollback: (1) Restaurar DNS/Endpoints, (2) desativar alterações do Affilentra, (3) verificar sincronização de acompanhamento.
- Comunicação: Informe parceiros e stakeholders internos imediatamente sobre o rollback e espere uma downtime limitada.
Aprovação, Monitorização e Trabalhos Pós-Migração
Depois do cutover bem-sucedido:
- Realize uma aprovação oficial com checklist (tracking de conversão, webhooks, reconciliação de pagamentos, acessos de parceiros).
- Implemente monitorização: logs de erro, webhooks falhados, anomalias de tracking e latência no cálculo de comissões.
- Agende uma janela de suporte para questões dos parceiros e ajustes corretivos de dados.
Exemplos Práticos e Erros Típicos
Problemas frequentes e prevenção:
- Tabelas de mapeamento incompletas: imports de amostra em staging evitam surpresas.
- Parâmetros de tracking perdidos em redirects: verifique a lógica de redirects e preserve SubIDs.
- Conflitos de domínio de cookie em subdomínios: defina cookie_scope conscientemente e teste casos cross-domain.
- Erros de autenticação de webhook: assine payloads e teste com cenários de replay.
Conclusão e Recomendações
Uma migração estruturada para o Affilentra self-hosted reduz riscos operacionais e fortalece o controlo sobre produtos, comissões e pagamentos. Trabalhe em fases bem definidas, utilize ambientes de staging, execute testes end-to-end abrangentes e planeie um cutover reversível. A Affilentra oferece a possibilidade de reunir de forma transparente tracking, validação de conversões, cálculo de comissões e pagamento distribuído por papéis separados — ideal para comerciantes que querem permanecer independentes e escaláveis.
Próximo passo: Escolha o seu ponto de entrada e verifique as edições adequadas (PRO / NETWORK) para as suas necessidades: Einstieg wählen
Próximo passo
Experimentar o Affilentra
Plataforma unificada que reúne de forma transparente a disponibilização de produtos, tracking, validação de conversões, cálculo de comissões e pagamentos distribuídos por papéis claramente separados; opção de instalação self-hosted com licença perpétua sem partilha de receita; comerciantes mantêm o controlo sobre produtos, condições e materiais promocionais; parceiros recebem links de tracking pessoais e histórico de pagamentos auditável.