System Status Guide
The System Status page helps you monitor the health and availability of Ad Unblock's CDN endpoints and proxy APIs. This guide explains how to interpret and use this information to ensure optimal performance of your integration.
Accessing the System Status Page
To access the System Status page:
- Log in to your Ad Unblock dashboard
- Select your site from the site switcher
- In the sidebar navigation, click on "System Status"
CDN Endpoint Responsibility
As a site owner, you are responsible for ensuring your integration uses valid CDN endpoints. Ad blockers regularly update their rules, which may block our endpoints. Regularly check the System Status page for the latest endpoint information.
Understanding the System Status Page
The System Status page is divided into two main sections:
1. Unblocker Script Status
This section displays the current status of our CDN distribution endpoints:
Note: These statuses are updated every 15 minutes. Valid endpoints can be used in your integration.
2. Proxy API Status
This section shows the operational status of our global proxy API endpoints:
Note: Our system automatically routes traffic to the closest operational endpoint. If all endpoints in a region are down, traffic will be redirected to the next closest available region.
Taking Action Based on Status Information
When a CDN Endpoint is Blocked
If an endpoint your site uses becomes blocked, you should:
- Update your integration to use a valid CDN endpoint
- Implement server-side endpoint selection (recommended for production sites)
- Fetch the latest valid endpoints from the API endpoint
Valid Script Sources API
You can programmatically fetch the latest valid CDN endpoints from our API:
https://config.adunblocker.com/valid_script_sources.json
Important: Always fetch this information server-side with appropriate caching, never client-side.
When a Proxy API is Degraded or Down
If a proxy API shows as degraded or down:
- No immediate action is typically required
- Our system automatically routes traffic to healthy endpoints
- If all endpoints show issues, contact support immediately
Advanced: Server-Side Implementation
For production environments, we strongly recommend implementing server-side endpoint selection:
- Set up a scheduled task that runs every few hours
- Fetch the list of valid CDN endpoints from our API
- Store this information in your server's cache
- When serving HTML to users, dynamically inject the script tag with a valid endpoint
This approach ensures your site always uses working endpoints, even if some become blocked by ad blockers.
Why endpoints get blocked
Ad blockers maintain lists of domains and URLs they block. As ad-blocking technology evolves, they may detect and block our CDN endpoints. By maintaining multiple endpoints and providing real-time status information, we ensure you can always find a working solution for your site.
Need Further Assistance?
If you're experiencing issues with your integration or have questions about the System Status page, please contact our support team at support@adunblock.com.