Saltar para o conteúdo
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Neverblock

Visão geral

Anti-Adblock

O NeverBlock é uma solução comprovada para contornar bloqueadores de anúncios que maximiza instantaneamente as suas receitas.

A nossa tecnologia exclusiva garante que os seus anúncios continuam a ser apresentados, mesmo que o utilizador tenha instalado e ativado um software de bloqueio de anúncios.

A tecnologia avançada do NeverBlock contorna os bloqueadores de anúncios para recuperar todas as suas receitas publicitárias e funciona em todos os navegadores (incluindo Safari, Chrome, Internet Explorer, Mozilla, etc.) e em todas as plataformas e dispositivos (computador, smartphone, tablet).

Esta solução é gratuita para todos os clientes da ExoClick e consiste num processo simples de colocar uma linha de código no seu site.

Nesta documentação, abordaremos quatro implementações diferentes do NeverBlock. São elas:

  • NeverBlock PHP - A solução padrão, mais fácil de implementar e mais utilizada. É abordada com maior detalhe nesta documentação.

  • NeverBlock API - Quando é necessária uma linguagem não suportada, a API disponibiliza os pontos finais necessários para obter os anúncios diretamente. Deve ser utilizada quando são necessárias soluções manuais.

  • NeverBlock Proxy - Uma aplicação multiplataforma destinada a processar pedidos à API e a colocar anúncios em cache. Este serviço é executado em segundo plano para disponibilizar ao utilizador um ponto final mais direto para obter anúncios.

  • Plugin para WordPress - Um plugin para WordPress desenvolvido para integrar facilmente zonas de anúncios do NeverBlock no seu site WordPress.

NeverBlock PHP - Instalação automática

Objetivo

O instalador Phar do NeverBlock é uma ferramenta que ajuda a instalar a solução NeverBlock PHP (versão 3.0). Pode ser utilizado em vez dos passos descritos em Instalação manual. Instalará os ficheiros no diretório especificado ou, por predefinição, no diretório nb . O instalador tratará de parte da configuração, nomeadamente da mudança dos nomes dos ficheiros e das chaves de identificação.

Transferir o instalador

A versão mais recente pode ser transferida através da seguinte ligação:

Executar o instalador

Depois de transferir o ficheiro phar, coloque-o no diretório onde pretende guardar os ficheiros do NeverBlock. Ao executar o instalador, pode especificar o caminho onde pretende instalar os ficheiros ou deixar que sejam instalados no caminho predefinido. Também pode, opcionalmente, definir o ficheiro de registo utilizado; a sua finalidade é descrita na secção Ficheiro de registo .

Parâmetros opcionais:

Analisar a resposta

Depois de executar o comando, será apresentada uma resposta semelhante à que pode ver abaixo. Podemos analisá-la em duas secções distintas: os resultados do diagnóstico e os scripts necessários.

Resultados do diagnóstico

Depois de executar o ficheiro phar, serão apresentados os resultados de alguns testes à configuração. Tenha em atenção que a deteção de IP irá exigir o diag.php a ser executado manualmente. Para obter mais informações sobre estes resultados e a execução manual, consulte as secções Executar o diag.php e Possíveis resultados do diag.php.

Scripts necessários

Abaixo dos resultados do diagnóstico, vemos dois scripts cujos nomes foram gerados automaticamente. Estes scripts mostram os nomes do nosso frontend_loader.js e backend_loader.php, e serão os caminhos a utilizar ao Apresentar anúncios.

NeverBlock PHP - Instalação manual

Transferir os ficheiros

A instalação e a maior parte da configuração podem ser feitas através do instalador phar. A instalação manual pode ser feita da seguinte forma.

A versão mais recente (v3.14) pode ser transferida através destas ligações:

Ou através dos seguintes comandos:

Os ficheiros necessários desta pasta são:

  • backend_loader.php

  • frontend_loader.js

  • diag.php

Mudar o nome dos ficheiros (obrigatório)

Para garantir que os ficheiros não são imediatamente bloqueados por bloqueadores de anúncios, é obrigatório mudar-lhes o nome.

Um dos testes em diag.php verifica se existe o ficheiro backend_loader.php, pelo que as referências neste teste têm de ser atualizadas para corresponderem ao novo nome do ficheiro. O exemplo abaixo utiliza a mesma configuração apresentada na imagem anterior. No início da página, atualize a seguinte linha:

Colocar os ficheiros no servidor

Os ficheiros mencionados acima devem ser colocados no servidor onde pretende apresentar os seus anúncios.

Copie os ficheiros para uma pasta à sua escolha:

Executar o diag.php

