> 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/zh/guang-gao-lan-jie/yong-bu-lan-jie.md).

# 永不拦截

## 概览

### 反广告拦截

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 Installer 是一款用于安装 NeverBlock PHP（3.0 版）解决方案的工具。您可以使用它代替 [手动安装](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#neverblock-php-manual-installation)中的步骤。它会将文件安装到指定目录，或默认的 **nb** 目录。安装程序还会处理部分配置，包括 [文件重命名](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#renaming-the-files-mandatory) 和 [识别密钥](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#identification-keys).

### 下载安装程序

可通过以下链接下载最新版本：

* [neverBlockInstaller.phar.zip – v1.13](https://117853814-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/zh/guang-gao-lan-jie/yong-bu-lan-jie.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://117853814-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/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#adding-zones-to-a-page).

## NeverBlock PHP - 手动安装

### 下载文件

安装和大部分配置都可以通过 [phar 安装程序](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#neverblock-php-automatic-installation)完成。也可以按以下步骤手动安装。

可通过以下链接下载最新版本（v3.14）：

* [latest.zip – v3.14](https://117853814-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://117853814-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://117853814-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://117853814-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** 文件来验证目前一切是否正常。前往 diag.php 文件所在的 URL 即可进行检查。以上一张截图为例，我们的 URL 如下： `https://www.my-example-site.com/nb/diag.php`

如果目前一切正常，您应该会看到以下内容（我们将在 [日志文件](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#logfile)):

![](https://117853814-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\_loader.php** 无法被 **diag.php**找到。这可能是由于文件名更改或路径问题导致的。

**错误报告：** 这可能会显示为警告。此警告不会影响 NeverBlock 解决方案的运行。

**缓存是否存在** 和 **cURL 库：** 如果缓存和 cURL 均不可用，您会收到警告。这不会影响 NeverBlock 的运行，但我们建议配置好这两项。

* PHP [cURL](https://www.php.net/manual/en/book.curl.php) 扩展 *（强烈推荐）*
* PHP [APCu](https://www.php.net/manual/en/book.apcu.php) 扩展，或文件缓存（参见 [缓存](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#caching))

**IP 检测：** 如果出现 IP 匹配错误，请参阅 [传递 IP](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#passing-ips-using-cloudflare-etc).

**广告请求：** 如果请求耗时超出预期，系统可能会提示您增大 **REQUEST\_TIMEOUT\_MS** 和 **CONNECT\_TIMEOUT\_MS** 设置的值。相关说明请参阅 [配置常量](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#configuring-constants).

## NeverBlock PHP - 配置

### 传递 IP（使用 Cloudflare 等服务）

如果您使用 CloudFlare 等位于用户与实际服务器之间的服务， **backend\_loader.php** 检测到的 IP 可能会被判定为无效。这可能导致广告点击或展示次数的统计不准确。要解决此问题，您可以将传递给 `$_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/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#neverblock-php-automatic-installation)期间的可选配置。如果希望记录请求超时和其他错误，可以创建一个可写的日志文件。在此示例中，日志文件与其他 NeverBlock 文件放在同一目录中。

![](https://117853814-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://117853814-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/zh/guang-gao-lan-jie/yong-bu-lan-jie.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/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#neverblock-php-automatic-installation) ，安装过程中已完成此操作。这些密钥用于加密，以防止横幅网址被篡改。强烈建议将 *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**中配置。也可以通过设置 [no\_cookie: true](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#how-do-i-configure-neverblock-from-a-different-domain).
* **zone-closed-** - 如果用户在启用广告拦截器时关闭了广告位，之后又关闭了广告拦截器，此 Cookie 可确保该广告位仍保持关闭状态。

### 配置常量

以下常量定义在 **backend\_loader.php**中。建议保持这些常量不变，但在某些情况下，修改部分配置可能会有所帮助。

* **CONNECT\_TIMEOUT\_MS** - curl/fsock 请求的连接超时时间（毫秒）。
* **REQUEST\_TIMEOUT\_MS** - curl/fsock 请求的总超时时间（毫秒），其中也包括 CONNECT\_TIMEOUT\_MS 所设定的时间。
* **LOGFILE** - 用于记录消息（例如错误以及请求超时情况）的可写文件路径。
* **ALLOW\_MULTI\_CURL** - 在可能的情况下，脚本会尝试使用 curl\_multi\_exec。如果这会增加 CPU 负担，可以将其关闭。

APC/APCu 和文件缓存设置：

* **WRITABLE\_PATH** - 可写目录的路径，用于存放缓存文件。（如果设置了此项，文件缓存将成为默认缓存。）
* **CACHE\_INTERVAL\_BANNERS** - 横幅图片的缓存时长（秒）；设为 0 时，图片将不会被缓存。
* **CACHE\_INTERVAL\_SCRIPTS** - JavaScript 文件的缓存时长；设为 0 时，这些文件将不会被缓存。
* **CACHE\_KEYS\_LIMIT\_BANNERS** - 缓存中允许存储的横幅图片数量上限（避免过度占用发布商资源）；设为 0 时不设上限，所有图片都会被缓存。

如果你设置了 Apache/Nginx 重写规则，以便通过其他 URI 访问 **backend\_loader.php** ：

* **LINK\_URL\_PREFIX** - 如果设置，此值将成为前端点击链接的新 URI（重定向用的 URL 哈希会附加在其后）。
* **BANNER\_URL\_PREFIX** - 如果设置，此值将成为前端横幅图片的新 URI（特定横幅的哈希会附加在其后）。
* **KEY\_1** - 用于防止横幅 URL 被篡改的密钥（这些 URL 现在会随请求传回后端加载器）。
* **KEY\_2** - 用于防止横幅 URL 被篡改的密钥（这些 URL 现在会随请求传回后端加载器）。

## NeverBlock PHP - 展示广告

### 向页面添加广告位

这些代码片段适用于 NeverBlock 3.14 及更高版本。旧版本请使用 getexoloader，而不是 getmsgloader。

{% hint style="info" %}
如果你使用的是单页应用，那么 [动态加载](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#dynamic-loading-single-page-applications) 必须实现。
{% endhint %}

支持以下广告格式：

* 横幅广告
* 原生广告
* 粘性横幅广告
* 即时消息

{% hint style="info" %}
目前尚不支持多格式广告。不过，你仍然可以将 NeverBlock 与已设置为用于多格式广告的单个横幅广告搭配使用。这样，普通用户可以看到多格式广告，而启用了 NeverBlock 的横幅广告则可用于定向投放给使用广告拦截器的用户。
{% endhint %}

请注意，此脚本仅会在用户安装并启用了广告拦截器时显示广告。请勿移除任何现有的标准广告代码。

在本示例中，我们将使用 [重命名文件](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.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 的值替换为你的广告位 ID）：

```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"});
        
        //如需使用子 ID，请向传递给 addZone 的对象添加一个数值型 sub 参数
        //ExoLoader.addZone({"idzone":"111", "sub": "1"});
    })();
</script>
```

**步骤 3 - 投放广告（backend\_loader.php）**

包含所有 *addZone()* 声明后，我们就可以投放广告了。为此，我们将使用 *serve* 函数。它会为之前声明的所有广告位提供数据， **通常在页面上只应调用一次**。页面上可调用的 **广告位数量最多为 20 个**。动态加载页面时不受此限制，详情请参阅 [动态加载](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.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**），则应在首次调用 addZone 之前，将检测器对象（ *domain\_base* 的`ExoLoader.getDetector()`）设置为“exosrv.com”。如下所示：

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

### 没有广告显示

如果没有广告显示，请先检查 diag.php 文件，确认配置是否有误。如果所有测试都成功，请创建一个只包含一个广告位的测试页面，以确认其能单独正常工作。如果此时仍没有广告显示，请参阅 [帮助](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.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
```

**检查广告位 ID。**

请确保你提供的 idzone 对应的广告位确实存在，并且属于你。

**你是否将广告代码放在 iframe 中？**

iframe 的内容会在主页面之后加载。如果你调用 *addZone()* 在 iframe 中，并调用 *serve()* 在主页面上， *serve()* 将在……之前执行 *addZone()*，因此无法正常工作。使用 iframe 有两种方法：

1. 将所有内容都放在 iframe 中： [向页面添加广告位](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#adding-zones-to-a-page) 中的第 1、2 和 3 步代码都必须放在 iframe 内。但如果页面上有多个这样的 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"});
})();
```

这种方法的缺点是需要使用多个后端加载器，并在其中设置不同的 Cookie 名称，例如：

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

2. 在网站主页面中添加第 1 步的代码（引入前端加载器文件）。在 iframe 内调用 addZone。为了正确获取 ExoLoader 对象，需要更新标准调用，改用 **window\.top**.document.dispatchEvent，并且还要将 **doc** 参数传给 addZone，使其指向 iframe 的 document 属性：

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

同样，在最后一个 iframe 内调用 serve()：

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

**你的网站前端是否使用了 JavaScript 框架？**

请确认你没有覆盖包含 *addZone()* 调用的元素的 innerHTML。 *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，或者你的 Web 服务器是否通过其他服务进行了代理？**

NeverBlock 广告请求不会从最终用户的浏览器直接发送到我们的服务器，因此我们依赖发布商端的 **backend\_loader.php** 向我们传递用户 IP。我们从此脚本的 PHP 全局变量中获取该值： `$_SERVER['REMOTE_ADDR']` 如果发布商的基础设施配置导致此处的用户 IP 值不正确，就可能出现展示次数或点击数据无效的问题。请参阅 [传递 IP 地址](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#passing-ips-using-cloudflare-etc).

### 在 Firefox（或其他浏览器）的隐私模式下，NB 广告和普通广告都在显示

**请检查 domain\_base 设置是否配置正确。**

[此处](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.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>
```

### 如果出现 Ad Block 检测误报怎么办？

有时，即使用户已停用 AdBlock，仍会看到 NB 广告与常规广告同时显示。这可能是因为 NB 会尝试在页面中加载一个真实广告投放脚本作为蜜罐，以检查该脚本是否被拦截。有时，在网络连接较慢时，该脚本加载耗时过长，NB 可能会认为它已被拦截，因此决定请求广告。由于某些广告拦截器的工作方式，无法判断加载只是尚未完成，还是会因拦截器的作用而永远无法完成。对大多数网站和用户而言，这并不是问题。如果这一情况影响了相当一部分用户，我们建议通过 **setTimeout** 函数增大 NB 检测的超时时间，例如在 **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>
```

## NeverBlock API

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]** - *要请求的广告位 ID*
* **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"
  }
}
```

**响应数据**

可从以下内容中提取这些值： **zones** 在返回的 JSON 载荷中，每个区域对应的对象可提取以下值，用于广告投放：

* **idzone**：区域标识符（处理请求时可用于区分不同区域的请求）
* **type**：广告类型；在 **renderers** 中，可以获取与之对应的默认渲染器脚本。（默认渲染器脚本要求其作用域中存在 ExoLoader 对象。）
* **data**：特定广告类型对应的广告数据。最常见的是 **image** 和 **url** ，它们通常适用于横幅广告及类似类型；其中一些类型还带有其他参数。

如果使用 API，则需要自行编写代码，根据提供的数据生成要在前端显示的 DOM。我们的默认渲染器是脚本，负责默认 NeverBlock 解决方案（PHP + JavaScript 安装）中的这项工作。这些脚本只能与 ExoLoader JS 对象配合使用。该对象会在内部以自己的格式存储经过后处理的响应，并提供渲染器所使用且要求已定义的多个辅助函数。

### 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]** - *要请求的广告位 ID*
* **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**：用于包裹横幅图片的点击链接
* **imgurl**：横幅图片源 URL
* **idzone**：区域标识符（处理请求时可用于区分不同区域的请求）

## NeverBlock Proxy

### 这是什么？

NeverBlock Proxy 是一款跨平台应用，用于处理 API 请求和缓存广告。该服务在后台运行，为用户提供一个更直接的广告获取端点。不建议选择 NeverBlock Proxy 而非标准的 NeverBlock PHP 解决方案，因为它的功能没有后者全面。

有时，广告拦截器会针对网站采取激进的拦截措施，导致 NeverBlock PHP 无法继续工作。如果你的网站遇到这种情况，可以考虑使用 NeverBlock Proxy。

### 下载 NeverBlock Proxy

下载适用于你所用平台的预编译压缩包：

* [neverblock-proxy\_v1.0.1\_darwin\_386.tar.gz](https://117853814-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://117853814-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://117853814-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://117853814-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://117853814-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://117853814-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://117853814-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://117853814-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://117853814-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://117853814-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://117853814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FSBQwdGZNe43QO6HCTXRW%2Fneverblock_nbproxy_1.png?alt=media)

**创建缓存目录**

创建一个可写目录，用于存储下载的文件。可以在同一文件夹中创建该目录，因为稍后我们会设置其路径。

![](https://117853814-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"
```

**启动服务**

在命令提示符或终端中启动二进制文件——必须在该文件所在目录中执行。这样会启动服务，之后你应该就可以向 localhost 的 8080 端口发送 curl 请求了。

### 用法

使用 cURL 请求获取广告位（zones）。此请求可以使用任何你选择的语言实现。cURL 请求会返回一个 JSON 载荷，其中包含点击 URL 和相关图片路径。图片也已下载到你指定的路径。传递 **user\_ip** 时，请注意 [传递 IP](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.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** - Exoclick Syndication URL。有关详情，请参阅 [域名基址](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#domain-base) 了解何时需要更改此项

### 标志

可以使用标志覆盖配置文件中的设置：

```bash
heisenberg:neverblock-proxy craig$ ./neverblock-proxy -h
Neverblock-Proxy - 广告拦截流量处理器

用法：
  neverblock-proxy [flags]

标志：
  -c, --cache-path string    图像缓存路径
  -C, --config-file string   配置文件
  -l, --log string           日志文件
  -p, --port string          服务端口
```

## WordPress 插件

### 插件安装

可通过以下链接下载该插件：

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

在 WordPress 中安装 NeverBlock 插件与安装其他插件并无不同。在菜单中选择 **插件** -> **上传插件** -> 选择要安装的 NeverBlock 插件。

![](https://117853814-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://117853814-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/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#configuring-constants)。安装向导的步骤 3 可用于配置这些设置。每项设置的详细信息都在相关章节中介绍，下面的屏幕截图也对此进行了说明。

![](https://117853814-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://117853814-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 节点的 ID。该属性会将此节点追加到相关的 div 中。要使其正常工作，此 div 必须位于短代码之前，否则 NeverBlock 将无法找到该元素。

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

**常规脚本**

编辑主题模板时，可以使用 [展示广告](https://docs.exoclick.com/publishers/zh/guang-gao-lan-jie/yong-bu-lan-jie.md#adding-zones-to-a-page).

## 更新日志

请参阅软件包中包含的 CHANGELOG 文件。

### NeverBlock PHP 更新日志

**3.14 (21.10.2026)**

* 即使修复了已弃用的 PHP 通知和 IP 检测问题，NeverBlock 后端加载器仍无法在本地投放广告
* 从 3.14 版本开始，加载器事件为 getmsgloader。如果升级到 3.14，请更新代码片段。旧代码片段（getexoloader）会报错：Cannot read properties of undefined (reading 'addZone')。

**3.12 (10.01.2025)**

* 修复 Neverblock > diag.php 在 IP 检测中始终返回“无法访问用于比较 IP 的服务”的问题

**3.11 (11.07.2023)**

* 修复了与 PHP 5.2 及更高版本的兼容性

**3.10 (12.01.2022)**

* 添加一个可用于向前兼容的参数
* 添加对 WebP 格式的支持

**3.9 (03.12.2021)**

* 添加检测超时，避免在连接较慢时出现误报

**3.8 (10.06.2021)**

* 移除与弹出式底层广告相关的代码（推荐使用内嵌方式）以及不必要的 Cookie

**3.7 (05.07.2019)**

* 针对“anti-cv”过滤器采取了一些防护措施

**3.6 (16.05.2019)**

* 移除有时会被拦截的 JS 对象引用
* 在 diag 中新增 IP 检测 API（支持 IPv6）

**3.5 (14.03.2019)**

* 添加移除部分被拦截广告的功能
* 添加 no\_cookie 参数，以允许 backend\_loader.php 位于不同域名
* 添加对 acpu 缓存的支持

**3.4 (09.07.2018)**

* 改进检测（等待页面加载）

**3.3 (25.05.2018)**

* 更新传递 IP 的文档链接
* 修复某些拦截器（uBlock）导致 window\.ExoLoader 覆盖时报错的问题
* 替换旧的 IP 检测服务

**3.2 (15.03.2018)**

* 修复 PHP <= 5.3 时的错误

**3.1 (07.03.2018)**

* 自动随机化横幅和链接参数名称，并提供更灵活的控制
* 修复多次调用 serve() 时出现的 JS 错误

**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 中出现的接口错误
* 修复指定 LINK\_URL\_PREFIX 时 frontend\_loader.php 的打开链接问题

**2.16 (14.03.2017)**

* 允许动态添加广告位，而不仅限于页面加载时
* 将容器引用添加为 addZone 参数

**2.15 (08.03.2017)**

* 添加文件缓存。
* 减少传输的数据量。
* 通过 `<img>`加载横幅，而不是使用 base64 背景样式。

**2.14 (30.09.2016)**

* 修复 resolveMulti，使其始终返回数组

**2.13 (14.09.2016)**

* 为 openLink 正确传递 POST 参数

**2.12 (12.09.2016)**

* 将所有内联样式彻底移至 CSS 类

**2.11 (09.09.2016)**

* 修复 IE 中 document.contains 未定义的问题

**2.10 (07.09.2016)**

* 修复 IPv6 连接和 curl 相关问题
* 修复因服务器端别名导致点击链接错误的问题

**2.9 (02.09.2016)**

* 更改打开链接的机制，使其通过后端加载器重定向

**2.8 (30.08.2016)**

* 通过在 curl 之外进行 DNS 解析和缓存，解决 HTTPS 广告问题

**2.7 (22.08.2016)**

* 将广告端点切换为 HTTPS，以避免混合内容问题

**2.6 (17.08.2016)**

* 采用更通用的横幅 DOM 占位符
* 修复标头相关问题
* 在前端加载器中将错误与调试消息分开
* 故障排除说明

**2.5 (02.08.2016)**

* 添加超时请求和其他错误的日志记录
* 修复覆盖广告 DOM 占位符时出现的 JS 错误

**2.4 (22.07.2016)**

* 优化超时设置
* 诊断文件与更便捷的调试

**2.3 (20.07.2016)**

* 修复未添加任何区域时向后端加载器发送请求的小问题

**2.2 (15.07.2016)**

* 为广告端点启用新域名，以实现更好的负载均衡

**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/zh/guang-gao-lan-jie/yong-bu-lan-jie.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.
