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

# Neverblock

## Übersicht

### Anti-Adblock

NeverBlock ist eine bewährte Lösung zur Umgehung von Werbeblockern, mit der Sie Ihre Einnahmen sofort maximieren können.

Unsere einzigartige Technologie sorgt dafür, dass Ihre Anzeigen weiterhin geschaltet werden, selbst wenn Nutzer eine Werbeblockersoftware installiert und aktiviert haben.

Die fortschrittliche Technologie von NeverBlock umgeht Werbeblocker, um Ihre gesamten Werbeeinnahmen zurückzugewinnen. Sie funktioniert in allen Browsern (darunter Safari, Chrome, Internet Explorer, Mozilla usw.) und auf allen Plattformen und Geräten (Desktop, Smartphone, Tablet).

Diese Lösung ist für alle ExoClick-Kunden kostenlos. Zur Einrichtung muss lediglich eine Codezeile auf Ihrer Website eingefügt werden.

In dieser Dokumentation behandeln wir vier verschiedene Implementierungen von NeverBlock:

* **NeverBlock PHP** - Die Standardlösung, die am einfachsten zu implementieren ist und am häufigsten verwendet wird. Sie wird in dieser Dokumentation am ausführlichsten behandelt.
* **NeverBlock API** - Wenn eine nicht unterstützte Sprache erforderlich ist, stellt die API Endpunkte bereit, über die Anzeigen direkt abgerufen werden können. Diese Variante eignet sich, wenn manuelle Lösungen erforderlich sind.
* **NeverBlock Proxy** - Eine plattformübergreifende Anwendung zur Verarbeitung von API-Anfragen und zum Zwischenspeichern von Anzeigen. Dieser Dienst läuft im Hintergrund und stellt Nutzern einen direkteren Endpunkt zum Abrufen von Anzeigen bereit.
* **WordPress-Plugin** - Ein WordPress-Plugin, mit dem sich NeverBlock-Anzeigenzonen ganz einfach in Ihre WordPress-Website integrieren lassen.

## NeverBlock PHP – Automatische Installation

### Zweck

