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

# Neverblock

## Обзор

### Обход блокировщиков рекламы

NeverBlock — проверенное решение для обхода блокировщиков рекламы, которое позволяет мгновенно увеличить доходы.

Наша уникальная технология гарантирует показ рекламы, даже если у пользователя установлена и включена программа для блокировки рекламы.

Передовая технология NeverBlock обходит блокировщики рекламы, возвращая вам весь доход от рекламы. Она работает во всех браузерах (включая Safari, Chrome, Internet Explorer, Mozilla и другие), а также на всех платформах и устройствах (настольных компьютерах, смартфонах и планшетах).

Это решение бесплатно для всех клиентов ExoClick. Для его настройки достаточно добавить строку кода на сайт.

В этой документации рассмотрены четыре способа интеграции NeverBlock:

* **NeverBlock PHP** — стандартное решение, которое проще всего внедрить и которое используется чаще всего. Ему посвящена большая часть этой документации.
* **NeverBlock API** — если требуется язык, который не поддерживается, API предоставляет конечные точки для получения рекламы напрямую. Используйте этот способ, если требуется ручная настройка.
* **NeverBlock Proxy** — кроссплатформенное приложение для обработки запросов к API и кэширования рекламы. Сервис работает в фоновом режиме и предоставляет пользователю более прямую конечную точку для получения рекламы.
* **Плагин WordPress** — плагин WordPress, разработанный для простой интеграции рекламных блоков NeverBlock на ваш сайт WordPress.

## NeverBlock PHP — автоматическая установка

### Назначение