Agora que os ficheiros NeverBlock estão no nosso servidor, vamos utilizar o ficheiro diag.php para verificar se está tudo correto até aqui. Para isso, basta aceder ao URL onde se encontra o ficheiro diag.php. Usando a captura de ecrã anterior como exemplo, o nosso seria o seguinte: https://www.my-example-site.com/nb/diag.php

Se tudo estiver correto até aqui, deverá ver o seguinte (iremos configurar o ficheiro de registo em Ficheiro de registo):

Se vir resultados diferentes, poderá ser necessária configuração adicional.

Possíveis resultados do diag.php

Versão do PHP: Se a versão do PHP não for suportada, será notificado. A solução NeverBlock padrão requer a versão 5.2 ou superior do PHP.

Presença do script do carregador de backend: Se este teste falhar, o ficheiro backend_loader.php não pode ser encontrado por diag.php. Isto pode dever-se a uma alteração do nome do ficheiro ou a um problema com o caminho.

Relatório de erros: Isto pode aparecer como um aviso. Este aviso não impedirá o funcionamento da solução NeverBlock.

Presença de cache e biblioteca cURL: Se a cache e o cURL não estiverem presentes, receberá avisos. Isto não impedirá o funcionamento do NeverBlock, mas recomendamos que sejam configurados.

  • A extensão cURL do PHP (altamente recomendada)

  • A extensão APC do PHP OU XCache

Deteção de IP: Se ocorrer um erro relacionado com a correspondência de IP, consulte Transmissão de IPs.

Pedidos de anúncios: Se os pedidos demorarem mais do que o esperado, poderá ser-lhe solicitado que aumente os valores de REQUEST_TIMEOUT_MS e CONNECT_TIMEOUT_MS . Para saber como fazê-lo, consulte Configuração de constantes.

NeverBlock PHP - Configuração

Transmissão de IPs (com Cloudflare, etc.)

Se utilizar um serviço, como o CloudFlare, que se situa entre o utilizador e os seus servidores, o IP detetado em backend_loader.php pode ser considerado inválido. Isto pode fazer com que os cliques ou as impressões dos anúncios sejam registados incorretamente. Para corrigir isto, pode substituir o $_SERVER["REMOTE_ADDR"] transmitido à classe UserEnvironment em backend_loader.php pelo valor correto fornecido pelo seu serviço de cache ou proxy.

No caso do Cloudflare, transmitiríamos o parâmetro $_SERVER["HTTP_CF_CONNECTING_IP"] . É apresentado um exemplo abaixo.

Depois de o fazer, o nosso UserEnvironment ficará da seguinte forma:

Ao utilizar outro serviço, como o Apache ou o NGINX, podemos usar isset($_SERVER['HTTP_X_REAL_IP']) ? $_SERVER['HTTP_X_REAL_IP'] : $_SERVER['REMOTE_ADDR'] como se mostra a seguir:

Podemos agora voltar a executar diag.php, se isto estava a fazer falhar o teste de deteção do IP , deveremos agora obter resultados bem-sucedidos.

Ficheiro de registo

Esta configuração era opcional durante a instalação automática. Se pretender registar os tempos limite das solicitações e outros erros, pode criar um ficheiro de registo com permissões de escrita. Neste exemplo, o ficheiro de registo foi colocado no mesmo diretório que os outros ficheiros do NeverBlock.

Depois de criar este ficheiro (lembre-se de garantir que tem permissões de escrita), atualizaremos o backend_loader.php para definir o caminho. No início do ficheiro, LOGFILE estará definido como NULL e deverá ser atualizado para definir o caminho do novo ficheiro de registo, assim:

Depois de fazer isto, podemos voltar a executar o diag.php. Se o ficheiro tiver sido criado e o caminho definido corretamente, veremos agora o seguinte.

Armazenamento em cache

Esta configuração era opcional durante a instalação automática. O armazenamento em cache pode melhorar significativamente os tempos de resposta dos anúncios. Se não tiver APC ou XCache, que são suportados por predefinição pelo backend_loader.php , recomenda-se configurar uma cache em ficheiro. Para tal, tem de configurar um diretório com permissões de escrita para o PHP e definir o respetivo caminho como valor da constante WRITABLE_PATH no backend_loader.php. Se esta constante estiver definida, a cache em ficheiro será utilizada por predefinição em vez de qualquer outra cache (mesmo que tenha APC ou XCache).

Chaves de identificação

Se tiver utilizado a instalação automática , esta configuração já foi feita durante a instalação. Estas chaves são utilizadas para encriptação, a fim de impedir a adulteração dos URLs dos banners. Recomenda-se vivamente que altere os valores de ambas as chaves, KEY_1 e KEY_2 em backend_loader.php para cadeias únicas.

Cookies

