MDH GROUP · BLOG

Lista de Verificação de Migração: Melhores Práticas para a Mudança para Affilentra (Tracking, Mapeamento de Dados, Preservação de Links)

Uma migração técnica de plataformas externas envolve riscos para o tracking, pagamentos e links de parceiros. Affilentra, como software de afiliados self‑hosted, reúne papéis claros (operador, comerciante, parceiro), tracking, cálculo de comissões e pagamento numa

← Todos os artigos

Lista de Verificação de Migração: Melhores Práticas para a Mudança para Affilentra (Tracking, Mapeamento de Dados, Preservação de Links)

Por que planear a migração para Affilentra em vez de improvisar

Uma migração técnica de plataformas externas envolve riscos para o tracking, para os pagamentos e para os links de parceiros. A Affilentra oferece, como software de afiliados self-hosted, papéis bem definidos (operador do software, comerciante, parceiro), tracking, cálculo de comissões e pagamentos numa única plataforma. Para que a mudança decorra sem problemas, é necessário um procedimento baseado em dados: exportação de dados, mapeamento de campos, preservação de links, testes e um cutover seguro. Esta lista de verificação orienta comerciantes e operadores de rede de forma prática ao longo do processo.

1. Auditoria pré-migração: inventário

Antes da exportação, crie um inventário completo de todos os elementos relevantes. Documente:

  • Contas de comerciante, IDs de produto ou oferta e condições associadas
  • Parceiros (afiliados) com IDs, informações de contacto, comissões padrão
  • Formatos de links de tracking, parâmetros usados (por exemplo affiliate_id, partner_id, subid, click_id)
  • Eventos de conversão, URLs de postback, integrações S2S e pixels
  • Materiais criativos, landing pages, domínios vanity ou shortlink

Esta auditoria é a base para um mapeamento limpo na Affilentra e evita lacunas no tracking e nos relatórios.

2. Exportação de dados: estrutura e formatos

Exporte da base de dados do sistema legado ou do backend os seguintes dados em ficheiros CSV/JSON:

  • Merchants/Offers: Offer-ID, Nome, Comissão padrão, Lógica de pagamento
  • Partners: Partner-ID, Nome, E‑mail, Tracking-ID, Estado (ativo/pausado)
  • Campaigns/Creatives: Creative-ID, Template de link, URL de landing, ficheiros de mídia
  • Clicks & Conversions (histórico): Click-ID, Timestamp, Partner-ID, Offer-ID, Estado da conversão, Order-ID

Cuidado com uma codificação de caracteres limpa (UTF-8) e separadores de campo idênticos, para evitar erros de importação.

3. Mapeamento de dados: campos e regras

Defina as correspondências de campos entre o formato de origem e o esquema da Affilentra. Pontos importantes:

  • Partner-ID → Affilentra partner_id (evitar atribuições duplicadas)
  • Offer-ID → Affilentra merchant_offer_id
  • Parâmetros de tracking: anote os nomes de parâmetros antigos e associe-os ao novo template (por exemplo affiliate= → aff_id=)
  • Regras de comissão: garanta que regras por níveis, fixas ou CPA sejam reproduzidas exatamente
  • Conversões históricas: importe apenas conversões verificadas e concluídas; marque incertezas

Crie uma tabela de mapeamento (CSV) para reutilização e como documentação para auditorias posteriores.

4. Preservação de trackinglinks: como manter os links dos parceiros válidos

Objetivo central: os links de parceiros existentes devem continuar a converter após a mudança, sem que os parceiros tenham de alterar os seus links. Procedimento:

  • Análise da estrutura de links existente: nomes de host, padrões de caminho, parâmetros de query
  • Estratégia de redirecionamento: Implemente redirecionamentos 301 das antigas URLs de clique para as URLs de tracking do Affilentra. Em configurações self-hosted, pode mapear redirects ao nível do servidor web (Nginx/Apache) ou através de um serviço de shortlink.
  • Mapeamento de parâmetros: Assegure-se de que todos os parâmetros relevantes (Partner-ID, SubID, Campaign) sejam transferidos para o novo template.
  • Vanity domains: Se parceiros utilizam domínios próprios, deve redirecioná‑los ou registar CNAME/hosts de tracking no Affilentra, para que os vanity-links sejam preservados.

Importante: Utilize redirecionamentos permanentes (301), para que caches existentes e motores de busca não se confundam.

