Aller au contenu principal

Première intégration

Intégrez Ad Sentinelle sur votre site en ajoutant une seule ligne de code.

Le code d'intégration​

Depuis la page Intégration de votre site dans le dashboard, copiez le code suivant :

<!-- Ad Sentinelle SDK - Une seule ligne ! -->
<script src="https://adwall-backend-xxxxx.run.app/v1/loader/VOTRE_SITE_ID.js" async></script>
Personnalisé pour vous

Le code affiché dans votre dashboard contient déjà votre Site ID. Copiez-le directement !

Où placer le code ?​

Ajoutez cette ligne juste avant la balise </body> de votre page HTML :

<!DOCTYPE html>
<html>
<head>
  <title>Mon Site</title>
</head>
<body>
  <!-- Votre contenu -->
  <header>...</header>
  <main>...</main>
  <footer>...</footer>
  
  <!-- Ad Sentinelle SDK (juste avant </body>) -->
  <script src="https://adwall-backend-xxxxx.run.app/v1/loader/VOTRE_SITE_ID.js" async></script>
</body>
</html>

Intégration par framework​

WordPress​

Ajoutez le code dans votre thème via Apparence → Éditeur de thème → footer.php, ou utilisez un plugin comme "Insert Headers and Footers".

React / Next.js​

// app/layout.tsx (Next.js App Router)
import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Script 
          src="https://adwall-backend-xxxxx.run.app/v1/loader/VOTRE_SITE_ID.js"
          strategy="afterInteractive"
        />
      </body>
    </html>
  )
}

Vue.js / Nuxt​

// plugins/adwall.client.ts (Nuxt 3)
export default defineNuxtPlugin(() => {
  if (process.client) {
    const script = document.createElement('script')
    script.src = 'https://adwall-backend-xxxxx.run.app/v1/loader/VOTRE_SITE_ID.js'
    script.async = true
    document.body.appendChild(script)
  }
})

Vérifier l'intégration​

Test rapide​

  1. Ouvrez votre site dans un navigateur
  2. Activez un adblocker (uBlock Origin recommandé)
  3. Rafraîchissez la page
  4. Le wall Ad Sentinelle doit s'afficher ✅

Console développeur​

Ouvrez la console (F12) et vérifiez :

✅ Ad Sentinelle SDK initialized
✅ Session ID: abc123...
✅ Publisher ID: 677c2846...
✅ Adblock detected: true
✅ Wall displayed

Dashboard​

Retournez sur votre dashboard Ad Sentinelle. Après quelques secondes, vous devriez voir :

  • Une nouvelle session dans les analytics
  • Un événement "adblock_detected"
  • Un événement "adwall_displayed"

Problèmes courants​

Le wall ne s'affiche pas​

ProblèmeSolution
Script non chargéVérifiez l'URL du script et votre Site ID
Adblock non actifAssurez-vous que l'adblock est activé pour le test
Cache navigateurVidez le cache (Ctrl+Shift+R)
Erreur consoleVérifiez la console pour les erreurs

Erreur CORS​

Si vous testez en local (localhost), assurez-vous que votre domaine est bien configuré dans le dashboard.

Script bloqué​

Certains adblockers agressifs peuvent bloquer le script Ad Sentinelle lui-même. Notre SDK utilise des techniques d'obfuscation pour éviter cela.

Désactiver temporairement​

Pour désactiver Ad Sentinelle temporairement (maintenance, tests), vous pouvez :

  1. Dans le dashboard : Mettez le site en mode "Inactif"
  2. Dans le code : Commentez la ligne du script
<!-- Ad Sentinelle temporairement désactivé -->
<!-- <script src="https://adwall-backend-xxxxx.run.app/v1/loader/VOTRE_SITE_ID.js" async></script> -->

Prochaines étapes​

🎉 Félicitations ! Ad Sentinelle est maintenant intégré sur votre site.

Continuez avec :