Comment empêcher les plugins de cache WordPress comme WP Rocket d'interférer avec les scripts de suivi Post Affiliate Pro

Définition du problème

Les plugins de cache et d’optimisation WordPress tels que WP Rocket, Autoptimize, W3 Total Cache et LiteSpeed Cache sont populaires pour accélérer les sites web. Cependant, ils peuvent involontairement interférer avec le suivi d’affiliation en modifiant la façon dont le JavaScript est chargé. Cela peut empêcher les scripts de suivi de Post Affiliate Pro de s’exécuter correctement, entraînant la perte des clics ou ventes d’affiliés.

Comprendre comment ces plugins modifient le chargement des scripts est essentiel pour garantir un suivi précis et assurer le bon fonctionnement de votre programme d’affiliation.

Comment WP Rocket et d’autres plugins de cache affectent le suivi Post Affiliate Pro

WP Rocket et des plugins similaires optimisent votre site en retardant, combinant ou minifiant les fichiers JavaScript. Ils ajoutent souvent des attributs comme “defer” ou “async” aux balises <script>, ou déplacent les scripts dans le pied de page. Bien que ces modifications améliorent les performances, elles peuvent perturber la synchronisation précise nécessaire au bon fonctionnement des scripts de suivi Post Affiliate Pro, provoquant des échecs de suivi.

Les problèmes les plus courants incluent :

• Le script de suivi ne se déclenche pas du tout
• Le script de suivi se déclenche trop tard (après le départ du visiteur)
• Le script de suivi est minifié ou combiné d’une manière qui casse sa fonctionnalité

Dépannage : s’assurer que votre script de suivi est exclu de l’optimisation

1. Identifiez votre script de suivi : Le nom du fichier du script de suivi dans l’attribut src (ex : a1x2j2) est unique à votre installation, et l’ID du script est généralement pap_x2s6df8d. Pour trouver votre script exact, allez dans votre panneau marchand Post Affiliate Pro puis dans Outils → Intégration → Suivi des clics. Utilisez à la fois le nom du fichier (a1x2j2) et son ID (pap_x2s6df8d) pour les exclusions.
2. Exclure de l’optimisation :
   • WP Rocket : Dans les paramètres de WP Rocket, allez dans “Optimisation des fichiers” et ajoutez l’URL complète ou le nom du fichier de votre script de suivi (comme trouvé dans le panneau marchand, ex : a1x2j2) au champ “Fichiers JavaScript exclus”. Vous pouvez aussi cibler le script par son ID (pap_x2s6df8d).
   • Scripts personnalisés : Ajoutez l’attribut data-nowprocket à votre balise script. Exemple :

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

   • Autres plugins : Recherchez des options similaires “Exclure” ou “Ne pas différer”, et utilisez à la fois le nom unique du fichier et son ID.
3. Activer le suivi asynchrone : Si vous utilisez le plugin WordPress Post Affiliate Pro, activez l’option “Utiliser le suivi asynchrone lorsque possible” dans les paramètres généraux du plugin.
4. Testez votre intégration : Après exclusion du script, utilisez les outils développeur de votre navigateur et la fonctionnalité de test de suivi des clics de Post Affiliate Pro pour vérifier que le suivi fonctionne comme prévu.

Comment améliorer la précision du suivi avec le suivi JavaScript Post Affiliate Pro

Pour maximiser la fiabilité du suivi :

• Utilisez toujours le nom de fichier unique du script de suivi (ex : a1x2j2) depuis la section Outils → Intégration → Suivi des clics de votre panneau marchand, car le nom de fichier est unique et peut changer.
• Excluez votre script de suivi par son URL ou ID unique de tous les processus de cache ou d’optimisation.
• Envisagez de configurer un domaine ou sous-domaine personnalisé sur votre compte Post Affiliate Pro pour les scripts de suivi (ex : partenaires.votredomaine.com). Évitez d’utiliser des mots comme “affiliate” ou “track” dans le nom de domaine, car ils peuvent être bloqués par des bloqueurs de publicités.
• L’utilisation d’un domaine personnalisé (neutre) pour votre script de suivi augmente les chances que le script se charge et s’exécute, même pour les utilisateurs avec des outils de confidentialité ou de blocage de publicité agressifs.

Bonnes pratiques pour le suivi Post Affiliate Pro avec des plugins de cache

• Excluez toujours les scripts de suivi critiques de l’optimisation JavaScript (déférer, combiner, minifier) dans votre plugin de cache, en utilisant à la fois le nom de fichier src du script et son ID.
• Utilisez le suivi asynchrone lorsque possible pour améliorer la compatibilité et la rapidité du site.
• Testez régulièrement le suivi après chaque mise à jour de plugins ou de thèmes.
• Documentez toute modification personnalisée des scripts pour les futurs administrateurs du site.
• Si possible, utilisez le suivi côté serveur (S2S) pour une fiabilité maximale.

Conseils généraux : gérer d’autres plugins d’optimisation

• Autoptimize : Utilisez le champ “Exclure les scripts d’Autoptimize” pour votre script de suivi (ajoutez à la fois son nom de fichier src et son ID).
• W3 Total Cache : Excluez votre script de suivi des paramètres de minification et de combinaison.
• LiteSpeed Cache : Ajoutez les scripts de suivi à la liste “JS Excludes”.
• Dans tous les cas, consultez la documentation de votre plugin pour connaître la syntaxe d’exclusion correcte et testez soigneusement.

Comment tester si mon suivi fonctionne après les modifications ?

1. Videz le cache de votre site et de votre navigateur.
2. Cliquez sur un lien de parrainage et vérifiez que le script de suivi se charge dans l’onglet réseau de votre navigateur.
3. Effectuez une vente ou conversion test et vérifiez si elle apparaît dans le panneau marchand Post Affiliate Pro.
4. Si le suivi échoue, revérifiez vos paramètres d’exclusion et essayez de désactiver temporairement les fonctionnalités d’optimisation.

Pourquoi mon suivi d’affiliation ne fonctionne-t-il toujours pas après les exclusions ?

• Vérifiez à nouveau le chemin ou le nom du script dans vos paramètres d’exclusion (utilisez à la fois src et ID).
• Assurez-vous qu’il n’y a pas de plugins conflictuels ou de couches de cache supplémentaires (CDN, cache serveur).
• Essayez de passer au suivi asynchrone ou au suivi S2S pour plus de fiabilité.
• Contactez votre hébergeur ou le support du plugin pour un dépannage avancé.

Comment implémenter manuellement le code de suivi asynchrone

Si vous devez insérer manuellement le suivi asynchrone, utilisez le modèle de code suivant :

<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>

Remplacez https://yourpapdomain.com/scripts/a1x2j2 et default1 par vos valeurs réelles. Cela garantit que le script se charge après le contenu de votre page, améliorant la compatibilité avec les plugins de cache.