# 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.

## Diagnóstico, CSP e atualização do detector

Entrega completa no seu domínio, diagnóstico e status alternativo.

Fonte: https://antiadblockguard.com/guides/diagnostico-e-csp

### Atualize a entrega Máxima

A partir do Pro, baixe novamente o arquivo PHP, o plugin WordPress ou route.js na tela Entrega Máxima. Substitua a instalação preservando o nome e confira as regras atualizadas no painel. Verifique novamente para confirmar o protocolo 2. Ele encaminha carregador, script, coleta, diagnóstico e controle de conectividade pelo domínio do cliente. Instalações antigas mantêm as funções anteriores até a atualização. Nenhuma entrega oferece garantia contra todas as listas.

### Instalação com CSP

Em Sua tag de instalação, abra Instalação com CSP e use essa tag no lugar da anterior. Ela não usa onerror inline. Quando sua política usa nonce, gere um valor imprevisível a cada resposta no servidor, use o mesmo valor no cabeçalho CSP e no atributo nonce da tag. O carregador propaga esse nonce aos scripts criados e ao estilo do aviso. A política precisa permitir os scripts AdSense e IMA, além de connect-src para coleta, diagnóstico e controle. style-src deve autorizar o estilo do aviso pelo nonce. img-src precisa permitir sua logo. Não adicione unsafe-inline para contornar uma configuração incorreta. As rotas de fallback também precisam estar autorizadas. Um nonce de script com strict-dynamic delega confiança a scripts criados por ele, inclusive as sondagens; avalie isso com o responsável pela segurança do seu site.

### Aviso renderizado pelo servidor

Em Entrega Máxima, baixe guard-status.html e inclua o fragmento no template do seu servidor, fora do conteúdo protegido. O visitante verá uma mensagem neutra enquanto a checagem não concluir. O detector oculta o fragmento quando há resultado conclusivo. Sem JavaScript ou com toda a entrega bloqueada, a mensagem continua visível. Ela não confirma adblock e não bloqueia a navegação. Estilize o fragmento no CSS do seu site.

### Leia o diagnóstico

A aba Diagnóstico mostra carregador iniciado, detector executado, checagem concluída, abertura do aviso, falhas na coleta e uso de fallback. As confirmações usam um ID aleatório por carregamento e não armazenam IP, URL ou user-agent nessa tabela. Os dados são enviados pelo navegador e não são uma prova inviolável. Se o carregador e seu diagnóstico forem bloqueados juntos, não há confirmação. O comando agendado compara taxas em duas janelas de 24 horas, exige ao menos 100 inícios em cada janela e emite no máximo um alerta por site a cada 24 horas. Falta de tráfego, isoladamente, não gera esse alerta.

### Versões e rollback

Em Administração → Detector, selecione uma versão estável e opcionalmente uma versão em teste para 1 a 100 por cento dos sites. Os grupos são estáveis por site e não usam cookies. Apenas versões revisadas e incluídas na aplicação podem ser selecionadas; não existe campo para executar código remoto arbitrário. O histórico permite restaurar a distribuição anterior. O rollback vale para novos carregamentos; páginas já abertas precisam ser recarregadas. A versão 1.0.2 tem diagnóstico parcial e serve como rollback.

### Agendamento na hospedagem

O operador precisa executar php artisan schedule:run a cada minuto pelo cron da hospedagem. A tarefa adsinal:diagnose-delivery roda de hora em hora, gera alertas e remove diagnósticos com mais de 30 dias. A matriz de navegadores é uma rotina separada de desenvolvimento/CI e não deve executar navegadores na hospedagem compartilhada.