Aller au contenu principal

Vérification de l'intégration

Ce guide vous aide à vérifier que AdSentinel est correctement intégré sur votre site.

Checklist de vérification​

✅ 1. Le script est chargé​

Ouvrez les outils de développement (F12) et vérifiez dans l'onglet Network :

  • Le script SITE_ID.js est chargé avec un statut 200
  • Le script provient de cdn.web-kit.io

✅ 2. Le SDK est initialisé​

Dans la Console, vous devriez voir :

✅ AdSentinel SDK initialized
✅ Session ID: abc123-def456-789...
✅ Config loaded for site: SITE_ID

✅ 3. La détection fonctionne​

Avec un adblocker activé, vous devriez voir :

✅ Adblock detected: true
✅ Detection method: bait
✅ Wall displayed

✅ 4. Le wall s'affiche​

  • Le wall apparaît en overlay sur la page
  • Le titre et le message sont visibles
  • Le bouton CTA est cliquable
  • Le style correspond à votre configuration

✅ 5. La conversion fonctionne​

  1. Désactivez votre adblocker
  2. Cliquez sur le bouton CTA
  3. Vérifiez dans la console :
✅ Verification started
✅ Adblock disabled confirmed
✅ Conversion tracked
✅ Wall removed

Test avec différents adblockers​

Testez avec plusieurs adblockers pour valider la détection :

AdblockerComment tester
uBlock OriginChrome/Firefox extension
AdBlock PlusChrome/Firefox extension
AdBlockChrome extension
BraveNavigateur Brave avec shields activés

Vérification dans le Dashboard​

Après vos tests, vérifiez dans le dashboard AdSentinel :

  1. Allez sur Analytics → Temps réel
  2. Vérifiez que vos sessions de test apparaissent
  3. Vérifiez les événements :
    • adblock_detected
    • adwall_displayed
    • conversion_allowlist (si conversion effectuée)

Mode Debug​

Activez le mode debug pour des logs détaillés :

<script>
  window.ADWALL_CONFIG = { debug: true };
</script>
<script src="https://cdn.web-kit.io/loader.js?site=VOTRE_SITE_ID" async></script>

Logs de debug​

[AdSentinel Debug] Init started
[AdSentinel Debug] Session ID: abc123...
[AdSentinel Debug] Variant assigned: control
[AdSentinel Debug] Starting adblock detection...
[AdSentinel Debug] Bait element created
[AdSentinel Debug] Bait element blocked: true
[AdSentinel Debug] Network test started
[AdSentinel Debug] Network test blocked: true
[AdSentinel Debug] Detection result: BLOCKED
[AdSentinel Debug] Checking conversion status...
[AdSentinel Debug] User not converted, showing wall
[AdSentinel Debug] Wall template loaded
[AdSentinel Debug] Wall displayed
[AdSentinel Debug] Event tracked: adwall_displayed

Problèmes courants​

Le script ne se charge pas​

Causes possibles :

  • URL du script incorrecte
  • Site ID invalide
  • Problème réseau

Solutions :

  1. Vérifiez l'URL dans le dashboard
  2. Vérifiez qu'il n'y a pas de typo dans le Site ID
  3. Vérifiez la console pour les erreurs CORS

Le wall ne s'affiche pas​

Causes possibles :

  • Adblocker non actif
  • Utilisateur déjà converti (cookie présent)
  • Site non configuré

Solutions :

  1. Vérifiez que votre adblocker est activé
  2. Supprimez les cookies adwall_* et réessayez
  3. Vérifiez la configuration du site dans le dashboard

Erreur CORS​

Access to script at 'https://...' from origin 'http://localhost:3000' 
has been blocked by CORS policy

Solution : Ajoutez votre domaine (y compris localhost pour les tests) dans les domaines autorisés du dashboard.

Le wall s'affiche même sans adblocker​

Causes possibles :

  • Faux positif de détection
  • Extension qui bloque certaines ressources

Solutions :

  1. Désactivez toutes les extensions et retestez
  2. Contactez le support avec les détails

Outils de test​

Extension de test​

Utilisez l'extension de développement AdSentinel (disponible sur demande) pour :

  • Forcer l'affichage du wall
  • Simuler un adblocker
  • Réinitialiser les cookies
  • Voir les événements en temps réel

Console AdSentinel​

Dans la console du navigateur :

// Forcer une nouvelle détection
window.AdSentinel?.check()

// Obtenir l'ID de session
window.AdSentinel?.getSessionId()

// Réinitialiser (supprimer les cookies)
document.cookie = 'adwall_converted=; max-age=0; path=/'
document.cookie = 'adwall_seen=; max-age=0; path=/'

Valider en production​

Avant le déploiement en production :

  1. Testez sur un environnement de staging
  2. Vérifiez le comportement mobile
  3. Testez les différents navigateurs
  4. Validez les analytics dans le dashboard
  5. Désactivez le mode debug
Important

N'oubliez pas de désactiver debug: true en production pour éviter de polluer la console de vos utilisateurs.