> 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/ja/adoburokku/neverblock.md).

# Neverblock

## 概要

### アンチアドブロック

NeverBlockは、広告ブロックを回避して収益をすぐに最大化できる、実績あるソリューションです。

独自のテクノロジーにより、ユーザーが広告ブロックソフトウェアをインストールして有効にしていても、広告を表示できます。

NeverBlockの高度なテクノロジーは、広告ブロッカーを回避して広告収益をすべて取り戻します。また、Safari、Chrome、Internet Explorer、Mozillaなどのすべてのブラウザーと、デスクトップ、スマートフォン、タブレットなど、あらゆるプラットフォームやデバイスで動作します。

このソリューションはすべてのExoClickクライアントに無料で提供され、ウェブサイトにコードを1行追加するだけで利用できます。

このドキュメントでは、NeverBlockの4種類の実装方法について説明します。

* **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/ja/adoburokku/neverblock.md#neverblock-php-manual-installation)で説明している手順の代わりに実行できます。ファイルは指定したディレクトリ、または既定の **nb** ディレクトリにインストールされます。設定の一部（ [ファイル名の変更](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#renaming-the-files-mandatory) および [識別キー](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#identification-keys).

### インストーラーをダウンロードする

最新バージョンは、以下のリンクからダウンロードできます。