5. Validação de Conversões: Testar antes de ativar em produção

Realize testes extensivos para validar o tracking de click‑to‑conversion e o cálculo de comissões:

  • Cliques de teste: Gere cliques de teste com diferentes parâmetros (diversos parceiros, SubIDs, campanhas).
  • Pedidos end‑to‑end: Simule pedidos e verifique se os eventos de conversão chegam corretamente ao Affilentra.
  • S2S‑Postbacks: Valide server‑to‑server postbacks com dados assinados, caso a sua loja suporte S2S.
  • Reconciliação: Concilie conversões históricas importadas com os dados antigos; marque diferenças e esclareça suas causas.

6. Importação no Affilentra: Funções, Ferramentas e Passos

O Affilentra separa claramente entre operador de software, merchants e parceiros — aproveite essa separação durante a importação:

  • Operador de software: Instale/configure a instância self-hosted (PRO ou NETWORK Edition) e ajuste as configurações básicas.
  • Importação de merchants: Crie contas de Merchant, importe Offers e configurações de comissão.
  • Importação de parceiros: Importe perfis de parceiros com IDs de tracking; informe parceiros ativos paralelamente sobre os testes a realizar.
  • Importação de conversões: Carregue conjuntos de dados de conversões verificados apenas na área histórica, não no pipeline de pagamentos em produção.

Utilize as funções de importação CSV existentes ou as APIs da plataforma para passos de importação automatizados e repetíveis.

7. Plano de Cutover & Checklist

Planeie um período claro de cutover e siga esta checklist:

  • Definir janela de manutenção (tráfego mínimo)
  • Executar a última sincronização dos dados legados
  • Ativar redirects (301) e verificar por amostragem
  • Tracking em produção: verificar URLs, disparar conversões de teste
  • Informar parceiros: modelo de comunicação com status e contacto de suporte
  • Configurar monitorização para as primeiras 72 horas (logs, taxas de erro, taxas de conversão)
  • Definir gatilhos de rollback (p.ex. desvio significativo no volume de conversões durante uma janela temporal definida)

8. Pós-Cutover: Monitorização e Reconciliamento

Logo após o cutover, as atividades mais importantes são:

  • Verificação contínua dos logs de cliques e conversões
  • Reconciliar com dados do shop/CRM para identificar rapidamente receitas perdidas
  • Verificar cálculo de comissões: dados mestres e regras foram aplicados corretamente?
  • Priorizar e documentar a fila de suporte para pedidos dos parceiros

Realize ao fim de uma semana um relatório detalhado de reconciliação e resolva as diferenças remanescentes por processo.

9. Comunicação com Parceiros

Comunicação clara e concisa reduz o esforço de suporte e a incerteza:

  • Anúncio prévio com data e alterações previstas (caso os links dos parceiros precisem ser ajustados)
  • Guia técnico para parceiros, caso os seus vanity links precisem ser reconfigurados
  • Perguntas frequentes e um canal de suporte dedicado para os primeiros dias após o cutover

10. Proteção: Rollback e Lições Aprendidas

Um plano de rollback testado é obrigatório. Defina:

  • Quais critérios disparam um rollback (p.ex. >X% de queda em pedidos convertidos durante Y horas)
  • Como os redirects e o DNS são revertidos rapidamente
  • Quem toma a decisão e quem executa cada passo

Documente as lições aprendidas após a conclusão da migração e ajuste os processos operacionais para evitar repetições.

Conclusão

Uma migração bem-sucedida para Affilentra requer preparação estruturada: mapeamento de dados limpo, manutenção dos links de tracking via redirects, testes rigorosos e um cutover seguro com monitorização. A arquitetura self-hosted e a separação de funções da Affilentra dão-lhe controlo sobre produtos, condições e histórico de pagamentos — sem partilha de receita em modelos de licença.

Aja agora: Escolha a opção de início e planeie a sua migração com passos claros de exportação, mapeamento e testes. Escolha a opção de início: https://affilentra.de

Próximo passo

Experimentar o Affilentra

Plataforma unificada que integra de forma transparente a disponibilização de produtos, tracking, validação de conversões, cálculo de comissões e pagamentos ao longo de papéis claramente separados; opção de instalação self-hosted com licença perpétua sem participação nos rendimentos; os comerciantes mantêm controle sobre produtos, condições e materiais promocionais; os parceiros recebem links de tracking pessoais e um histórico de pagamentos auditável.

Começar