As visitas ou indicações não estão sendo geradas como esperado em seu programa de afiliados? Se sim, este guia o ajudará a identificar e resolver as causas mais comuns de problemas de rastreamento no AffiliateWP.
Seja o problema relacionado a cookies, configurações, integrações ou conflitos externos, nós o guiararemos por etapas de solução de problemas para garantir que seu programa de afiliados esteja funcionando corretamente.
Solução de Problemas de Visitas
Visitas são essenciais para rastrear afiliados e gerar indicações. A razão mais comum para indicações não serem criadas é porque uma visita não foi armazenada com sucesso. Você pode confirmar isso visitando AffiliateWP » Visitas em seu painel do WordPress. Para que as visitas sejam registradas, os cookies de rastreamento do AffiliateWP devem ser adicionados ao navegador do visitante. Siga estas etapas para solucionar problemas relacionados a visitas:
Primeiro, certifique-se de que você está executando a versão mais recente do plugin AffiliateWP. Verifique se o status da conta do afiliado está definido como Ativo em AffiliateWP » Afiliados. Afiliados devem usar URLs de indicação válidas com a variável de indicação correta e um ID de afiliado ou nome de usuário ativo. Revise este guia para formatos aceitáveis: URLs de Afiliados.
Em seguida, inspecione os cookies do seu navegador para verificar a presença de cookies do AffiliateWP (affwp_ref, affwp_ref_visit_id). Se os cookies não estiverem visíveis, as visitas não serão registradas. Este guia explica como visualizar e excluir cookies: Como Gerenciar Cookies do AffiliateWP.
O cache ou a otimização de scripts podem impedir a configuração de cookies. Verifique seus plugins de cache, serviços de CDN (por exemplo, Cloudflare) ou configurações de cache do lado do servidor. Consulte este guia para soluções de cache específicas: Como o AffiliateWP Funciona com Cache.
Erros de JavaScript também podem impedir que os scripts de rastreamento funcionem. Abra o console do seu navegador para identificar erros, especialmente aqueles vinculados a arquivos .js. Erros de JavaScript são frequentemente causados por conflitos com plugins ou temas. Desative temporariamente todos os plugins, exceto o AffiliateWP, e teste as visitas novamente. Reative gradualmente os plugins em pequenos grupos para identificar a origem do conflito.
Se os erros de JavaScript persistirem, ative o Método de Rastreamento de Indicação de Fallback em AffiliateWP » Configurações » Avançado. Embora o rastreamento de fallback ignore o JavaScript, é altamente recomendável corrigir o erro subjacente, pois ele pode afetar outros plugins.
Solução de Problemas de Indicações
Se as visitas estiverem sendo rastreadas, mas as indicações não estiverem sendo criadas, o problema provavelmente está em sua integração ou configurações. As indicações podem ser visualizadas em AffiliateWP » Indicações. Use as seguintes etapas para diagnosticar o problema:
Comece verificando se a integração escolhida está instalada, ativada e atualizada. Certifique-se de que a integração esteja habilitada em AffiliateWP » Configurações » Integrações. Lembre-se, referências não podem ser geradas se você estiver logado como afiliado ou usando o e-mail do afiliado durante os testes. Por padrão, o AffiliateWP impede que afiliados gerem referências para suas próprias compras, a menos que o addon Permitir Referências Próprias esteja habilitado.
Verifique se a opção Ignorar Referências com Valores Zero está habilitada em AffiliateWP » Configurações » Comissões. Se você estiver tentando gerar referências de R$ 0,00 (por exemplo, para geração de leads), esta configuração pode bloquear essas entradas. Da mesma forma, certifique-se de que o addon Produtos Permitidos esteja configurado corretamente, se você o estiver usando; a falha na especificação de produtos resultará em referências de R$ 0,00, que podem ser ignoradas se a configuração de valor zero estiver ativa.
Para solucionar ainda mais, ative o Modo de Depuração em AffiliateWP » Configurações » Avançado. Isso ativa uma aba Assistente de Depuração em AffiliateWP » Ferramentas, onde você pode revisar os logs em busca de erros. Usuários avançados também podem ativar o modo de depuração globalmente definindo AFFILIATE_WP_DEBUG como true no arquivo wp-config.php. Teste as referências novamente e revise o log de depuração para obter insights.
Problemas Externos
Se nem as visitas nem as referências estiverem funcionando, o problema pode ser causado por conflitos externos, como incompatibilidades de plugins ou temas. Se possível, realize testes em um site de staging.
Comece desativando todos os plugins, exceto o AffiliateWP, e teste se as visitas e referências estão funcionando. Se tudo funcionar, reative gradualmente seus plugins em pequenos grupos para identificar quaisquer conflitos. Uma vez identificado, entre em contato com o desenvolvedor do plugin para obter assistência.
Se os plugins não forem o problema, mude temporariamente para um tema padrão do WordPress (por exemplo, Twenty Twenty-Two). Se isso resolver o problema, o problema provavelmente está no seu tema atual. Entre em contato com o desenvolvedor do tema para obter suporte.
Certifique-se de que seu site de staging ou live esteja com backup antes de fazer alterações significativas, especialmente em um site live.
Perguntas Frequentes
Por que as visitas não estão sendo rastreadas no AffiliateWP?
As visitas não são rastreadas se os cookies do AffiliateWP (affwp_ref ou affwp_ref_visit_id) não forem definidos com sucesso no navegador do visitante. Causas comuns incluem problemas de cache, erros de JavaScript ou bloqueadores de anúncios. Certifique-se de que os cookies estejam habilitados no navegador, verifique conflitos com plugins de cache ou CDNs e inspecione erros de JavaScript no console.
Como posso verificar se os cookies do AffiliateWP estão funcionando?
Use as ferramentas de desenvolvedor do seu navegador para verificar a presença de cookies ao visitar um link de referência. Consulte este guia para obter etapas detalhadas: Como Visualizar e Excluir Cookies do AffiliateWP.
Por que as referências não estão sendo criadas, mesmo que as visitas sejam rastreadas?
Isso pode ser devido a:
- Uma integração inativa ou mal configurada.
- Testando enquanto logado como o afiliado, o que o AffiliateWP bloqueia por padrão.
- Referrals de valor zero sendo ignorados se a configuração Ignorar Referrals com Valores Zero estiver ativada.
Revise suas configurações de integração, garanta configurações corretas e teste com o modo de depuração ativado.
O que é Rastreamento de Referral de Fallback e quando devo usá-lo?
O Rastreamento de Referral de Fallback ignora o rastreamento baseado em JavaScript, confiando no rastreamento do lado do servidor. Ative-o em AffiliateWP » Configurações » Avançado se erros de JavaScript ou bloqueadores de anúncios impedirem o rastreamento padrão. No entanto, é recomendado resolver os problemas subjacentes em vez de depender do rastreamento de fallback.
Por que referrals de R$ 0,00 não estão sendo registrados?
Se você está gerando referrals para geração de leads ou testes gratuitos, certifique-se de que a opção Ignorar Referrals com Valores Zero em AffiliateWP » Configurações » Comissões esteja desativada. Se estiver usando o addon Produtos Permitidos, certifique-se de que os produtos estejam especificados corretamente.
Um afiliado pode criar referrals para si mesmo?
Por padrão, o AffiliateWP impede que afiliados gerem seus próprios referrals. Se necessário, você pode ativar auto-referrals usando o addon Permitir Referrals Próprios.
É isso! Seguindo as etapas de solução de problemas acima, você deve ser capaz de identificar e resolver problemas que impedem que visitas ou referrals sejam registrados no AffiliateWP. Seja garantindo que os cookies sejam armazenados, resolvendo erros de JavaScript ou configurando suas configurações de integração, essas verificações ajudarão a colocar seu programa de afiliados de volta nos trilhos.
Se você ainda encontrar problemas, não hesite em contatar a equipe de suporte do AffiliateWP para obter mais assistência.