> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md).

# Neverblock

## Visão geral

### Anti-Adblock

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

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

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

Esta solução é gratuita para todos os clientes da ExoClick e consiste num processo simples de inserção de 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. Será abordada com maior detalhe nesta documentação.
* **NeverBlock API** - Quando é necessária uma linguagem não suportada, a API disponibiliza os endpoints necessários para obter os anúncios diretamente. Utilizar quando forem necessárias soluções manuais.
* **NeverBlock Proxy** - Uma aplicação multiplataforma destinada a tratar pedidos à API e a colocar anúncios em cache. Este serviço é executado em segundo plano para disponibilizar ao utilizador um endpoint 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 NeverBlock Phar Installer é uma ferramenta que ajuda a instalar a solução NeverBlock PHP (versão 3.0). Pode ser utilizado em alternativa aos passos descritos em [Instalação manual](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#neverblock-php-manual-installation). Instalará os ficheiros no diretório especificado ou num diretório **nb** predefinido. O instalador tratará de parte da configuração, incluindo a [mudança do nome dos ficheiros](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#renaming-the-files-mandatory) e as [chaves de identificação](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#identification-keys).

### Transferir o instalador

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

* [neverBlockInstaller.phar.zip – v1.13](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FEb1X61WoFuzi12igYPH7%2FneverBlockInstaller.phar.zip?alt=media) (versão 3.14 do NeverBlock)

### Executar o instalador

Depois de transferir o 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 o valor predefinido. Também existe um parâmetro opcional para definir o ficheiro de registo utilizado, cuja finalidade é descrita na secção [Ficheiro de registo](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#logfile) .

```bash
# Criar e instalar os ficheiros no diretório predefinido 'nb' 
./neverBlockInstaller.phar
```

Parâmetros opcionais:

```bash
# Criar e instalar os ficheiros no diretório especificado
./neverBlockInstaller.phar --path=specific/path 

# Instalar os ficheiros no diretório atual
./neverBlockInstaller.phar --path=.

# Caminho para o ficheiro de registo
./neverBlockInstaller.phar --logfile=path/logfile

# Caminho para writable_path (caso o APC/APCu não esteja instalado)
./neverBlockInstaller.phar --writable_path=path/writable_path
```

### Analisar a resposta

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

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FREPgeFazdOI16fYxh5YQ%2Fneverblock_phar_1.png?alt=media)

**Resultados do diagnóstico**

Depois de executar o 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** para ser executado manualmente. Para obter mais detalhes sobre estes resultados e sobre 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 indicam os nomes do nosso **frontend\_loader.js** e do **backend\_loader.php**, que serão os caminhos a utilizar ao [Apresentar anúncios](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#adding-zones-to-a-page).

## NeverBlock PHP - Instalação manual

### Transferir os ficheiros

A instalação e a maioria da configuração podem ser feitas através do [instalador phar](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#neverblock-php-automatic-installation). 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:

* [latest.zip – v3.14](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FQc4BPMTtFCJkiX8CABYV%2Flatest.zip?alt=media)
* [latest.tar.gz – v3.14](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FbDMaTz3tFwlPsZMsexJe%2Flatest.tar.gz?alt=media)

Ou através dos seguintes comandos:

```bash
$ wget -q -O latest.tar.gz "https://59878909-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FbDMaTz3tFwlPsZMsexJe%2Flatest.tar.gz?alt=media"
$ tar -xf latest.tar.gz
$ rm latest.tar.gz
```

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 sejam imediatamente bloqueados pelos bloqueadores de anúncios, é necessário mudar-lhes o nome.

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2F55HNQN8HKZBXTikeTbzu%2Fneverblock_installation_3.png?alt=media)

Um dos testes em **diag.php** verifica a existência do **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. Atualize a seguinte linha no início da página:

```php
define("BACKEND_LOADER_PHP", "ba_lo.php");
```

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

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FsdZ2WF3MEXnQhvQW4Vj4%2Fneverblock_installation_1.png?alt=media)

### Executar o diag.php

Agora que os ficheiros NeverBlock estão no servidor, vamos utilizar o ficheiro **diag.php** para verificar se, até aqui, está tudo correto. Para isso, aceda 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 (vamos configurar o ficheiro de registo em [Ficheiro de registo](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#logfile)):

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FAInyqxCuza4Y04YbLhth%2Fneverblock_installation_2.png?alt=media)

Se os resultados forem 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 do PHP ou posterior.

**Presença do script de carregamento do backend:** Se este teste falhar, o **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órios de erros:** Isto pode surgir como um aviso. Este aviso não impedirá o funcionamento da solução NeverBlock.

**Presença da cache** e **Biblioteca cURL:** Se a cache e o cURL não estiverem disponíveis, serão apresentados avisos. Isto não impedirá o funcionamento do NeverBlock, mas recomendamos que os configure.

* A extensão PHP [cURL](https://www.php.net/manual/en/book.curl.php)   *(altamente recomendada)*
* A extensão PHP [APCu](https://www.php.net/manual/en/book.apcu.php) , ou uma cache de ficheiros (consulte [Caching](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#caching))

**Deteção de IP:** Se ocorrer um erro relacionado com a correspondência do IP, consulte [Passing IPs](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

**Pedidos de anúncios:** Se os pedidos demorarem mais do que o esperado, poderá ser-lhe pedido que aumente as definições **REQUEST\_TIMEOUT\_MS** e **CONNECT\_TIMEOUT\_MS**  . Este procedimento é explicado em [Configuring constants](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#configuring-constants).

## NeverBlock PHP - Configuration

### Passing IPs (using Cloudflare etc.)

Se estiver a utilizar um serviço, como o Cloudflare, que se encontra entre o utilizador e os seus servidores propriamente ditos, o IP detetado em **backend\_loader.php** poderá ser considerado inválido. Isto pode fazer com que os cliques ou as impressões dos anúncios sejam registados incorretamente. Para corrigir este problema, pode substituir o valor `$_SERVER["REMOTE_ADDR"]` passado à *UserEnvironment* classe em **backend\_loader.php** pelo valor correto fornecido pelo seu serviço de cache/proxy.

No caso do Cloudflare, passaríamos o parâmetro `$_SERVER["HTTP_CF_CONNECTING_IP"]` Segue-se um exemplo.

```php
isset($_SERVER['HTTP_CF_CONNECTING_IP']) ? $_SERVER['HTTP_CF_CONNECTING_IP'] : $_SERVER['REMOTE_ADDR']
```

Depois de fazer isto, o nosso *UserEnvironment* ficará assim:

```php
$userEnvironment = new UserEnvironment(
    isset($_SERVER['HTTP_CF_CONNECTING_IP']) ? $_SERVER['HTTP_CF_CONNECTING_IP'] : $_SERVER['REMOTE_ADDR'],
    isset($_SERVER['HTTP_X_FORWARDED_FOR']) ? $_SERVER['HTTP_X_FORWARDED_FOR'] : null,
    isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : null,
    isset($_SERVER['HTTP_REFERER']) ? $_SERVER['HTTP_REFERER'] : null,
    isset($_SERVER['HTTP_ACCEPT_LANGUAGE']) ? $_SERVER['HTTP_ACCEPT_LANGUAGE'] : null
);
```

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

```php
$userEnvironment = new UserEnvironment(
    isset($_SERVER['HTTP_X_REAL_IP']) ? $_SERVER['HTTP_X_REAL_IP'] : $_SERVER['REMOTE_ADDR'],
    isset($_SERVER['HTTP_X_FORWARDED_FOR']) ? $_SERVER['HTTP_X_FORWARDED_FOR'] : null,
    isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : null,
    isset($_SERVER['HTTP_REFERER']) ? $_SERVER['HTTP_REFERER'] : null,
    isset($_SERVER['HTTP_ACCEPT_LANGUAGE']) ? $_SERVER['HTTP_ACCEPT_LANGUAGE'] : null
);
```

Podemos agora executar novamente **diag.php**, se isto estava a causar a falha no teste de *Deteção de IP* , deveremos agora obter resultados bem-sucedidos.

### Ficheiro de registo

Esta foi uma configuração opcional durante a [Instalação automática](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#neverblock-php-automatic-installation). Se pretender registar tempos limite de pedidos 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 nossos outros ficheiros do NeverBlock.

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FziEt1tnKzsL0ED073dZh%2Fneverblock_configuration_2.png?alt=media)

Depois de criar este ficheiro (não se esqueça de garantir que tem permissões de escrita), vamos atualizar 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, da seguinte forma:

```php
define('LOGFILE', 'logfile');
```

Feito isto, podemos executar novamente o **diag.php**. Se o ficheiro tiver sido criado e o caminho definido corretamente, veremos agora o seguinte.

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2Fpl5roLivXkej6m3X5gyu%2Fneverblock_configuration_3.png?alt=media)

### Armazenamento em cache

Esta foi uma configuração opcional durante a [Instalação automática](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#neverblock-php-automatic-installation). O armazenamento em cache pode melhorar significativamente os tempos de resposta dos anúncios. Se não tiver APC ou APCu, que são suportados pelo **backend\_loader.php** por predefinição, recomenda-se configurar uma cache de ficheiros. Para isso, 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, será utilizada uma cache de ficheiros por predefinição, em vez de qualquer outra cache (mesmo que tenha APC ou APCu).

```php
define('WRITABLE_PATH', '/path/to/my/writeable_folder');
```

### Chaves de identificação

Se tiver utilizado a [Instalação automática](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#neverblock-php-automatic-installation) esta configuração já foi feita durante a instalação. Estas chaves são utilizadas para cifrar os dados e impedir a adulteração dos URLs dos banners. Recomenda-se vivamente que altere os valores de ambas as chaves, *KEY\_1* e *KEY\_2* no ficheiro **backend\_loader.php** para cadeias de caracteres exclusivas.

```php
define('KEY_1', "t8Sn7cvBv2n8duxUyrtUxqd6i+gAywzoNo72ItPEtdU=");
define('KEY_2', "zCeopESQfMDIVekZkytm52lbdnQ2iC2RgLuh3RAhexU=");
```

### 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](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#how-do-i-configure-neverblock-from-a-different-domain).
* **zone-closed-** - Este cookie garante que a zona permanece fechada se o utilizador a tiver fechado com o adBlock ativado e, em seguida, o tiver desativado.

### 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 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** - caminho para um ficheiro com permissões de escrita onde são registadas mensagens, como alguns erros e casos 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 desativar esta opção.

Definições da cache APC/APCu e de ficheiros:

* **WRITABLE\_PATH** - caminho para um diretório com permissões 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 dos banners (em segundos); se for definido como 0, as imagens NÃO serão colocadas em cache.
* **CACHE\_INTERVAL\_SCRIPTS** - duração da cache dos ficheiros JavaScript; se for definido como 0, estes NÃO serão colocados em cache.
* **CACHE\_KEYS\_LIMIT\_BANNERS** - limite do número de imagens de banners que podem ser armazenadas na cache (para evitar o uso excessivo dos recursos do publicador); se for definido como 0, não haverá limite e todas as imagens serão colocadas 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, será o novo URI das ligações de clique no frontend (o hash do URL para redirecionamento será acrescentado ao prefixo).
* **BANNER\_URL\_PREFIX** - se estiver definido, será o novo URI das imagens dos banners no frontend (o hash do banner específico será acrescentado ao prefixo).
* **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 - Apresentação de anúncios

### Adicionar zonas a uma página

Estes trechos são para o NeverBlock 3.14 e versões posteriores. Nas versões anteriores, utilize getexoloader em vez de getmsgloader.

{% hint style="info" %}
Se estiver a utilizar uma aplicação de página única, [Carregamento dinâmico](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#dynamic-loading-single-page-applications) será obrigatório implementá-lo.
{% endhint %}

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

* Banners
* Anúncios nativos
* Banners fixos
* Mensagens instantâneas

{% hint style="info" %}
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 normais e banners compatíveis com o NeverBlock para alcançar utilizadores com bloqueadores de anúncios.
{% endhint %}

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](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#renaming-the-files-mandatory). 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, adicione o seguinte no início:

```html
<script type="text/javascript" src="/nb/fro_lo.js"></script>
```

Este código deve ser incluído na página apenas uma vez. Também deve ficar antes 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 deste tipo 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 estas divs serão detetadas 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):

```html
<script type="text/javascript">
    (function () {
        function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;
        
        //O código para adicionar zonas pode ser colocado várias vezes na página
        ExoLoader.addZone({"idzone":"111"});
        
        //Para utilizar um sub ID, adicione um parâmetro sub numérico ao objeto passado a addZone
        //ExoLoader.addZone({"idzone":"111", "sub": "1"});
    })();
</script>
```

**Passo 3 - Apresentar os anúncios (backend\_loader.php)**

Depois de incluir todas as declarações *addZone()* pretendemos apresentar os anúncios. Para isso, vamos utilizar a função *serve* . Esta função disponibiliza dados para todas as zonas de anúncios declaradas anteriormente e **normalmente só deve ser chamada uma vez por página**. O **número máximo de zonas que podem ser chamadas numa página é 20**. As exceções são os casos em que uma página é carregada dinamicamente, descritos em [Carregamento dinâmico](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#dynamic-loading-single-page-applications).

```html
<script type="text/javascript">
    (function () {
        function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;
        
        ExoLoader.serve({"script_url":"/nb/ba_lo.php"});
    })();
</script>
```

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

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

```html
<script type="text/javascript">
    (function () {
        function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;
        
        ExoLoader.addZone({"idzone":"111", "container": document.getElementById('banner1_and_placeholder')});
    })();
</script>
```

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

```html
<script type="text/javascript">
    (function () {
        function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;
        
        ExoLoader.addZone({"idzone":"111"});
        ExoLoader.addZone({"idzone":"222"});
        ExoLoader.addZone({"idzone":"333"});
        ExoLoader.serve({"script_url":"/nb/ba_lo.php", "force": true});
    })();
</script>
  ...
<script type="text/javascript">
    (function () {      
        function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;

        ExoLoader.addZone({"idzone":"444", "container": document.getElementById('banner4_placeholder')});
        ExoLoader.serve({"script_url":"/nb/ba_lo.php", "force": true});
    })();
</script>
```

A função *serve()* pode ser chamada várias vezes. Após cada *serve()* a chamada a ExoLoader será limpa das chamadas anteriores *addZone()* . Assim, apenas os banners que chamar *addZone()* após uma chamada a serve serão apresentados na próxima *serve()*.

### Domínio base

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

```html
<script type="text/javascript" src="/nb/fro_lo.js"></script>
<script type="text/javascript">
    (function () {
        function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;
        
        ExoLoader.getDetector().domain_base = "exosrv.com";
    })();
</script>
...
<!-- First addZone call -->
<script type="text/javascript">
    (function () {
        function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;
        
        ExoLoader.addZone({"idzone":"111"});
    })();
</script>
```

### Não são apresentados anúncios

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, mesmo assim, não forem apresentados anúncios, consulte a secção [Ajuda](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#neverblock-php-help) para obter mais informações.

## NeverBlock PHP - Ajuda

### Os meus anúncios não estão a ser apresentados. O que devo fazer?

**Confirme que está a utilizar a versão mais recente do código da solução para bloqueadores de anúncios.**

Estamos constantemente a 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 podem ainda ter problemas que já corrigimos. Por isso, antes de verificar os pontos abaixo, certifique-se de que está a utilizar a versão mais recente.

**Executou o diag.php?**

Este ficheiro poderá indicar se existe algum problema na configuração do carregador no backend.

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

O seu **frontend\_loader.js** está a carregar corretamente?

**Talvez seja necessário especificar um caminho diferente.**

* Experimente indicar o caminho completo em src, em vez de “/frontend\_loader.js”
* Verifique se *ExoLoader.addZone()* é chamado **antes de** *ExoLoader.serve()*
* Verifique o separador “Consola” na barra das “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 será semelhante a este:

```
2016-08-05T09:29:21.804Z: addZone() banner 2140951 added
2016-08-05T09:29:21.918Z: serve() called
2016-08-05T09:29:22.049Z: renderBannerZones() called
2016-08-05T09:29:22.049Z: renderBannerZone() #0 called for zone 2140951
2016-08-05T09:29:22.051Z: serve() hosted script loaded
```

**Verifique os IDs das zonas.**

Certifique-se de que a zona com o idzone indicado 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()* no iframe e chamar *serve()* na página principal, o *serve()* será executado antes de *addZone()*, e não funcionará. Há duas formas de usar iframes:

1. Inclua tudo num iframe: todo o código dos passos 1, 2 e 3 de [Adicionar zonas a uma página](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#adding-zones-to-a-page) tem de estar dentro dele. No entanto, 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 mudar o nome do cookie antes de chamar serve, assim:

```javascript
(function () {
    function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;

    ExoLoader.cookie_name = "exo_zones1";

    ExoLoader.serve({"script_url":"http://yoursite/backend_loader1.php"});
})();
```

A desvantagem é que terá de ter vários carregadores de backend, nos quais também definirá nomes de cookie diferentes:

```php
define('ADS_COOKIE_NAME', 'exo_zones1');
```

2. Coloque o código do passo 1 (a inclusão do ficheiro do carregador de frontend) 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 a **doc** como parâmetro de addZone, apontando para a propriedade document do iframe:

```javascript
(function () {
    function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}
    window.top.document.dispatchEvent(event); var ExoLoader=myEl.el;

    ExoLoader.addZone({"idzone": 111, "doc": window.document});
    ExoLoader.addZone({"idzone": 111, "doc": window.document});
})();
```

Chame também serve() dentro do último iframe:

```javascript
(function () {
    function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}
    window.top.document.dispatchEvent(event);var ExoLoader=myEl.el;

    ExoLoader.serve({script_url: "/backend_loader.php"});
})();
```

**Está a usar uma framework JavaScript no frontend 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 é invocada. Se algo o substituir, o script não conseguirá preenchê-lo com dados dos anúncios.

**O backend\_loader.php está a devolver uma resposta vazia?**

Se sim, verifique o registo de erros do PHP para encontrar possíveis erros relacionados. Depois de abrir uma página com o código do ExoLoader, aceda a: `http://yoursite/backend_loader.php?exoDebug=exoDebug`. Se forem apresentados erros de tempo limite de *curl/fsock* , 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 nem impressões

**Está a usar o CloudFlare ou os seus servidores Web estão a ser encaminhados por proxy de outra forma?**

Os pedidos NeverBlock para os anúncios 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 publisher para nos fornecer 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 publisher estiver configurada de forma a não apresentar aqui o IP correto do utilizador, poderá haver problemas com impressões ou cliques inválidos. Para resolver, consulte [Transmitir endereços IP](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

### 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](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#domain-base) pode encontrar um exemplo de como configurar o domínio base. O problema é que, em alguns browsers, mais frequentemente no FF, o modo privado bloqueia pedidos a determinados domínios. Por exemplo, o Exoclick.com foi colocado na 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, na verdade, a solução NB deverá apresentar anúncios. No entanto, os nossos outros domínios podem não ser bloqueados pelo modo privado. Para evitar anúncios duplicados e permitir que o detetor NB detete corretamente se os anúncios normais estão ou não a ser bloqueados nesse momento, é necessário saber a partir de que domínio são pedidos.

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

1. Em *frontend\_loader.js*, aceda à função `serve: function(params)` e retire o comentário do conjunto de parâmetros.
2. Adicione outro domínio e defina `force: true` e `no_cookie: true`:

```javascript
    params = {
                 script_url: 'https://yourotherdomain.com/backend_loader.php',
                 force: true,
                 no_cookie: true
             }
```

3. Em seguida, faça referência ao caminho do NeverBlock com o novo domínio na página.

Frontend\_loader:

```html
<script type="text/javascript" src="https://yourotherdomain.com/frontend_loader.js"></script>
```

Backend\_loader:

```html
<script type="text/javascript">
(function () {      
    function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;

    ExoLoader.serve({"script_url":"https://yourotherdomain.com/backend_loader.php"});
        
})();
</script>
```

### E se a deteção de bloqueio de anúncios der um falso positivo?

Por vezes, os utilizadores que têm o AdBlock desativado continuam a ver anúncios 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, usado como honeypot, para verificar se é bloqueado. Por vezes, em ligações lentas, o carregamento desse script demora demasiado e o NB pode considerar que foi bloqueado, decidindo assim pedir os anúncios. Devido à forma como alguns bloqueadores de anúncios funcionam, não é possível determinar 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 a uma parte significativa dos seus utilizadores, sugerimos que aumente o tempo limite da deteção do NB com a função **setTimeout** no **ExoLoader**, desta forma:

```html
<script type="text/javascript">
    (function () {
        function randStr(e,t){for(var n="",r=t||"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",o=0;o<e;o++)n+=r.charAt(Math.floor(Math.random()*r.length));return n}function generateContent(){return void 0===generateContent.val&&(generateContent.val="document.dispatchEvent("+randStr(4*Math.random()+3)+");"),generateContent.val}try{Object.defineProperty(document.currentScript,"innerHTML",{get:generateContent}),Object.defineProperty(document.currentScript,"textContent",{get:generateContent})}catch(e){}var myEl={el:null};try{var event=new CustomEvent("getmsgloader",{detail:myEl})}catch(e){(event=document.createEvent("CustomEvent")).initCustomEvent("getmsgloader",!1,!1,myEl)}window.document.dispatchEvent(event);var ExoLoader=myEl.el;
          
        ExoLoader.setTimeout(200);
        ExoLoader.addZone({"idzone":"111"});
    })();
</script>
```

## API do NeverBlock

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

Este endpoint está documentado abaixo e pode utilizá-lo livremente 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**

```
https://syndication-adblock.exoclick.com/ads-multi.php?v=1&zones[0][idzone]=123456&user_ip=8.8.8.8
```

**Pedido para várias zonas**

```
https://syndication-adblock.exoclick.com/ads-multi.php?v=1&zones[0][idzone]=123456&zones[1][idzone]=654321&zones[2][idzone]=135790&user_ip=8.8.8.8
```

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 (*ou seja, zones\[0]\[idzone], zones\[1]\[idzone],…*), conforme demonstrado.

{% hint style="info" %}
Os pedidos para várias zonas estão limitados a um máximo de **20** zonas por pedido.
{% endhint %}

**Parâmetros**

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

* **zones\[N]\[idzone]** - *ID da zona a pedir*
* **user\_ip** - *endereço IP dos utilizadores finais (utilizado para segmentação)*

**Cabeçalhos**

Os seguintes cabeçalhos devem ser definidos para **todas as** solicitações:

* **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 localidade do cliente*

**Resposta**

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

Resposta de uma única zona:

```json
{
  "zones": [
    {
      "idzone":"123456",
      "type":"sticky_banner",
      "data": {
          "image":"http:\\/\\/static.exoclick.com\\/library\\/238804\\/29d31cb0a21c35619a8e34a52b895a1d18fe4eae.gif",
          "url":"http:\\/\\/main.dynsrvaba.com\\/click.php?data=IHwyMTY4Mzk5fHxodHRwJTNBJTJGJTJGd3d3LnNreXBlLmNvbXx8fDB8fDE1MTcyNTI1NzF8b2xkLnhoYW1zdGVyLmNvbXwxMC40Mi4wLjF8fDE4MTAwMjM1fDI4MjkyNTN8NTA4fHw0MXwyfDE1fDB8MHx8NDY4eDYwfDF8MHx8NWE2YjY1MTBhYWFlODEuNDg3MjYwNzIxNDY0MzgzNjM2fDB8fDF8MHx8MXwwfDB8ICB8fDF8MHwwfDB8MHwwfDB8MHx8fDB8T0t8YzcwYTVmNDcwZDQzMDFjMjIzNDExNTRjZWMzNDIyZTg%3D",
          "v_pos":"top",
          "h_pos":"left",
          "frequency_period":"1440",
          "width":"468",
          "height":"60"
      }
    }
  ],
  "renderers":{"sticky_banner":"http:\\/\\/ads.exoclick.com\\/nb\\/sticky_banner.js"}
}
```

Resposta de várias zonas:

```json
{
  "zones": [
    {
      "idzone": "123456",
      "type": "banner",
      "data": {
        "image": "http://static.exoclick.com/library/238804/98fe7c6aee5b7348ee3b1329a48e16b418c20251.gif",
        "url": "http://main.dynsrvaba.com/click.php?data=IHwyMTY4Mzk1fHxodHRwJTNBJTJGJTJGd3d3LnlhbmRleC5ydXx8fDB8fDE1MTcyNTM2MzV8b2xkLnhoYW1zdGVyLmNvbXwxMC40Mi4wLjF8fDE4MTAwMjI5fDI4MjkyNDV8NTA4fHw0MXwyfDE1fDB8MHx8MzAweDI1MHwxfDB8fDVhNmI2NTEwYWFhZTgxLjQ4NzI2MDcyMTQ2NDM4MzYzNnwwfHwxfDB8fDF8MHwwfCAgfHwxfDB8MHwwfDB8MHwwfDB8fHwwfE9LfGY5MDQwMGEyNzE4MDIyYjBkZDNmMjg0MmM0NGVhYzA2"
      }
    },
    {
      "idzone": "654321",
      "type": "instant_message",
      "data": {
        "image": "http://static.exoclick.com/library/238804/43a77757d684abc5ee93d8169c09f3b1c9bfb650.gif",
        "url": "http://main.dynsrvaba.com/click.php?data=IHwyMTY4Mzg5fHxodHRwJTNBJTJGJTJGd3d3LnlhbmRleC5ydXx8fDB8fDE1MTcyNTM2MzZ8b2xkLnhoYW1zdGVyLmNvbXwxMC40Mi4wLjF8fDE4MTAwMjIzfDI4MjkyNDl8NTA4fHw0MXwyfDE1fDB8MHx8MjUweDE1MHwxfDB8fDVhNmI2NTEwYWFhZTgxLjQ4NzI2MDcyMTQ2NDM4MzYzNnwwfHwxfDB8fDF8MHwwfCAgfHwxfDB8MHwwfDB8MHwwfDB8fHwwfE9LfDNmNzNkOWU3OGEwM2NkNGQ5MjI5ZGRiNDhkODJiYjdk",
        "frequency_period": "1440"
      }
    },
    {
      "idzone": "135790",
      "type": "sticky_banner",
      "data": {
        "image": "http://static.exoclick.com/library/238804/29d31cb0a21c35619a8e34a52b895a1d18fe4eae.gif",
        "url": "http://main.dynsrvaba.com/click.php?data=IHwyMTY4Mzk5fHxodHRwJTNBJTJGJTJGd3d3LnNreXBlLmNvbXx8fDB8fDE1MTcyNTM2MzZ8b2xkLnhoYW1zdGVyLmNvbXwxMC40Mi4wLjF8fDE4MTAwMjM1fDI4MjkyNTd8NTA4fHw0MXwyfDE1fDB8MHx8NDY4eDYwfDF8MHx8NWE2YjY1MTBhYWFlODEuNDg3MjYwNzIxNDY0MzgzNjM2fDB8fDF8MHx8MXwwfDB8ICB8fDF8MHwwfDB8MHwwfDB8MHx8fDB8T0t8YjFmZjRiMjMyMTkyOTJkNDZjYzMyMDFhYzA2N2YxYjY%3D",
        "v_pos": "top",
        "h_pos": "right",
        "frequency_period": "1440",
        "width": "468",
        "height": "60"
      }
    }
  ],
  "renderers": {
    "banner": "http://ads.vagrant.test/nb/banner.js",
    "instant_message": "http://ads.vagrant.test/nb/im.js",
    "sticky_banner": "http://ads.vagrant.test/nb/sticky_banner.js"
  }
}
```

**Dados da resposta**

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

* **idzone**: Identificador da zona (útil para distinguir pedidos de zonas 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 presente 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** estão presentes nos tipos banner e semelhantes a banner; alguns incluem 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 com 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 inclui várias funções auxiliares que os renderizadores utilizam e que esperam que estejam definidas.

### API v0

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

**Pedido para uma única zona**

```
https://syndication-adblock.exoclick.com/ads-multi.php?zones[0][idzone]=123456&user_ip=8.8.8.8
```

**Pedido para várias zonas**

```
https://syndication-adblock.exoclick.com/ads-multi.php?zones[0][idzone]=123456&zones[1][idzone]=654321&zones[2][idzone]=135790&user_ip=8.8.8.8
```

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 (*ou seja, zones\[0]\[idzone], zones\[1]\[idzone],…*), conforme demonstrado.

{% hint style="info" %}
Os pedidos para várias zonas estão limitados a um máximo de **20** zonas por pedido.
{% endhint %}

**Parâmetros**

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

* **zones\[N]\[idzone]** - *ID da zona a pedir*
* **user\_ip** - *endereço IP dos utilizadores finais (utilizado para segmentação)*

**Cabeçalhos**

Os seguintes cabeçalhos devem ser definidos para **todas as** solicitações:

* **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 localidade do cliente*

**Resposta**

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

Resposta de uma única zona:

```json
[ 
   { 
      "idzone":"123456",
      "url":"https:\\/\\/main.dynsrvaba.com\\/click.php?data=IHwyMDMyMTU4fHxodHRwJTNBJTJGJTJGdC5mcnR5aC5jb20lMkZhZmZfYyUzRm9mZmVyX2lkJTNEMTQ0NyUyNmFmZl9pZCUzRDE3MyUyNmFmZl9zdWIyJTNEJTdCY29udmVyc2lvbnNfdHJhY2tpbmclN0RfJTdCem9uZV9pZCU3RCUyNm5vcG9wfHx8MHx8MTUwODQzMTUzM3xwZXJmZWN0Z2lybHMubmV0fDg3LjE5OC4yNDkuMTU0fHwxNzI3ODUyMnwxMzc2NzAyfDUwOHx8NDF8M3wxNnwwfDB8fDMwMHgyNTB8MXwxfHw1ODU4MjRmYWFhMWFmMy41NzE5MDExODUzMzAwNDgxOXwxODcyNHx8MXwwfHwxfDB8MHwgIHx8MXwwfDB8MHwxfDc1MjEzMTR8MHwyOTY0NTc0fHx8T0t8NTM0YmY0MDdmMmUxMDM3NGZiZTBjMDIyZjZjNTFiNTE%3D",
      "imgurl":"https:\\/\\/static.exoclick.com\\/banners\\/148652\\/17918070509411500_1_xacd.gif"
   }
]
```

Resposta de várias zonas:

```json
[{
	"idzone": "123456",
	"url": "http:\\/\\/main.dynsrvaba.com\\/click.php?data=IHwyMDMyNDAyfHxodHRwJTNBJTJGJTJGb3B0aW1pc2VyLnRtdHJjay5jb20lMkYlM0Zncm91cF9pZCUzRDE2ODQlMjZzdWJpZCUzRCU3QmNvbnZlcnNpb25zX3RyYWNraW5nJTdEJTI2a2V5d29yZCUzRCU3QnpvbmVfaWQlN0R8fHwxODE4MTgxODE4MTh8fDE1MDg3NzIxOTl8b2xvbG8uY29tfDg3LjE5OC4yNDkuMTU0fHwxNzI4MDI0MHwyMTM3MjM3fDUwOHx8NDF8MnwxNnwwfDB8fDMwMHgyNTB8MXwwfHw1OTViODM5N2Q2YjZmOC45MjExMDU0MjE5MjgyOTYwMzN8MTg3MjR8fDF8MHx8MXwyNTc3OHwzNjQxOHwgIHx8MXwwfDB8MHwwfDc1MjEzMTR8MHwyOTY0NTc0fHx8T0t8M2RhMTYyNWM2YzJiOTI3ZDdmZjc3YzEyMDIzMDBkZTU%3D",
	"imgurl": "http:\\/\\/static.exoclick.com\\/banners\\/510942\\/17918091848105800_1_xacd.gif"
}, {
	"idzone": "654321",
	"url": "http:\\/\\/main.dynsrvaba.com\\/click.php?data=IHwyMDMyNDAyfHxodHRwJTNBJTJGJTJGb3B0aW1pc2VyLnRtdHJjay5jb20lMkYlM0Zncm91cF9pZCUzRDE2ODQlMjZzdWJpZCUzRCU3QmNvbnZlcnNpb25zX3RyYWNraW5nJTdEJTI2a2V5d29yZCUzRCU3QnpvbmVfaWQlN0R8fHwxODE4MTgxODE4MTh8fDE1MDg3NzIxOTl8b2xvbG8uY29tfDg3LjE5OC4yNDkuMTU0fHwxNzI4MDIyMnwyMTM3MjM3fDUwOHx8NDF8MnwxNnwwfDB8fDMwMHgyNTB8MXwwfHw1OTViODM5N2Q2YjZmOC45MjExMDU0MjE5MjgyOTYwMzN8MTg3MjR8fDF8MHx8MXwyNTc3OHwzNjQxOHwgIHx8MXwwfDB8MHwwfDc1MjEzMTR8MHwyOTY0NTc0fHx8T0t8NjdhMDM3Zjc2OGIyYTVmMWRhYjhkYTk0Njk4YTQ0ZWY%3D",
	"imgurl": "http:\\/\\/static.exoclick.com\\/banners\\/510942\\/17918091847332100_1_xask.gif"
}, {
	"idzone": "135790",
	"url": "http:\\/\\/main.dynsrvaba.com\\/click.php?data=IHwxNzU4MjI3fHxodHRwcyUzQSUyRiUyRnd3dy5jYXJ0b29udHViZS5jb20lMkZwMiUyRmluZGV4LnBocCUzRnQlM0RFWC0zMDB4MjUwLUlFLURlc2stUk9OfHx8MTgxODE4MTgxODE4fHwxNTA4NzcyMTk5fG9sb2xvLmNvbXw4Ny4xOTguMjQ5LjE1NHx8MTY3MDczNTZ8MjEzNzIzN3w1MDh8fDQxfDJ8MTZ8MHwwfHwzMDB4MjUwfDF8MHx8NTk1YjgzOTdkNmI2ZjguOTIxMTA1NDIxOTI4Mjk2MDMzfDE4NzI0fHwxfDB8fDF8MHwwfCAgfHwxfDB8MHwwfDB8NzUyMTMxNHwwfDI5NjQ1NzR8fHxPS3xkZmM4MTcwYzMyZjhkMDhmM2FhNTMxMjA4MjIyNThhMw%3D%3D",
	"imgurl": "http:\\/\\/static.exoclick.com\\/banners\\/41682\\/17713113437719500_1_xacd.gif"
}]
```

**Dados da resposta**

Os seguintes valores podem ser extraídos do payload JSON devolvido, para fins 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 pedidos de zonas durante o processamento)

## Proxy NeverBlock

### O que é?

O Proxy NeverBlock é uma aplicação multiplataforma concebida para processar pedidos à API e colocar anúncios em cache. Este serviço é executado em segundo plano para fornecer ao utilizador um ponto de acesso mais direto através do qual pode obter anúncios. Não se recomenda escolher o Proxy NeverBlock em vez da solução PHP padrão do NeverBlock, uma vez que não é tão abrangente.

Por vezes, os bloqueadores de anúncios visam os sites de forma agressiva, fazendo com que o NeverBlock PHP deixe de funcionar. Se isso acontecer no seu site, considere utilizar o Proxy NeverBlock.

### Transferir o Proxy NeverBlock

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

* [neverblock-proxy\_v1.0.1\_darwin\_386.tar.gz](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FpB7pWeraYosbq5FPjHpj%2Fneverblock-proxy_v1.0.1_darwin_386.tar.gz?alt=media)
* [neverblock-proxy\_v1.0.1\_darwin\_amd64.tar.gz](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FWUivayFhNymy71fk3QJ8%2Fneverblock-proxy_v1.0.1_darwin_amd64.tar.gz?alt=media)
* [neverblock-proxy\_v1.0.1\_linux\_386.tar.gz](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FDqC6cGd0LKpq0Vc7iRNJ%2Fneverblock-proxy_v1.0.1_linux_386.tar.gz?alt=media)
* [neverblock-proxy\_v1.0.1\_linux\_amd64.tar.gz](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FtSRLFwzdmRH5bOF2zhoG%2Fneverblock-proxy_v1.0.1_linux_amd64.tar.gz?alt=media)
* [neverblock-proxy\_v1.0.1\_windows\_386.tar.gz](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FmujYyqexiNC9pI2EQ0hp%2Fneverblock-proxy_v1.0.1_windows_386.tar.gz?alt=media)
* [neverblock-proxy\_v1.0.1\_windows\_amd64.tar.gz](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FwaGUbLehUE4YWdFO9yEx%2Fneverblock-proxy_v1.0.1_windows_amd64.tar.gz?alt=media)
* [neverblock-proxy\_v1.0.1\_freebsd\_386.tar.gz](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FgOcXuPP3IYYs0sRouWld%2Fneverblock-proxy_v1.0.1_freebsd_386.tar.gz?alt=media)
* [neverblock-proxy\_v1.0.1\_freebsd\_amd64.tar.gz](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FcgLlblKswcpvrkqYq7Om%2Fneverblock-proxy_v1.0.1_freebsd_amd64.tar.gz?alt=media)
* [Código-fonte (zip)](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2Fjs3iKFWD2UJ9wHao2JbJ%2Fneverblock-proxy-1.0.1.zip?alt=media)
* [Código-fonte (tar.gz)](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FUaPDpukcQjp8WNZEFHAc%2Fneverblock-proxy-1.0.1.tar.gz?alt=media)

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

* **neverblock-conf.toml**
* **redirect.html**
* **neverblock-proxy**

### Configuração do proxy

**Colocar os ficheiros no servidor**

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

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FSBQwdGZNe43QO6HCTXRW%2Fneverblock_nbproxy_1.png?alt=media)

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

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FdLKtaVP6n20wZWlsL5uf%2Fneverblock_nbproxy_2.png?alt=media)

**Atualizar a configuração obrigatória**

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

```toml
#####################
#     Obrigatória     #
#####################

## Caminho da cache (ATENÇÃO: TODOS os ficheiros aqui serão eliminados em intervalos regulares!)
cache_path = "nb-cache/"

## Caminho relativo para a cache a partir da raiz de publicação Web (por exemplo, "images/cache/"; por predefinição, será usado cache_path se não for definido)
www_cache_path = "nb-proxy/nb-cache/"

## Caminho e nome do ficheiro HTML de redirecionamento (relativo à raiz de publicação Web — por exemplo, "misc/redirect.html")
www_redirect_path = "nb-proxy/redirect.html"
```

**Iniciar o serviço**

Inicie o binário numa linha de comandos/terminal — tem de o fazer no diretório onde este se encontra. Isto iniciará o serviço e deverá então poder fazer pedidos cURL ao 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 um caminho para a imagem correspondente. A imagem também será transferida para o caminho especificado. Ao transmitir **user\_ip** tenha em atenção os pontos indicados em [Transmitir endereços IP](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#passing-ips-using-cloudflare-etc). A estrutura deste pedido é a seguinte:

```bash
curl -X POST http://localhost:8080/serve \
    -H "Content-Type: application/json" \
    -d '{
  "user_ip": "8.8.8.8",
  "user_agent": "curl/7.43.0",
  "language": "en;q=0.9",
  "referer": "https://example.com",
  "zones": [
    {
      "idzone": "1813348"
    },
    {
      "idzone": "1813348"
    },
    {
      "idzone": "1813348"
    }
  ]
}'
```

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

```php
$ip = $_SERVER['REMOTE_ADDR'];
if (array_key_exists('HTTP_X_FORWARDED_FOR', $_SERVER)) {
    $ip = array_shift(explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']));
}

$referer = "";
if (array_key_exists('HTTP_REFERER', $_SERVER)) {
    $referer = array_shift(explode(',', $_SERVER['HTTP_REFERER']));
}

$language = "";
if (array_key_exists('HTTP_ACCEPT_LANGUAGE', $_SERVER)) {
    $language = array_shift(explode(',', $_SERVER['HTTP_ACCEPT_LANGUAGE']));
}
    
$data = [
    "user_ip" => $ip,
    "user_agent" => $_SERVER['HTTP_USER_AGENT'],
    "language" => $language,
    "referer" => $referer,
    "zones" => [
        ["idzone" => "1813348"],
        ["idzone" => "1813348"],
        ["idzone" => "1813348"]
    ]
];

$request = json_encode($data);

$ch = curl_init('http://localhost:8080/serve');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $request);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Content-Length: ' . strlen($request))
);

$result = json_decode(curl_exec($ch), true);
print_r($result);
```

### 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 da Exoclick. Consulte [Domínio base](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#domain-base) para saber em que casos deve alterar este valor

### Opções

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

```bash
heisenberg:neverblock-proxy craig$ ./neverblock-proxy -h
Neverblock-Proxy - o gestor de tráfego do AdBlock

Utilização:
  neverblock-proxy [flags]

Opções:
  -c, --cache-path string    Caminho da cache de imagens
  -C, --config-file string   Ficheiro de configuração
  -l, --log string           Ficheiro de registo
  -p, --port string          Porta do serviço
```

## Plugin do WordPress

### Instalação do plugin

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

* [neverblock\_wp.zip – v1.13](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FFlNcVzwtfnwWcuWWe6eW%2Fneverblock_wp.zip?alt=media) (versão 3.14 do NeverBlock)

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.

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FFyBwRaXNSVoZZO46rsnn%2Fneverblock_wp_1.png?alt=media)

**Passo 1 – Introdução**

A primeira página do assistente de instalação não requer quaisquer dados.

**Passo 2 – Requisitos do sistema**

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

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FigUqsco4QT753tqfflea%2Fneverblock_wp_2.png?alt=media)

Para obter mais detalhes 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 [Configuração de constantes](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#configuring-constants). O passo 3 do assistente de instalação permite configurar estas definições. Os detalhes de cada uma são abordados na secção correspondente e também estão descritos na captura de ecrã abaixo.

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FZJxj1ZfINzStqP6JmgnP%2Fneverblock_wp_3.png?alt=media)

Estas configurações podem ser alteradas em 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:

![](https://4037347725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FLyIk36QD848C12vTaTHS%2Fneverblock_wp_4.png?alt=media)

### Adicionar zonas no WordPress

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

**Shortcodes**

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

```
[neverblock idzone=123456]
```

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

```php
<?php echo do_shortcode('[neverblock idzone=123456]') ?>
```

Tenha em atenção que existe um atributo opcional `container_id` que pode ser usado para referenciar o ID de um nó DOM. Este atributo acrescenta-o à div correspondente. Para que isto funcione, a div tem de estar presente antes do shortcode; caso contrário, o NeverBlock não encontrará o elemento.

```
<div id="my-ad-container-id"></div>
[neverblock idzone=123456 container_id="my-ad-container-id"]
```

**Scripts convencionais**

Ao editar um modelo de tema, pode usar os scripts padrão descritos em [Apresentar anúncios](https://docs.exoclick.com/publishers/pt/adblock/neverblock.md#adding-zones-to-a-page).

## 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 obsoletos e da deteção de IP
* Desde a versão 3.14, o evento do carregador é getmsgloader. Se atualizar para a versão 3.14, atualize o seu snippet. O snippet antigo (getexoloader) falha com o erro: Cannot read properties of undefined (reading 'addZone').

**3.12 (10.01.2025)**

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

**3.11 (11.07.2023)**

* Compatibilidade corrigida com o PHP 5.2 e versões posteriores

**3.10 (12.01.2022)**

* Adiciona um parâmetro que pode ser usado para garantir a compatibilidade com versões futuras
* Adiciona suporte ao formato WebP

**3.9 (03.12.2021)**

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

**3.8 (10.06.2021)**

* Remove o código relacionado com popunders (o modo 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)**

* Remove 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)**

* Adiciona a funcionalidade de remover anúncios parcialmente bloqueados
* Adicionar o parâmetro no\_cookie para permitir que backend\_loader.php esteja noutro domínio
* Adicionar suporte à 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 para a documentação sobre o envio de IPs
* Corrigir o erro ao substituir window\.ExoLoader causado por alguns bloqueadores (uBlock)
* Substituir o serviço antigo 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 de banners e ligações e adicionar um controlo mais flexível
* Corrigir erro de JS se serve() for chamado várias vezes

**3.0 (30.01.2018)**

* Introduzir o conceito de renderizadores solicitados
* Adicionar novos formatos de anúncios: anúncio nativo, banner fixo, mensagem instantânea para web e dispositivos móveis
* Atribuir um nome dinâmico ao objeto ExoLoader caso os bloqueadores de anúncios o tornem imutável
* Pequenas alterações para facilitar a instalação do phar e do plugin do WordPress
* Detetar automaticamente a versão do PHP para multi curl

**2.25 (12.10.2017)**

* Corrigir a verificação de alterações no texto do corpo da resposta em pedidos 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
* Permitir 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 do 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)**

* Alterar a deteção de bloqueadores
* 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 das campanhas de intercâmbio e do banner 404
* Pequenas correções para a versão 5.2 do PHP

**2.18 (07.04.2017)**

* Enviar o cabeçalho correto para JavaScript quando a validação de cabeçalhos é rigorosa

**2.17 (27.03.2017)**

* Corrigir o erro de interface nas versões mais antigas do PHP em backend\_loader.php
* Corrigir o problema de abertura de ligações em frontend\_loader.php quando LINK\_URL\_PREFIX está especificado

**2.16 (14.03.2017)**

* Permitir adicionar zonas dinamicamente, e não apenas ao carregar a página
* Adicionar uma referência ao 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 usar 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)**

* Transferir 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 e 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 carregador de backend

**2.8 (30.08.2016)**

* Resolver o problema dos anúncios HTTPS com a resolução DNS e a cache externas ao 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 carregador de frontend
* Instruções de resolução de problemas

**2.5 (02.08.2016)**

* Introduzir um registo 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)**

* Tempos limite melhorados
* Ficheiro de diagnóstico e depuração melhorada

**2.3 (20.07.2016)**

* Corrigido um pequeno problema ao fazer um pedido ao carregador de back-end quando não tinham sido adicionadas zonas

**2.2 (15.07.2016)**

* Novo domínio para o ads-endpoint com melhor distribuição de carga

**2.1 (27.06.2016)**

* Corrigida a incompatibilidade com a framework Prototype

**2.0 (14.06.2016)**

* Lançamento público
* Um único pedido para vários anúncios
* Carregador unificado para banners

### Histórico 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.exoclick.com/publishers/pt/adblock/neverblock.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
