Detection API
La API de detección de adblock headless
Ejecuta nuestro motor de detección multi-señal sin overlay. El script confirma el bloqueador y entrega el resultado a tu propio código mediante un evento o un callback de JavaScript, así que tú decides qué pasa después. Disponible en los planes Max y Business, por sitio.
Un detector sobre el que construir
Tu interfaz, nuestro motor
El script detecta todos los bloqueadores importantes y no muestra nada. Sin overlay, sin mensaje, sin petición de lista blanca. Lo que ve un visitante bloqueado lo decides tú.
Un resultado claro en cada visita
Un evento de window, aabc:detection, se dispara con un payload pequeño y congelado: si se encontró un bloqueador, de qué tipo y el navegador. También hay un callback y un snapshot para los listeners que se registran tarde.
El tipo de bloqueador, clasificado
Cada resultado dice qué está bloqueando: una extensión del navegador, Brave Shields, la protección integrada del navegador o filtrado a nivel de red y DNS. La misma taxonomía que ya usa tu panel.
Estadísticas y cuota, sin cambios
Las detecciones se siguen contando y se ven en tu panel, y una detección cuesta lo mismo que en modo recovery. Si tu propio flujo convence a un visitante de permitir anuncios, tu tasa de recuperación lo sigue registrando.
Un listener, tu lógica
Lee el resultado en unas pocas líneas
<script>
window.addEventListener("aabc:detection", function (event) {
var d = event.detail;
// { detected, blockerType, path, browser }
if (d.detected) {
// Your logic: your own notice, content gating, logging.
}
});
</script>Payload de ejemplo: { detected: true, blockerType: "extension", path: "A", browser: "chromium" }. Cada campo, valor de enum y caso límite está documentado en la referencia de la API.
Una cuenta, los dos modos
El modo es un ajuste por sitio. Ejecuta un dominio headless para tu aplicación y mantén el overlay de recuperación en tu web de contenidos, desde el mismo panel y la misma cuota.
Preguntas frecuentes de la Detection API
¿Qué es la Detection API?
Es un modo headless de AntiAdBlock Core. El mismo motor de detección se ejecuta, pero en lugar de mostrar un overlay de recuperación entrega el resultado a tu propio JavaScript. Tú gestionas la respuesta: un aviso propio, gating de contenido, analítica, lo que necesite tu producto.
¿Qué planes lo incluyen?
La Detection API está disponible en los planes Max y Business. Se activa por sitio, así que un dominio puede ir headless mientras otro mantiene el overlay de recuperación.
¿Una detección sigue consumiendo cuota?
Sí. La detección funciona exactamente igual en este modo, así que cada visita con adblock cuenta una vez, igual que con el overlay de recuperación. Las páginas vistas normales nunca cuentan.
¿Cómo leo el resultado de forma fiable?
Escucha el evento de window aabc:detection, define un callback window.AABC_ON_DETECT o lee el snapshot window.AABC_DETECTION para listeners que se registran tarde. El callback es el más robusto, porque los scripts de la página no pueden interceptar una llamada directa. La referencia de la API cubre las tres vías.
¿Qué pasa si el script no puede ejecutarse?
Se queda en silencio. Si un sitio no está verificado, hay un kill switch activo o el visitante es un bot, no se emite ningún evento. El silencio significa sin respuesta, no sin bloqueador, así que tu código debe tomar el camino normal por defecto y fallar en abierto.
Crea tu propia respuesta al adblock
Empieza gratis, pasa a Max cuando estés listo y cambia cualquier sitio a la Detection API desde tu panel.