Установщик NeverBlock Phar упрощает установку решения NeverBlock PHP (версии 3.0). Его можно использовать вместо инструкций из раздела [Ручная установка](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#neverblock-php-manual-installation). Файлы будут установлены в указанную директорию или в директорию **nb** по умолчанию. Установщик также выполнит часть настроек, связанных с [переименованием файлов](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#renaming-the-files-mandatory) и [идентификационными ключами](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#identification-keys).

### Скачайте установщик

Последнюю версию можно скачать по ссылке:

* [neverBlockInstaller.phar.zip — v1.13](https://3591890222-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FEb1X61WoFuzi12igYPH7%2FneverBlockInstaller.phar.zip?alt=media) (версия NeverBlock 3.14)

### Запустите установщик

После загрузки файла phar поместите его в директорию, где должны храниться файлы NeverBlock. При запуске установщика можно указать путь для установки файлов или использовать путь по умолчанию. Также можно указать необязательный параметр, задающий используемый файл журнала. Описание приведено в разделе [Файл журнала](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#logfile) .

```bash
# Создать и установить файлы в директорию 'nb' по умолчанию 
./neverBlockInstaller.phar
```

Необязательные параметры:

```bash
# Создать и установить файлы в указанную директорию
./neverBlockInstaller.phar --path=specific/path 

# Установить файлы в текущую директорию
./neverBlockInstaller.phar --path=.

# Путь к файлу журнала
./neverBlockInstaller.phar --logfile=path/logfile

# Путь к writable_path (если APC/APCu не установлены)
./neverBlockInstaller.phar --writable_path=path/writable_path
```

### Анализ результатов

После запуска вы увидите результаты, похожие на приведённые ниже. Их можно разделить на две части: результаты диагностики и необходимые скрипты.

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

**Результаты диагностики**

После запуска файла phar отобразятся результаты проверки конфигурации. Обратите внимание: для **определения IP-адреса** потребуется **diag.php** нужно запускать вручную. Подробнее об этих результатах и ручном запуске см. в разделах «Запуск diag.php» и «Возможные результаты diag.php».

**Необходимые скрипты**

Под результатами диагностики отображаются два автоматически сгенерированных имени скриптов. Это имена наших **frontend\_loader.js** и **backend\_loader.php**, пути к которым нужно указать при [показе рекламы](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#adding-zones-to-a-page).

## NeverBlock PHP — установка вручную

### Скачивание файлов

Установку и большую часть настроек можно выполнить с помощью [установщика PHAR](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#neverblock-php-automatic-installation). Установить вручную можно следующим образом.

Последнюю версию (v3.14) можно скачать по этим ссылкам:

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

Или выполните следующие команды:

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

Из этой папки понадобятся следующие файлы:

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

### Переименование файлов (обязательно)

Чтобы блокировщики рекламы не заблокировали файлы сразу, их необходимо переименовать.

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

Один из тестов в **diag.php** проверяет наличие файла **backend\_loader.php**, поэтому ссылки в этом тесте нужно обновить, указав новое имя файла. В примере ниже используется та же конфигурация, что и на предыдущем изображении. В начале страницы измените следующую строку:

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

### Размещение файлов на сервере

Указанные выше файлы нужно разместить на сервере, где вы хотите показывать рекламу.

Скопируйте файлы в выбранную папку:

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

### Запуск diag.php

Теперь, когда файлы NeverBlock размещены на сервере, воспользуемся файлом **diag.php** , чтобы проверить, всё ли настроено правильно. Для этого откройте URL, по которому находится файл diag.php. В качестве примера возьмём адрес с предыдущего снимка экрана: `https://www.my-example-site.com/nb/diag.php`

Если всё настроено правильно, вы увидите следующее (файл журнала настроим в разделе [«Файл журнала»](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#logfile)):

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

Если результаты отличаются, может потребоваться дополнительная настройка.

### Возможные результаты diag.php

**Версия PHP:** Если версия PHP не поддерживается, вы получите соответствующее уведомление. Для стандартного решения NeverBlock требуется PHP версии 5.2 или выше.

**Наличие скрипта загрузчика backend:** Если проверка не пройдена, файл **backend\_loader.php** не удаётся найти с помощью **diag.php**. Это может быть связано с изменением имени файла или проблемой с путём.

**Отчёты об ошибках:** Это может отображаться как предупреждение. Оно не помешает работе решения NeverBlock.

**Наличие кеша** и **библиотеки cURL:** Если кеш и cURL отсутствуют, вы получите предупреждения. Это не помешает работе NeverBlock, но мы рекомендуем их настроить.

* Расширение [cURL](https://www.php.net/manual/en/book.curl.php) для PHP *(настоятельно рекомендуется)*
* Расширение [APCu](https://www.php.net/manual/en/book.apcu.php) для PHP или файловый кеш (см. [Кеширование](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#caching))

**Определение IP-адреса:** Если возникает ошибка сопоставления IP-адресов, см. раздел [Передача IP-адресов](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

**Рекламные запросы:** Если выполнение запросов занимает больше времени, чем ожидалось, вам может быть предложено увеличить значения параметров **REQUEST\_TIMEOUT\_MS** и **CONNECT\_TIMEOUT\_MS** . Порядок настройки описан в разделе [Настройка констант](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#configuring-constants).

## NeverBlock PHP — настройка

### Передача IP-адресов (при использовании Cloudflare и подобных сервисов)

Если вы используете сервис, например CloudFlare, который выступает посредником между пользователем и вашими серверами, IP-адрес, определённый в **backend\_loader.php** , может быть признан недействительным. Это может привести к некорректной регистрации кликов или показов рекламы. Чтобы исправить это, замените значение `$_SERVER["REMOTE_ADDR"]` , передаваемое классу *UserEnvironment* в файле **backend\_loader.php** , на правильное значение, передаваемое вашим сервисом кеширования или проксирования.

В случае Cloudflare мы передадим параметр `$_SERVER["HTTP_CF_CONNECTING_IP"]` . Пример приведён ниже.

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

После этого наш экземпляр *UserEnvironment* будет выглядеть следующим образом:

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

При использовании другого сервера, например Apache или NGINX, можно использовать `isset($_SERVER['HTTP_X_REAL_IP']) ? $_SERVER['HTTP_X_REAL_IP'] : $_SERVER['REMOTE_ADDR']` как показано ниже:

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

Теперь можно повторно запустить **diag.php**, и если из-за этого не проходил тест *определения IP-адреса* , теперь он должен завершиться успешно.

### Файл журнала

Эта настройка была необязательной при [автоматической установке](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#neverblock-php-automatic-installation). Если вы хотите записывать в журнал превышение времени ожидания запросов и другие ошибки, можно создать доступный для записи файл журнала. В этом примере он находится в том же каталоге, что и остальные файлы NeverBlock.

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

Создав этот файл (не забудьте убедиться, что в него можно записывать), измените **backend\_loader.php** и укажите путь к файлу. В начале файла `LOGFILE` имеет значение **NULL** ; его нужно заменить на путь к новому файлу журнала, например так:

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

После этого можно повторно запустить **diag.php**. Если файл создан, а путь указан правильно, вы увидите следующее.

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

### Кэширование

Эта настройка была необязательной при [автоматической установке](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#neverblock-php-automatic-installation). Кэширование может значительно ускорить отклик рекламы. Если у вас нет APC или APCu, поддержку которых **backend\_loader.php** имеет по умолчанию, рекомендуется настроить файловый кэш. Для этого создайте каталог, доступный для записи пользователю php, и укажите его путь в качестве значения константы **WRITABLE\_PATH** в файле **backend\_loader.php**. Если эта константа задана, по умолчанию будет использоваться файловый кэш вместо любых других кэшей (даже если у вас установлены APC или APCu).

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

### Ключи идентификации

Если вы выполнили [автоматическую установку](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#neverblock-php-automatic-installation) , эта настройка уже была выполнена в процессе установки. Эти ключи используются для шифрования, чтобы предотвратить подмену URL-адресов баннеров. Настоятельно рекомендуется заменить значения обоих ключей — *KEY\_1* и *KEY\_2* — в файле **backend\_loader.php** на уникальные строки.

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

### Файлы cookie

Файлы cookie используются для проверки корректной работы NeverBlock.

* **yuo1** — имя этого файла cookie по умолчанию **yuo1**, и это имя можно настроить в **frontend\_loader.js**. Этот файл cookie также можно отключить, установив [no\_cookie: true](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#how-do-i-configure-neverblock-from-a-different-domain).
* **zone-closed-**  — этот файл cookie гарантирует, что зона останется закрытой, если пользователь закрыл её при включённом AdBlock, а затем отключил AdBlock.

### Настройка констант

В файле **backend\_loader.php**определены некоторые константы. Рекомендуется оставить их без изменений, но в некоторых случаях может быть полезно изменить отдельные параметры.

* **CONNECT\_TIMEOUT\_MS**  — время ожидания подключения в миллисекундах для запросов curl/fsock.
* **REQUEST\_TIMEOUT\_MS**  — общее время ожидания запроса в миллисекундах (включая время, заданное параметром CONNECT\_TIMEOUT\_MS) для запросов curl/fsock.
* **LOGFILE**  — путь к файлу, доступному для записи, в который будут записываться сообщения, например сведения об ошибках и случаях превышения времени ожидания запросов.
* **ALLOW\_MULTI\_CURL**  — при возможности скрипт использует curl\_multi\_exec. Если это создаёт чрезмерную нагрузку на процессор, эту функцию можно отключить.

Настройки APC/APCu и файлового кэша:

* **WRITABLE\_PATH**  — путь к доступному для записи каталогу, в котором будут храниться файлы кэша. (Если задан, файловый кэш станет кэшем по умолчанию.)
* **CACHE\_INTERVAL\_BANNERS**  — срок хранения изображений баннеров в кэше (в секундах). Если установить значение 0, изображения НЕ будут кэшироваться.
* **CACHE\_INTERVAL\_SCRIPTS**  — срок хранения JavaScript-файлов в кэше. Если установить значение 0, они НЕ будут кэшироваться.
* **CACHE\_KEYS\_LIMIT\_BANNERS**  — ограничение на количество изображений баннеров, хранящихся в кэше (чтобы не расходовать чрезмерно ресурсы издателя). Если установить значение 0, ограничения не будет и все изображения будут кэшироваться.

Если вы настроили правила перезаписи Apache/nginx для доступа к файлу **backend\_loader.php** по другим URI:

* **LINK\_URL\_PREFIX**  — если задано, это значение станет новым URI для ссылок перехода на стороне интерфейса (к нему добавляется хеш URL для перенаправления).
* **BANNER\_URL\_PREFIX**  — если задано, это значение станет новым URI для изображений баннеров на стороне интерфейса (к нему добавляется хеш конкретного баннера).
* **KEY\_1**  — секретный ключ для защиты URL баннеров от подмены (теперь они передаются обратно загрузчику backend в запросе).
* **KEY\_2**  — секретный ключ для защиты URL баннеров от подмены (теперь они передаются обратно загрузчику backend в запросе).

## NeverBlock PHP — отображение рекламы

### Добавление зон на страницу

Эти фрагменты кода предназначены для NeverBlock версии 3.14 и новее. В более старых версиях используйте getexoloader вместо getmsgloader.

{% hint style="info" %}
Если вы используете одностраничное приложение, [динамическую загрузку](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#dynamic-loading-single-page-applications) необходимо реализовать.
{% endhint %}

Поддерживаются следующие форматы рекламы:

* Баннеры
* Нативная реклама
* Закреплённые баннеры
* Мгновенные сообщения

{% hint style="info" %}
Мультиформатная реклама пока не поддерживается. Однако вы можете использовать NeverBlock с отдельными баннерами, настроенными для показа в мультиформатной рекламе. Таким образом, вы сможете показывать мультиформатную рекламу обычным пользователям, а баннеры с поддержкой NeverBlock — пользователям с блокировщиками рекламы.
{% endhint %}

Обратите внимание: этот скрипт будет показывать рекламу только в том случае, если у пользователя установлен и включён блокировщик рекламы. Не удаляйте существующие стандартные рекламные теги.

В этом примере мы будем использовать конфигурацию, описанную в [Переименование файлов](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#renaming-the-files-mandatory). Убедитесь, что пути и имена файлов соответствуют вашей конфигурации.

**Шаг 1 — Размещение frontend\_loader.js на странице**

Внутри тега `<body>` в самом начале страницы добавьте следующее:

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

Этот код нужно добавить на страницу только один раз. Он также должен располагаться выше всех остальных скриптов зон.

**Шаг 2 — Добавление зоны NeverBlock**

Следующие фрагменты кода используются для объявления рекламных зон. Их нужно разместить в DOM в том месте, где должна отображаться зона. На странице можно добавить несколько таких блоков баннеров. **Не размещайте их в div-элементах с классами или специальными стилями, предназначенными для показа рекламы**, поскольку такие div-элементы будут обнаруживаться блокировщиками рекламы (например, `class="ad-footer"`, `style="width:300px;height:250px;"`).

Чтобы добавить рекламную зону, выполните следующие действия (не забудьте заменить значение idzone на идентификатор своей зоны):

```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"});
        
        //Чтобы использовать подидентификатор, добавьте в объект, передаваемый в addZone, числовой параметр sub
        //ExoLoader.addZone({"idzone":"111", "sub": "1"});
    })();
</script>
```

**Шаг 3 — Показ рекламы (backend\_loader.php)**

После того как все объявления *addZone()* добавлены, нужно показать рекламу. Для этого используйте функцию *serve* Она передаёт данные для всех ранее объявленных рекламных зон и **обычно должна вызываться на странице только один раз**. Максимальное **число зон, которые можно вызвать на странице, — 20**. Исключения возможны при динамической загрузке страницы, описанной в разделе [Динамическая загрузка](https://docs.exoclick.com/publishers/ru/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>
```

### Динамическая загрузка (одностраничные приложения)

Можно передать ссылку на DOM-элемент-контейнер, в который будет добавлен баннер. Тогда при вызове serve система будет знать, где разместить рекламную зону. Это делается следующим образом:

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

Также можно вызвать *serve()* с флагом force, чтобы показать рекламу в выбранный момент (например, в функции после отрисовки части страницы), а не при загрузке страницы:

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

Функцию *serve()* можно вызывать несколько раз. После каждого *serve()* вызов ExoLoader очистит предыдущие *addZone()* вызовы. Поэтому в следующем показе отобразятся только баннеры, для которых вы вызовете *addZone()* после вызова serve. *serve()*.

### Основной домен

Если вы уже являетесь клиентом ExoClick, на вашем сайте могут быть обычные рекламные зоны. Если вы используете домен, отличный от \*.exoclick.com (например, **ads.exosrv.com**), задайте для *domain\_base* объекта detector (`ExoLoader.getDetector()`) значение «exosrv.com» перед первым вызовом addZone. Это делается, как показано ниже:

```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>
...
<!-- Первый вызов 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>
```

### Реклама не отображается

Если реклама не отображается, сначала проверьте файл diag.php: возможно, некоторые параметры заданы неверно. Если все проверки пройдены успешно, создайте тестовую страницу только с одной рекламной зоной, чтобы убедиться, что она работает независимо. Если после этого реклама всё ещё не отображается, см. [раздел «Справка»](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#neverblock-php-help) для получения дополнительной информации.

## NeverBlock PHP — Справка

### Моя реклама не отображается. Что делать?

**Убедитесь, что вы используете последнюю версию кода решения для обхода блокировщиков рекламы.**

Мы постоянно совершенствуем решение на основе наших тестов, отзывов клиентов и изменений в блокировщиках рекламы. В старых версиях могут оставаться проблемы, которые мы уже исправили, поэтому, прежде чем проверять остальные пункты ниже, убедитесь, что у вас установлена последняя версия.

**Вы запускали diag.php?**

Этот файл может помочь выявить проблемы с настройкой загрузчика на серверной стороне.

**Проверьте вкладку «Сеть» на панели «Инструменты разработчика» в Chrome/FF.**

Файл **frontend\_loader.js** загружается правильно?

**Возможно, нужно указать другой путь?**

* Попробуйте указать для src полный путь вместо «/frontend\_loader.js».
* Убедитесь, что *ExoLoader.addZone()* вызывается **до** *ExoLoader.serve()*
* Проверьте вкладку «Консоль» на панели «Инструменты разработчика» в Chrome/FF. Там могут отображаться ошибки, связанные с **frontend\_loader.js**
* Выполните `ExoLoader.getDebug();` в консоли JavaScript, чтобы посмотреть, что происходит. Вывод будет выглядеть так:

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

**Проверьте идентификаторы рекламных зон.**

Убедитесь, что рекламная зона с указанным вами idzone существует и принадлежит вам.

**Вы размещаете рекламный код во фреймах iframe?**

Содержимое iframe загружается после основной страницы. Если вызвать *addZone()* в iframe и вызвать *serve()* на главной странице, *serve()* будет выполнен до *addZone()*, и это не сработает. С iframe можно работать двумя способами:

1. Разместите всё внутри iframe: весь код из шагов 1, 2 и 3 раздела [Добавление зон на страницу](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#adding-zones-to-a-page) должен находиться внутри него. Но если на странице несколько таких iframe, может возникнуть конфликт, поскольку в этом решении используется cookie. Если имя cookie совпадает, рекламные объявления в iframe могут перепутаться. Перед вызовом serve можно изменить имя cookie, например:

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

Недостаток этого подхода в том, что потребуется несколько загрузчиков backend, в каждом из которых нужно указать своё имя cookie:

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

2. Разместите код из шага 1 (подключение файла загрузчика frontend) на главной странице сайта. Внутри iframe вызовите addZone. Чтобы правильно получить объект ExoLoader, обновите стандартный вызов, используя **window\.top**.document.dispatchEvent; также передайте в addZone параметр **doc** со значением свойства document вашего 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});
})();
```

Также вызовите serve() внутри последнего 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"});
})();
```

**Используете ли вы JS-фреймворк во frontend сайта?**

Убедитесь, что вы не переопределяете innerHTML элементов, в которых выполняются вызовы *addZone()* Вызов *addZone()* размещает DOM-заполнитель в месте своего вызова. Если его перезаписать, скрипт не сможет заполнить его данными рекламного объявления.

**Файл backend\_loader.php возвращает пустой ответ?**

Если да, проверьте журнал ошибок PHP на наличие связанных ошибок. Открыв страницу с кодом ExoLoader, перейдите по адресу: `http://yoursite/backend_loader.php?exoDebug=exoDebug`. Если обнаружены ошибки тайм-аута *curl/fsock* , возможно, потребуется увеличить значения **CONNECT\_TIMEOUT\_MS** и **REQUEST\_TIMEOUT\_MS** в файле **backend\_loader.php**.

### Рекламные объявления отображаются, но в статистике нет кликов или показов

**Вы используете CloudFlare или ваши веб-серверы проксируются каким-либо другим сервисом?**

Запросы NeverBlock для получения рекламы отправляются не напрямую с браузера конечного пользователя на наш сервер, поэтому для передачи IP-адреса пользователя мы полагаемся на файл **backend\_loader.php** на стороне издателя. Мы получаем его из `$_SERVER['REMOTE_ADDR']` — глобальной переменной PHP в этом скрипте. Если инфраструктура издателя настроена так, что здесь указано неверное значение IP-адреса пользователя, это может привести к некорректному учёту показов или кликов. Чтобы исправить проблему, см. раздел [Передача IP-адресов](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

### В приватном режиме Firefox (или другого браузера) показываются и NB-, и обычные объявления

**Проверьте, правильно ли настроен параметр domain\_base.**

[Здесь](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#domain-base) пример настройки основного домена можно найти здесь. Проблема в том, что в некоторых браузерах, чаще всего в FF, режим приватного просмотра блокирует запросы к определённым доменам. Например, Exoclick.com внесён в чёрный список. Поэтому, если код обычной зоны содержит домен «exoclick.com», режим приватного просмотра действует как блокировщик рекламы, и решение NB должно показывать рекламу. Однако другие наши домены режим приватного просмотра может не блокировать. Чтобы избежать показа двойной рекламы, детектор NB должен знать, с какого домена запрашивается обычная реклама, чтобы корректно определить, блокируется ли она в данный момент.

### Как настроить NeverBlock для работы с другим доменом?

1. В файле *frontend\_loader.js*найдите функцию `serve: function(params)` и раскомментируйте набор параметров.
2. Добавьте другой домен и задайте `force: true` и `no_cookie: true`:

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

3. Затем укажите на странице путь к NeverBlock с новым доменом.

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

### Что делать, если обнаружение блокировщика рекламы даёт ложноположительный результат?

Иногда пользователи с отключённым AdBlock всё равно видят рекламу NB вместе с обычной рекламой. Это может происходить потому, что NB пытается загрузить на страницу реальный рекламный скрипт-ловушку, чтобы проверить, блокируется ли он. При медленном соединении загрузка этого скрипта иногда занимает слишком много времени, и NB может решить, что он заблокирован, и запросить рекламу. Из-за особенностей работы некоторых блокировщиков рекламы невозможно определить, ещё не завершилась ли загрузка или она не завершится вовсе из-за блокировщика. Для большинства сайтов и пользователей это не проблема. Если такое происходит у значительной части вашей аудитории, рекомендуем увеличить тайм-аут обнаружения NB с помощью функции **setTimeout** в **ExoLoader**, например:

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

NeverBlock использует простой конечный адрес для проксирования запросов к серверам синдикации ExoClick.

Этот адрес описан ниже. Вы можете использовать его для создания собственной интеграции на любом удобном вам языке.

### API v1

Эта версия API поддерживает все форматы, доступные в решении NeverBlock (баннеры, липкие баннеры, нативную рекламу и мгновенные сообщения).

**Запрос для одной зоны**

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

**Запрос для нескольких зон**

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

Приведённые выше запросы похожи, за исключением того, что запросы для нескольких зон должны иметь структуру с инкрементальной нотацией массива (*то есть zones\[0]\[idzone], zones\[1]\[idzone],…*), как показано в примере.

{% hint style="info" %}
В одном запросе можно указать не более **20** зон.
{% endhint %}

**Параметры**

Для **всех** запросов необходимо указать следующие параметры:

* **zones\[N]\[idzone]** - *идентификатор запрашиваемой зоны*
* **user\_ip** - *IP-адрес конечного пользователя (используется для таргетинга)*

**Заголовки**

Для **всех** запросов должны быть заданы следующие заголовки:

* **X-Forwarded-For** - *Исходный IP-адрес клиента*
* **Referer** - *Адрес сайта, с которого выполнен переход*
* **User-Agent** - *Идентификатор клиента*
* **Accept-Language** - *Язык и региональные настройки клиента*

**Ответ**

Ответы с данными JSON, возвращаемые в приведённых выше примерах, выглядят следующим образом.

Ответ для одной зоны:

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

Ответ для нескольких зон:

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

**Данные ответа**

Из **объекта** в возвращаемых данных JSON можно извлечь следующие значения для каждой зоны, чтобы показывать рекламу:

* **idzone**: идентификатор зоны (помогает различать запросы для разных зон при обработке)
* **type**: тип рекламы; в **рендерерах** можно найти соответствующий скрипт рендерера по умолчанию. (Для работы скрипту рендерера по умолчанию требуется объект ExoLoader в его области видимости.)
* **data**: данные объявления, специфичные для соответствующего типа рекламы. Чаще всего для баннеров и подобных форматов встречаются поля **image** и **url** , некоторые типы также содержат дополнительные параметры.

При использовании API вам нужно самостоятельно написать код, который на основе предоставленных данных создаёт DOM-элементы для отображения на клиентской стороне. Наши рендереры по умолчанию — это скрипты, выполняющие эту задачу в рамках стандартного решения NeverBlock (установка PHP + JavaScript). Их можно использовать только с объектом JavaScript ExoLoader: он хранит ответы после обработки в собственном формате и предоставляет несколько вспомогательных функций, которые рендереры используют и ожидают найти определёнными.

### API v0

Эта версия API поддерживает только баннеры. Для зон других типов она возвращает *false* .

**Запрос для одной зоны**

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

**Запрос для нескольких зон**

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

Приведённые выше запросы похожи, за исключением того, что запросы для нескольких зон должны иметь структуру с инкрементальной нотацией массива (*то есть zones\[0]\[idzone], zones\[1]\[idzone],…*), как показано в примере.

{% hint style="info" %}
В одном запросе можно указать не более **20** зон.
{% endhint %}

**Параметры**

Для **всех** запросов необходимо указать следующие параметры:

* **zones\[N]\[idzone]** - *идентификатор запрашиваемой зоны*
* **user\_ip** - *IP-адрес конечного пользователя (используется для таргетинга)*

**Заголовки**

Для **всех** запросов должны быть заданы следующие заголовки:

* **X-Forwarded-For** - *Исходный IP-адрес клиента*
* **Referer** - *Адрес сайта, с которого выполнен переход*
* **User-Agent** - *Идентификатор клиента*
* **Accept-Language** - *Язык и региональные настройки клиента*

**Ответ**

Ответы с данными JSON, возвращаемые в приведённых выше примерах, выглядят следующим образом.

Ответ для одной зоны:

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

Ответ для нескольких зон:

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

**Данные ответа**

Из возвращаемых данных JSON можно извлечь следующие значения, чтобы показывать рекламу:

* **url**: URL перехода, которую следует использовать для обёртки изображения баннера
* **imgurl**: URL источника изображения баннера
* **idzone**: идентификатор зоны (помогает различать запросы для разных зон при обработке)

## Прокси NeverBlock

### Что это?

Прокси NeverBlock — кроссплатформенное приложение для обработки запросов к API и кэширования рекламы. Сервис работает в фоновом режиме и предоставляет пользователю более прямую конечную точку для получения рекламы. Не рекомендуется выбирать прокси NeverBlock вместо стандартного решения NeverBlock на PHP, поскольку прокси не обладает таким же широким функционалом.

Иногда блокировщики рекламы начинают активно блокировать сайты, из-за чего NeverBlock PHP перестаёт работать. Если это происходит на вашем сайте, попробуйте использовать прокси NeverBlock.

### Скачать прокси NeverBlock

Скачайте готовый архив для вашей платформы:

* [neverblock-proxy\_v1.0.1\_darwin\_386.tar.gz](https://3591890222-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://3591890222-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://3591890222-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://3591890222-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://3591890222-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://3591890222-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://3591890222-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://3591890222-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)
* [Исходный код (zip)](https://3591890222-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2Fjs3iKFWD2UJ9wHao2JbJ%2Fneverblock-proxy-1.0.1.zip?alt=media)
* [Исходный код (tar.gz)](https://3591890222-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)

Для работы рекламы NeverBlock необходимы следующие файлы:

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

### Настройка прокси

**Разместите файлы на сервере**

После загрузки файлов вы можете поместить их в каталог на сервере, как показано на скриншоте ниже:

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

**Создайте кэш**

Создайте доступный для записи каталог, в котором будут храниться загруженные файлы. Его можно создать в той же папке, поскольку путь мы укажем позже.

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

**Измените обязательные параметры конфигурации**

В верхней части файла **neverblock-conf.toml** есть раздел с пометкой *Обязательные параметры*. В этом разделе мы укажем пути на основе конфигурации, показанной на скриншотах выше. Обратите внимание: эти пути будут зависеть от вашей конфигурации.

```toml
#####################
#     Обязательные параметры     #
#####################

## Путь к кэшу (ВНИМАНИЕ: все файлы здесь будут регулярно удаляться!)
cache_path = "nb-cache/"

## Относительный путь к кэшу от корневого каталога веб-сервера (например, "images/cache/"; если не задан, используется cache_path)
www_cache_path = "nb-proxy/nb-cache/"

## Путь и имя файла HTML-перенаправления (относительно корневого каталога веб-сервера, например "misc/redirect.html")
www_redirect_path = "nb-proxy/redirect.html"
```

**Запустите службу**

Запустите исполняемый файл из командной строки или терминала — это необходимо сделать из каталога, в котором он находится. Так запустится служба, и после этого вы сможете отправлять запросы curl на localhost через порт 8080.

### Использование

Для получения зон используется запрос cURL. Его можно реализовать на любом выбранном вами языке. В ответе на запрос cURL будет JSON с URL перехода по клику и соответствующим путем к изображению. Изображение также будет загружено по указанному вами пути. При передаче параметра **user\_ip** учитывайте рекомендации из раздела [Передача IP-адресов](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#passing-ips-using-cloudflare-etc). Структура запроса выглядит так:

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

На примере этой структуры покажем, как использовать ее в 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);
```

### Необязательные параметры конфигурации

В файле **neverblock-conf.toml**:

* **debug** - Включить режим отладки
* **port** - Порт, на котором прослушивает сервис
* **log** - Журнал приложения
* **http\_timeout** - Тайм-аут HTTP-запроса (сек.)
* **cache\_ttl** - Время жизни кэшированных файлов (мин.)
* **cache\_purge\_frequency** - Интервал запуска очистки кэша (мин.)
* **syndication** - URL синдикации Exoclick. Подробнее см. в разделе [Базовый домен](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#domain-base) о случаях, когда его следует изменить

### Флаги

С помощью флагов можно переопределить настройки из файла конфигурации:

```bash
heisenberg:neverblock-proxy craig$ ./neverblock-proxy -h
Neverblock-Proxy — система управления рекламным трафиком AdBlock

Использование:
  neverblock-proxy [flags]

Флаги:
  -c, --cache-path string    Путь к кэшу изображений
  -C, --config-file string   Файл конфигурации
  -l, --log string           Файл журнала
  -p, --port string          Порт сервиса
```

## Плагин WordPress

### Установка плагина

Плагин можно скачать по следующей ссылке:

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

Установка плагина NeverBlock для WordPress ничем не отличается от установки любого другого плагина. В меню выберите **Плагины** -> **Загрузить плагин** -> выберите плагин NeverBlock для установки.

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

**Шаг 1 — Введение**

На первой странице мастера установки не потребуется вводить никаких данных.

**Шаг 2 — Системные требования**

На этом шаге будут показаны результаты проверки конфигурации. Результаты могут различаться в зависимости от настроек вашей системы.

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

Подробнее о каждой из проверок, результатах и ручном запуске см. в разделах «Запуск diag.php» и «Возможные результаты diag.php».

**Шаг 3 — Настройки плагина**

В разделе конфигурации NeverBlock PHP есть раздел о [настройке констант](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#configuring-constants). На шаге 3 мастера установки можно настроить эти параметры. Подробное описание каждого параметра приведено в соответствующем разделе, а также на снимке экрана ниже.

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

Эти настройки можно изменить в любое время после установки.

**Шаг 4 — Готово**

После завершения установки в меню появится пункт **NeverBlock** . Здесь при необходимости можно изменить настройки плагина:

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

### Добавление зон в WordPress

Добавить зоны NeverBlock на страницу WordPress можно двумя способами.

**Шорткоды**

При создании или редактировании записи в TinyMCE добавьте следующий код, указав правильный idzone:

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

Также можно использовать следующий пример в шаблоне темы:

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

Обратите внимание: необязательный атрибут `container_id` можно использовать, чтобы указать идентификатор узла DOM. Этот узел будет добавлен в соответствующий div. Чтобы это работало, div должен находиться перед шорткодом, иначе NeverBlock не сможет найти элемент.

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

**Обычные скрипты**

При редактировании шаблона темы можно использовать стандартные скрипты, описанные в разделе [Показ рекламы](https://docs.exoclick.com/publishers/ru/adblock/neverblock.md#adding-zones-to-a-page).

## История изменений

См. файл CHANGELOG, включённый в пакет программного обеспечения.

### История изменений NeverBlock PHP

**3.14 (21.10.2026)**

* Загрузчик серверной части NeverBlock не показывает рекламу локально, даже после устранения уведомлений об устаревших функциях PHP и проблем с определением IP-адреса
* Начиная с версии 3.14 используется событие загрузчика getmsgloader. При обновлении до версии 3.14 обновите фрагмент кода. Старый фрагмент (getexoloader) вызывает ошибку: Cannot read properties of undefined (reading 'addZone').

**3.12 (10.01.2025)**

* Исправлена ошибка, из-за которой NeverBlock > diag.php при определении IP всегда возвращал «Can’t access service to compare IPs»

**3.11 (11.07.2023)**

* Исправлена совместимость с PHP 5.2 и более поздними версиями

**3.10 (12.01.2022)**

* Добавлен параметр для обеспечения обратной совместимости
* Добавлена поддержка формата WebP

**3.9 (03.12.2021)**

* Добавлено ограничение времени ожидания при обнаружении, чтобы избежать ложных срабатываний при медленном соединении

**3.8 (10.06.2021)**

* Удалён код, связанный с popunder (предпочтителен встроенный способ), и ненужная cookie

**3.7 (05.07.2019)**

* Добавлены меры против фильтра «anti-cv»

**3.6 (16.05.2019)**

* Удалена ссылка на объект JS, которая иногда блокируется
* В diag добавлен новый API для определения IP (поддерживает IPv6)

**3.5 (14.03.2019)**

* Добавлена возможность удалять частично заблокированную рекламу
* Добавлен параметр no\_cookie, позволяющий размещать backend\_loader.php на другом домене
* Добавлена поддержка кэша acpu

**3.4 (09.07.2018)**

* Улучшено определение (ожидание загрузки страницы)

**3.3 (25.05.2018)**

* Обновлена ссылка на документацию по передаче IP-адресов
* Исправлена ошибка при переопределении window\.ExoLoader некоторыми блокировщиками (uBlock)
* Заменён устаревший сервис определения IP-адреса

**3.2 (15.03.2018)**

* Исправлена ошибка в PHP версии <= 5.3

**3.1 (07.03.2018)**

* Добавлена автоматическая рандомизация имён параметров баннеров и ссылок, а также более гибкое управление
* Исправлена ошибка JavaScript, возникавшая при многократном вызове serve()

**3.0 (30.01.2018)**

* Добавлено понятие запрошенных рендереров
* Добавлены новые форматы рекламы: нативная реклама, фиксированный баннер, мгновенные сообщения для веб- и мобильных устройств
* Динамическое присвоение имени объекту ExoLoader на случай, если блокировщики рекламы делают его неизменяемым
* Небольшие изменения для упрощения работы установщика phar и плагина WordPress
* Версия PHP автоматически проверяется для multi curl

**2.25 (12.10.2017)**

* Исправлена проверка изменения текста тела ответа в диагностическом запросе рекламы
* Добавлено журналирование ошибок, возвращаемых рекламным сервером
* Исправлена диагностика определения IP-адреса (используются настройки из backend\_loader.php)

**2.24 (15.08.2017)**

* Добавлена проверка определения IP-адреса в скрипт диагностики
* Добавлена возможность размещать backend\_loader.php на другом домене

**2.22 (13.06.2017)**

* Определение: стили box-sizing сайта больше не влияют на параметры DOM-ловушки

**2.21 (09.06.2017)**

* Устранена проблема ложных срабатываний при обнаружении блокировщиков рекламы

**2.20 (01.06.2017)**

* Изменено обнаружение блокировщиков
* Исправлена проблема, из-за которой несколько запусков serve() перезаписывали cookie друг друга

**2.19 (24.05.2017)**

* Устранена проблема с кампаниями обмена и баннером 404
* Небольшие исправления для PHP версии 5.2

**2.18 (07.04.2017)**

* Для JavaScript отправляется корректный заголовок при строгой проверке заголовков

**2.17 (27.03.2017)**

* Исправлена ошибка интерфейса в backend\_loader.php для старых версий PHP
* Исправлена проблема с открытием ссылки в frontend\_loader.php при указании LINK\_URL\_PREFIX

**2.16 (14.03.2017)**

* Разрешено динамически добавлять зоны, а не только при загрузке страницы
* Ссылка на контейнер добавлена в качестве параметра addZone

**2.15 (08.03.2017)**

* Добавлен файловый кэш.
* Уменьшен объём передаваемых данных.
* Загрузка баннеров через `<img>`, вместо фонового стиля с base64.

**2.14 (30.09.2016)**

* Исправлена функция resolveMulti: теперь она всегда возвращает массив

**2.13 (14.09.2016)**

* Параметры POST корректно передаются в openLink

**2.12 (12.09.2016)**

* Встроенные стили полностью перенесены в классы CSS

**2.11 (09.09.2016)**

* Исправлена проблема с неопределённым document.contains в IE

**2.10 (07.09.2016)**

* Исправлены проблемы с подключением по IPv6 и curl
* Исправлены проблемы с неправильными ссылками перехода из-за серверных псевдонимов

**2.9 (02.09.2016)**

* Механизм открытия ссылок изменён: теперь перенаправление выполняется через загрузчик backend

**2.8 (30.08.2016)**

* Устранена проблема с HTTPS-рекламой, связанная с разрешением DNS и кэшированием вне curl

**2.7 (22.08.2016)**

* Конечные точки рекламы переведены на HTTPS, чтобы избежать проблем со смешанным содержимым

**2.6 (17.08.2016)**

* Более универсальный DOM-плейсхолдер для баннеров
* Исправлена проблема с заголовками
* Ошибки отделены от отладочных сообщений в загрузчике frontend
* Инструкции по устранению неполадок

**2.5 (02.08.2016)**

* Добавлено журналирование запросов, время ожидания которых истекло, и других ошибок
* Исправлена ошибка JavaScript, возникавшая при перезаписи DOM-плейсхолдера для рекламы

**2.4 (22.07.2016)**

* Улучшены тайм-ауты
* Файл диагностики и улучшенная отладка

**2.3 (20.07.2016)**

* Исправлена небольшая проблема при отправке запроса загрузчику бэкенда, если не было добавлено ни одной зоны

**2.2 (15.07.2016)**

* Новый домен для ads-endpoint с улучшенной балансировкой нагрузки

**2.1 (27.06.2016)**

* Исправлена несовместимость с фреймворком Prototype

**2.0 (14.06.2016)**

* Открытый релиз
* Один запрос для нескольких объявлений
* Унифицированный загрузчик баннеров

### Список изменений NeverBlock Proxy

**1.0.1**

* Добавлена возможность передавать язык и Referer в запросе
* Примеры обновлены

**1.0.0**

* Первый релиз


---

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