Os cookies são utilizados para garantir que o NeverBlock está a funcionar como esperado.

  • yuo1 - o nome predefinido deste cookie é yuo1, e este nome pode ser configurado em frontend_loader.js. Este cookie também pode ser desativado definindo no_cookie: true.

  • zone-closed- - Este cookie garante que a zona permanece fechada se o utilizador a tiver fechado com o adBlock ativado e, em seguida, desativado o adBlock.

Configurar constantes

Existem algumas constantes definidas em backend_loader.php. Recomenda-se mantê-las como estão, mas, em alguns casos, pode ser útil alterar algumas das configurações.

  • CONNECT_TIMEOUT_MS - o tempo limite de ligação, em milissegundos, utilizado para pedidos curl/fsock.

  • REQUEST_TIMEOUT_MS - o tempo limite total do pedido, em milissegundos (inclui também o tempo de CONNECT_TIMEOUT_MS), utilizado para pedidos curl/fsock.

  • LOGFILE - o caminho para um ficheiro com permissão de escrita onde serão registadas mensagens, como alguns erros e situações em que os pedidos excedem o tempo limite.

  • ALLOW_MULTI_CURL - sempre que possível, o script tenta utilizar curl_multi_exec. Se isso sobrecarregar a CPU, pode ser desativado.

Definições de cache do XCache, APC e ficheiros:

  • WRITABLE_PATH - caminho para um diretório com permissão de escrita, que conterá os ficheiros de cache. (Se estiver definido, a cache de ficheiros será a cache predefinida.)

  • CACHE_INTERVAL_BANNERS - duração da cache das imagens de banners (em segundos); se for definido como 0, as imagens NÃO serão guardadas em cache.

  • CACHE_INTERVAL_SCRIPTS - duração da cache dos ficheiros JavaScript; se for definido como 0, não serão guardados em cache.

  • CACHE_KEYS_LIMIT_BANNERS - limite do número de imagens de banners que podem ser guardadas em cache (para evitar o uso excessivo dos recursos do editor); se for definido como 0, não haverá limite e todas as imagens serão guardadas em cache.

Se configurar algumas regras de reescrita do Apache/nginx para aceder a backend_loader.php através de outros URIs:

  • LINK_URL_PREFIX - se estiver definido, passará a ser o novo URI das ligações de clique no frontend (o hash do URL para redirecionamento será acrescentado ao URI)

  • BANNER_URL_PREFIX - se estiver definido, passará a ser o novo URI das imagens de banners no frontend (o hash do banner específico será acrescentado ao URI)

  • KEY_1 - chave secreta para impedir a adulteração dos URLs dos banners (estes são agora enviados de volta ao carregador do backend no pedido)

  • KEY_2 - chave secreta para impedir a adulteração dos URLs dos banners (estes são agora enviados de volta ao carregador do backend no pedido)

NeverBlock PHP - Apresentar anúncios

Adicionar zonas a uma página

Se estiver a utilizar uma aplicação de página única, Carregamento dinâmico será obrigatório implementá-lo.

São suportados os seguintes formatos de anúncios:

  • Banners

  • Anúncios nativos

  • Banners fixos

  • Mensagens instantâneas

Os anúncios multiformato ainda não são suportados. No entanto, pode continuar a utilizar o NeverBlock com os banners individuais que configurou para utilização em anúncios multiformato. Assim, pode utilizar anúncios multiformato para utilizadores comuns e banners compatíveis com o NeverBlock para alcançar utilizadores com bloqueadores de anúncios.

Tenha em atenção que este script só apresenta anúncios quando o utilizador tem um bloqueador de anúncios instalado e ativado. Não remova quaisquer etiquetas de publicidade padrão existentes.

Neste exemplo, vamos utilizar a configuração descrita em Mudar o nome dos ficheiros. Certifique-se de que os caminhos e os nomes dos ficheiros correspondem à sua configuração.

Passo 1 - Colocar frontend_loader.js na página

Dentro da etiqueta <body> da sua página, no início, adicione o seguinte:

Este elemento deve ser incluído na página apenas uma vez. Também deve estar acima de todos os outros scripts de zonas.

Passo 2 - Adicionar uma zona NeverBlock

Os seguintes trechos de código servem para declarar as suas zonas de anúncios. Devem ser colocados no DOM onde pretende que a zona seja apresentada. Pode adicionar vários blocos de banners como este numa página. Tenha cuidado para não os colocar em divs com classes ou estilos específicos relevantes para a apresentação de anúncios, pois esses divs serão visados pelos bloqueadores de anúncios (por exemplo, class="ad-footer", style="width:300px;height:250px;").

Para adicionar uma zona de anúncios, faça o seguinte (não se esqueça de substituir o valor de idzone pelo ID da sua zona):

Passo 3 - Apresentar os anúncios (backend_loader.php)

