Aller au contenu principal

Vérification de l'intégration

Ce guide vous aide à vérifier que Ad Sentinelle 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 adwall-backend-xxxxx.run.app

✅ 2. Le SDK est initialisé​

Dans la Console, vous devriez voir :

✅ Ad Sentinelle 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 Ad Sentinelle :

  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://adwall-backend-xxxxx.run.app/v1/loader/SITE_ID.js" async></script>

Logs de debug​

[Ad Sentinelle Debug] Init started
[Ad Sentinelle Debug] Session ID: abc123...
[Ad Sentinelle Debug] Variant assigned: control
[Ad Sentinelle Debug] Starting adblock detection...
[Ad Sentinelle Debug] Bait element created
[Ad Sentinelle Debug] Bait element blocked: true
[Ad Sentinelle Debug] Network test started
[Ad Sentinelle Debug] Network test blocked: true
[Ad Sentinelle Debug] Detection result: BLOCKED
[Ad Sentinelle Debug] Checking conversion status...
[Ad Sentinelle Debug] User not converted, showing wall
[Ad Sentinelle Debug] Wall template loaded
[Ad Sentinelle Debug] Wall displayed
[Ad Sentinelle 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 Ad Sentinelle (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 Ad Sentinelle​

Dans la console du navigateur :

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

// Obtenir l'ID de session
window.Ad Sentinelle?.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.