Der NeverBlock Phar Installer ist ein Tool, das bei der Installation der Lösung NeverBlock PHP (Version 3.0) hilft. Er kann anstelle der unter [Manuelle Installation](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#neverblock-php-manual-installation)beschriebenen Schritte verwendet werden. Die Dateien werden im angegebenen Verzeichnis oder in einem Standardverzeichnis namens **nb** installiert. Der Installer übernimmt einige Konfigurationsaufgaben, etwa die [Umbenennung von Dateien](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#renaming-the-files-mandatory) und die Einrichtung von [Identifikationsschlüsseln](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#identification-keys).

### Installer herunterladen

Die neueste Version kann über den folgenden Link heruntergeladen werden:

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

### Installer ausführen

Legen Sie die heruntergeladene PHAR-Datei in dem Verzeichnis ab, in dem Sie die NeverBlock-Dateien speichern möchten. Beim Ausführen des Installers können Sie den Pfad angeben, in dem die Dateien installiert werden sollen, oder den Standardpfad verwenden. Optional können Sie auch die zu verwendende Protokolldatei festlegen. Weitere Informationen dazu finden Sie im Abschnitt [Protokolldatei](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#logfile) .

```bash
# Dateien im Standardverzeichnis 'nb' erstellen und installieren 
./neverBlockInstaller.phar
```

Optionale Parameter:

```bash
# Dateien im angegebenen Verzeichnis erstellen und installieren
./neverBlockInstaller.phar --path=specific/path 

# Dateien im aktuellen Verzeichnis installieren
./neverBlockInstaller.phar --path=.

# Pfad zur Protokolldatei
./neverBlockInstaller.phar --logfile=path/logfile

# Pfad zu writable_path (falls APC/APCu nicht installiert ist)
./neverBlockInstaller.phar --writable_path=path/writable_path
```

### Antwort analysieren

Nach der Ausführung wird eine Antwort angezeigt, die der unten dargestellten ähnelt. Sie lässt sich in zwei Bereiche unterteilen: die Diagnoseergebnisse und die erforderlichen Skripte.

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

**Diagnoseergebnisse**

Nach dem Ausführen der PHAR-Datei werden die Ergebnisse einiger Konfigurationstests angezeigt. Beachten Sie, dass für die **IP-Erkennung** erforderlich ist **diag.php** manuell ausgeführt werden. Weitere Informationen zu diesen Ergebnissen und zur manuellen Ausführung finden Sie in den Abschnitten „diag.php ausführen“ und „Mögliche Ergebnisse von diag.php“.

**Erforderliche Skripte**

Unterhalb der Diagnoseergebnisse sehen wir zwei Skripte, deren Namen automatisch generiert wurden. Diese Skripte zeigen uns die Namen unserer **frontend\_loader.js** und **backend\_loader.php**, und geben die Pfade an, die beim [Anzeigen von Anzeigen](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#adding-zones-to-a-page).

## NeverBlock PHP – Manuelle Installation

### Dateien herunterladen

Die Installation und der Großteil der Konfiguration können mit dem [phar-Installer](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#neverblock-php-automatic-installation)vorgenommen werden. Die manuelle Installation erfolgt wie folgt.

Die neueste Version (v3.14) kann über diese Links heruntergeladen werden:

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

Oder mit den folgenden Befehlen:

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

Folgende Dateien aus diesem Ordner werden benötigt:

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

### Dateien umbenennen (erforderlich)

Damit die Dateien nicht sofort von Werbeblockern blockiert werden, müssen sie umbenannt werden.

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

Einer der Tests in **diag.php** prüft, ob die Datei **backend\_loader.php**vorhanden ist. Daher müssen die Verweise in diesem Test aktualisiert werden, damit sie mit dem neu benannten Dateinamen übereinstimmen. Das folgende Beispiel verwendet dieselbe Konfiguration wie im vorherigen Bild. Aktualisieren Sie oben auf der Seite die folgende Zeile:

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

### Dateien auf dem Server ablegen

Die oben genannten Dateien sollten auf dem Server abgelegt werden, auf dem Sie Ihre Anzeigen schalten möchten.

Kopieren Sie die Dateien in ein Verzeichnis Ihrer Wahl:

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

### diag.php ausführen

Nachdem sich unsere NeverBlock-Dateien auf dem Server befinden, verwenden wir die Datei **diag.php** um zu überprüfen, ob bisher alles in Ordnung ist. Rufen Sie dazu die URL auf, unter der sich die Datei diag.php befindet. Im Beispiel des vorherigen Screenshots wäre dies: `https://www.my-example-site.com/nb/diag.php`

Wenn bisher alles korrekt eingerichtet wurde, sollten Sie Folgendes sehen (die Protokolldatei konfigurieren wir im Abschnitt [Protokolldatei](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#logfile)):

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

Wenn andere Ergebnisse angezeigt werden, ist möglicherweise eine zusätzliche Konfiguration erforderlich.

### Mögliche Ergebnisse von diag.php

**PHP-Version:** Wenn die PHP-Version nicht unterstützt wird, werden Sie darüber informiert. Für die Standardlösung NeverBlock ist PHP-Version 5.2 oder höher erforderlich.

**Vorhandensein des Backend-Loader-Skripts:** Wenn diese Prüfung fehlschlägt, ist die Datei **backend\_loader.php** kann nicht gefunden werden von **diag.php**. Dies kann auf eine Änderung des Dateinamens oder ein Problem mit dem Pfad zurückzuführen sein.

**Fehlerberichterstattung:** Dies wird möglicherweise als Warnung angezeigt. Diese Warnung verhindert nicht, dass die NeverBlock-Lösung funktioniert.

**Cache vorhanden** und **cURL-Bibliothek:** Wenn Cache und cURL nicht verfügbar sind, erhalten Sie Warnungen. Dadurch wird die Funktionsweise von NeverBlock nicht beeinträchtigt, wir empfehlen jedoch, beides zu konfigurieren.

* Die PHP- [cURL](https://www.php.net/manual/en/book.curl.php) Erweiterung *(dringend empfohlen)*
* Die PHP- [APCu](https://www.php.net/manual/en/book.apcu.php) -Erweiterung oder ein Datei-Cache (siehe [Caching](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#caching))

**IP-Erkennung:** Wenn ein Fehler beim Abgleich der IP-Adresse auftritt, finden Sie Informationen dazu unter [IP-Adressen übergeben](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

**Anfragen für Anzeigen:** Wenn die Anfragen länger als erwartet dauern, werden Sie möglicherweise aufgefordert, den Wert von **REQUEST\_TIMEOUT\_MS** und **CONNECT\_TIMEOUT\_MS** zu erhöhen. Wie das geht, wird unter [Konstanten konfigurieren](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#configuring-constants).

## NeverBlock PHP – Konfiguration

### IP-Adressen übergeben (z. B. bei Verwendung von Cloudflare)

Wenn Sie einen Dienst wie Cloudflare verwenden, der zwischen dem Nutzer und Ihren eigentlichen Servern liegt, wird die in **backend\_loader.php** erkannte IP möglicherweise als ungültig eingestuft. Dadurch können die Klicks oder Impressionen der Anzeigen falsch erfasst werden. Um dies zu beheben, können Sie den an die Klasse `$_SERVER["REMOTE_ADDR"]` übergebenen Wert *UserEnvironment* in **backend\_loader.php** durch den korrekten Wert ersetzen, den Ihr Caching-/Proxy-Dienst übermittelt.

Bei Cloudflare würden wir den Parameter `$_SERVER["HTTP_CF_CONNECTING_IP"]` übergeben. Ein Beispiel sehen Sie unten.

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

Danach sieht unser *UserEnvironment* wie folgt aus:

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

Bei Verwendung eines anderen Dienstes wie Apache oder NGINX können wir Folgendes verwenden: `isset($_SERVER['HTTP_X_REAL_IP']) ? $_SERVER['HTTP_X_REAL_IP'] : $_SERVER['REMOTE_ADDR']` wie im Folgenden gezeigt:

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

Wir können nun **diag.php**, erneut ausführen. Falls dies dazu geführt hat, dass der *IP-Erkennung* -Test fehlschlug, sollten wir nun erfolgreiche Ergebnisse erhalten.

### Protokolldatei

Dies war eine optionale Konfiguration während der [Automatischen Installation](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#neverblock-php-automatic-installation). Wenn Sie Zeitüberschreitungen bei Anfragen und andere Fehler protokollieren möchten, können Sie eine beschreibbare Protokolldatei erstellen. In diesem Beispiel wurde die Protokolldatei im selben Verzeichnis wie die anderen NeverBlock-Dateien abgelegt.

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

Sobald diese Datei erstellt wurde (achten Sie darauf, dass sie beschreibbar ist), aktualisieren wir **backend\_loader.php** und legen den Pfad fest. Am Anfang der Datei wird `LOGFILE` auf **NULL** gesetzt und sollte so angepasst werden, dass der Pfad zur neuen Protokolldatei angegeben wird:

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

Danach können wir **diag.php**. erneut ausführen. Wenn die Datei erstellt und der Pfad korrekt festgelegt wurde, wird nun Folgendes angezeigt.

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

### Caching

Dies war eine optionale Konfiguration während der [Automatischen Installation](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#neverblock-php-automatic-installation). Caching kann die Antwortzeiten von Anzeigen erheblich verbessern. Wenn Sie weder APC noch APCu verwenden, die von **backend\_loader.php** standardmäßig unterstützt werden, empfiehlt es sich, einen dateibasierten Cache einzurichten. Dazu müssen Sie ein für PHP beschreibbares Verzeichnis einrichten und dessen Pfad als Wert für die Konstante **WRITABLE\_PATH** in **backend\_loader.php**angeben. Ist diese Konstante gesetzt, wird standardmäßig der dateibasierte Cache anstelle anderer Caches verwendet (auch wenn Sie APC oder APCu installiert haben).

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

### Identifikationsschlüssel

Wenn Sie die [Automatische Installation](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#neverblock-php-automatic-installation) verwendet haben, wurden diese Schlüssel bereits während der Installation eingerichtet. Sie dienen der Verschlüsselung, um Manipulationen an Banner-URLs zu verhindern. Es wird dringend empfohlen, die Werte für *KEY\_1* und *KEY\_2* in **backend\_loader.php** durch eindeutige Zeichenfolgen zu ersetzen.

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

### Cookies

Cookies werden verwendet, um sicherzustellen, dass NeverBlock wie erwartet funktioniert.

* **yuo1** – der Standardname dieses Cookies lautet **yuo1**, und dieser Name kann in **frontend\_loader.js**. Dieses Cookie kann auch deaktiviert werden, indem [no\_cookie: true](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#how-do-i-configure-neverblock-from-a-different-domain).
* **zone-closed-** – Dieses Cookie sorgt dafür, dass die Zone geschlossen bleibt, wenn der Nutzer sie bei aktiviertem AdBlock geschlossen und AdBlock anschließend deaktiviert hat.

### Konstanten konfigurieren

In **backend\_loader.php**sind einige Konstanten definiert. Es wird empfohlen, sie unverändert zu lassen. In manchen Fällen kann es jedoch sinnvoll sein, einzelne Einstellungen zu ändern.

* **CONNECT\_TIMEOUT\_MS** – das Verbindungstimeout in Millisekunden für curl-/fsock-Anfragen.
* **REQUEST\_TIMEOUT\_MS** – das gesamte Anfrage-Timeout in Millisekunden (einschließlich der Zeit aus CONNECT\_TIMEOUT\_MS) für curl-/fsock-Anfragen.
* **LOGFILE** – ein Pfad zu einer beschreibbaren Datei, in der Meldungen wie Fehler und Fälle von Zeitüberschreitungen bei Anfragen protokolliert werden.
* **ALLOW\_MULTI\_CURL** – wenn möglich, versucht das Skript, curl\_multi\_exec zu verwenden. Wenn dies die CPU zu stark belastet, kann die Funktion deaktiviert werden.

APC/APCu- und Dateicache-Einstellungen:

* **WRITABLE\_PATH** – Pfad zu einem beschreibbaren Verzeichnis, das die Cache-Dateien enthält. (Wenn dieser Wert festgelegt ist, wird der Dateicache zum standardmäßig verwendeten Cache.)
* **CACHE\_INTERVAL\_BANNERS** – Cache-Lebensdauer für Bannerbilder (in Sekunden). Bei einem Wert von 0 werden Bilder NICHT zwischengespeichert.
* **CACHE\_INTERVAL\_SCRIPTS** – Cache-Lebensdauer für JavaScript-Dateien. Bei einem Wert von 0 werden sie NICHT zwischengespeichert.
* **CACHE\_KEYS\_LIMIT\_BANNERS** – Begrenzung der Anzahl der Bannerbilder, die im Cache gespeichert werden dürfen (um die Ressourcen des Publishers nicht übermäßig zu beanspruchen). Bei einem Wert von 0 gibt es keine Begrenzung, sodass alle Bilder zwischengespeichert werden.

Wenn Sie Apache-/Nginx-Rewrite-Regeln einrichten, um auf **backend\_loader.php** über andere URIs zuzugreifen:

* **LINK\_URL\_PREFIX** – falls festgelegt, wird dies zur neuen URI für Klicklinks im Frontend (der Hash der umzuleitenden URL wird angehängt).
* **BANNER\_URL\_PREFIX** – falls festgelegt, wird dies zur neuen URI für Bannerbilder im Frontend (der Hash des jeweiligen Banners wird angehängt).
* **KEY\_1** – geheimer Schlüssel, um Manipulationen an Banner-URLs zu verhindern (diese werden in der Anfrage an den Backend-Loader zurückgesendet).
* **KEY\_2** – geheimer Schlüssel, um Manipulationen an Banner-URLs zu verhindern (diese werden in der Anfrage an den Backend-Loader zurückgesendet).

## NeverBlock PHP – Anzeigen einblenden

### Zonen zu einer Seite hinzufügen

Diese Code-Snippets gelten für NeverBlock 3.14 und höher. Verwenden Sie in älteren Versionen getexoloader anstelle von getmsgloader.

{% hint style="info" %}
Wenn Sie eine Single-Page-Anwendung verwenden, müssen Sie [Dynamisches Laden](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#dynamic-loading-single-page-applications) implementieren.
{% endhint %}

Folgende Anzeigenformate werden unterstützt:

* Banner
* Native Ads
* Sticky-Banner
* Sofortnachrichten

{% hint style="info" %}
Anzeigen mit mehreren Formaten werden noch nicht unterstützt. Sie können NeverBlock jedoch weiterhin mit einzelnen Bannern verwenden, die Sie für den Einsatz in Anzeigen mit mehreren Formaten eingerichtet haben. So können Sie Anzeigen mit mehreren Formaten für Standardnutzer und NeverBlock-fähige Banner verwenden, um Nutzer mit Werbeblockern anzusprechen.
{% endhint %}

Bitte beachten Sie, dass dieses Skript nur dann Anzeigen zeigt, wenn ein Nutzer einen Adblocker installiert und aktiviert hat. Entfernen Sie keine vorhandenen Standard-Werbetags.

In diesem Beispiel verwenden wir die in [Dateien umbenennen](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#renaming-the-files-mandatory). Achten Sie darauf, dass Pfad und Dateinamen mit Ihrer Konfiguration übereinstimmen.

**Schritt 1 – frontend\_loader.js auf der Seite platzieren**

Fügen Sie innerhalb des `<body>` -Tags Ihrer Seite ganz oben Folgendes ein:

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

Dieser Code sollte nur einmal auf der Seite eingebunden werden. Er sollte außerdem vor allen anderen Zonenskripten stehen.

**Schritt 2 – Eine NeverBlock-Zone hinzufügen**

Die folgenden Codeausschnitte dienen zum Deklarieren Ihrer Anzeigenzonen. Sie sollten im DOM an der Stelle eingefügt werden, an der die Zone angezeigt werden soll. Sie können auf einer Seite mehrere Bannerblöcke dieser Art hinzufügen. **Achten Sie darauf, sie nicht in div-Elemente mit Klassen oder bestimmten Stilelementen einzufügen, die für die Anzeige von Werbung relevant sind**, da diese div-Elemente von Adblockern erkannt werden (z. B. `class="ad-footer"`, `style="width:300px;height:250px;"`).

Gehen Sie zum Hinzufügen einer Anzeigenzone wie folgt vor (ersetzen Sie den Wert für idzone durch die ID Ihrer Zone):

```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;
        
        //Code to add zones can be placed multiple times on page
        ExoLoader.addZone({"idzone":"111"});
        
        //If you want to use sub id, add a numeric sub parameter to object, passed to addZone
        //ExoLoader.addZone({"idzone":"111", "sub": "1"});
    })();
</script>
```

**Schritt 3 – Anzeigen ausliefern (backend\_loader.php)**

Nachdem alle *addZone()* -Deklarationen eingebunden wurden, können die Anzeigen ausgeliefert werden. Dazu verwenden wir die *serve* -Funktion. Sie liefert Daten für alle zuvor deklarierten Anzeigenzonen und **sollte in der Regel nur einmal pro Seite aufgerufen werden**. Die **maximale Anzahl der Zonen, die auf einer Seite aufgerufen werden können, beträgt 20**. Ausnahmen gelten beim dynamischen Laden einer Seite, wie unter [Dynamisches Laden](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#dynamic-loading-single-page-applications).

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

### Dynamisches Laden (Single-Page-Anwendungen)

Es ist möglich, eine Referenz auf ein Container-DOM-Element zu übergeben, an das das Banner angehängt werden soll. Dadurch weiß das Skript beim Aufruf von serve, an welcher Stelle die Anzeigenzone platziert werden soll. Das geht wie folgt:

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

Außerdem ist es möglich, *serve()* mit dem force-Flag aufzurufen, um die Anzeigen zu einem von Ihnen gewählten Zeitpunkt auszuliefern (z. B. in einer Funktion, nachdem ein Teil der Seite gerendert wurde), statt beim Laden der Seite:

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

Die *serve()* kann mehrmals aufgerufen werden. Nach jedem *serve()* Der Aufruf von ExoLoader wird von vorherigen *addZone()* Aufrufen geleert. Daher werden nur die Banner, die Sie *addZone()* nach einem serve-Aufruf hinzufügen, beim nächsten *serve()*.

### Domain-Basis

Wenn Sie bereits ExoClick-Kunde sind, haben Sie möglicherweise reguläre Anzeigenzonen auf Ihrer Website. Wenn Sie eine andere Domain als \*.exoclick.com verwenden (z. B. **ads.exosrv.com**), sollten Sie den Wert von *domain\_base* des Detector-Objekts (`ExoLoader.getDetector()`) vor dem ersten addZone-Aufruf auf „exosrv.com“ setzen. Gehen Sie dazu wie unten gezeigt vor:

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

### Es werden keine Anzeigen angezeigt

Wenn keine Anzeigen angezeigt werden, überprüfen Sie zunächst die Datei diag.php auf fehlerhafte Konfigurationen. Wenn alle Tests erfolgreich sind, erstellen Sie eine Testseite mit nur einer Zone, um sicherzustellen, dass sie unabhängig funktioniert. Werden weiterhin keine Anzeigen angezeigt, finden Sie weitere Informationen im Abschnitt [Hilfe](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#neverblock-php-help) .

## NeverBlock PHP – Hilfe

### Meine Anzeigen werden nicht angezeigt. Was soll ich tun?

**Vergewissern Sie sich, dass Sie die neueste Version des Adblock-Lösungscodes verwenden.**

Wir arbeiten kontinuierlich daran, die Lösung auf Grundlage unserer Tests, des Kundenfeedbacks und der Änderungen bei Adblockern zu verbessern. Ältere Versionen können noch Probleme aufweisen, die wir bereits behoben haben. Vergewissern Sie sich daher, dass Sie die aktuellste Version verwenden, bevor Sie die weiteren Punkte unten überprüfen.

**Haben Sie diag.php ausgeführt?**

Das Skript kann auf ein Problem mit der Konfiguration Ihres Backend-Loaders hinweisen.

**Überprüfen Sie den Tab „Netzwerk“ in der Symbolleiste der „Entwicklertools“ von Chrome/FF.**

Wird Ihre **frontend\_loader.js** ordnungsgemäß geladen?

**Möglicherweise müssen Sie einen anderen Pfad angeben.**

* Versuchen Sie, in src den vollständigen Pfad anzugeben, anstatt „/frontend\_loader.js“ zu verwenden.
* Überprüfen Sie, ob *ExoLoader.addZone()* vor **aufgerufen wird:** *ExoLoader.serve()*
* Überprüfen Sie den Tab „Konsole“ in der Symbolleiste der „Entwicklertools“ von Chrome/FF. Möglicherweise gibt es Fehler im Zusammenhang mit **frontend\_loader.js**
* Führen Sie `ExoLoader.getDebug();` in der JavaScript-Konsole aus, um zu sehen, was passiert. Die Ausgabe sieht etwa so aus:

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

**Überprüfen Sie die Zonen-IDs.**

Vergewissern Sie sich, dass die Zone mit der von Ihnen angegebenen idzone existiert und Ihnen gehört.

**Fügen Sie Anzeigencodes in Iframes ein?**

Der Inhalt von Iframes wird nach dem Laden der Hauptseite geladen. Wenn Sie *addZone()* in einem iframe und *serve()* auf der Hauptseite wird der *serve()* ausgeführt, bevor *addZone()*, und es funktioniert nicht. Bei iframes gibt es zwei Möglichkeiten:

1. Alles in ein iframe einfügen: Sämtlicher Code aus den Schritten 1, 2 und 3 von [Zonen zu einer Seite hinzufügen](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#adding-zones-to-a-page) muss sich darin befinden. Wenn es auf einer Seite jedoch mehrere solcher iframes gibt, kann es zu Konflikten kommen, da diese Lösung ein Cookie verwendet. Haben die Cookies denselben Namen, können die Anzeigen in den iframes durcheinandergeraten. Sie können den Cookie-Namen vor dem Aufruf von serve umbenennen, zum Beispiel so:

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

Der Nachteil ist, dass Sie mehrere Backend-Loader benötigen, in denen Sie ebenfalls unterschiedliche Cookie-Namen festlegen müssen:

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

2. Fügen Sie den Code aus Schritt 1 (die Einbindung der Frontend-Loader-Datei) in die Hauptseite Ihrer Website ein. Rufen Sie in den iframes addZone auf. Damit das ExoLoader-Objekt korrekt abgerufen wird, müssen Sie den Standardaufruf anpassen und **window\.top**.document.dispatchEvent verwenden. Übergeben Sie außerdem an addZone den Parameter **doc** , der auf die document-Eigenschaft Ihres iframes verweist:

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

Rufen Sie auch im letzten iframe serve() auf:

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

**Verwenden Sie für das Frontend Ihrer Website ein JavaScript-Framework?**

Stellen Sie sicher, dass Sie innerHTML der Elemente, in denen Sie *addZone()* aufrufen, nicht überschreiben. Der *addZone()* Aufruf fügt an der Stelle, an der er erfolgt, einen DOM-Platzhalter ein. Wird dieser durch etwas anderes überschrieben, kann das Skript ihn nicht mit Anzeigendaten füllen.

**Liefert backend\_loader.php eine leere Antwort zurück?**

Falls ja, prüfen Sie das PHP-Fehlerprotokoll auf mögliche relevante Fehler. Öffnen Sie nach dem Aufrufen einer Seite mit den ExoLoader-Codes folgende URL: `http://yoursite/backend_loader.php?exoDebug=exoDebug`. Werden *curl/fsock* -Timeoutfehler angezeigt, müssen Sie möglicherweise die Werte von **CONNECT\_TIMEOUT\_MS** und **REQUEST\_TIMEOUT\_MS** in **backend\_loader.php**.

### Die Anzeigen werden ausgeliefert, aber in den Statistiken werden keine Klicks oder Impressionen angezeigt

**Verwenden Sie Cloudflare oder sind Ihre Webserver über einen anderen Dienst proxiert?**

Die NeverBlock-Anfragen für Anzeigen gehen nicht direkt vom Browser des Endnutzers an unseren Server. Deshalb verlassen wir uns darauf, dass **backend\_loader.php** auf der Publisher-Seite die IP-Adresse des Nutzers an uns übermittelt. Wir lesen sie über `$_SERVER['REMOTE_ADDR']` aus der globalen PHP-Variable in diesem Skript aus. Ist die Infrastruktur des Publishers so konfiguriert, dass dort keine korrekte IP-Adresse des Nutzers vorliegt, kann es zu fehlerhaften Impressionen oder Klicks kommen. Informationen zur Behebung finden Sie unter [IP-Adressen übermitteln](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

### Im privaten Modus von Firefox (oder einem anderen Browser) werden sowohl NB- als auch normale Anzeigen ausgeliefert

**Prüfen Sie, ob die Einstellung domain\_base korrekt konfiguriert ist.**

[Hier](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#domain-base) Ein Beispiel für die Konfiguration der Basisdomain findest du hier. Das Problem ist, dass der Private-Modus in einigen Browsern, am häufigsten in Firefox, Anfragen an bestimmte Domains blockiert. Exoclick.com wurde beispielsweise auf die Sperrliste gesetzt. Wenn der normale Zonencode also die Domain „exoclick.com“ enthält, fungiert der Private-Modus als Adblocker, und die NB-Lösung sollte tatsächlich Anzeigen ausliefern. Unsere anderen Domains werden vom Private-Modus möglicherweise jedoch nicht blockiert. Um doppelte Anzeigen zu vermeiden und damit der NB-Detektor korrekt erkennen kann, ob die normalen Anzeigen gerade blockiert werden oder nicht, muss er wissen, von welcher Domain aus sie angefordert werden.

### Wie konfiguriere ich NeverBlock über eine andere Domain?

1. Gehe in *frontend\_loader.js*zur Funktion `serve: function(params)` und hebe die Auskommentierung des Parameter-Sets auf.
2. Füge eine weitere Domain hinzu und setze `force: true` und `no_cookie: true`:

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

3. Verweise als Nächstes auf der Seite auf den NeverBlock-Pfad mit der neuen Domain.

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

### Was ist bei einer fälschlichen Erkennung eines Ad Blockers zu tun?

Manchmal werden Nutzern, die AdBlock deaktiviert haben, trotzdem NB-Anzeigen zusammen mit ihren normalen Anzeigen angezeigt. Das kann daran liegen, dass NB versucht, ein Honeypot-Skript für die Auslieferung echter Anzeigen auf der Seite einzubinden, um zu prüfen, ob es blockiert wird. Bei langsamen Verbindungen dauert das Laden dieses Skripts manchmal zu lange. NB kann dann annehmen, dass es blockiert wurde, und entscheidet sich deshalb, die Anzeigen anzufordern. Aufgrund der Funktionsweise einiger Adblocker lässt sich nicht feststellen, ob der Ladevorgang noch nicht abgeschlossen ist oder aufgrund eines Blockers nie abgeschlossen wird. Für die meisten Websites und Nutzer ist das kein Problem. Sollte es bei einem erheblichen Anteil deiner Nutzer auftreten, empfehlen wir, das Timeout für die NB-Erkennung mithilfe der Funktion **setTimeout** des **ExoLoader**zu erhöhen, zum Beispiel so:

```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 verwendet einen einfachen Endpunkt, der Anfragen an die ExoClick-Syndication-Server weiterleitet.

Dieser Endpunkt ist unten dokumentiert. Du kannst ihn frei verwenden, um eine eigene benutzerdefinierte Integration in der Programmiersprache deiner Wahl zu erstellen.

### API v1

Diese API-Version unterstützt alle Formate, die derzeit für die NeverBlock-Lösung verfügbar sind (Banner, Sticky-Banner, native Anzeigen, Instant Messages).

**Anfrage für eine einzelne Zone**

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

**Anfrage für mehrere Zonen**

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

Die obigen Anfragen sind ähnlich. Anfragen für mehrere Zonen müssen jedoch mit einer inkrementellen Array-Notation strukturiert werden (*z. B. zones\[0]\[idzone], zones\[1]\[idzone],…*), wie gezeigt.

{% hint style="info" %}
Anfragen für mehrere Zonen sind auf maximal **20** Zonen pro Anfrage begrenzt.
{% endhint %}

**Parameter**

Die folgenden Parameter müssen für **alle** Anfragen gesetzt werden:

* **zones\[N]\[idzone]** - *anzufordernde Zonen-ID*
* **user\_ip** - *IP-Adresse des Endnutzers (wird für das Targeting verwendet)*

**Header**

Die folgenden Header sollten für **alle** Anfragen festgelegt werden:

* **X-Forwarded-For** - *Ursprüngliche IP-Adresse des Clients*
* **Referer** - *Adresse der verweisenden Website*
* **User-Agent** - *Client-Kennung*
* **Accept-Language** - *Sprache und Gebietsschema des Clients*

**Antwort**

Die JSON-Payloads, die von den obigen Beispielen zurückgegeben werden, sehen wie folgt aus.

Antwort für eine einzelne Zone:

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

Antwort für mehrere Zonen:

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

**Antwortdaten**

Die folgenden Werte können aus dem **zones** -Objekt für jede Zone in der zurückgegebenen JSON-Nutzlast zum Zweck der Anzeigenauslieferung extrahiert werden:

* **idzone**: Zonenkennung (nützlich zur Unterscheidung von Zonenanfragen bei der Verarbeitung)
* **type**: Anzeigentyp; in **renderers** kann das zugehörige Standard-Renderer-Skript abgerufen werden. (Das Standard-Renderer-Skript setzt voraus, dass sich ein ExoLoader-Objekt in seinem Gültigkeitsbereich befindet.)
* **data**: Die Anzeigendaten für den jeweiligen Anzeigentyp. Am häufigsten sind **image** und **url** bei Bannern und bannerähnlichen Typen zu finden; einige davon haben zusätzliche Parameter.

Wenn Sie die API verwenden, liegt es an Ihnen, den Code zu schreiben, der anhand der bereitgestellten Daten das im Frontend anzuzeigende DOM erzeugt. Unsere Standard-Renderer sind Skripte, die diese Aufgabe als Teil der standardmäßigen NeverBlock-Lösung (PHP- und JavaScript-Installation) übernehmen. Sie können ausschließlich mit dem ExoLoader-JS-Objekt verwendet werden, das intern die nachbearbeiteten Antworten in einem eigenen Format speichert und mehrere Hilfsfunktionen bereitstellt, die von den Renderern verwendet werden und als vorhanden vorausgesetzt werden.

### API v0

Diese API-Version unterstützt nur Banner. Für *false* wird für alle Zonen eines anderen Typs zurückgegeben.

**Anfrage für eine einzelne Zone**

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

**Anfrage für mehrere Zonen**

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

Die obigen Anfragen sind ähnlich. Anfragen für mehrere Zonen müssen jedoch mit einer inkrementellen Array-Notation strukturiert werden (*z. B. zones\[0]\[idzone], zones\[1]\[idzone],…*), wie gezeigt.

{% hint style="info" %}
Anfragen für mehrere Zonen sind auf maximal **20** Zonen pro Anfrage begrenzt.
{% endhint %}

**Parameter**

Die folgenden Parameter müssen für **alle** Anfragen gesetzt werden:

* **zones\[N]\[idzone]** - *anzufordernde Zonen-ID*
* **user\_ip** - *IP-Adresse des Endnutzers (wird für das Targeting verwendet)*

**Header**

Die folgenden Header sollten für **alle** Anfragen festgelegt werden:

* **X-Forwarded-For** - *Ursprüngliche IP-Adresse des Clients*
* **Referer** - *Adresse der verweisenden Website*
* **User-Agent** - *Client-Kennung*
* **Accept-Language** - *Sprache und Gebietsschema des Clients*

**Antwort**

Die JSON-Payloads, die von den obigen Beispielen zurückgegeben werden, sehen wie folgt aus.

Antwort für eine einzelne Zone:

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

Antwort für mehrere Zonen:

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

**Antwortdaten**

Die folgenden Werte können zum Zweck der Anzeigenauslieferung aus der zurückgegebenen JSON-Nutzlast extrahiert werden:

* **url**: Klick-URL, die zum Verlinken des Bannerbilds verwendet wird
* **imgurl**: Quell-URL des Bannerbilds
* **idzone**: Zonenkennung (nützlich zur Unterscheidung von Zonenanfragen bei der Verarbeitung)

## NeverBlock-Proxy

### Was ist das?

NeverBlock Proxy ist eine plattformübergreifende Anwendung zur Verarbeitung von API-Anfragen und zum Zwischenspeichern von Anzeigen. Dieser Dienst läuft im Hintergrund und bietet dem Nutzer einen direkteren Endpunkt, über den Anzeigen abgerufen werden können. Es wird nicht empfohlen, NeverBlock Proxy der standardmäßigen NeverBlock-PHP-Lösung vorzuziehen, da Proxy nicht so umfangreich ist.

Gelegentlich nehmen Adblocker Websites besonders stark ins Visier, sodass NeverBlock PHP nicht mehr funktioniert. Ist dies bei Ihrer Website der Fall, sollten Sie NeverBlock Proxy in Betracht ziehen.

### NeverBlock Proxy herunterladen

Laden Sie ein vorgefertigtes Archiv für Ihre Plattform herunter:

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

Die zum Ausführen von NeverBlock-Anzeigen erforderlichen Dateien sind:

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

### Proxy-Konfiguration

**Dateien auf den Server übertragen**

Nachdem die Dateien heruntergeladen wurden, können Sie sie wie im folgenden Screenshot gezeigt in einem Verzeichnis auf Ihrem Server ablegen:

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

**Cache erstellen**

Erstellen Sie ein beschreibbares Verzeichnis, in dem die heruntergeladenen Dateien gespeichert werden. Sie können es im selben Ordner anlegen, da wir den Pfad später festlegen.

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

**Erforderliche Konfiguration aktualisieren**

Am Anfang der **neverblock-conf.toml** gibt es einen Abschnitt mit der Bezeichnung *Mandatory*. In diesem Abschnitt legen wir unsere Pfade anhand der Konfiguration in den obigen Screenshots fest. Beachten Sie, dass sie von Ihrer Konfiguration abhängen.

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

## Cache-Pfad (ACHTUNG: ALLE Dateien hier werden in regelmäßigen Abständen gelöscht!)
cache_path = "nb-cache/"

## Relativer Pfad zum Cache ausgehend vom Webserver-Stammverzeichnis (z. B. "images/cache/"; wenn nicht festgelegt, wird standardmäßig cache_path verwendet)
www_cache_path = "nb-proxy/nb-cache/"

## Pfad und Dateiname der Weiterleitungs-HTML-Datei (relativ zum Webserver-Stammverzeichnis, z. B. "misc/redirect.html")
www_redirect_path = "nb-proxy/redirect.html"
```

**Dienst starten**

Starten Sie die Binärdatei über eine Eingabeaufforderung bzw. ein Terminal – dies muss innerhalb des Verzeichnisses geschehen, in dem sie sich befindet. Dadurch wird der Dienst gestartet. Anschließend sollten Sie cURL-Anfragen an localhost auf Port 8080 senden können.

### Verwendung

Zum Abrufen der Zonen wird eine cURL-Anfrage verwendet. Diese Anfrage lässt sich in einer beliebigen Programmiersprache implementieren. Die cURL-Anfrage gibt eine JSON-Nutzlast mit einer Klick-URL sowie einem passenden Bildpfad zurück. Das Bild wurde außerdem in den von Ihnen angegebenen Pfad heruntergeladen. Wenn Sie den Wert **user\_ip** übergeben, beachten Sie die Hinweise unter [IP-Adressen übergeben](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#passing-ips-using-cloudflare-etc). Die Anfrage hat folgende Struktur:

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

Anhand dieser Struktur sehen wir uns ein Beispiel für die Verwendung mit PHP an:

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

### Optionale Konfiguration

Es gibt mehrere optionale Konfigurationseinträge in **neverblock-conf.toml**:

* **debug** - Debug-Modus aktivieren
* **port** - Port, an dem der Dienst auf Anfragen wartet
* **log** - Anwendungsprotokoll
* **http\_timeout** - HTTP-Anfrage-Timeout (Sek.)
* **cache\_ttl** - Gültigkeitsdauer (Min.) der zwischengespeicherten Dateien
* **cache\_purge\_frequency** - Intervall zwischen Cache-Bereinigungen (Min.)
* **syndication** - Exoclick-Syndication-URL. Siehe [Domain-Basis](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#domain-base) für Details dazu, wann diese geändert werden sollte

### Flags

Mit Flags lässt sich die Konfigurationsdatei überschreiben:

```bash
heisenberg:neverblock-proxy craig$ ./neverblock-proxy -h
Neverblock-Proxy – der AdBlock-Traffic-Vermittler

Verwendung:
  neverblock-proxy [flags]

Flags:
  -c, --cache-path string    Pfad zum Bild-Cache
  -C, --config-file string   Konfigurationsdatei
  -l, --log string           Protokolldatei
  -p, --port string          Dienst-Port
```

## WordPress-Plugin

### Plugin-Installation

Das Plugin kann über den folgenden Link heruntergeladen werden:

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

Die Installation des NeverBlock-Plugins für WordPress unterscheidet sich nicht von der Installation anderer Plugins. Wählen Sie im Menü **Plugins** -> **Plugin hochladen** -> Wählen Sie das NeverBlock-Plugin zur Installation aus.

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

**Schritt 1 – Einführung**

Auf der ersten Seite des Installationsassistenten sind keine Eingaben erforderlich.

**Schritt 2 – Systemanforderungen**

In diesem Schritt werden die Ergebnisse der Konfigurationstests angezeigt. Die Ergebnisse können je nach Ihrer Einrichtung variieren.

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

Weitere Informationen zu den einzelnen Tests und Ergebnissen sowie zur manuellen Ausführung finden Sie in den Abschnitten „diag.php ausführen“ und „Mögliche diag.php-Ergebnisse“.

**Schritt 3 – Plugin-Einstellungen**

Im Konfigurationsabschnitt von NeverBlock PHP gibt es einen Abschnitt zum Thema [Konstanten konfigurieren](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#configuring-constants). In Schritt 3 des Installationsassistenten können Sie diese Einstellungen konfigurieren. Einzelheiten zu den einzelnen Einstellungen finden Sie im entsprechenden Abschnitt. Sie sind außerdem im folgenden Screenshot beschrieben.

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

Diese Konfigurationen können jederzeit nach der Installation geändert werden.

**Schritt 4 – Fertig**

Nach Abschluss der Installation wird die Option **NeverBlock** in Ihrem Menü angezeigt. Hier können Sie die Plugin-Einstellungen bei Bedarf ändern:

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

### Zonen in WordPress hinzufügen

NeverBlock-Zonen können auf zwei Arten zu Ihrer WordPress-Seite hinzugefügt werden.

**Shortcodes**

Fügen Sie in TinyMCE beim Erstellen oder Bearbeiten eines Beitrags den folgenden Shortcode ein und achten Sie darauf, die richtige idzone zu verwenden:

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

Alternativ können Sie die folgende Vorlage als Beispiel für ein Theme-Template verwenden:

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

Beachten Sie, dass es ein optionales Attribut `container_id` gibt, mit dem auf die ID eines DOM-Knotens verwiesen werden kann. Dadurch wird der Knoten an das zugehörige div angehängt. Damit dies funktioniert, muss das div vor dem Shortcode vorhanden sein. Andernfalls findet NeverBlock das Element nicht.

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

**Reguläre Skripte**

Beim Bearbeiten eines Theme-Templates können Sie die standardmäßigen Skripte verwenden, die im Abschnitt [Anzeigen einblenden](https://docs.exoclick.com/publishers/de/adblock/neverblock.md#adding-zones-to-a-page).

## Änderungsprotokoll

Weitere Informationen finden Sie in der Datei CHANGELOG, die im Softwarepaket enthalten ist.

### Änderungsprotokoll von NeverBlock PHP

**3.14 (21.10.2026)**

* Der NeverBlock-Backend-Loader kann lokal keine Anzeigen ausliefern, selbst nachdem veraltete PHP-Hinweise und die IP-Erkennung korrigiert wurden
* Seit Version 3.14 lautet das Loader-Ereignis getmsgloader. Wenn Sie auf Version 3.14 aktualisieren, passen Sie Ihr Snippet an. Das alte Snippet (getexoloader) verursacht folgenden Fehler: Cannot read properties of undefined (reading 'addZone').

**3.12 (10.01.2025)**

* Fehler behoben: Neverblock > diag.php meldet bei der IP-Erkennung immer „Can’t access service to compare IPs“

**3.11 (11.07.2023)**

* Kompatibilität mit PHP 5.2 und höher behoben

**3.10 (12.01.2022)**

* Einen Parameter für zukünftige Kompatibilität hinzugefügt
* Unterstützung für das WebP-Format hinzugefügt

**3.9 (03.12.2021)**

* Zeitlimit für die Erkennung hinzugefügt, um falsch positive Ergebnisse bei langsamen Verbindungen zu vermeiden

**3.8 (10.06.2021)**

* Pop-under-bezogenen Code entfernt (Inline ist die bevorzugte Methode) und unnötiges Cookie entfernt

**3.7 (05.07.2019)**

* Einige Maßnahmen gegen den „Anti-CV“-Filter

**3.6 (16.05.2019)**

* JavaScript-Objektreferenz entfernt, die manchmal blockiert wird
* Neue API zur IP-Erkennung in diag (unterstützt IPv6)

**3.5 (14.03.2019)**

* Funktion zum Entfernen teilweise blockierter Anzeigen hinzugefügt
* no\_cookie-Parameter hinzufügen, damit backend\_loader.php auf einer anderen Domain liegen kann
* Unterstützung für den acpu-Cache hinzufügen

**3.4 (09.07.2018)**

* Erkennung verbessern (auf das Laden der Seite warten)

**3.3 (25.05.2018)**

* Dokumentationslink zur Übermittlung von IPs aktualisieren
* Fehler beim Überschreiben von window\.ExoLoader durch manche Blocker (uBlock) beheben
* Bisherigen IP-Erkennungsdienst ersetzen

**3.2 (15.03.2018)**

* Fehler mit PHP-Versionen ≤ 5.3 beheben

**3.1 (07.03.2018)**

* Banner- und Link-Parameternamen automatisch zufällig generieren und flexiblere Steuerung hinzufügen
* JavaScript-Fehler beheben, wenn serve() mehrfach aufgerufen wird

**3.0 (30.01.2018)**

* Konzept angeforderter Renderer einführen
* Neue Anzeigenformate hinzugefügt: Native Ad, Sticky-Banner, Web- und mobile Instant Messages
* Dynamische Benennung des ExoLoader-Objekts, falls es von Adblockern unveränderlich gemacht wird
* Kleinere Änderungen zur Unterstützung des Phar-Installers und des WordPress-Plugins
* PHP-Version für Multi-Curl automatisch prüfen

**2.25 (12.10.2017)**

* Prüfung auf Änderung des Antworttexts im Textkörper bei Diagnose-Anfragen für Anzeigen beheben
* Vom Anzeigenserver zurückgegebene Fehler protokollieren
* Diagnose der IP-Erkennung beheben (Setup aus backend\_loader.php verwenden)

**2.24 (15.08.2017)**

* IP-Erkennung im Diagnoseskript prüfen
* backend\_loader.php auf einer anderen Domain hosten können

**2.22 (13.06.2017)**

* Erkennung: Verhindern, dass die box-sizing-Formatierung der Website die Parameter der DOM-Falle beeinflusst

**2.21 (09.06.2017)**

* Problem mit falsch positiven Ergebnissen bei der Adblock-Erkennung beheben

**2.20 (01.06.2017)**

* Blockererkennung geändert
* Problem beheben, bei dem mehrere serve()-Aufrufe gegenseitig ihre Cookies überschreiben

**2.19 (24.05.2017)**

* Problem mit Exchange-Kampagnen und 404-Bannern beheben
* Kleinere Fehlerbehebungen für PHP 5.2

**2.18 (07.04.2017)**

* Bei strikter Header-Validierung den korrekten Header für JavaScript senden

**2.17 (27.03.2017)**

* Schnittstellenfehler in backend\_loader.php bei älteren PHP-Versionen beheben
* Problem mit dem Öffnen von Links in frontend\_loader.php beheben, wenn LINK\_URL\_PREFIX angegeben ist

**2.16 (14.03.2017)**

* Zonen dynamisch hinzufügen können, nicht nur beim Laden der Seite
* Container-Referenz als Parameter für addZone hinzufügen

**2.15 (08.03.2017)**

* Datei-Cache hinzufügen.
* Übertragene Datenmenge verringern.
* Banner laden über `<img>`, statt als Base64-Hintergrundstil.

**2.14 (30.09.2016)**

* resolveMulti so korrigieren, dass immer ein Array zurückgegeben wird

**2.13 (14.09.2016)**

* POST-Parameter korrekt an openLink übergeben

**2.12 (12.09.2016)**

* Inline-Stile vollständig in CSS-Klassen verschieben

**2.11 (09.09.2016)**

* Problem beheben, dass document.contains im IE nicht definiert ist

**2.10 (07.09.2016)**

* Probleme mit IPv6-Verbindungen und cURL beheben
* Probleme mit falschen Klick-Links aufgrund serverseitiger Aliase beheben

**2.9 (02.09.2016)**

* Mechanismus zum Öffnen von Links so ändern, dass die Weiterleitung über den Backend-Loader erfolgt

**2.8 (30.08.2016)**

* Problem mit HTTPS-Anzeigen durch externe DNS-Auflösung und Caching außerhalb von cURL beheben

**2.7 (22.08.2016)**

* Anzeigen-Endpunkte auf HTTPS umstellen, um Probleme mit gemischten Inhalten zu vermeiden

**2.6 (17.08.2016)**

* Allgemeinerer DOM-Platzhalter für Banner
* Problem mit Headern beheben
* Fehler und Debug-Meldungen im Frontend-Loader getrennt ausgeben
* Anleitung zur Fehlerbehebung

**2.5 (02.08.2016)**

* Protokollierung für abgelaufene Anfragen und andere Fehler hinzufügen
* JavaScript-Fehler beheben, wenn etwas den DOM-Platzhalter für Anzeigen überschreibt

**2.4 (22.07.2016)**

* Verbesserte Timeouts
* Diagnosedatei und verbesserte Fehlersuche

**2.3 (20.07.2016)**

* Kleineren Fehler beim Senden einer Anfrage an den Backend-Loader beheben, wenn keine Zonen hinzugefügt wurden

**2.2 (15.07.2016)**

* Neue Domain für den Ads-Endpunkt mit besserem Load-Balancing

**2.1 (27.06.2016)**

* Inkompatibilität mit dem Prototype-Framework beheben

**2.0 (14.06.2016)**

* Offene Veröffentlichung
* Eine Anfrage für mehrere Anzeigen
* Einheitlicher Loader für Banner

### NeverBlock-Proxy-Änderungsprotokoll

**1.0.1**

* Ermöglicht die Übergabe von Sprache und Referer in der Anfrage
* Aktualisierte Beispiele

**1.0.0**

* Erstveröffentlichung


---

# 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/de/adblock/neverblock.md?ask=<question>&goal=<user_goal>
```

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

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

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