Depois de incluir todas as declarações addZone() , queremos apresentar os anúncios. Para tal, utilizaremos a função serve . Esta função apresenta os dados de todas as zonas de anúncios declaradas anteriormente e normalmente só deve ser chamada uma vez na página. O número máximo de zonas que podem ser chamadas numa página é 20. As exceções a esta regra ocorrem ao carregar uma página dinamicamente, conforme descrito em Carregamento dinâmico.

Carregamento dinâmico (aplicações de página única)

É possível passar uma referência a um elemento do DOM que servirá de contentor ao qual o banner será acrescentado. Assim, quando serve for chamado, saberá onde colocar a zona de anúncios. Faça o seguinte:

Também é possível chamar serve() com o sinalizador force para apresentar os anúncios no momento que escolher (por exemplo, numa função após apresentar parte da página), em vez de o fazer quando a página é carregada:

A função serve() pode ser chamada várias vezes. Após cada serve() chamada, o ExoLoader será limpo dos dados anteriores addZone() chamadas. Portanto, apenas os banners para os quais chamar addZone() após um serve serão apresentados no próximo serve().

Domínio base

Se já for cliente da ExoClick, poderá ter zonas de anúncios normais no seu site. Se estiver a utilizar um domínio diferente de *.exoclick.com (por exemplo, ads.exosrv.com), deverá definir domain_base do objeto detector (ExoLoader.getDetector()) como “exosrv.com” antes da primeira chamada a addZone. Faça-o conforme ilustrado abaixo:

Os anúncios não são apresentados

Se não forem apresentados anúncios, comece por verificar o ficheiro diag.php para ver se alguma configuração está incorreta. Se todos os testes forem bem-sucedidos, crie uma página de teste com apenas uma zona para garantir que funciona isoladamente. Se, nesta fase, continuarem a não ser apresentados anúncios, consulte a secção Ajuda para mais informações.

NeverBlock PHP - Ajuda

Os meus anúncios não são apresentados. O que devo fazer?

Confirme que está a utilizar a versão mais recente do código da solução anti-adblock.

Estamos constantemente a trabalhar para melhorar a solução com base nos nossos testes, no feedback dos clientes e nas alterações dos bloqueadores de anúncios. As versões mais antigas ainda podem ter alguns problemas que já corrigimos. Por isso, antes de verificar os outros pontos abaixo, certifique-se de que está a utilizar a versão mais atualizada.

Já executou diag.php?

O ficheiro poderá indicar se há algum problema com a configuração do carregador no back-end.

Verifique o separador “Rede” na barra “Ferramentas de programador” do Chrome/FF.

O ficheiro frontend_loader.js está a carregar corretamente?

Talvez seja necessário especificar um caminho diferente.

  • Experimente usar o caminho completo em src em vez de “/frontend_loader.js”

  • Verifique se ExoLoader.addZone() é chamada antes de ExoLoader.serve()

  • Verifique o separador “Consola” na barra “Ferramentas de programador” do Chrome/FF. Poderão existir erros relacionados com frontend_loader.js

  • Execute ExoLoader.getDebug(); na consola JavaScript para ver o que está a acontecer. O resultado deverá ser semelhante a este:

Verifique os IDs das zonas.

Certifique-se de que a zona correspondente ao idzone fornecido existe e lhe pertence.

Está a colocar códigos de anúncios em iframes?

O conteúdo dos iframes é carregado depois da página principal. Se chamar addZone() num iframe e chamar serve() na página principal, o serve() será executado antes de addZone(), e não funcionará. Existem duas formas de usar iframes:

  1. Inclua tudo dentro de um iframe: todo o código dos passos 1, 2 e 3 de Adicionar zonas a uma página tem de estar dentro dele. Mas, se houver vários iframes deste tipo numa página, poderá ocorrer um conflito, uma vez que esta solução usa um cookie. Se o nome do cookie for igual, os anúncios nos iframes podem misturar-se. Pode alterar o nome do cookie antes de chamar serve, assim:

A desvantagem é que terá de ter vários carregadores de back-end, nos quais também definirá nomes de cookies diferentes:

  1. Tenha o código do passo 1 (a inclusão do ficheiro do carregador de front-end) na página principal do seu site. Dentro dos iframes, chame addZone. Para obter corretamente o objeto ExoLoader, terá de atualizar a chamada padrão para usar window.top.document.dispatchEvent; além disso, passe para addZone o parâmetro doc que apontará para a propriedade document do seu iframe:

Também dentro do último iframe, chame serve():

Está a usar uma framework JavaScript no front-end do seu site?

Confirme que não está a substituir o innerHTML dos elementos onde tem chamadas a addZone() A addZone() chamada coloca um marcador de posição DOM no local onde é efetuada. Se algo o substituir, o script não conseguirá preenchê-lo com dados de anúncios.

O backend_loader.php está a devolver uma resposta vazia?

Se sim, verifique o registo de erros do PHP para detetar possíveis erros relacionados. Depois de abrir uma página com o código do ExoLoader, abra: http://yoursite/backend_loader.php?exoDebug=exoDebug. Se forem apresentados erros de curl/fsock por tempo limite, poderá ter de aumentar os valores de CONNECT_TIMEOUT_MS e REQUEST_TIMEOUT_MS em backend_loader.php.

Os anúncios são apresentados, mas as estatísticas não mostram cliques ou impressões

Está a usar o CloudFlare ou os seus servidores Web estão a passar por proxy de outro serviço?

Os pedidos de anúncios do NeverBlock não vão diretamente para o nosso servidor a partir do navegador do utilizador final, por isso dependemos do backend_loader.php do lado do editor para nos transmitir o IP do utilizador. Obtemo-lo através de $_SERVER['REMOTE_ADDR'] neste script, a partir da variável global do PHP. Se a infraestrutura do editor estiver configurada de forma a não fornecer aí um IP correto do utilizador, poderá ocorrer um problema de impressões ou cliques inválidos. Para o corrigir, consulte Transmitir endereços IP.

No modo privado do Firefox (ou de outro navegador), são apresentados anúncios NB e anúncios normais

Verifique se a definição domain_base está configurada corretamente.

Aqui pode encontrar um exemplo de configuração da base do domínio. O problema é que alguns navegadores, sobretudo o FF, bloqueiam no modo privado os pedidos a determinados domínios. Por exemplo, o Exoclick.com foi colocado numa lista negra. Assim, se o código da zona normal contiver o domínio “exoclick.com”, o modo privado funciona como um bloqueador de anúncios e a solução NB deverá apresentar anúncios. No entanto, os nossos outros domínios poderão não ser bloqueados pelo modo privado. Para evitar a apresentação de anúncios duplicados, o detetor NB precisa de saber de que domínio são solicitados os anúncios, para detetar corretamente se os anúncios normais estão a ser bloqueados neste momento.

Como configuro o NeverBlock a partir de um domínio diferente?

  1. Em frontend_loader.js, aceda à função serve: function(params) e remova o comentário do conjunto de parâmetros.

  2. Adicione outro domínio e defina force: true e no_cookie: true:

  1. Em seguida, referencie na página o caminho do NeverBlock com o novo domínio.

Frontend_loader:

Backend_loader:

E se houver uma deteção falsa positiva de bloqueio de anúncios?

Por vezes, os utilizadores que têm o AdBlock desativado continuam a ver anúncios do NB apresentados juntamente com os anúncios normais. Isto pode acontecer porque o NB tenta incluir na página um script real de apresentação de anúncios, do tipo honeypot, para verificar se é bloqueado. Por vezes, em ligações lentas, demora demasiado tempo a carregar esse script e o NB pode considerar que foi bloqueado, decidindo assim solicitar os anúncios. Devido à forma como alguns bloqueadores de anúncios funcionam, não é possível saber se o carregamento ainda não terminou ou se nunca será concluído devido a um bloqueador. Isto não é um problema para a maioria dos sites e utilizadores. Se acontecer com uma parte significativa dos seus utilizadores, sugerimos que defina um tempo limite maior para a deteção do NB, usando a função setTimeout no ExoLoader, desta forma:

API do NeverBlock

O NeverBlock utiliza um endpoint simples para encaminhar pedidos para os servidores de distribuição da ExoClick.

Este endpoint está documentado abaixo e pode utilizá-lo para criar a sua própria integração personalizada na linguagem que preferir.

API v1

Esta versão da API suporta todos os formatos atualmente disponíveis para a solução NeverBlock (banners, banners fixos, anúncios nativos e mensagens instantâneas).

Pedido para uma única zona

Pedido para várias zonas

Os pedidos acima são semelhantes, exceto pelo facto de os pedidos para várias zonas terem de ser estruturados com uma notação de matriz incremental (por exemplo, zones[0][idzone], zones[1][idzone],…), conforme demonstrado.

Os pedidos para várias zonas estão limitados a um máximo de 20 zonas por pedido.

Parâmetros

Os seguintes parâmetros devem ser definidos para todos os pedidos:

  • zones[N][idzone] - ID da zona a solicitar

  • user_ip - endereço IP dos utilizadores finais (utilizado para a segmentação)

Cabeçalhos

Os seguintes cabeçalhos devem ser definidos para todos pedidos:

  • X-Forwarded-For - Endereço IP de origem do cliente

  • Referer - Endereço do site de referência

  • User-Agent - Identificador do cliente

  • Accept-Language - Idioma e região do cliente

Resposta

Os payloads JSON devolvidos pelos exemplos acima são os seguintes.

Resposta de zona única:

Resposta de várias zonas:

Dados da resposta

Os seguintes valores podem ser extraídos de zonas objeto para cada zona no payload JSON devolvido, para efeitos de apresentação de anúncios:

  • idzone: Identificador da zona (útil para distinguir os pedidos de zona durante o processamento)

  • type: Tipo de anúncio; em renderers é possível obter o script de renderização predefinido correspondente. (O script de renderização predefinido espera que o objeto ExoLoader esteja disponível no seu âmbito)

  • data: Os dados do anúncio específicos do tipo de anúncio em questão. Na maioria dos casos, image e url podem ser encontrados em tipos de banners e semelhantes; alguns têm parâmetros adicionais.

Se utilizar a API, cabe-lhe escrever o código que gera o DOM a apresentar no front-end, com base nos dados fornecidos. Os nossos renderizadores predefinidos são os scripts responsáveis por esta tarefa, como parte da solução NeverBlock predefinida (instalação php + javascript). Só podem ser utilizados com o objeto JavaScript ExoLoader, que armazena internamente as respostas pós-processadas no seu próprio formato e disponibiliza várias funções auxiliares que os renderizadores utilizam e esperam que estejam definidas.

API v0

Esta versão da API só suporta banners. Devolverá false para zonas de qualquer outro tipo.

Pedido para uma única zona

Pedido para várias zonas

Os pedidos acima são semelhantes, exceto pelo facto de os pedidos para várias zonas terem de ser estruturados com uma notação de matriz incremental (por exemplo, zones[0][idzone], zones[1][idzone],…), conforme demonstrado.

Os pedidos para várias zonas estão limitados a um máximo de 20 zonas por pedido.

Parâmetros

Os seguintes parâmetros devem ser definidos para todos os pedidos:

  • zones[N][idzone] - ID da zona a solicitar

  • user_ip - endereço IP dos utilizadores finais (utilizado para a segmentação)

Cabeçalhos

Os seguintes cabeçalhos devem ser definidos para todos pedidos:

  • X-Forwarded-For - Endereço IP de origem do cliente

  • Referer - Endereço do site de referência

  • User-Agent - Identificador do cliente

  • Accept-Language - Idioma e região do cliente

Resposta

Os payloads JSON devolvidos pelos exemplos acima são os seguintes.

Resposta de zona única:

Resposta de várias zonas:

Dados da resposta

Os seguintes valores podem ser extraídos do payload JSON devolvido, para efeitos de apresentação de anúncios:

  • url: URL de clique a utilizar para envolver a imagem do banner

  • imgurl: URL de origem da imagem do banner

  • idzone: Identificador da zona (útil para distinguir os pedidos de zona durante o processamento)

Proxy NeverBlock

O que é?

O Proxy NeverBlock é uma aplicação multiplataforma destinada a gerir pedidos à API e a armazenar anúncios em cache. Este serviço é executado em segundo plano para fornecer ao utilizador um ponto final mais direto através do qual pode obter anúncios. Não se recomenda optar pelo Proxy NeverBlock em vez da solução NeverBlock PHP padrão, uma vez que é menos abrangente.

Por vezes, os bloqueadores de anúncios visam agressivamente os sites, o que pode fazer com que o NeverBlock PHP deixe de funcionar. Se isto acontecer no seu site, considere utilizar o Proxy NeverBlock.

Transferir o Proxy NeverBlock

Transfira um arquivo pré-compilado para a sua plataforma específica:

Os ficheiros necessários para executar os anúncios NeverBlock são:

  • neverblock-conf.toml

  • redirect.html

  • neverblock-proxy

Configuração do proxy

Coloque os ficheiros no servidor

Depois de transferir os ficheiros, pode colocá-los num diretório do servidor, como mostrado na captura de ecrã abaixo:

Criar a cache

Crie um diretório com permissões de escrita para armazenar os ficheiros transferidos. Pode criá-lo na mesma pasta, uma vez que definiremos o caminho mais adiante.

Atualizar a configuração obrigatória

No início do ficheiro neverblock-conf.toml há uma secção identificada como Obrigatório. Nesta secção, definiremos os caminhos com base na configuração mostrada nas capturas de ecrã acima. Tenha em atenção que os caminhos serão específicos da sua configuração.

Iniciar o serviço

Inicie o binário a partir de uma linha de comandos/terminal — tem de o fazer dentro do diretório onde se encontra. Isto iniciará o serviço e poderá então fazer pedidos curl a localhost na porta 8080.

Utilização

É utilizado um pedido cURL para obter as zonas. Este pedido pode ser implementado na linguagem que preferir. O pedido cURL devolverá um payload JSON com um URL de clique e o caminho para a imagem correspondente. A imagem também terá sido transferida para o caminho especificado. Ao fornecer user_ip tenha em conta os pontos indicados em Transmitir endereços IP. A estrutura deste pedido é a seguinte:

