# AntiAdblock Guard — Guia público de instalação e operação

URL oficial: https://antiadblockguard.com
Documentação: https://antiadblockguard.com/guides

Este guia não contém chaves nem dados de conta. Use os valores gerados no painel do proprietário para integrar um site.

## Recuperação e Detection API

Escolha entre mostrar o aviso ou decidir pela sua integração.

Fonte: https://antiadblockguard.com/guides/modos

### Recuperação

Quando as checagens visuais ou de rede indicam possível bloqueio, o script mostra o aviso configurado. O botão verifica novamente. Você pode permitir fechar o aviso ou exigir uma nova checagem sem bloqueio. Visitas sem indício de bloqueio não abrem o aviso.

### Detection API

Disponível no Max e Business. Nesse modo não aparece aviso. Ouça window.addEventListener("adsinal:detection", callback). event.detail contém detected e site. O evento é emitido também quando o detector não identifica bloqueio e a visita foi aceita. No Free e Pro, o evento público não é emitido.

### Cobertura atual

O detector combina elementos isca com carregamento de scripts e verificação dos objetos públicos criados por eles. O núcleo foi adaptado do CHP Adblock Detector (MIT), com checagem adicional do SDK IMA para listas que substituem o AdSense por um script inofensivo. Os scripts do AdSense e IMA são solicitados ao Google com crossorigin=anonymous e referrerPolicy=no-referrer, sem credenciais e sem solicitar anúncios; o código dos SDKs é executado e o IP do visitante é visível ao provedor. Uma indicação de bloqueio deve se repetir com controle de conectividade funcionando. Timeout, modo offline e CSP não são tratados isoladamente como bloqueio. Testado em perfis isolados com uBlock Origin Lite e Brave com filtros inicializados. Não identifica qual extensão está instalada nem garante cobertura universal.

### Falhas de coleta

A detecção local não depende do sucesso do envio da visita. Falhas de rede ou HTTP 5xx têm uma nova tentativa com o mesmo identificador de página, sem duplicar eventos aceitos. Recusas explícitas de acesso ou quota são respeitadas. O aviso pode ser exibido durante uma falha temporária de telemetria, mas a métrica só aparece no painel quando o servidor aceita o evento.