* [neverBlockInstaller.phar.zip – v1.13](https://729358990-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/ja/adoburokku/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
```

### 応答の分析

実行すると、以下に示すような応答が表示されます。これを診断結果と必要なスクリプトの2つのセクションに分けて確認できます。

![](https://729358990-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 の結果として考えられる内容」のセクションを参照してください。

**必須スクリプト**

診断結果の下には、名前が自動生成された2つのスクリプトが表示されます。これらのスクリプトは、次のファイル名を示しています。 **frontend\_loader.js** および **backend\_loader.php**。広告を表示する際に使用するパスになります。 [広告の表示](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#adding-zones-to-a-page).

## NeverBlock PHP - 手動インストール

### ファイルをダウンロードする

インストールと設定の大部分は、 [phar インストーラー](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#neverblock-php-automatic-installation)で行えます。手動でインストールする場合は、次の手順に従ってください。

最新バージョン（v3.14）は、次のリンクからダウンロードできます。

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

次のテストの1つは **diag.php** の存在を確認します **backend\_loader.php**なので、このテスト内の参照を新しいファイル名に合わせて更新する必要があります。以下の例では、前の画像と同じ設定を使用しています。ページの先頭で、次の行を更新します。

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

### ファイルをサーバーに配置する

上記のファイルは、広告を表示するサーバーに配置してください。

選択したディレクトリにファイルをコピーします。

![](https://729358990-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/ja/adoburokku/neverblock.md#logfile)):

![](https://729358990-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/ja/adoburokku/neverblock.md#caching))

**を参照）** IPの照合に関するエラーがある場合は、 [IPの受け渡し](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#passing-ips-using-cloudflare-etc).

**広告リクエスト：** リクエストに想定以上の時間がかかる場合、 **REQUEST\_TIMEOUT\_MS** および **CONNECT\_TIMEOUT\_MS** の設定値を大きくするよう求められることがあります。この設定方法については、 [定数の設定](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#configuring-constants).

## を参照してください。

### 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/ja/adoburokku/neverblock.md#neverblock-php-automatic-installation)時の任意の設定です。リクエストのタイムアウトやその他のエラーを記録したい場合は、書き込み可能なログファイルを作成できます。この例では、ログファイルを他のNeverBlockファイルと同じディレクトリに配置しています。

![](https://729358990-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://729358990-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/ja/adoburokku/neverblock.md#neverblock-php-automatic-installation)時の任意の設定です。キャッシュを使うと広告の応答時間を大幅に改善できます。 **backend\_loader.php** が標準でサポートするAPCまたはAPCuを使用していない場合は、ファイルキャッシュを設定することをおすすめします。そのためには、PHPが書き込み可能なディレクトリを用意し、そのパスを **WRITABLE\_PATH** 定数の値として **backend\_loader.php**に設定します。この定数を設定すると、他のキャッシュ（APCやAPCuを使用している場合も含む）ではなく、ファイルキャッシュがデフォルトで使用されます。

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

### 識別キー

「 [自動インストール](https://docs.exoclick.com/publishers/ja/adoburokku/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/ja/adoburokku/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** - 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 に設定すると、JavaScript はキャッシュされません。
* **CACHE\_KEYS\_LIMIT\_BANNERS** - キャッシュに保存するバナー画像の上限数（パブリッシャーのリソースを過剰に使用しないための設定）。0 に設定すると上限がなくなり、すべての画像がキャッシュされます。

Apache/nginx のリライトルールを設定して、次のファイルに **backend\_loader.php** 別の URI からアクセスする場合：

* **LINK\_URL\_PREFIX** - 設定すると、フロントエンドのクリックリンクで使用する新しい URI になります（リダイレクト先 URL のハッシュが末尾に追加されます）。
* **BANNER\_URL\_PREFIX** - 設定すると、フロントエンドのバナー画像で使用する新しい URI になります（個々のバナーのハッシュが末尾に追加されます）。
* **KEY\_1** - バナー URL の改ざんを防ぐ秘密鍵（現在、リクエスト内でバックエンドローダーに渡されます）。
* **KEY\_2** - バナー URL の改ざんを防ぐ秘密鍵（現在、リクエスト内でバックエンドローダーに渡されます）。

## NeverBlock PHP - 広告の表示

### ページへのゾーンの追加

以下のスニペットは NeverBlock 3.14 以降に対応しています。以前のバージョンでは、getmsgloader の代わりに getexoloader を使用してください。

{% hint style="info" %}
シングルページアプリケーションを使用している場合は、 [動的読み込み](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#dynamic-loading-single-page-applications) を実装する必要があります。
{% endhint %}

次の広告フォーマットに対応しています。

* バナー
* ネイティブ広告
* スティッキーバナー
* インスタントメッセージ

{% hint style="info" %}
マルチフォーマット広告にはまだ対応していません。ただし、マルチフォーマット広告で使用するように設定済みの個別バナーであれば、NeverBlock と併用できます。これにより、通常のユーザーにはマルチフォーマット広告を表示し、広告ブロッカーを使用しているユーザーには NeverBlock 対応バナーを表示できます。
{% endhint %}

このスクリプトは、広告ブロッカーがインストールされ、有効になっているユーザーにのみ広告を表示する点にご注意ください。既存の標準広告タグは削除しないでください。

この例では、次の項で説明する設定を使用します。 [ファイル名の変更](https://docs.exoclick.com/publishers/ja/adoburokku/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 の値をゾーン 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"});
        
        // sub IDを使用する場合は、addZoneに渡すオブジェクトに数値のsubパラメーターを追加します
        //ExoLoader.addZone({"idzone":"111", "sub": "1"});
    })();
</script>
```

**ステップ3 - 広告の配信（backend\_loader.php）**

すべての *addZone()* 宣言を含めたら、広告を配信します。そのために、次の *serve* 関数です。これは、以前に宣言されたすべての広告ゾーンのデータを配信し、 **通常、ページ上で1回だけ呼び出してください**。 **1ページで呼び出せるゾーンの最大数は20です**。ただし、ページを動的に読み込む場合は例外です。詳細は [動的読み込み](https://docs.exoclick.com/publishers/ja/adoburokku/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**）を使用している場合は、最初の 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>
...
<!-- 最初の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 ファイルを確認し、設定に誤りがないか調べてください。すべてのテストに成功した場合は、ゾーンを1つだけ含むテストページを作成し、単独で動作することを確認してください。それでも広告が表示されない場合は、詳しくは「 [ヘルプ](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#neverblock-php-help) 」セクションをご覧ください。

## NeverBlock PHP - ヘルプ

### 広告が表示されません。どうすればよいですか？

**最新バージョンの広告ブロック対策コードを使用していることを確認してください。**

テスト結果、お客様からのフィードバック、広告ブロッカーの変更に基づいて、対策の改善に継続的に取り組んでいます。古いバージョンには、すでに修正済みの問題が残っている場合があるため、以下の項目を確認する前に、必ず最新バージョンを使用してください。

**diag.php を実行しましたか？**

バックエンドローダーの設定に問題がある場合、手がかりが得られることがあります。

**Chrome／Firefox の「デベロッパーツール」ツールバーで「ネットワーク」タブを確認してください。**

フロントエンドローダーの **frontend\_loader.js** は正しく読み込まれていますか？

**別のパスを指定する必要があるかもしれません。**

* 「/frontend\_loader.js」ではなく、src に完全なパスを指定してみてください。
* 次の呼び出し順を確認してください。 *ExoLoader.addZone()* が呼び出されていること **その後に** *ExoLoader.serve()*
* Chrome／Firefox の「デベロッパーツール」ツールバーで「コンソール」タブを確認してください。 **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 を使う方法は 2 つあります。

1. iframe 内にすべてを含めます。 [ページへのゾーンの追加](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.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 のコード（フロントエンドローダーファイルの include）をサイトのメインページに配置します。iframe 内では addZone を呼び出します。ExoLoader オブジェクトを正しく取得するには、標準の呼び出しを次のように更新し、 **window\.top**.document.dispatchEvent を使用します。また、addZone に **doc** パラメーターを渡し、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()* の *addZone()* 呼び出しは、呼び出された場所に DOM プレースホルダーを配置します。何かによって上書きされると、スクリプトは広告データを挿入できません。

**backend\_loader.php が空のレスポンスを返していますか？**

はいの場合は、関連するエラーがないか PHP のエラーログを確認してください。ExoLoader のコードを含むページを開いた後、次の URL を開きます。 `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 を取得しています。IP は、このスクリプトで PHP のグローバル変数 `$_SERVER['REMOTE_ADDR']` から取得します。パブリッシャーのインフラストラクチャの設定によっては、ここに正しいユーザー IP が格納されず、インプレッション数やクリック数が正しく計上されない場合があります。修正方法については、 [IP アドレスの受け渡し](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#passing-ips-using-cloudflare-etc).

### Firefox（または他のブラウザー）のプライベートモードで、NB 広告と通常の広告の両方が表示される

**domain\_base の設定が正しいことを確認してください。**

[こちら](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#domain-base) ドメインベースの設定方法の例を確認できます。問題は、一部のブラウザー（特に Firefox）では、プライベートモードが特定のドメインへのリクエストをブロックすることです。たとえば、exoclick.com はブロックリストに登録されています。そのため、通常のゾーンコードに「exoclick.com」ドメインが含まれている場合、プライベートモードは広告ブロッカーとして機能し、実際には NB ソリューションが広告を表示するはずです。ただし、他のドメインはプライベートモードでブロックされない可能性があります。広告が二重に表示されるのを防ぎ、通常の広告が現在ブロックされているかどうかを NB 検出器が正しく判定できるようにするには、リクエスト先のドメインを把握する必要があります。

### 別のドメインから NeverBlock を設定するにはどうすればよいですか？

1. &#x20;*frontend\_loader.js*内で、関数 `serve: function(params)` に移動し、params の設定のコメントを解除します。
2. 別のドメインを追加し、 `force: true` を設定して、 `no_cookie: true`:

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

3. 次に、ページ内で新しいドメインを使用してNeverBlockのパスを参照します。

フロントエンドローダー:

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

バックエンドローダー:

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

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

**レスポンスデータ**

広告配信のために、返された JSON ペイロード内の **zones** オブジェクトから、ゾーンごとに次の値を取得できます。

* **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**：バナー画像をラップするために使用するクリック URL
* **imgurl**：バナー画像のソース URL
* **idzone**：ゾーン識別子（処理時にゾーンリクエストを区別するのに便利です）

## NeverBlock Proxy

### 概要

NeverBlock Proxy は、API リクエストの処理と広告のキャッシュを目的としたクロスプラットフォームアプリケーションです。このサービスはバックグラウンドで実行され、広告を取得するための、より直接的なエンドポイントをユーザーに提供します。標準の NeverBlock PHP ソリューションよりも機能範囲が狭いため、NeverBlock Proxy の使用は推奨されません。

アドブロッカーがサイトを集中的に標的にすることがあり、その結果、NeverBlock PHP が機能しなくなる場合があります。その場合は、サイトで NeverBlock Proxy の使用をご検討ください。

### NeverBlock Proxy をダウンロード

お使いのプラットフォームに対応するビルド済みアーカイブをダウンロードしてください。

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

**キャッシュを作成する**

ダウンロードしたファイルを保存する、書き込み可能なディレクトリを作成します。後ほどパスを設定するため、同じフォルダー内に作成してもかまいません。

![](https://729358990-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
#####################
#     Mandatory     #
#####################

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

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

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

**サービスを起動する**

コマンドプロンプトまたはターミナルからバイナリを起動します。これは、バイナリが置かれているディレクトリ内で実行する必要があります。これによりサービスが起動し、localhost のポート 8080 に対して curl リクエストを送信できるようになります。

### 使用方法

ゾーンの取得には cURL リクエストを使用します。このリクエストは任意の言語で実装できます。cURL リクエストは、クリック URL と関連する画像パスを含む JSON ペイロードを返します。画像は指定したパスにもダウンロードされています。 **user\_ip** を渡す際は、 [IP の渡し方](https://docs.exoclick.com/publishers/ja/adoburokku/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**:

* **デバッグ** - デバッグモードを有効にする
* **ポート** - サービスの待ち受けポート
* **ログ** - アプリケーションログ
* **http\_timeout** - HTTPリクエストのタイムアウト（秒）
* **cache\_ttl** - キャッシュファイルの有効期間（分）
* **cache\_purge\_frequency** - キャッシュ削除の実行間隔（分）
* **syndication** - ExoclickシンジケーションURL。詳しくは [ドメインベース](https://docs.exoclick.com/publishers/ja/adoburokku/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://729358990-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://729358990-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://729358990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FigUqsco4QT753tqfflea%2Fneverblock_wp_2.png?alt=media)

各テストの詳細、結果、手動での実行方法については、次のセクションを参照してください。Run the diag.php と Possible diag.php results。

**ステップ 3 - プラグイン設定**

NeverBlock PHP の設定セクションには、 [定数の設定](https://docs.exoclick.com/publishers/ja/adoburokku/neverblock.md#configuring-constants)に関するセクションがあります。インストールウィザードのステップ 3 では、これらの設定を行えます。各設定の詳細は、関連するセクションで説明しているほか、以下のスクリーンショットにも記載されています。

![](https://729358990-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://729358990-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGoSwRYjxsR1XS6va6yLj%2Fuploads%2FLyIk36QD848C12vTaTHS%2Fneverblock_wp_4.png?alt=media)

### WordPress でのゾーンの追加

WordPress ページに NeverBlock のゾーンを追加する方法は 2 つあります。

**ショートコード**

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/ja/adoburokku/neverblock.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)**

* 一部がブロックされた広告を削除する機能を追加
* 別ドメインに backend\_loader.php を配置できるよう、no\_cookie パラメーターを追加
* 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 プラグインを使いやすくするための小規模な変更
* マルチ cURL 用の PHP バージョンを自動チェック

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

* 古い PHP バージョンで backend\_loader.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)**

* オープンリリース
* 複数の広告を1回のリクエストで取得
* バナー用の統合ローダー

### NeverBlock Proxy の変更履歴

**1.0.1**

* リクエストで言語とリファラーを指定可能に
* サンプルを更新

**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/ja/adoburokku/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.
