Skip to main content

First Integration

Integrate Ad Sentinelle on your site by adding a single line of code.

Integration Code​

From the Integration page of your site in the dashboard, copy the following code:

<!-- Ad Sentinelle SDK - Just one line! -->
<script src="https://adwall-backend-xxxxx.run.app/v1/loader/YOUR_SITE_ID.js" async></script>
Personalized for You

The code displayed in your dashboard already contains your Site ID. Copy it directly!

Where to Place the Code?​

Add this line just before the </body> tag in your HTML page:

<!DOCTYPE html>
<html>
<head>
  <title>My Site</title>
</head>
<body>
  <!-- Your content -->
  <header>...</header>
  <main>...</main>
  <footer>...</footer>
  
  <!-- Ad Sentinelle SDK (just before </body>) -->
  <script src="https://adwall-backend-xxxxx.run.app/v1/loader/YOUR_SITE_ID.js" async></script>
</body>
</html>

Integration by Framework​

WordPress​

Add the code to your theme via Appearance → Theme Editor → footer.php, or use a plugin like "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/YOUR_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/YOUR_SITE_ID.js'
    script.async = true
    document.body.appendChild(script)
  }
})

Verify Integration​

Quick Test​

  1. Open your site in a browser
  2. Enable an ad blocker (uBlock Origin recommended)
  3. Refresh the page
  4. The Ad Sentinelle wall should appear ✅

Developer Console​

Open the console (F12) and verify:

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

Dashboard​

Go back to your Ad Sentinelle dashboard. After a few seconds, you should see:

  • A new session in analytics
  • An "adblock_detected" event
  • An "adwall_displayed" event

Common Issues​

Wall Doesn't Appear​

IssueSolution
Script not loadedCheck script URL and Site ID
Ad blocker not activeMake sure ad blocker is enabled for the test
Browser cacheClear cache (Ctrl+Shift+R)
Console errorCheck console for errors

CORS Error​

If you're testing locally (localhost), make sure your domain is configured in the dashboard.

Script Blocked​

Some aggressive ad blockers may block the Ad Sentinelle script itself. Our SDK uses obfuscation techniques to prevent this.

Disable Temporarily​

To temporarily disable Ad Sentinelle (maintenance, testing), you can:

  1. In Dashboard: Set site to "Inactive" mode
  2. In Code: Comment out the script line
<!-- Ad Sentinelle temporarily disabled -->
<!-- <script src="https://adwall-backend-xxxxx.run.app/v1/loader/YOUR_SITE_ID.js" async></script> -->

Next Steps​

🎉 Congratulations! Ad Sentinelle is now integrated on your site.

Continue with: