> 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/es/adblock/neverblock.md).

# Neverblock

## Descripción general

### Anti-Adblock

NeverBlock es una solución probada para eludir los bloqueadores de anuncios que maximiza tus ingresos al instante.

Nuestra tecnología exclusiva garantiza que tus anuncios sigan mostrándose aunque el usuario tenga instalado y activado un software de bloqueo de anuncios.

La tecnología avanzada de NeverBlock elude los bloqueadores de anuncios para recuperar todos tus ingresos publicitarios. Funciona en todos los navegadores (incluidos Safari, Chrome, Internet Explorer, Mozilla, etc.) y en todas las plataformas y dispositivos (ordenadores de escritorio, smartphones y tabletas).

Esta solución es gratuita para todos los clientes de ExoClick y basta con añadir una línea de código a tu sitio web.

En esta documentación explicaremos cuatro formas distintas de implementar NeverBlock:

* **NeverBlock PHP** - La solución estándar, la más fácil de implementar y la más utilizada. Es la que se explicará con más detalle en esta documentación.
* **NeverBlock API** - Cuando se necesita un lenguaje no compatible, la API proporciona los endpoints necesarios para obtener los anuncios directamente. Se utiliza cuando se requieren soluciones manuales.
* **NeverBlock Proxy** - Aplicación multiplataforma que gestiona las solicitudes a la API y almacena los anuncios en caché. Este servicio se ejecuta en segundo plano para proporcionar al usuario un endpoint más directo desde el que obtener los anuncios.
* **Plugin de WordPress** - Plugin de WordPress desarrollado para integrar fácilmente las zonas publicitarias de NeverBlock en tu sitio de WordPress.

## NeverBlock PHP: instalación automática

### Objetivo

El instalador Phar de NeverBlock es una herramienta que facilita la instalación de la solución NeverBlock PHP (versión 3.0). Puede utilizarse en lugar de seguir los pasos indicados en [Instalación manual](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#neverblock-php-manual-installation). Instalará los archivos en el directorio especificado o, de forma predeterminada, en el directorio **nb** . El instalador se encargará de parte de la configuración, en particular del [cambio de nombre de los archivos](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#renaming-the-files-mandatory) y de las [claves de identificación](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#identification-keys).

### Descargar el instalador

La versión más reciente se puede descargar desde el siguiente enlace:

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

### Ejecutar el instalador

Una vez descargado el archivo phar, colócalo en el directorio donde quieras guardar los archivos de NeverBlock. Al ejecutar el instalador, puedes especificar la ruta donde quieres instalar los archivos o dejar que use la ruta predeterminada. También puedes definir un parámetro opcional para indicar el archivo de registro; su finalidad se describe en la sección [Archivo de registro](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#logfile) .

```bash
# Crear e instalar los archivos en el directorio predeterminado 'nb' 
./neverBlockInstaller.phar
```

Parámetros opcionales:

```bash
# Crear e instalar los archivos en el directorio especificado
./neverBlockInstaller.phar --path=specific/path 

# Instalar los archivos en el directorio actual
./neverBlockInstaller.phar --path=.

# Ruta del archivo de registro
./neverBlockInstaller.phar --logfile=path/logfile

# Ruta de writable_path (si APC/APCu no está instalado)
./neverBlockInstaller.phar --writable_path=path/writable_path
```

### Analizar la respuesta

Una vez ejecutado, se mostrará una respuesta similar a la que aparece a continuación. Podemos analizarla en dos secciones: los resultados del diagnóstico y los scripts necesarios.

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

**Resultados del diagnóstico**

Al ejecutar el archivo phar, se mostrarán los resultados de varias pruebas de configuración. Ten en cuenta que la **detección de IP** requerirá el **diag.php** para ejecutarse manualmente. Para obtener más información sobre estos resultados y la ejecución manual, consulta las secciones Ejecutar diag.php y Posibles resultados de diag.php.

**Scripts necesarios**

Debajo de los resultados del diagnóstico aparecen dos scripts cuyos nombres se han generado automáticamente. Estos scripts nos muestran los nombres de nuestro **frontend\_loader.js** y **backend\_loader.php**, y serán las rutas que se deben usar al [mostrar anuncios](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#adding-zones-to-a-page).

## NeverBlock PHP: instalación manual

### Descargar los archivos

La instalación y la mayor parte de la configuración se pueden realizar mediante el [instalador phar](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#neverblock-php-automatic-installation). La instalación manual se puede realizar de la siguiente manera.

La versión más reciente (v3.14) se puede descargar mediante estos enlaces:

* [latest.zip – v3.14](https://212229893-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://212229893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FbDMaTz3tFwlPsZMsexJe%2Flatest.tar.gz?alt=media)

O mediante los siguientes 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
```

Los archivos que se necesitarán de esta carpeta son:

* **backend\_loader.php**
* **frontend\_loader.js**
* **diag.php**

### Cambiar el nombre de los archivos (obligatorio)

Para evitar que los bloqueadores de anuncios bloqueen inmediatamente los archivos, es necesario cambiarles el nombre.

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

Una de las pruebas de **diag.php** comprueba si existe el archivo **backend\_loader.php**, por lo que las referencias de esta prueba se deben actualizar para que coincidan con el nuevo nombre del archivo. El siguiente ejemplo usa la misma configuración que se muestra en la imagen anterior. Actualiza la siguiente línea al principio de la página:

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

### Colocar los archivos en el servidor

Los archivos mencionados anteriormente deben colocarse en el servidor donde quieras mostrar los anuncios.

Copia los archivos en el directorio que elijas:

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

### Ejecutar diag.php

Ahora que los archivos de NeverBlock están en nuestro servidor, usaremos el archivo **diag.php** para verificar que todo esté bien hasta ahora. Para ello, ve a la URL donde se encuentra el archivo diag.php. Si tomamos como ejemplo la captura de pantalla anterior, la nuestra sería la siguiente: `https://www.my-example-site.com/nb/diag.php`

Si todo está correcto hasta ahora, deberías ver lo siguiente (configuraremos el archivo de registro en [Archivo de registro](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#logfile)):

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

Si ves resultados diferentes, puede que sea necesaria una configuración adicional.

### Posibles resultados de diag.php

**Versión de PHP:** Se te notificará si la versión de PHP no es compatible. La solución estándar de NeverBlock requiere PHP 5.2 o posterior.

**Presencia del script de carga del backend:** Si esta comprobación falla, el archivo **backend\_loader.php** no se puede encontrar mediante **diag.php**. Esto puede deberse a un cambio en el nombre del archivo o a un problema con la ruta.

**Informes de errores:** Esto puede aparecer como una advertencia. Esta advertencia no impedirá que la solución NeverBlock funcione.

**Presencia de caché** y **Biblioteca cURL:** Si no hay caché ni cURL, recibirás advertencias. Esto no impedirá que NeverBlock funcione, pero recomendamos configurar ambos.

* La extensión [cURL](https://www.php.net/manual/en/book.curl.php) de PHP *(muy recomendada)*
* La extensión [APCu](https://www.php.net/manual/en/book.apcu.php) de PHP o una caché de archivos (consulta [Almacenamiento en caché](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#caching))

**Detección de IP:** Si se produce un error relacionado con la coincidencia de IP, consulta la sección [Transferencia de IP](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

**Solicitudes de anuncios:** Si las solicitudes tardan más de lo esperado, es posible que se te indique que aumentes los valores de **REQUEST\_TIMEOUT\_MS** y **CONNECT\_TIMEOUT\_MS** configuración. Para hacerlo, consulta [Configuración de constantes](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#configuring-constants).

## NeverBlock PHP: configuración

### Transferencia de IP (uso de Cloudflare, etc.)

Si utilizas un servicio como Cloudflare que se interpone entre el usuario y tus servidores, es posible que la IP detectada en **backend\_loader.php** se considere no válida. Esto podría hacer que los clics o las impresiones de los anuncios se registren incorrectamente. Para solucionarlo, puedes sustituir `$_SERVER["REMOTE_ADDR"]` que se pasa a *UserEnvironment* en la clase **backend\_loader.php** por el valor correcto que proporciona tu servicio de almacenamiento en caché o proxy.

En el caso de Cloudflare, pasaríamos el parámetro `$_SERVER["HTTP_CF_CONNECTING_IP"]` . A continuación se muestra un ejemplo.

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

Una vez hecho esto, nuestro objeto *UserEnvironment* quedará así:

```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
);
```

Al usar otro servicio como Apache o NGINX, podemos usar `isset($_SERVER['HTTP_X_REAL_IP']) ? $_SERVER['HTTP_X_REAL_IP'] : $_SERVER['REMOTE_ADDR']` como se muestra a continuación:

```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
);
```

Ahora podemos volver a ejecutar **diag.php**, si esto era lo que provocaba que fallara la prueba de *detección de IP* , ahora deberíamos obtener resultados satisfactorios.

### Archivo de registro

Esta fue una configuración opcional durante la [instalación automática](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#neverblock-php-automatic-installation). Si quieres registrar los tiempos de espera agotados de las solicitudes y otros errores, puedes crear un archivo de registro con permisos de escritura. En este ejemplo, el archivo de registro se ha guardado en el mismo directorio que los demás archivos de NeverBlock.

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

Una vez creado este archivo (recuerda asegurarte de que tenga permisos de escritura), actualizaremos **backend\_loader.php** para establecer la ruta. Al principio del archivo, `LOGFILE` estará establecido en **NULL** y debe actualizarse para establecer la ruta del nuevo archivo de registro, así:

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

Una vez hecho esto, podemos volver a ejecutar **diag.php**. Si el archivo se creó y la ruta se estableció correctamente, ahora veremos lo siguiente.

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

### Almacenamiento en caché

Esta fue una configuración opcional durante la [instalación automática](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#neverblock-php-automatic-installation). El almacenamiento en caché puede mejorar considerablemente los tiempos de respuesta de los anuncios. Si no tienes APC o APCu, compatibles de forma predeterminada con **backend\_loader.php** , se recomienda configurar una caché de archivos. Para ello, debes crear un directorio con permisos de escritura para PHP y establecer su ruta como valor de la constante **WRITABLE\_PATH** en el archivo **backend\_loader.php**. Si se establece esta constante, la caché de archivos se usará de forma predeterminada en lugar de cualquier otra caché (incluso si tienes APC o APCu).

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

### Claves de identificación

Si usaste la [instalación automática](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#neverblock-php-automatic-installation) , esto ya se habrá hecho durante la instalación. Estas claves se usan para cifrar las URL de los banners y evitar que se manipulen. Se recomienda encarecidamente cambiar los valores de ambas claves, *KEY\_1* y *KEY\_2* en **backend\_loader.php** por cadenas únicas.

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

### Cookies

Las cookies se usan para asegurarse de que NeverBlock funcione según lo previsto.

* **yuo1** - el nombre predeterminado de esta cookie es **yuo1**, y este nombre se puede configurar en **frontend\_loader.js**. Esta cookie también se puede desactivar configurando [no\_cookie: true](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#how-do-i-configure-neverblock-from-a-different-domain).
* **zone-closed-** - Esta cookie garantiza que la zona permanezca cerrada si el usuario la ha cerrado con adBlock activado y luego lo desactiva.

### Configuración de constantes

Hay algunas constantes definidas en **backend\_loader.php**. Se recomienda dejarlas como están, pero en algunos casos puede ser útil cambiar algunas configuraciones.

* **CONNECT\_TIMEOUT\_MS** - el tiempo de espera de conexión, en milisegundos, usado para las solicitudes curl/fsock.
* **REQUEST\_TIMEOUT\_MS** - el tiempo de espera total de la solicitud, en milisegundos (también incluye el tiempo de CONNECT\_TIMEOUT\_MS), usado para las solicitudes curl/fsock.
* **LOGFILE** - la ruta a un archivo en el que se pueda escribir para registrar mensajes, como algunos errores y los casos en que se agote el tiempo de espera de las solicitudes.
* **ALLOW\_MULTI\_CURL** - cuando es posible, el script intenta usar curl\_multi\_exec. Si esto supone una carga para la CPU, se puede desactivar.

Configuración de APC/APCu y de la caché en archivos:

* **WRITABLE\_PATH** - ruta a un directorio en el que se pueda escribir y que contendrá los archivos de caché. (Si se configura, la caché en archivos será la caché predeterminada.)
* **CACHE\_INTERVAL\_BANNERS** - tiempo de vida de la caché de las imágenes de los banners (en segundos); si se configura en 0, las imágenes NO se almacenarán en caché.
* **CACHE\_INTERVAL\_SCRIPTS** - tiempo de vida de la caché de los archivos JavaScript; si se configura en 0, NO se almacenarán en caché.
* **CACHE\_KEYS\_LIMIT\_BANNERS** - límite de imágenes de banners que se pueden guardar en la caché (para no consumir demasiados recursos del editor); si se configura en 0, no habrá límite y se almacenarán en caché todas las imágenes.

Si configuras algunas reglas de reescritura de Apache/nginx para acceder a **backend\_loader.php** mediante otros URI:

* **LINK\_URL\_PREFIX** - si se configura, se convertirá en el nuevo URI de los enlaces en los que se hace clic en el frontend (se le añadirá el hash de la URL de redirección).
* **BANNER\_URL\_PREFIX** - si se configura, se convertirá en el nuevo URI de las imágenes de banners en el frontend (se le añadirá el hash del banner correspondiente).
* **KEY\_1** - clave secreta para evitar la manipulación de las URL de los banners (ahora se envían de vuelta al cargador del backend en la solicitud).
* **KEY\_2** - clave secreta para evitar la manipulación de las URL de los banners (ahora se envían de vuelta al cargador del backend en la solicitud).

## NeverBlock PHP: mostrar anuncios

### Añadir zonas a una página

Estos fragmentos de código son para NeverBlock 3.14 y versiones posteriores. En versiones anteriores, usa getexoloader en lugar de getmsgloader.

{% hint style="info" %}
Si usas una aplicación de página única, [la carga dinámica](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#dynamic-loading-single-page-applications) será obligatoria.
{% endhint %}

Se admiten los siguientes formatos de anuncios:

* Banners
* Anuncios nativos
* Banners fijos
* Mensajes instantáneos

{% hint style="info" %}
Los anuncios multiformato aún no son compatibles. Sin embargo, puedes seguir usando NeverBlock con los banners individuales que hayas configurado para usar en anuncios multiformato. Así, puedes utilizar anuncios multiformato para los usuarios estándar y banners compatibles con NeverBlock para llegar a los usuarios que usan bloqueadores de anuncios.
{% endhint %}

Ten en cuenta que este script solo mostrará anuncios cuando el usuario tenga instalado y habilitado un bloqueador de anuncios. No elimines ninguna etiqueta publicitaria estándar existente.

En este ejemplo usaremos la configuración descrita en [Cambiar el nombre de los archivos](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#renaming-the-files-mandatory). Asegúrate de que las rutas y los nombres de archivo coincidan con tu configuración.

**Paso 1: colocar frontend\_loader.js en la página**

Dentro de la etiqueta `<body>` de tu página, al principio, añade lo siguiente:

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

Esto debe incluirse en la página una sola vez. También debe ir antes de todos los demás scripts de zonas.

**Paso 2: añadir una zona NeverBlock**

Los siguientes fragmentos de código sirven para declarar las zonas publicitarias. Deben colocarse en el DOM donde quieras que se muestre la zona. Puedes añadir varios bloques de banner como este en una página. **Ten cuidado de no colocarlos en divs con clases o estilos específicos relacionados con la visualización de anuncios**, ya que los bloqueadores de anuncios identificarán estos divs (por ejemplo, `class="ad-footer"`, `style="width:300px;height:250px;"`).

Para añadir una zona publicitaria, sigue estos pasos (asegúrate de reemplazar el valor de idzone por el ID de tu 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;
        
        //El código para añadir zonas se puede colocar varias veces en la página
        ExoLoader.addZone({"idzone":"111"});
        
        //Si quieres usar un subid, añade al objeto un parámetro numérico sub y pásalo a addZone
        //ExoLoader.addZone({"idzone":"111", "sub": "1"});
    })();
</script>
```

**Paso 3: mostrar los anuncios (backend\_loader.php)**

Una vez incluidas todas las declaraciones *addZone()* queremos mostrar los anuncios. Para ello, usaremos la función *serve* que proporciona los datos de todas las zonas publicitarias declaradas anteriormente y **normalmente debe llamarse una sola vez por página**. El **número máximo de zonas que se pueden invocar en una página es 20**. Las excepciones son los casos en que se carga una página de forma dinámica, como se describe en [Carga dinámica](https://docs.exoclick.com/publishers/es/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>
```

### Carga dinámica (aplicaciones de página única)

Es posible pasar una referencia a un elemento contenedor del DOM al que se añadirá el banner. Así, cuando se invoque serve, sabrá dónde colocar la zona publicitaria. Se hace de la siguiente manera:

```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>
```

También es posible llamar a *serve()* con la marca force para mostrar los anuncios en el momento que elijas (por ejemplo, en una función después de renderizar una parte de la página), en lugar de hacerlo al cargar la 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>
```

La función *serve()* se puede llamar varias veces. Después de cada *serve()* las llamadas a ExoLoader se vaciarán de las anteriores *addZone()* llamadas. Así que solo los banners para los que llames a *addZone()* después de un serve se mostrarán en el siguiente *serve()*.

### Dominio base

Si ya eres cliente de ExoClick, es posible que tengas zonas publicitarias normales en tu sitio. Si usas un dominio distinto de \*.exoclick.com (p. ej., **ads.exosrv.com**), debes establecer *domain\_base* del objeto detector (`ExoLoader.getDetector()`) en “exosrv.com” antes de la primera llamada a addZone. Hazlo como se muestra a continuación:

```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>
...
<!-- Primera llamada a addZone -->
<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>
```

### No se muestran anuncios

Si no se muestran anuncios, primero comprueba el archivo diag.php para ver si alguna configuración es incorrecta. Si todas las pruebas se completan correctamente, crea una página de prueba con una sola zona para asegurarte de que funciona de forma aislada. Si aun así no se muestran anuncios, consulta la sección [Ayuda](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#neverblock-php-help) para obtener más información.

## NeverBlock PHP - Ayuda

### No se muestran mis anuncios. ¿Qué debo hacer?

**Verifica que estés usando la versión más reciente del código de la solución para bloqueadores de anuncios.**

Trabajamos constantemente para mejorar la solución basándonos en nuestras pruebas, los comentarios de los clientes y los cambios en los bloqueadores de anuncios. Las versiones antiguas pueden tener problemas que ya hemos solucionado, así que asegúrate de usar la versión más actualizada antes de comprobar los demás puntos que se indican a continuación.

**¿Has ejecutado diag.php?**

Puede ayudarte a detectar si hay algún problema con la configuración del cargador del backend.

**Comprueba la pestaña “Red” en la barra de “Herramientas para desarrolladores” de Chrome/FF.**

¿Se está cargando correctamente **frontend\_loader.js** ?

**¿Quizá debas especificar una ruta distinta?**

* Prueba a usar una ruta completa en src en lugar de “/frontend\_loader.js”.
* Comprueba que *ExoLoader.addZone()* se llame **antes que** *ExoLoader.serve()*
* Comprueba la pestaña “Consola” en la barra de “Herramientas para desarrolladores” de Chrome/FF. Puede que haya errores relacionados con **frontend\_loader.js**
* Ejecuta `ExoLoader.getDebug();` en la consola de JavaScript para ver qué está ocurriendo. El resultado es similar 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
```

**Comprueba los identificadores de las zonas.**

Asegúrate de que la zona cuyo idzone proporcionas exista y sea tuya.

**¿Estás colocando códigos publicitarios en iframes?**

El contenido de los iframes se carga después de la página principal. Si llamas a *addZone()* en un iframe y llamar a *serve()* en la página principal, se ejecutará *serve()* antes de *addZone()*, y no funcionará. Hay dos formas de usar iframes:

1. Incluya todo dentro de un iframe: todo el código de los pasos 1, 2 y 3 de [Añadir zonas a una página](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#adding-zones-to-a-page) debe estar dentro del iframe. Pero si hay varios iframes de este tipo en una página, podrían producirse conflictos, ya que esta solución utiliza una cookie. Si el nombre de la cookie es el mismo, los anuncios de los iframes pueden mezclarse. Puede cambiar el nombre de una cookie antes de llamar a serve, así:

```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"});
})();
```

La desventaja es que necesitará varios cargadores de backend, en los que también configurará nombres de cookie distintos:

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

2. Incluya el código del paso 1 (la inclusión del archivo del cargador de frontend) en la página principal de su sitio. Dentro de los iframes, llame a addZone. Para obtener correctamente el objeto ExoLoader, deberá actualizar la llamada estándar para que use **window\.top**.document.dispatchEvent; además, pase a addZone el parámetro **doc** que apuntará a la propiedad document de su 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});
})();
```

Llame también a serve() dentro del ú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"});
})();
```

**¿Utiliza un framework de JavaScript en el frontend de su sitio?**

Confirme que no está sobrescribiendo el innerHTML de los elementos en los que ha colocado llamadas a *addZone()* La *addZone()* llamada coloca un marcador de posición del DOM en el lugar donde se ejecuta. Si algún elemento lo sobrescribe, el script no podrá rellenarlo con datos de anuncios.

**¿backend\_loader.php devuelve una respuesta vacía?**

Si es así, compruebe si hay errores relacionados en el registro de errores de PHP. Después de abrir una página con el código de ExoLoader, abra: `http://yoursite/backend_loader.php?exoDebug=exoDebug`. Si aparecen errores de tiempo de espera *de curl/fsock* , quizá tenga que aumentar los valores de **CONNECT\_TIMEOUT\_MS** y **REQUEST\_TIMEOUT\_MS** en **backend\_loader.php**.

### Los anuncios se muestran, pero las estadísticas no registran clics o impresiones

**¿Utiliza Cloudflare o sus servidores web están detrás de algún otro proxy?**

Las solicitudes de anuncios de NeverBlock no llegan directamente a nuestro servidor desde el navegador del usuario final, por lo que dependemos de **backend\_loader.php** en el lado del editor para que nos envíe la IP del usuario. La obtenemos como `$_SERVER['REMOTE_ADDR']` desde la variable global de PHP en este script. Si la infraestructura del editor está configurada de forma que ese valor no contiene la IP correcta del usuario, podrían producirse problemas de impresiones o clics no válidos. Para solucionarlo, consulte [Transmitir direcciones IP](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

### Al usar el modo privado en Firefox (o en otro navegador), se muestran tanto los anuncios NB como los normales

**Compruebe que el ajuste domain\_base esté configurado correctamente.**

[Aquí](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#domain-base) puedes encontrar un ejemplo de cómo configurar el dominio base. El problema es que, en algunos navegadores, especialmente FF, el modo privado bloquea las solicitudes a ciertos dominios. Exoclick.com, por ejemplo, está en la lista negra. Por lo tanto, si el código de zona normal contiene el dominio «exoclick.com», el modo privado actúa como un bloqueador de anuncios y, de hecho, la solución NB debería mostrar anuncios. Sin embargo, es posible que el modo privado no bloquee nuestros otros dominios. Para evitar mostrar anuncios por duplicado y que el detector de NB determine correctamente si los anuncios normales se están bloqueando en ese momento, necesita saber desde qué dominio se solicitan.

### ¿Cómo configuro NeverBlock desde otro dominio?

1. En *frontend\_loader.js*, ve a la función `serve: function(params)` y descomenta el conjunto de parámetros.
2. Añade otro dominio y establece `force: true` y `no_cookie: true`:

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

3. A continuación, haz referencia en la página a la ruta de NeverBlock con el nuevo dominio.

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>
```

### ¿Qué ocurre si se detecta AdBlock por error?

A veces, los usuarios que tienen AdBlock desactivado siguen viendo anuncios de NB junto con sus anuncios normales. Esto puede ocurrir porque NB intenta incluir en la página un script de publicación de anuncios real que funciona como honeypot, para comprobar si se bloquea o no. A veces, en conexiones lentas, el script tarda demasiado en cargarse y NB puede considerar que se ha bloqueado, por lo que decide solicitar los anuncios. Debido al funcionamiento de algunos bloqueadores de anuncios, no es posible saber si la carga aún no ha terminado o si nunca se completará porque un bloqueador la ha impedido. No supone un problema para la mayoría de los sitios y usuarios. Si afecta a una parte considerable de tus usuarios, recomendamos aumentar el tiempo de espera de la detección de NB con la función **setTimeout** del **ExoLoader**, así:

```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 de NeverBlock

NeverBlock utiliza un endpoint sencillo para enviar solicitudes a los servidores de sindicación de ExoClick mediante un proxy.

Este endpoint se documenta a continuación y puedes utilizarlo para crear tu propia integración personalizada en el lenguaje que prefieras.

### API v1

Esta versión de la API admite todos los formatos disponibles actualmente para la solución NeverBlock (banners, banners adhesivos, anuncios nativos y mensajes instantáneos).

**Solicitud de una sola zona**

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

**Solicitud de varias 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
```

Las solicitudes anteriores son similares, excepto que las solicitudes de varias zonas deben estructurarse con una notación de matriz incremental (*es decir, zones\[0]\[idzone], zones\[1]\[idzone],…*), como se muestra.

{% hint style="info" %}
Las solicitudes de varias zonas están limitadas a un máximo de **20** zonas por solicitud.
{% endhint %}

**Parámetros**

Se deben establecer los siguientes parámetros para **todas las** solicitudes:

* **zones\[N]\[idzone]** - *ID de la zona que se va a solicitar*
* **user\_ip** - *dirección IP del usuario final (se utiliza para la segmentación)*

**Encabezados**

Los siguientes encabezados deben configurarse para **todas** las solicitudes:

* **X-Forwarded-For** - *Dirección IP de origen del cliente*
* **Referer** - *Dirección del sitio web de referencia*
* **User-Agent** - *Identificador del cliente*
* **Accept-Language** - *Idioma y configuración regional del cliente*

**Respuesta**

Las cargas JSON devueltas por los ejemplos anteriores son las siguientes.

Respuesta de una 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"}
}
```

Respuesta de varias 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"
  }
}
```

**Datos de respuesta**

Los siguientes valores se pueden extraer del objeto **zones** para cada zona en la respuesta JSON devuelta, con el fin de publicar anuncios:

* **idzone**: Identificador de la zona (útil para distinguir las solicitudes de zona durante el procesamiento)
* **type**: Tipo de anuncio; en **renderers** se puede obtener el script de renderizado predeterminado correspondiente. (El script de renderizado predeterminado requiere que el objeto ExoLoader esté disponible en su ámbito)
* **data**: Datos del anuncio específicos del tipo de anuncio indicado. Normalmente, **image** y **url** se encuentran en los tipos de banner y similares; algunos incluyen parámetros adicionales.

Si usas la API, te corresponde escribir el código que genere el DOM que se mostrará en el front-end a partir de los datos proporcionados. Nuestros renderizadores predeterminados son los scripts que se encargan de esta tarea como parte de la solución predeterminada de NeverBlock (instalación de PHP + JavaScript). Solo se pueden usar con el objeto JavaScript ExoLoader, que almacena internamente las respuestas posprocesadas en su propio formato y cuenta con varias funciones auxiliares que los renderizadores utilizan y esperan que estén definidas.

### API v0

Esta versión de la API solo admite banners. Devolverá *false* para cualquier zona de otro tipo.

**Solicitud de una sola zona**

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

**Solicitud de varias 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
```

Las solicitudes anteriores son similares, excepto que las solicitudes de varias zonas deben estructurarse con una notación de matriz incremental (*es decir, zones\[0]\[idzone], zones\[1]\[idzone],…*), como se muestra.

{% hint style="info" %}
Las solicitudes de varias zonas están limitadas a un máximo de **20** zonas por solicitud.
{% endhint %}

**Parámetros**

Se deben establecer los siguientes parámetros para **todas las** solicitudes:

* **zones\[N]\[idzone]** - *ID de la zona que se va a solicitar*
* **user\_ip** - *dirección IP del usuario final (se utiliza para la segmentación)*

**Encabezados**

Los siguientes encabezados deben configurarse para **todas** las solicitudes:

* **X-Forwarded-For** - *Dirección IP de origen del cliente*
* **Referer** - *Dirección del sitio web de referencia*
* **User-Agent** - *Identificador del cliente*
* **Accept-Language** - *Idioma y configuración regional del cliente*

**Respuesta**

Las cargas JSON devueltas por los ejemplos anteriores son las siguientes.

Respuesta de una 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"
   }
]
```

Respuesta de varias 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"
}]
```

**Datos de respuesta**

Los siguientes valores se pueden extraer de la respuesta JSON devuelta para publicar anuncios:

* **url**: URL de clic que se usará para envolver la imagen del banner
* **imgurl**: URL de origen de la imagen del banner
* **idzone**: Identificador de la zona (útil para distinguir las solicitudes de zona durante el procesamiento)

## Proxy de NeverBlock

### ¿Qué es?

NeverBlock Proxy es una aplicación multiplataforma diseñada para gestionar solicitudes a la API y almacenar anuncios en caché. Este servicio se ejecuta en segundo plano para ofrecer al usuario un punto de acceso más directo desde el que obtener anuncios. No se recomienda elegir NeverBlock Proxy en lugar de la solución estándar de NeverBlock PHP, ya que no ofrece tantas prestaciones.

En ocasiones, los bloqueadores de anuncios atacan agresivamente los sitios, lo que puede hacer que NeverBlock PHP deje de funcionar. Si este es tu caso, considera usar NeverBlock Proxy.

### Descargar NeverBlock Proxy

Descarga un archivo comprimido precompilado para tu plataforma:

* [neverblock-proxy\_v1.0.1\_darwin\_386.tar.gz](https://212229893-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://212229893-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://212229893-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://212229893-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://212229893-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://212229893-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://212229893-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://212229893-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 fuente (zip)](https://212229893-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 fuente (tar.gz)](https://212229893-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)

Los archivos necesarios para ejecutar los anuncios de NeverBlock son:

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

### Configuración del proxy

**Coloca los archivos en el servidor**

Una vez descargados los archivos, puedes colocarlos en un directorio del servidor, como se muestra en la siguiente captura de pantalla:

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

**Crea la caché**

Crea un directorio con permisos de escritura para almacenar los archivos descargados. Puedes crearlo en la misma carpeta, ya que configuraremos la ruta más adelante.

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

**Actualiza la configuración obligatoria**

En la parte superior de **neverblock-conf.toml** hay una sección marcada como *Obligatorio*. En esta sección configuraremos las rutas según lo que se muestra en las capturas de pantalla anteriores. Ten en cuenta que dependerán de tu configuración.

```toml
#####################
#     Mandatory     #
#####################

## Cache path (CAUTION: ALL files here will be purged at regular intervals!)
cache_path = "nb-cache/"

## Relative path to cache from web serving root (i.e "images/cache/", will default to cache_path if not set)
www_cache_path = "nb-proxy/nb-cache/"

## Path & filename to redirect html file (relative to web serving root - i.e. "misc/redirect.html")
www_redirect_path = "nb-proxy/redirect.html"
```

**Inicia el servicio**

Inicia el binario desde una ventana de comandos o una terminal; debes hacerlo dentro del directorio donde se encuentra. Esto iniciará el servicio y ya deberías poder realizar solicitudes curl a localhost en el puerto 8080.

### Uso

Se utiliza una solicitud cURL para obtener las zonas. Puedes implementar esta solicitud en cualquier lenguaje. La solicitud cURL devolverá una carga JSON con una URL de clic y la ruta de una imagen pertinente. La imagen también se habrá descargado en la ruta especificada. Al pasar **user\_ip** ten en cuenta los puntos indicados en [Transmisión de direcciones IP](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#passing-ips-using-cloudflare-etc). La estructura de esta solicitud es la siguiente:

```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"
    }
  ]
}'
```

Con esta estructura, podemos ver un ejemplo de uso en 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);
```

### Configuración opcional

Hay varias opciones de configuración en **neverblock-conf.toml**:

* **debug** - Activar el modo de depuración
* **port** - Puerto de escucha del servicio
* **log** - Registro de la aplicación
* **http\_timeout** - Tiempo de espera de la solicitud HTTP (segundos)
* **cache\_ttl** - Tiempo de vida (minutos) de los archivos almacenados en caché
* **cache\_purge\_frequency** - Intervalo entre ejecuciones de la limpieza de caché (minutos)
* **syndication** - URL de sindicación de Exoclick. Consulta [Dominio base](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#domain-base) para obtener detalles sobre cuándo cambiarla

### Indicadores

Hay indicadores disponibles para sustituir la configuración del archivo:

```bash
heisenberg:neverblock-proxy craig$ ./neverblock-proxy -h
Neverblock-Proxy: el gestor de tráfico de AdBlock

Uso:
  neverblock-proxy [flags]

Indicadores:
  -c, --cache-path string    Ruta de la caché de imágenes
  -C, --config-file string   Archivo de configuración
  -l, --log string           Archivo de registro
  -p, --port string          Puerto del servicio
```

## Plugin de WordPress

### Instalación del plugin

El plugin se puede descargar mediante el siguiente enlace:

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

La instalación del plugin NeverBlock para WordPress no difiere de la de cualquier otro plugin. En el menú, selecciona **Plugins** -> **Subir plugin** -> selecciona el plugin NeverBlock que quieres instalar.

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

**Paso 1 - Introducción**

La primera página del asistente de instalación no requiere ninguna entrada.

**Paso 2 - Requisitos del sistema**

En este paso veremos los resultados de las pruebas de configuración. Los resultados pueden variar según tu configuración.

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

Para obtener más detalles sobre cada una de estas pruebas, sus resultados y cómo ejecutarlas manualmente, consulta estas secciones: Ejecutar diag.php y Posibles resultados de diag.php.

**Paso 3 - Ajustes del plugin**

En la sección de configuración de NeverBlock PHP hay un apartado sobre [Configurar constantes](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#configuring-constants). El paso 3 del asistente de instalación te permite configurar estos ajustes. Los detalles de cada uno se explican en la sección correspondiente y también se muestran en la captura de pantalla siguiente.

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

Puedes cambiar estos ajustes en cualquier momento después de la instalación.

**Paso 4 - Finalizar**

Una vez completada la instalación, verás la opción **NeverBlock** en el menú. Desde allí puedes cambiar los ajustes del plugin cuando sea necesario:

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

### Añadir zonas en WordPress

Hay dos formas de añadir zonas de NeverBlock a una página de WordPress.

**Códigos cortos**

En TinyMCE, al crear o editar una entrada, simplemente añádelo de la siguiente manera y asegúrate de usar el idzone correcto:

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

Como alternativa, puedes usar lo siguiente como ejemplo en una plantilla de tema:

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

Ten en cuenta que hay un atributo opcional `container_id` que puede usarse para hacer referencia al id de un nodo del DOM. Esto lo añadirá al div correspondiente. Para que funcione, el div debe estar presente antes del código corto; de lo contrario, NeverBlock no encontrará el elemento.

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

**Scripts habituales**

Al editar una plantilla de tema, puedes usar los scripts estándar descritos en [Mostrar anuncios](https://docs.exoclick.com/publishers/es/adblock/neverblock.md#adding-zones-to-a-page).

## Registro de cambios

Consulta el archivo CHANGELOG incluido en el paquete del software.

### Registro de cambios de NeverBlock PHP

**3.14 (21.10.2026)**

* El cargador del backend de NeverBlock no consigue servir anuncios localmente, incluso después de corregir los avisos de PHP obsoletos y la detección de IP
* Desde la versión 3.14, el evento del cargador es getmsgloader. Si actualizas a la versión 3.14, actualiza tu fragmento de código. El fragmento anterior (getexoloader) provoca el error: Cannot read properties of undefined (reading 'addZone').

**3.12 (10.01.2025)**

* Corregir el problema por el que NeverBlock > diag.php siempre devuelve “Can’t access service to compare IPs” en la detección de IP

**3.11 (11.07.2023)**

* Se corrigió la compatibilidad con PHP 5.2 y versiones posteriores

**3.10 (12.01.2022)**

* Añadir un parámetro que pueda usarse para garantizar la compatibilidad con versiones futuras
* Añadir compatibilidad con el formato WebP

**3.9 (03.12.2021)**

* Añadir un tiempo de espera a la detección para evitar falsos positivos en conexiones lentas

**3.8 (10.06.2021)**

* Eliminar el código relacionado con popunders (se prefiere el método en línea) y las cookies innecesarias

**3.7 (05.07.2019)**

* Algunas medidas contra el filtro “anti-cv”

**3.6 (16.05.2019)**

* Eliminar la referencia al objeto JS, que a veces se bloquea
* Nueva API de detección de IP en diag (compatible con IPv6)

**3.5 (14.03.2019)**

* Añadir la función para eliminar anuncios bloqueados parcialmente
* Añadir el parámetro no\_cookie para permitir alojar backend\_loader.php en un dominio diferente
* Añadir compatibilidad con la caché acpu

**3.4 (09.07.2018)**

* Mejorar la detección (esperar a que se cargue la página)

**3.3 (25.05.2018)**

* Actualizar el enlace a la documentación sobre cómo pasar direcciones IP
* Corregir el error al sobrescribir window\.ExoLoader provocado por algunos bloqueadores (uBlock)
* Sustituir el antiguo servicio de detección de IP

**3.2 (15.03.2018)**

* Corregir un error con PHP <= 5.3

**3.1 (07.03.2018)**

* Aleatorizar automáticamente los nombres de los parámetros de banners y enlaces; añadir un control más flexible
* Corregir un error de JS si se llama a serve() varias veces

**3.0 (30.01.2018)**

* Introducir el concepto de renderizadores solicitados
* Añadir nuevos formatos de anuncios: anuncio nativo, banner fijo y mensaje instantáneo para web y móviles
* Asignar nombres dinámicos al objeto ExoLoader por si los bloqueadores de anuncios lo hacen inmutable
* Pequeños cambios para facilitar el instalador phar y el plugin de WordPress
* Comprobar automáticamente la versión de PHP para multi curl

**2.25 (12.10.2017)**

* Corregir la comprobación de cambios en el texto del cuerpo de la respuesta a la solicitud de anuncios de diagnóstico
* Registrar los errores devueltos por el servidor de anuncios
* Corregir los diagnósticos de detección de IP (usar la configuración de backend\_loader.php)

**2.24 (15.08.2017)**

* Comprobar la detección de IP en el script de diagnóstico
* Permitir alojar backend\_loader.php en un dominio diferente

**2.22 (13.06.2017)**

* Detección: impedir que los estilos box-sizing del sitio influyan en los parámetros de la trampa del DOM

**2.21 (09.06.2017)**

* Resolver el problema de falsos positivos durante la detección de bloqueadores de anuncios

**2.20 (01.06.2017)**

* Cambiar la detección de bloqueadores
* Corregir el problema por el que varias ejecuciones de serve() sobrescribían la cookie de las demás

**2.19 (24.05.2017)**

* Resolver el problema con las campañas de intercambio y los banners 404
* Pequeñas correcciones para PHP 5.2

**2.18 (07.04.2017)**

* Enviar la cabecera correcta para JavaScript cuando se valida estrictamente el encabezado

**2.17 (27.03.2017)**

* Corregir el error de interfaz en versiones antiguas de PHP en backend\_loader.php
* Corregir el problema de apertura de enlaces en frontend\_loader.php cuando se especifica LINK\_URL\_PREFIX

**2.16 (14.03.2017)**

* Permitir añadir zonas dinámicamente, no solo al cargar la página
* Añadir la referencia al contenedor como parámetro de addZone

**2.15 (08.03.2017)**

* Añadir caché de archivos.
* Reducir la cantidad de datos transferidos.
* Cargar los banners mediante `<img>`, en lugar de usar un estilo de fondo con base64.

**2.14 (30.09.2016)**

* Corregir resolveMulti para que siempre devuelva un array

**2.13 (14.09.2016)**

* Pasar correctamente los parámetros POST para openLink

**2.12 (12.09.2016)**

* Trasladar por completo los estilos en línea a clases CSS

**2.11 (09.09.2016)**

* Corregir el problema de document.contains undefined en IE

**2.10 (07.09.2016)**

* Corregir problemas de conectividad IPv6 y curl
* Corregir problemas con enlaces de clic incorrectos debido a alias del servidor

**2.9 (02.09.2016)**

* Cambiar el mecanismo de apertura de enlaces para redirigir a través del cargador del backend

**2.8 (30.08.2016)**

* Resolver el problema de los anuncios HTTPS mediante la resolución DNS y el almacenamiento en caché fuera de curl

**2.7 (22.08.2016)**

* Cambiar los endpoints de anuncios a HTTPS para evitar problemas de contenido mixto

**2.6 (17.08.2016)**

* Marcador de posición del DOM más genérico para los banners
* Corregir un problema con las cabeceras
* Separar los errores de los mensajes de depuración en el cargador del frontend
* Instrucciones para la resolución de problemas

**2.5 (02.08.2016)**

* Añadir un registro para las solicitudes que superan el tiempo de espera y otros errores
* Corregir un error de JS cuando algo sobrescribe el marcador de posición del DOM del anuncio

**2.4 (22.07.2016)**

* Mejores tiempos de espera
* Archivo de diagnóstico y mejor depuración

**2.3 (20.07.2016)**

* Se corrigió un problema menor al realizar una solicitud al cargador del backend cuando no se habían añadido zonas

**2.2 (15.07.2016)**

* Nuevo dominio para ads-endpoint con mejor balanceo de carga

**2.1 (27.06.2016)**

* Se corrigió la incompatibilidad con el framework Prototype

**2.0 (14.06.2016)**

* Versión pública
* Una sola solicitud para varios anuncios
* Cargador unificado para banners

### Registro de cambios de NeverBlock Proxy

**1.0.1**

* Permitir enviar el idioma y el referente en la solicitud
* Ejemplos actualizados

**1.0.0**

* Versión 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/es/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.