Com esta estrutura, podemos ver um exemplo da sua utilização em PHP:

Configuração opcional

Existem várias configurações opcionais em neverblock-conf.toml:

  • debug - Ativar o modo de depuração

  • port - Porta em que o serviço escuta

  • log - Registo da aplicação

  • http_timeout - Tempo limite do pedido HTTP (segundos)

  • cache_ttl - Tempo de vida (minutos) dos ficheiros em cache

  • cache_purge_frequency - Intervalo entre execuções da limpeza da cache (minutos)

  • syndication - URL de distribuição do Exoclick. Consulte Domínio base para saber em que situações deve alterá-lo

Opções

Estão disponíveis opções para substituir o ficheiro de configuração:

Plugin do WordPress

Instalação do plugin

O plugin pode ser transferido através da seguinte ligação:

A instalação do plugin NeverBlock para WordPress não é diferente da de qualquer outro plugin. No menu, selecione Plugins -> Carregar plugin -> selecione o plugin NeverBlock para instalar.

Passo 1 - Introdução

A primeira página do assistente de instalação não requer qualquer informação.

Passo 2 - Requisitos do sistema

Neste passo, veremos os resultados dos testes à configuração. Os resultados apresentados podem variar consoante a sua configuração.

Para mais informações sobre cada um destes testes, os resultados e a execução manual, consulte estas secções: Executar o diag.php e Possíveis resultados do diag.php.

Passo 3 - Definições do plugin

Na secção de configuração do NeverBlock PHP, existe uma secção sobre Configurar constantes. O passo 3 do assistente de instalação permite-lhe configurar estas definições. Os detalhes de cada uma são apresentados na secção correspondente e também na captura de ecrã abaixo.

Estas configurações podem ser alteradas a qualquer momento após a instalação.

Passo 4 - Concluído

Quando a instalação estiver concluída, verá a opção NeverBlock no menu. Aqui, podemos optar por alterar as definições do plugin sempre que necessário:

Adicionar zonas no WordPress

Há duas formas de adicionar zonas NeverBlock à sua página WordPress.

Códigos curtos

No TinyMCE, ao criar ou editar uma publicação, basta adicioná-la da seguinte forma, certificando-se de que utiliza o idzone correto:

Em alternativa, utilize o seguinte exemplo num modelo de tema:

Tenha em atenção que existe um atributo opcional container_id que pode ser utilizado para referenciar o ID de um nó DOM. Este irá anexá-lo à div correspondente. Para que funcione, a div tem de estar presente antes do código curto; caso contrário, o NeverBlock não encontrará o elemento.

Scripts tradicionais

Ao editar um modelo de tema, pode utilizar os scripts padrão descritos em Apresentar anúncios.

Registo de alterações

Consulte o ficheiro CHANGELOG incluído no pacote de software.

Registo de alterações do NeverBlock PHP

3.14 (21.10.2026)

  • O carregador de backend do NeverBlock não consegue apresentar anúncios localmente, mesmo após a correção dos avisos de PHP obsoleto e da deteção de IP

3.12 (10.01.2025)

  • Corrigido o problema em que Neverblock > diag.php devolvia sempre “Can’t access service to compare IPs” na deteção de IP

3.11 (11.07.2023)

  • Corrigida a compatibilidade com PHP 5.2 e versões posteriores

3.10 (12.01.2022)

  • Adicionado um parâmetro que pode ser utilizado para compatibilidade futura

  • Adicionado suporte para o formato WebP

3.9 (03.12.2021)

  • Adicionado um tempo limite à deteção para evitar falsos positivos em ligações lentas

3.8 (10.06.2021)

  • Removido o código relacionado com popunders (o método inline é o preferido) e um cookie desnecessário

3.7 (05.07.2019)

  • Algumas medidas contra o filtro “anti-cv”

3.6 (16.05.2019)

  • Removida a referência ao objeto JS, que por vezes é bloqueada

  • Nova API de deteção de IP no diag (com suporte para IPv6)

3.5 (14.03.2019)

  • Adicionada funcionalidade para remover anúncios parcialmente bloqueados

  • Adicionado o parâmetro no_cookie para permitir alojar backend_loader.php noutro domínio

  • Adicionado suporte para cache ACPU

3.4 (09.07.2018)

  • Melhorar a deteção (aguardar pelo carregamento da página)

3.3 (25.05.2018)

  • Atualizar a ligação da documentação para a passagem de IPs

  • Corrigir a substituição de window.ExoLoader que causa erros com alguns bloqueadores (uBlock)

  • Substituir o antigo serviço de deteção de IP

