Padrão e Máximo
Padrão utiliza o subdomínio first-party quando CNAME e HTTPS estão verificados e mantém fallback central. Máximo, disponível a partir do Pro, acrescenta uma rota no domínio principal. Se o subdomínio falhar, a tag tenta essa rota antes do serviço central. Trata-se de disponibilidade de entrega: o motor continua baseado em elemento isca e não garante identificar todo bloqueador.
Pré-requisitos
Tenha acesso ao servidor do domínio cadastrado. Para o arquivo avulso, use PHP 8.0 ou superior, extensão cURL e saída HTTPS permitida. O domínio público deve usar HTTPS válido. Sites estáticos e hospedagens sem execução PHP exigem uma implementação de rota específica; o arquivo fornecido não é executável nesses ambientes. No desenvolvimento local, o AntiAdblock Guard usa localhost/127.0.0.1 com uma porta de teste separada.
Instalar o arquivo PHP
1. Cadastre e verifique a propriedade do site. 2. Abra Configuração → Set up Maximum Detection → PHP. 3. Clique em Baixar arquivo PHP. Envie esse arquivo para a raiz pública do site, preservando o nome gerado. Não envie como texto, não renomeie e não exponha seu código-fonte: ele contém a chave privada desta instalação. 4. Confira a URL exibida no painel e clique em Check and install. A prova assinada confirma que o arquivo correto responde no domínio esperado. Em Apache/LiteSpeed compatível, o arquivo tenta adicionar somente três regras AntiAdblock Guard ao .htaccess, com backup e teste da página inicial. Se não puder instalar as regras, informa o motivo e mantém a rota direta; o painel mostra regras manuais. Uma falha no teste tenta reverter a alteração. 5. Ative Máximo. Copie e substitua a tag atualizada no head das páginas. 6. Abra uma página e confirme o último contato da rota e os eventos. A prova do arquivo não substitui esse teste de comunicação.
Instalar com Next.js
No App Router com runtime Node.js, baixe route.js e coloque em app/NOME-DO-ARQUIVO/route.js ou src/app/NOME-DO-ARQUIVO/route.js, usando o nome exato exibido no painel (incluindo .php). Acrescente os três rewrites fornecidos no painel a next.config.js ou next.config.mjs, preservando regras existentes. Mantenha o arquivo fora de repositórios públicos porque contém a chave privada do site. Publique, verifique a rota direta e o rewrite no painel, ative Máximo e substitua a tag no head. Exportação estática de Next.js não executa Route Handlers.
Outras plataformas
Node, Nuxt, Astro e sites estáticos precisam de uma rota no próprio domínio que execute código no servidor ou na borda. Sites apenas estáticos precisam de uma função edge ou backend. Ainda não há pacote automático para essas plataformas; abra um ticket em Suporte no painel. Permaneça no Padrão até a integração estar pronta e verificada.
Instalar com WordPress
O plugin gerado exige WordPress instalado na raiz do domínio cadastrado e permalinks/rewrite funcionando. Em Configuração → Máximo, baixe o ZIP WordPress. No wp-admin, vá a Plugins → Adicionar plugin → Enviar plugin, envie o ZIP e ative. O plugin registra a rota e insere a tag no head das páginas públicas; usuários com permissão de editar posts são ignorados. Verifique a rota no AntiAdblock Guard e ative Máximo. Não instale também uma tag manual para evitar duplicidade. O plugin é específico do site e contém sua chave privada. Ao mudar domínio oficial do AntiAdblock Guard ou hostname de entrega, gere e reinstale o pacote atualizado.
Como o fallback funciona
A tag gerada usa primeiro o subdomínio verificado, depois a rota verificada do domínio principal, e por último o AntiAdblock Guard. Se não houver subdomínio ativo, a rota Máxima pode ser o primeiro caminho. O arquivo só encaminha as ações fixas de script e coleta ao AntiAdblock Guard; não aceita destinos externos informados pelo visitante. O script recebido pela rota também envia eventos por essa rota. Há limites curtos de conexão e tempo total; falhas não criam um bloqueio de conteúdo. O erro de carregamento pode acionar o próximo caminho, conforme a tag. Políticas CSP devem permitir os endereços e o fallback da instalação.
Verificar, trocar e revogar
Arquivo verificado significa que ele respondeu à prova de instalação com a chave esperada. Último contato da rota registra quando ela conseguiu buscar o script no AntiAdblock Guard. Ativar Máximo exige plano compatível e verificação. Revogar integração invalida imediatamente a chave do arquivo/plugin sem apagar o site ou o histórico; remova a instalação do cliente e baixe outra para reconectar. A renovação da chave de coleta do navegador é independente da revogação da integração de servidor. Em downgrade, o caminho Máximo é bloqueado e o fallback central continua disponível nas tags geradas.
Teste com uma IA
Forneça à sua IA o guia público ou o download em texto, a plataforma do seu site e a URL da rota indicada no painel. Solicite a instalação no head e a conferência de CSP, código HTTP, tipos MIME, timeout, certificado e eventos. Não envie senhas ou chaves privadas em prompts públicos. Teste o fallback bloqueando o subdomínio em um navegador de teste, sem alterar o DNS de produção. O domínio oficial e as chaves da cobrança são do operador, não devem ser inventados pela IA.