Como evitar que plugins de cache do WordPress como WP Rocket interfiram nos scripts de rastreamento do Post Affiliate Pro

Definição do problema

Plugins de cache e otimização do WordPress como WP Rocket, Autoptimize, W3 Total Cache e LiteSpeed Cache são populares para acelerar sites. No entanto, podem interferir inadvertidamente no rastreamento de afiliados ao modificar a forma como o JavaScript é carregado. Isso pode impedir que os scripts de rastreamento do Post Affiliate Pro sejam executados corretamente, levando à perda de cliques ou vendas de afiliados.

Entender como esses plugins alteram o carregamento dos scripts é essencial para manter o rastreamento preciso e garantir que seu programa de afiliados funcione conforme o esperado.

Como o WP Rocket e outros plugins de cache afetam o rastreamento do Post Affiliate Pro

O WP Rocket e plugins similares otimizam seu site adiando, combinando ou minificando arquivos JavaScript. Eles frequentemente adicionam atributos como “defer” ou “async” às tags <script>, ou movem scripts para o rodapé. Embora essas mudanças melhorem o desempenho, podem atrapalhar o momento exato necessário para os scripts de rastreamento do Post Affiliate Pro funcionarem, causando falhas no rastreamento.

Os problemas mais comuns incluem:

• Script de rastreamento não sendo acionado
• Script de rastreamento sendo acionado tarde demais (após o visitante sair)
• Script de rastreamento sendo minificado ou combinado de forma que prejudique sua funcionalidade

Solução de problemas: Garantindo que seu script de rastreamento seja excluído da otimização

1. Identifique seu script de rastreamento: O nome do arquivo do script de rastreamento no atributo src (ex.: a1x2j2) é único para sua instalação e o ID do script normalmente é pap_x2s6df8d. Para encontrar seu script exato, acesse o painel do comerciante do Post Affiliate Pro e navegue até Ferramentas → Integração → Rastreamento de cliques. Use tanto o nome do arquivo (a1x2j2) quanto o ID (pap_x2s6df8d) nas exclusões.
2. Exclua da otimização:
   • WP Rocket: Nas configurações do WP Rocket, vá até “Otimização de arquivos” e adicione a URL completa ou o nome do arquivo do seu script de rastreamento (como encontrado no painel do comerciante, ex.: a1x2j2) no campo “Arquivos JavaScript Excluídos”. Você também pode segmentar o script pelo seu ID (pap_x2s6df8d).
   • Scripts personalizados: Adicione o atributo data-nowprocket à tag do seu script. Exemplo:

     <script data-nowprocket src="https://yourpapdomain.com/scripts/a1x2j2" id="pap_x2s6df8d"></script>
     

   • Outros plugins: Procure por opções semelhantes de “Excluir” ou “Não adiar”, e utilize tanto o nome exclusivo do arquivo quanto o ID do script.
3. Habilite o rastreamento assíncrono: Se você usa o plugin do Post Affiliate Pro para WordPress, ative a opção “Usar rastreamento assíncrono quando possível” nas configurações gerais do plugin.
4. Teste sua integração: Após excluir o script, utilize as ferramentas de desenvolvedor do seu navegador e o recurso de teste de rastreamento de cliques do Post Affiliate Pro para verificar se o rastreamento funciona como esperado.

Como melhorar a precisão do rastreamento com o script JavaScript do Post Affiliate Pro

Para maximizar a confiabilidade do rastreamento:

• Sempre utilize o nome exclusivo do arquivo do script de rastreamento (ex.: a1x2j2) na seção Ferramentas → Integração → Rastreamento de cliques do seu painel de comerciante, pois o nome do arquivo é único e pode mudar.
• Exclua seu script de rastreamento por sua URL ou ID exclusivo de quaisquer processos de cache ou otimização.
• Considere estacionar um domínio ou subdomínio personalizado em sua conta do Post Affiliate Pro para scripts de rastreamento (ex.: parceiros.seudominio.com). Evite usar palavras como “affiliate” ou “track” no nome do domínio, pois podem ser bloqueadas por bloqueadores de anúncios.
• Usar um domínio personalizado (neutro) para seu script de rastreamento aumenta a chance do script carregar e executar, mesmo para usuários com ferramentas agressivas de privacidade ou de bloqueio de anúncios.

Melhores práticas para rastreamento do Post Affiliate Pro com plugins de cache

• Sempre exclua scripts críticos de rastreamento da otimização de JavaScript (adiar, combinar ou minificar) no seu plugin de cache, utilizando tanto o nome do arquivo src quanto o ID do script.
• Use rastreamento assíncrono sempre que possível para melhorar a compatibilidade e a velocidade do site.
• Teste o rastreamento regularmente após atualizar plugins ou temas.
• Documente qualquer alteração personalizada de script para futuros administradores do site.
• Se possível, use rastreamento do lado do servidor (S2S) para máxima confiabilidade.

Dicas gerais: Lidando com outros plugins de otimização

• Autoptimize: Use o campo “Excluir scripts do Autoptimize” para seu script de rastreamento (adicione tanto o nome do arquivo src quanto o ID).
• W3 Total Cache: Exclua seu script de rastreamento das configurações de minificação e combinação.
• LiteSpeed Cache: Adicione scripts de rastreamento à lista “JS Excludes”.
• Em todos os casos, consulte a documentação do seu plugin para a sintaxe de exclusão correta e teste cuidadosamente.

Como testar se o rastreamento está funcionando após alterações?

1. Limpe o cache do seu site e do navegador.
2. Clique em um link de indicação e verifique se o script de rastreamento carrega na aba de rede do navegador.
3. Faça uma venda ou conversão de teste e confira se ela aparece no painel do comerciante do Post Affiliate Pro.
4. Se o rastreamento falhar, revise as configurações de exclusão e tente desabilitar temporariamente as funções de otimização.

Por que meu rastreamento de afiliados ainda não funciona após as exclusões?

• Verifique novamente o caminho ou nome do script nas configurações de exclusão (use tanto src quanto ID).
• Certifique-se de que não há plugins conflitantes ou camadas adicionais de cache (CDN, cache de servidor).
• Tente alternar para rastreamento assíncrono ou S2S para maior confiabilidade.
• Entre em contato com o suporte do seu host ou plugin para solução de problemas avançada.

Como implementar manualmente o código de rastreamento assíncrono

Se precisar inserir manualmente o rastreamento assíncrono, use o seguinte modelo de código:

<script type="text/javascript">
  (function() {
    var papScriptHeader = document.createElement('script');
    papScriptHeader.src = 'https://yourpapdomain.com/scripts/a1x2j2';
    papScriptHeader.id = 'pap_x2s6df8d';
    papScriptHeader.type = 'text/javascript';
    papScriptHeader.onload = function() {
      try {
        PostAffTracker.setAccountId('default1');
        PostAffTracker.track();
      } catch (err) { }
    }
    document.body.appendChild(papScriptHeader);
  })();
</script>

Substitua https://yourpapdomain.com/scripts/a1x2j2 e default1 pelos seus valores reais. Isso garante que o script carregue após o conteúdo da página, melhorando a compatibilidade com plugins de cache.