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:

  1. Log in to your Ad Unblock dashboard
  2. Select your site from the site switcher
  3. 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:

https://d3fz90i49fwte1.cloudfront.net
Valid
https://example-blocked-cdn.net
Blocked

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:

https://us-726620180914.us-central1.run.appUS (Central)
Operational
https://fr-726620180914.europe-west9.run.appFrance (Europe West)
Degraded

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:

  1. Set up a scheduled task that runs every few hours
  2. Fetch the list of valid CDN endpoints from our API
  3. Store this information in your server's cache
  4. 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.