3.2 (15.03.2018)

  • Corrigir erro com PHP <= 5.3

3.1 (07.03.2018)

  • Aleatorizar automaticamente os nomes dos parâmetros do banner e da ligação e adicionar um controlo mais flexível

  • Corrigir erro de JS se serve() for chamado várias vezes

3.0 (30.01.2018)

  • Introduzido o conceito de renderizadores solicitados

  • Adicionados novos formatos de anúncios: anúncio nativo, banner fixo, mensagem instantânea para web e dispositivos móveis

  • Atribuição dinâmica de nomes ao objeto ExoLoader caso este seja tornado imutável por bloqueadores de anúncios

  • Pequenas alterações para facilitar o instalador phar e o plug-in do WordPress

  • A versão do PHP é verificada automaticamente para multi curl

2.25 (12.10.2017)

  • Corrigir a verificação de alterações no texto do corpo da resposta no pedido de anúncios de diagnóstico

  • Registar os erros devolvidos pelo servidor de anúncios

  • Corrigir os diagnósticos de deteção de IP (usar a configuração de backend_loader.php)

2.24 (15.08.2017)

  • Verificar a deteção de IP no script de diagnóstico

  • Possibilidade de alojar backend_loader.php noutro domínio

2.22 (13.06.2017)

  • Deteção: impedir que os estilos box-sizing do site influenciem os parâmetros da armadilha DOM

2.21 (09.06.2017)

  • Resolver o problema dos falsos positivos durante a deteção de bloqueadores de anúncios

2.20 (01.06.2017)

  • Deteção de bloqueadores alterada

  • Corrigir o problema em que várias execuções de serve() substituíam o cookie umas das outras

2.19 (24.05.2017)

  • Resolver o problema com campanhas de exchange e banners 404

  • Pequenas correções para a versão 5.2 do PHP

2.18 (07.04.2017)

  • Enviar o cabeçalho correto para JavaScript no caso de validação rigorosa de cabeçalhos

2.17 (27.03.2017)

  • Corrigir o erro de interface em versões mais antigas do PHP em backend_loader.php

  • Corrigir o problema da ligação aberta em frontend_loader.php quando LINK_URL_PREFIX está especificado

2.16 (14.03.2017)

  • Permitir adicionar zonas dinamicamente, não apenas ao carregar a página

  • Adicionar a referência do contentor como parâmetro de addZone

2.15 (08.03.2017)

  • Adicionar cache de ficheiros.

  • Reduzir a quantidade de dados transferidos.

  • Carregar banners através de <img>, em vez de um estilo de fundo base64.

2.14 (30.09.2016)

  • Corrigir resolveMulti para devolver sempre um array

2.13 (14.09.2016)

  • Passar corretamente os parâmetros POST para openLink

2.12 (12.09.2016)

  • Mover completamente os estilos inline para classes CSS

2.11 (09.09.2016)

  • Corrigir o problema de document.contains não definido no IE

2.10 (07.09.2016)

  • Corrigir problemas de conectividade IPv6 + curl

  • Corrigir problemas com ligações de clique incorretas devido a aliases do lado do servidor

2.9 (02.09.2016)

  • Alterar o mecanismo de abertura de ligações para redirecionar através do backend loader

2.8 (30.08.2016)

  • Resolver o problema dos anúncios HTTPS com resolução e cache DNS fora do curl

2.7 (22.08.2016)

  • Mudar os endpoints de anúncios para HTTPS para evitar problemas de conteúdo misto

2.6 (17.08.2016)

  • Marcador de posição DOM mais genérico para banners

  • Corrigir o problema com os cabeçalhos

  • Separar os erros das mensagens de depuração no frontend loader

  • Instruções de resolução de problemas

2.5 (02.08.2016)

  • Introduzir registos para pedidos que excedem o tempo limite e outros erros

  • Corrigir erro de JS quando algo substitui o marcador de posição DOM do anúncio

2.4 (22.07.2016)

  • Melhores tempos limite

  • Ficheiro de diagnóstico e melhor depuração

2.3 (20.07.2016)

  • Corrigido um pequeno problema ao fazer um pedido ao carregador do backend quando não tinham sido adicionadas zonas

2.2 (15.07.2016)

  • Novo domínio para o ponto final de anúncios, com melhor balanceamento de carga

2.1 (27.06.2016)

  • Corrigida a incompatibilidade com a framework Prototype

2.0 (14.06.2016)

  • Lançamento aberto

  • Um único pedido para vários anúncios

  • Carregador unificado para banners

Registo de alterações do NeverBlock Proxy

1.0.1

  • Permite incluir o idioma e o referenciador no pedido

  • Exemplos atualizados

1.0.0

  • Lançamento inicial

Última atualização

Isto foi útil?