Astro

Integration guide for Astro static site builder with ad blocker detection

Installation

Target file: src/layouts/Layout.astro

Quick Integration

Add the following script tag to your HTML. Replace the data-key value with your actual API key.

Script Tag

<script src="https://cdn.antiblocker.io/ab.js" data-style="minimal" data-key="abk_****"></script>

Complete Example

Here's a complete example showing where to place the script in your src/layouts/Layout.astro file:

src/layouts/Layout.astro

---
interface Props {
  title: string;
}
const { title } = Astro.props;
---

<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>{title}</title>
  </head>
  <body>
    <slot />
    <script src="https://cdn.antiblocker.io/ab.js" data-style="minimal" data-key="abk_****"></script>
  </body>
</html>

Configuration

Script Attributes

data-keyYour unique AntiBlocker API key (required)

data-styleDisplay style - choose one of 6 variants: "classic", "dark", "educational", "friendly", "minimal", or "urgent"

Implementation Notes

Add the script in your main layout file (typically src/layouts/Layout.astro)
Place it before the closing </body> tag
The script will be included on all pages using this layout
Works with Astro's partial hydration and island architecture

Best Practices

Performance

Place script before closing </body> tag. The script loads asynchronously and doesn't block page rendering.

Testing

Test integration in staging environment before deploying to production. Verify script loads correctly.

API Key

Obtain your unique API key from the AntiBlocker dashboard. Never share your key publicly.

Monitoring

Track detection rates and user responses through the AntiBlocker analytics dashboard.