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

# Neverblock

## Présentation

### Anti-blocage publicitaire

NeverBlock est une solution éprouvée de contournement des bloqueurs de publicité qui augmente immédiatement vos revenus.

Notre technologie unique garantit que vos publicités continuent de s’afficher, même si un utilisateur a installé et activé un logiciel de blocage des publicités.

La technologie avancée de NeverBlock contourne les bloqueurs de publicité afin de récupérer l’intégralité de vos revenus publicitaires. Elle fonctionne sur tous les navigateurs (notamment Safari, Chrome, Internet Explorer, Mozilla, etc.), ainsi que sur toutes les plateformes et tous les appareils (ordinateur de bureau, smartphone, tablette).

Cette solution est gratuite pour tous les clients d’ExoClick et s’installe simplement en ajoutant une ligne de code à votre site Web.

Cette documentation présente quatre façons différentes d’implémenter NeverBlock :

* **NeverBlock PHP** - La solution standard, la plus simple à mettre en œuvre et la plus couramment utilisée. Elle sera présentée en détail dans cette documentation.
* **API NeverBlock** - Lorsqu’un langage non pris en charge est nécessaire, l’API fournit les points de terminaison permettant d’obtenir directement les publicités. À utiliser lorsqu’une solution manuelle est requise.
* **Proxy NeverBlock** - Une application multiplateforme destinée à gérer les requêtes API et la mise en cache des publicités. Ce service s’exécute en arrière-plan et fournit à l’utilisateur un point de terminaison plus direct pour récupérer les publicités.
* **Extension WordPress** - Une extension WordPress conçue pour intégrer facilement les zones publicitaires NeverBlock à votre site WordPress.

## NeverBlock PHP - Installation automatique

### Objectif

L’installateur Phar NeverBlock est un outil qui facilite l’installation de la solution NeverBlock PHP (version 3.0). Il peut être utilisé à la place des étapes décrites dans la section [Installation manuelle](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#neverblock-php-manual-installation). Les fichiers seront installés dans le répertoire indiqué ou, par défaut, dans le répertoire **nb** . L’installateur se chargera de certains éléments de configuration, notamment du [renommage des fichiers](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#renaming-the-files-mandatory) et des [clés d’identification](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#identification-keys).

### Télécharger l’installateur

La dernière version peut être téléchargée à l’aide du lien suivant :

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

### Exécuter l’installateur

Une fois le fichier Phar téléchargé, placez-le dans le répertoire où vous souhaitez conserver les fichiers NeverBlock. Lors de l’exécution de l’installateur, vous pouvez indiquer le chemin d’installation des fichiers ou conserver le chemin par défaut. Vous pouvez également définir un paramètre facultatif pour le fichier journal. Son utilité est décrite dans la section [Fichier journal](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#logfile) .

```bash
# Créer et installer les fichiers dans le répertoire 'nb' par défaut 
./neverBlockInstaller.phar
```

Paramètres facultatifs :

```bash
# Créer et installer les fichiers dans le répertoire indiqué
./neverBlockInstaller.phar --path=specific/path 

# Installer les fichiers dans le répertoire courant
./neverBlockInstaller.phar --path=.

# Chemin du fichier journal
./neverBlockInstaller.phar --logfile=path/logfile

# Chemin vers writable_path (si APC/APCu n’est pas installé.)
./neverBlockInstaller.phar --writable_path=path/writable_path
```

### Analyse de la réponse

Une fois l’installateur exécuté, une réponse semblable à celle présentée ci-dessous s’affiche. Elle peut être analysée en deux parties : les résultats du diagnostic et les scripts requis.

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

**Résultats du diagnostic**

Après l’exécution du fichier Phar, les résultats de plusieurs tests de configuration s’affichent. Notez que la **détection de l’adresse IP** nécessitera le **diag.php** à exécuter manuellement. Pour plus de détails sur ces résultats et l’exécution manuelle, consultez les sections Exécuter diag.php et Résultats possibles de diag.php.

**Scripts requis**

Sous les résultats du diagnostic, deux scripts apparaissent, dont les noms ont été générés automatiquement. Ces scripts indiquent les noms de notre **frontend\_loader.js** et **backend\_loader.php**, et correspondent aux chemins à utiliser lors de l’ [Affichage des publicités](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#adding-zones-to-a-page).

## NeverBlock PHP - Installation manuelle

### Télécharger les fichiers

L’installation et la majeure partie de la configuration peuvent être effectuées à l’aide de l’ [installateur phar](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#neverblock-php-automatic-installation). L’installation manuelle peut se faire comme suit.

La dernière version (v3.14) peut être téléchargée à l’aide de ces liens :

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

Ou à l’aide des commandes suivantes :

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

Les fichiers nécessaires dans ce dossier sont :

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

### Renommer les fichiers (obligatoire)

Pour éviter que les fichiers soient immédiatement bloqués par les bloqueurs de publicité, il est nécessaire de les renommer.

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

L’un des tests de **diag.php** vérifie l’existence de **backend\_loader.php**, il faut donc mettre à jour les références de ce test afin qu’elles correspondent au nouveau nom de votre fichier. L’exemple ci-dessous reprend la même configuration que celle illustrée dans l’image précédente. En haut de la page, mettez à jour la ligne suivante :

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

### Placer les fichiers sur votre serveur

Les fichiers mentionnés ci-dessus doivent être placés sur le serveur où vous souhaitez afficher vos publicités.

Copiez les fichiers dans le répertoire de votre choix :

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

### Exécuter diag.php

Maintenant que les fichiers NeverBlock se trouvent sur notre serveur, nous allons utiliser le fichier **diag.php** pour vérifier que tout fonctionne correctement jusqu’ici. Pour ce faire, accédez à l’URL où se trouve le fichier diag.php. En prenant la capture d’écran précédente comme exemple, voici l’URL : `https://www.my-example-site.com/nb/diag.php`

Si tout s’est bien passé jusqu’ici, vous devriez voir ce qui suit (nous configurerons le fichier journal dans la section [Fichier journal](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#logfile)):

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

Si les résultats affichés sont différents, une configuration supplémentaire peut être nécessaire.

### Résultats possibles de diag.php

**Version de PHP :** Si la version de PHP n’est pas prise en charge, vous en serez informé. La solution NeverBlock standard nécessite PHP 5.2 ou une version ultérieure.

**Présence du script du chargeur backend :** En cas d’échec, le fichier **backend\_loader.php** introuvable par **diag.php**. Cela peut être dû à un changement de nom de fichier ou à un problème de chemin d’accès.

**Rapports d’erreurs :** Un avertissement peut s’afficher. Cet avertissement n’empêchera pas la solution NeverBlock de fonctionner.

**Présence du cache** et **Bibliothèque cURL :** En l’absence de cache et de cURL, des avertissements s’afficheront. Cela n’empêchera pas NeverBlock de fonctionner, mais nous vous recommandons de les configurer.

* L’extension PHP [cURL](https://www.php.net/manual/en/book.curl.php) extension *(fortement recommandée)*
* L’extension PHP [APCu](https://www.php.net/manual/en/book.apcu.php) ou un cache de fichiers (voir [Mise en cache](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#caching))

**Détection de l’adresse IP :** En cas d’erreur concernant la correspondance de l’adresse IP, consultez la section [Transmission des adresses IP](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

**Requêtes publicitaires :** Si les requêtes prennent plus de temps que prévu, vous serez peut-être invité à augmenter les paramètres **REQUEST\_TIMEOUT\_MS** et **CONNECT\_TIMEOUT\_MS** . La procédure est décrite dans la section [Configuration des constantes](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#configuring-constants).

## NeverBlock PHP - Configuration

### Transmission des adresses IP (avec Cloudflare, etc.)

Si vous utilisez un service tel que Cloudflare, placé entre l’utilisateur et vos serveurs, l’adresse IP détectée dans **backend\_loader.php** peut être considérée comme invalide. Cela peut entraîner un mauvais comptage des clics ou des impressions des annonces. Pour résoudre ce problème, vous pouvez remplacer la valeur `$_SERVER["REMOTE_ADDR"]` transmise à la classe *UserEnvironment* dans **backend\_loader.php** par la valeur correcte transmise par votre service de mise en cache ou de proxy.

Dans le cas de Cloudflare, nous transmettrions le paramètre `$_SERVER["HTTP_CF_CONNECTING_IP"]` . Exemple ci-dessous.

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

Une fois cette modification effectuée, notre classe *UserEnvironment* se présentera comme suit :

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

Lorsque vous utilisez un autre service, comme Apache ou NGINX, vous pouvez utiliser `isset($_SERVER['HTTP_X_REAL_IP']) ? $_SERVER['HTTP_X_REAL_IP'] : $_SERVER['REMOTE_ADDR']` comme illustré ci-dessous :

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

Nous pouvons maintenant relancer **diag.php**, si cela faisait échouer le test de *détection de l’adresse IP* , nous devrions maintenant obtenir des résultats positifs.

### Fichier journal

Il s’agissait d’une configuration facultative lors de l’ [installation automatique](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#neverblock-php-automatic-installation). Si vous souhaitez consigner les délais d’expiration des requêtes et d’autres erreurs, vous pouvez créer un fichier journal accessible en écriture. Dans cet exemple, le fichier journal se trouve dans le même répertoire que nos autres fichiers NeverBlock.

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

Une fois ce fichier créé (pensez à vérifier qu’il est accessible en écriture), nous allons modifier **backend\_loader.php** pour définir son chemin. En haut du fichier, `LOGFILE` est défini sur **NULL** et doit être modifié afin d’indiquer le chemin du nouveau fichier journal, comme suit :

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

Une fois cette opération effectuée, nous pouvons relancer **diag.php**. Si le fichier a été créé et que son chemin a été défini correctement, nous verrons maintenant ce qui suit.

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

### Mise en cache

Il s’agissait d’une configuration facultative lors de l’ [installation automatique](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#neverblock-php-automatic-installation). La mise en cache peut considérablement améliorer les temps de réponse des annonces. Si vous ne disposez pas d’APC ou d’APCu, pris en charge par **backend\_loader.php** par défaut, il est recommandé de configurer un cache de fichiers. Pour cela, vous devez créer un répertoire accessible en écriture par PHP et définir son chemin comme valeur de la constante **WRITABLE\_PATH** dans **backend\_loader.php**. Si cette constante est définie, le cache de fichiers sera utilisé par défaut à la place de tout autre cache (même si vous disposez d’APC ou d’APCu).

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

### Clés d’identification

Si vous avez utilisé l’ [installation automatique](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#neverblock-php-automatic-installation) ces clés ont déjà été configurées lors de l’installation. Elles servent au chiffrement afin d’empêcher la falsification des URL des bannières. Il est fortement recommandé de remplacer les valeurs de *KEY\_1* et de *KEY\_2* dans **backend\_loader.php** par des chaînes uniques.

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

### Cookies

Les cookies permettent de vérifier que NeverBlock fonctionne comme prévu.

* **yuo1** - le nom par défaut de ce cookie est **yuo1**, et ce nom peut être configuré dans **frontend\_loader.js**. Ce cookie peut également être désactivé en définissant [no\_cookie: true](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#how-do-i-configure-neverblock-from-a-different-domain).
* **zone-closed-** - Ce cookie garantit que la zone reste fermée si l’utilisateur l’a fermée avec adBlock activé, puis a désactivé adBlock.

### Configuration des constantes

Certaines constantes sont définies dans **backend\_loader.php**. Il est recommandé de les conserver telles quelles, mais dans certains cas, il peut être utile de modifier certains paramètres.

* **CONNECT\_TIMEOUT\_MS** - délai d’expiration de la connexion, en millisecondes, utilisé pour les requêtes curl/fsock.
* **REQUEST\_TIMEOUT\_MS** - délai d’expiration de la requête entière, en millisecondes (incluant également le temps de CONNECT\_TIMEOUT\_MS), utilisé pour les requêtes curl/fsock.
* **LOGFILE** - chemin vers un fichier accessible en écriture où consigner les messages, notamment certaines erreurs et les cas où les requêtes expirent.
* **ALLOW\_MULTI\_CURL** - lorsque c’est possible, le script essaie d’utiliser curl\_multi\_exec. Si cela sollicite trop le processeur, cette option peut être désactivée.

Paramètres du cache APC/APCu et du cache fichier :

* **WRITABLE\_PATH** - chemin vers un répertoire accessible en écriture qui contiendra les fichiers de cache. (Si cette option est définie, le cache fichier devient le cache utilisé par défaut.)
* **CACHE\_INTERVAL\_BANNERS** - durée de mise en cache des images de bannière (en secondes). Si cette valeur est définie sur 0, les images ne seront PAS mises en cache.
* **CACHE\_INTERVAL\_SCRIPTS** - durée de mise en cache des scripts JavaScript. Si cette valeur est définie sur 0, ils ne seront PAS mis en cache.
* **CACHE\_KEYS\_LIMIT\_BANNERS** - nombre maximal d’images de bannière pouvant être stockées dans le cache (afin de ne pas trop solliciter les ressources de l’éditeur). Si cette valeur est définie sur 0, il n’y aura aucune limite et toutes les images seront mises en cache.

Si vous configurez des règles de réécriture Apache/Nginx pour accéder à **backend\_loader.php** à l’aide d’autres URI :

* **LINK\_URL\_PREFIX** - si cette option est définie, elle devient la nouvelle URI des liens de clic sur le frontend (le hachage de l’URL de redirection y est ajouté).
* **BANNER\_URL\_PREFIX** - si cette option est définie, elle devient la nouvelle URI des images de bannière sur le frontend (le hachage de la bannière correspondante y est ajouté).
* **KEY\_1** - clé secrète empêchant la falsification des URL des bannières (elles sont désormais renvoyées au chargeur backend dans la requête).
* **KEY\_2** - clé secrète empêchant la falsification des URL des bannières (elles sont désormais renvoyées au chargeur backend dans la requête).

## NeverBlock PHP - Affichage des publicités

### Ajout de zones à une page

Ces extraits de code sont destinés à NeverBlock 3.14 et aux versions ultérieures. Pour les versions antérieures, utilisez getexoloader au lieu de getmsgloader.

{% hint style="info" %}
Si vous utilisez une application monopage, [le chargement dynamique](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#dynamic-loading-single-page-applications) devra obligatoirement être mis en œuvre.
{% endhint %}

Les formats publicitaires suivants sont pris en charge :

* Bannières
* Publicités natives
* Bannières fixes
* Messages instantanés

{% hint style="info" %}
Les publicités multiformat ne sont pas encore prises en charge. Vous pouvez toutefois utiliser NeverBlock avec les bannières individuelles que vous avez configurées pour les publicités multiformat. Vous pourrez ainsi utiliser les publicités multiformat pour les utilisateurs standards et les bannières compatibles avec NeverBlock pour cibler les utilisateurs équipés d’un bloqueur de publicités.
{% endhint %}

Veuillez noter que ce script n’affichera des publicités que si un utilisateur a installé et activé un bloqueur de publicités. Ne supprimez aucune balise publicitaire standard existante.

Dans cet exemple, nous allons utiliser la configuration décrite dans [Renommer les fichiers](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#renaming-the-files-mandatory). Vérifiez que vos chemins et noms de fichiers correspondent à votre configuration.

**Étape 1 - Placer frontend\_loader.js sur la page**

Dans la balise `<body>` de votre page, ajoutez tout en haut le code suivant :

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

Ce code ne doit être inclus qu’une seule fois sur la page. Il doit également se trouver avant tous les autres scripts de zone.

**Étape 2 - Ajouter une zone NeverBlock**

Les extraits de code suivants servent à déclarer vos zones publicitaires. Ils doivent être placés dans le DOM à l’endroit où vous souhaitez afficher la zone. Vous pouvez ajouter plusieurs blocs de bannières de cette manière sur une page. **Veillez à ne pas les placer dans des divs dotées de classes ou de styles spécifiques liés à l’affichage des publicités**, car les bloqueurs de publicités cibleront ces divs (par exemple, `class="ad-footer"`, `style="width:300px;height:250px;"`).

Pour ajouter une zone publicitaire, procédez comme suit (veillez à remplacer la valeur de idzone par l’identifiant de votre 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;
        
        //Le code d’ajout de zones peut être placé plusieurs fois sur la page
        ExoLoader.addZone({"idzone":"111"});
        
        //Pour utiliser un sous-identifiant, ajoutez un paramètre sub numérique à l’objet transmis à addZone
        //ExoLoader.addZone({"idzone":"111", "sub": "1"});
    })();
</script>
```

**Étape 3 - Diffuser les publicités (backend\_loader.php)**

Après avoir inclus toutes les déclarations *addZone()* nous souhaitons diffuser les publicités. Pour ce faire, nous allons utiliser la fonction *serve* Elle diffuse les données de toutes les zones publicitaires précédemment déclarées et **ne doit généralement être appelée qu’une seule fois sur la page**. Le **nombre maximal de zones pouvant être appelées sur une page est de 20**. Les exceptions concernent le chargement dynamique d’une page, décrit dans la section [Chargement dynamique](https://docs.exoclick.com/publishers/fr/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>
```

### Chargement dynamique (applications monopages)

Il est possible de transmettre une référence à l’élément DOM conteneur auquel la bannière sera ajoutée. Ainsi, lors de l’appel de serve, l’emplacement où placer la zone publicitaire sera connu. Voici comment procéder :

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

Il est également possible d’appeler *serve()* avec l’indicateur force pour diffuser les publicités au moment de votre choix (par exemple, dans une fonction après le rendu d’une partie de la page), plutôt qu’au chargement de la page :

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

        ExoLoader.addZone({"idzone":"444", "container": document.getElementById('banner4_placeholder')});
        ExoLoader.serve({"script_url":"/nb/ba_lo.php", "force": true});
    })();
</script>
```

La fonction *serve()* peut être appelée plusieurs fois. Après chaque *serve()* L’appel à ExoLoader sera vidé des précédents *addZone()* appels. Ainsi, seules les bannières que vous appelez *addZone()* après un appel à serve s’afficheront lors du prochain *serve()*.

### Domaine de base

Si vous êtes déjà client d’ExoClick, vous avez peut-être des zones publicitaires classiques sur votre site. Si vous utilisez un domaine autre que \*.exoclick.com (par ex. **ads.exosrv.com**), vous devez alors définir le paramètre *domain\_base* de l’objet detector (`ExoLoader.getDetector()`) sur « exosrv.com » avant le premier appel à addZone. Procédez comme indiqué ci-dessous :

```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>
...
<!-- Premier appel à 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>
```

### Aucune publicité ne s’affiche

Si aucune publicité ne s’affiche, vérifiez d’abord le fichier diag.php pour voir si certaines configurations sont incorrectes. Si tous les tests réussissent, créez une page de test avec une seule zone afin de vérifier qu’elle fonctionne de manière isolée. Si aucune publicité ne s’affiche à ce stade, consultez la section [Aide](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#neverblock-php-help) pour obtenir des informations supplémentaires.

## NeverBlock PHP - Aide

### Mes publicités ne s’affichent pas. Que dois-je faire ?

**Vérifiez que vous utilisez la dernière version du code de la solution anti-adblock.**

Nous travaillons sans cesse à l’amélioration de la solution en nous appuyant sur nos tests, les commentaires des clients et l’évolution des bloqueurs de publicité. Les anciennes versions peuvent encore présenter des problèmes que nous avons déjà corrigés. Veuillez donc vous assurer d’utiliser la version la plus récente avant de vérifier les autres points ci-dessous.

**Avez-vous exécuté diag.php ?**

Cela peut vous aider à détecter un problème dans la configuration de votre chargeur côté serveur.

**Vérifiez l’onglet « Réseau » de la barre d’outils « Outils de développement » de Chrome/FF.**

Est-ce que votre **frontend\_loader.js** se charge correctement ?

**Vous devez peut-être indiquer un autre chemin ?**

* Essayez d’indiquer un chemin complet dans src plutôt que « /frontend\_loader.js ».
* Vérifiez que *ExoLoader.addZone()* est appelé **avant** *ExoLoader.serve()*
* Vérifiez l’onglet « Console » de la barre d’outils « Outils de développement » de Chrome/FF. Des erreurs liées à **frontend\_loader.js**
* Exécutez `ExoLoader.getDebug();` dans la console JavaScript pour voir ce qui se passe. Le résultat ressemble à ceci :

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

**Vérifiez les identifiants des zones.**

Assurez-vous que la zone correspondant à l’idzone fourni existe et qu’elle vous appartient.

**Placez-vous les codes publicitaires dans des iframes ?**

Le contenu des iframes se charge après la page principale. Si vous appelez *addZone()* dans une iframe et appelez *serve()* sur la page principale, le *serve()* sera exécuté avant *addZone()*, et cela ne fonctionnera pas. Il existe deux méthodes avec les iframes :

1. Tout inclure dans une iframe : tous les codes des étapes 1, 2 et 3 de [Ajouter des zones à une page](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#adding-zones-to-a-page) doivent se trouver à l’intérieur. Toutefois, si une page contient plusieurs iframes de ce type, un conflit peut survenir, car cette solution utilise un cookie. Si le nom du cookie est identique, les publicités des iframes peuvent être mélangées. Vous pouvez renommer un cookie avant d’appeler serve, comme ceci :

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

L’inconvénient est que vous devrez disposer de plusieurs chargeurs backend, dans lesquels vous définirez également des noms de cookie différents :

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

2. Placez le code de l’étape 1 (l’inclusion du fichier du chargeur frontend) sur la page principale de votre site. Dans les iframes, appelez addZone. Pour récupérer correctement l’objet ExoLoader, vous devrez modifier l’appel standard afin d’utiliser **window\.top**.document.dispatchEvent. Dans addZone, transmettez également le paramètre **doc** qui pointera vers la propriété document de votre iframe :

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

    ExoLoader.addZone({"idzone": 111, "doc": window.document});
    ExoLoader.addZone({"idzone": 111, "doc": window.document});
})();
```

Appelez également serve() dans la dernière iframe :

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

    ExoLoader.serve({script_url: "/backend_loader.php"});
})();
```

**Utilisez-vous un framework JavaScript pour le frontend de votre site ?**

Vérifiez que vous ne remplacez pas le innerHTML des éléments dans lesquels vous avez les appels à *addZone()* L’appel *addZone()* place un espace réservé DOM à l’endroit où il est effectué. S’il est remplacé par autre chose, le script ne pourra pas le remplir avec les données publicitaires.

**Le fichier backend\_loader.php renvoie-t-il une réponse vide ?**

Si oui, consultez le journal des erreurs PHP pour repérer d’éventuelles erreurs connexes. Après avoir ouvert une page contenant le code ExoLoader, ouvrez : `http://yoursite/backend_loader.php?exoDebug=exoDebug`. Si des erreurs de délai d’expiration *curl/fsock* s’affichent, vous devrez peut-être augmenter les valeurs de **CONNECT\_TIMEOUT\_MS** et de **REQUEST\_TIMEOUT\_MS** dans le fichier **backend\_loader.php**.

### Les publicités s’affichent, mais les statistiques n’indiquent aucun clic ou aucune impression

**Utilisez-vous CloudFlare, ou vos serveurs Web passent-ils par un autre proxy ?**

Les requêtes publicitaires NeverBlock ne sont pas envoyées directement à notre serveur depuis le navigateur de l’utilisateur final. Nous comptons donc sur le fichier **backend\_loader.php** côté éditeur pour nous transmettre l’adresse IP de l’utilisateur. Nous la récupérons dans `$_SERVER['REMOTE_ADDR']` dans ce script, à partir d’une variable globale PHP. Si l’infrastructure de l’éditeur est configurée de telle sorte que cette variable ne contienne pas la bonne adresse IP de l’utilisateur, cela peut entraîner des problèmes d’impressions ou de clics invalides. Pour résoudre ce problème, consultez [Transmettre les adresses IP](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

### En mode privé dans Firefox (ou un autre navigateur), les publicités NB et standard s’affichent toutes les deux

**Veuillez vérifier que le paramètre domain\_base est configuré correctement.**

[Ici](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#domain-base) vous trouverez un exemple de configuration du domaine de base. Le problème est que, dans certains navigateurs, le plus souvent Firefox, le mode privé bloque les requêtes vers certains domaines. Exoclick.com, par exemple, figure sur la liste noire. Ainsi, si le code de zone normal contient le domaine « exoclick.com », le mode privé agit comme un bloqueur de publicités et la solution NB devrait donc afficher des publicités. En revanche, nos autres domaines ne sont pas forcément bloqués par le mode privé. Pour éviter l’affichage de publicités en double et permettre au détecteur NB de déterminer correctement si les publicités normales sont bloquées ou non, il doit savoir depuis quel domaine elles sont demandées.

### Comment configurer NeverBlock depuis un autre domaine ?

1. Dans *frontend\_loader.js*, accédez à la fonction `serve: function(params)` et décommentez la définition des paramètres.
2. Ajoutez un autre domaine et définissez `force: true` et `no_cookie: true`:

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

3. Faites ensuite référence au chemin NeverBlock associé au nouveau domaine dans la page.

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

### Que faire en cas de faux positif lors de la détection d’un bloqueur de publicités ?

Il arrive que des utilisateurs ayant désactivé AdBlock voient tout de même les publicités NB s’afficher en même temps que les publicités habituelles. Cela peut se produire parce que NB tente d’inclure dans la page un script de diffusion publicitaire réel servant de leurre, afin de vérifier s’il est bloqué. Sur les connexions lentes, le chargement de ce script prend parfois trop de temps et NB peut conclure qu’il a été bloqué, puis décider de demander les publicités. En raison du fonctionnement de certains bloqueurs de publicités, il est impossible de savoir si le chargement n’est pas encore terminé ou s’il ne se terminera jamais à cause d’un bloqueur. Ce problème ne concerne pas la plupart des sites et des utilisateurs. S’il touche une part importante de vos utilisateurs, nous vous conseillons d’augmenter le délai d’expiration de la détection NB à l’aide de la fonction **setTimeout** de **ExoLoader**, comme ceci :

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

## API NeverBlock

NeverBlock utilise un point de terminaison simple pour relayer les requêtes vers les serveurs de syndication d’ExoClick.

Ce point de terminaison est documenté ci-dessous. Vous pouvez l’utiliser librement pour créer votre propre intégration personnalisée dans le langage de votre choix.

### API v1

Cette version de l’API prend en charge tous les formats actuellement disponibles pour la solution NeverBlock (bannières, bannières fixes, publicités natives et messages instantanés).

**Requête pour une seule zone**

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

**Requête pour plusieurs zones**

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

Les requêtes ci-dessus sont similaires, à ceci près que les requêtes pour plusieurs zones doivent utiliser une notation de tableau à indices incrémentés (*c’est-à-dire zones\[0]\[idzone], zones\[1]\[idzone],…*), comme illustré.

{% hint style="info" %}
Les requêtes pour plusieurs zones sont limitées à un maximum de **20** zones par requête.
{% endhint %}

**Paramètres**

Les paramètres suivants doivent être définis pour **toutes les** requêtes :

* **zones\[N]\[idzone]** - *identifiant de la zone à demander*
* **user\_ip** - *adresse IP des utilisateurs finaux (utilisée pour le ciblage)*

**En-têtes**

Les en-têtes suivants doivent être définis pour **toutes les** requêtes :

* **X-Forwarded-For** - *Adresse IP d’origine du client*
* **Referer** - *Adresse du site référent*
* **User-Agent** - *Identifiant du client*
* **Accept-Language** - *Langue et paramètres régionaux du client*

**Réponse**

Les charges utiles JSON renvoyées par les exemples ci-dessus sont les suivantes.

Réponse pour une seule 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"}
}
```

Réponse pour plusieurs zones :

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

**Données de réponse**

Les valeurs suivantes peuvent être extraites de l’objet **zones** pour chaque zone dans la charge utile JSON renvoyée, afin de diffuser des annonces :

* **idzone**: Identifiant de la zone (utile pour distinguer les requêtes de zone lors du traitement)
* **type**: Type d’annonce ; dans les **renderers** il est possible d’obtenir le script de rendu par défaut correspondant. (Le script de rendu par défaut nécessite la présence de l’objet ExoLoader dans son contexte d’exécution.)
* **data**: Données publicitaires propres au type d’annonce concerné. Le plus souvent, **image** et **url** sont présents pour les bannières et les formats similaires ; certains comportent des paramètres supplémentaires.

Si vous utilisez l’API, il vous appartient d’écrire le code qui génère le DOM à afficher côté front-end à partir des données fournies. Nos renderers par défaut sont les scripts chargés de cette tâche dans le cadre de la solution NeverBlock standard (installation PHP + JavaScript). Ils ne peuvent être utilisés qu’avec l’objet JavaScript ExoLoader, qui stocke en interne les réponses post-traitées dans son propre format et fournit plusieurs fonctions utilitaires que les renderers utilisent et dont ils nécessitent la définition.

### API v0

Cette version de l’API ne prend en charge que les bannières. Elle renverra *false* pour toutes les zones d’un autre type.

**Requête pour une seule zone**

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

**Requête pour plusieurs zones**

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

Les requêtes ci-dessus sont similaires, à ceci près que les requêtes pour plusieurs zones doivent utiliser une notation de tableau à indices incrémentés (*c’est-à-dire zones\[0]\[idzone], zones\[1]\[idzone],…*), comme illustré.

{% hint style="info" %}
Les requêtes pour plusieurs zones sont limitées à un maximum de **20** zones par requête.
{% endhint %}

**Paramètres**

Les paramètres suivants doivent être définis pour **toutes les** requêtes :

* **zones\[N]\[idzone]** - *identifiant de la zone à demander*
* **user\_ip** - *adresse IP des utilisateurs finaux (utilisée pour le ciblage)*

**En-têtes**

Les en-têtes suivants doivent être définis pour **toutes les** requêtes :

* **X-Forwarded-For** - *Adresse IP d’origine du client*
* **Referer** - *Adresse du site référent*
* **User-Agent** - *Identifiant du client*
* **Accept-Language** - *Langue et paramètres régionaux du client*

**Réponse**

Les charges utiles JSON renvoyées par les exemples ci-dessus sont les suivantes.

Réponse pour une seule 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"
   }
]
```

Réponse pour plusieurs zones :

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

**Données de réponse**

Les valeurs suivantes peuvent être extraites de la charge utile JSON renvoyée pour diffuser des annonces :

* **url**: URL de clic utilisée pour envelopper l’image de la bannière
* **imgurl**: URL source de l’image de la bannière
* **idzone**: Identifiant de la zone (utile pour distinguer les requêtes de zone lors du traitement)

## Proxy NeverBlock

### De quoi s’agit-il ?

NeverBlock Proxy est une application multiplateforme conçue pour gérer les requêtes API et mettre en cache les annonces. Ce service s’exécute en arrière-plan afin de fournir à l’utilisateur un point de terminaison plus direct pour récupérer les annonces. Il est déconseillé de choisir NeverBlock Proxy plutôt que la solution PHP NeverBlock standard, car ses fonctionnalités sont moins complètes.

Il arrive que les bloqueurs de publicité ciblent agressivement certains sites, ce qui empêche NeverBlock PHP de fonctionner. Si c’est le cas sur votre site, envisagez d’utiliser NeverBlock Proxy.

### Télécharger NeverBlock Proxy

Téléchargez une archive précompilée pour votre plateforme :

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

Les fichiers nécessaires à l’exécution des publicités NeverBlock sont :

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

### Configuration du proxy

**Placer les fichiers sur le serveur**

Une fois les fichiers téléchargés, vous pouvez les placer dans un répertoire de votre serveur, comme illustré dans la capture d’écran ci-dessous :

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

**Créer le cache**

Créez un répertoire accessible en écriture qui stockera les fichiers téléchargés. Vous pouvez le créer dans le même dossier, puisque nous définirons le chemin ultérieurement.

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

**Mettre à jour la configuration obligatoire**

En haut du fichier **neverblock-conf.toml** se trouve une section intitulée *Mandatory*. Dans cette section, nous définirons nos chemins en fonction de la configuration présentée dans les captures d’écran ci-dessus. Notez que ces chemins seront propres à votre configuration.

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

**Démarrer le service**

Lancez le binaire depuis une invite de commandes ou un terminal — cette opération doit être effectuée dans le répertoire où il se trouve. Le service démarrera alors, et vous pourrez envoyer des requêtes cURL à localhost sur le port 8080.

### Utilisation

Une requête cURL permet de récupérer les zones. Cette requête peut être implémentée dans le langage de votre choix. Elle renverra une charge utile JSON contenant une URL de clic ainsi que le chemin d’accès à une image correspondante. L’image aura également été téléchargée dans le chemin indiqué. Lorsque vous transmettez le **user\_ip** tenez compte des points abordés dans [Transmission des adresses IP](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#passing-ips-using-cloudflare-etc). La structure de cette requête est la suivante :

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

Voici un exemple d’utilisation de cette structure en PHP :

```php
$ip = $_SERVER['REMOTE_ADDR'];
if (array_key_exists('HTTP_X_FORWARDED_FOR', $_SERVER)) {
    $ip = array_shift(explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']));
}

$referer = "";
if (array_key_exists('HTTP_REFERER', $_SERVER)) {
    $referer = array_shift(explode(',', $_SERVER['HTTP_REFERER']));
}

$language = "";
if (array_key_exists('HTTP_ACCEPT_LANGUAGE', $_SERVER)) {
    $language = array_shift(explode(',', $_SERVER['HTTP_ACCEPT_LANGUAGE']));
}
    
$data = [
    "user_ip" => $ip,
    "user_agent" => $_SERVER['HTTP_USER_AGENT'],
    "language" => $language,
    "referer" => $referer,
    "zones" => [
        ["idzone" => "1813348"],
        ["idzone" => "1813348"],
        ["idzone" => "1813348"]
    ]
];

$request = json_encode($data);

$ch = curl_init('http://localhost:8080/serve');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $request);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Content-Length: ' . strlen($request))
);

$result = json_decode(curl_exec($ch), true);
print_r($result);
```

### Configuration facultative

Il existe plusieurs paramètres de configuration facultatifs dans **neverblock-conf.toml**:

* **debug** - Activer le mode de débogage
* **port** - Port d'écoute du service
* **log** - Journal de l'application
* **http\_timeout** - Délai d'expiration des requêtes HTTP (s)
* **cache\_ttl** - Durée de vie (min) des fichiers mis en cache
* **cache\_purge\_frequency** - Intervalle entre les purges du cache (min)
* **syndication** - URL de syndication Exoclick. Voir [Domaine de base](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#domain-base) pour savoir dans quels cas la modifier

### Options

Des options permettent de remplacer les paramètres du fichier de configuration :

```bash
heisenberg:neverblock-proxy craig$ ./neverblock-proxy -h
Neverblock-Proxy - le gestionnaire de trafic AdBlock

Utilisation :
  neverblock-proxy [flags]

Options :
  -c, --cache-path string    Chemin du cache d'images
  -C, --config-file string   Fichier de configuration
  -l, --log string           Fichier journal
  -p, --port string          Port du service
```

## Extension WordPress

### Installation de l'extension

L'extension peut être téléchargée à l'aide du lien suivant :

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

L’installation du plugin NeverBlock pour WordPress ne diffère pas de celle de n’importe quel autre plugin. Dans le menu, sélectionnez **Extensions** -> **Téléverser une extension** -> sélectionnez le plugin NeverBlock à installer.

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

**Étape 1 - Introduction**

La première page de l’assistant d’installation ne vous demandera aucune saisie.

**Étape 2 - Configuration requise**

À cette étape, nous verrons les résultats des tests de configuration. Les résultats affichés peuvent varier selon votre environnement.

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

Pour plus de détails sur chacun de ces tests, leurs résultats et leur exécution manuelle, consultez les sections suivantes : Exécuter diag.php et Résultats possibles de diag.php.

**Étape 3 - Paramètres du plugin**

Dans la section de configuration de NeverBlock PHP, vous trouverez une rubrique consacrée à la [Configuration des constantes](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#configuring-constants). L’étape 3 de l’assistant d’installation vous permet de configurer ces paramètres. Les détails de chacun d’eux sont présentés dans la section correspondante et également décrits dans la capture d’écran ci-dessous.

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

Ces paramètres peuvent être modifiés à tout moment après l’installation.

**Étape 4 - Terminé**

Une fois l’installation terminée, l’option **NeverBlock** apparaît dans votre menu. Vous pouvez alors modifier les paramètres du plugin si nécessaire :

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

### Ajouter des zones dans WordPress

Il existe deux façons d’ajouter des zones NeverBlock à votre page WordPress.

**Codes courts**

Dans TinyMCE, lors de la création ou de la modification d’un article, ajoutez simplement le code suivant en veillant à utiliser le bon idzone :

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

Vous pouvez également utiliser l’exemple suivant dans un modèle de thème :

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

Notez qu’un attribut facultatif `container_id` permet de référencer l’identifiant d’un nœud DOM. Celui-ci sera ajouté au div correspondant. Pour que cela fonctionne, le div doit être présent avant le code court ; sinon, NeverBlock ne trouvera pas l’élément.

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

**Scripts classiques**

Lors de la modification d’un modèle de thème, vous pouvez utiliser les scripts standard décrits dans [Afficher les publicités](https://docs.exoclick.com/publishers/fr/adblock/neverblock.md#adding-zones-to-a-page).

## Journal des modifications

Veuillez consulter le fichier CHANGELOG inclus dans le package logiciel.

### Journal des modifications de NeverBlock PHP

**3.14 (21.10.2026)**

* Le chargeur backend de NeverBlock ne parvient pas à diffuser les publicités localement, même après la correction des avertissements PHP obsolètes et de la détection d’adresse IP
* Depuis la version 3.14, l’événement du chargeur est getmsgloader. Si vous passez à la version 3.14, mettez à jour votre extrait de code. L’ancien extrait (getexoloader) échoue avec l’erreur : Cannot read properties of undefined (reading 'addZone').

**3.12 (10.01.2025)**

* Correction du problème où Neverblock > diag.php renvoie toujours « Can’t access service to compare IPs » lors de la détection d’adresse IP

**3.11 (11.07.2023)**

* Compatibilité avec PHP 5.2 et versions ultérieures rétablie

**3.10 (12.01.2022)**

* Ajout d’un paramètre pouvant être utilisé pour assurer la compatibilité future
* Ajout de la prise en charge du format WebP

**3.9 (03.12.2021)**

* Ajout d’un délai d’expiration à la détection pour éviter les faux positifs sur les connexions lentes

**3.8 (10.06.2021)**

* Suppression du code lié aux popunders (la méthode inline est privilégiée) et du cookie superflu

**3.7 (05.07.2019)**

* Quelques mesures contre le filtre « anti-cv »

**3.6 (16.05.2019)**

* Suppression de la référence à l’objet JS, parfois bloquée
* Nouvelle API de détection d’adresse IP dans diag (prise en charge d’IPv6)

**3.5 (14.03.2019)**

* Ajout d’une fonctionnalité permettant de supprimer les publicités partiellement bloquées
* Ajout du paramètre no\_cookie pour permettre d’héberger backend\_loader.php sur un domaine différent
* Ajout de la prise en charge du cache acpu

**3.4 (09.07.2018)**

* Amélioration de la détection (attente du chargement de la page)

**3.3 (25.05.2018)**

* Mise à jour du lien vers la documentation sur la transmission des adresses IP
* Correction d’une erreur provoquée par certains bloqueurs (uBlock) lors du remplacement de window\.ExoLoader
* Remplacement de l’ancien service de détection d’adresse IP

**3.2 (15.03.2018)**

* Correction d’une erreur avec PHP <= 5.3

**3.1 (07.03.2018)**

* Randomisation automatique des noms de paramètres des bannières et des liens, et ajout d’un contrôle plus flexible
* Correction d’une erreur JavaScript si serve() est appelée plusieurs fois

**3.0 (30.01.2018)**

* Introduction du concept de moteurs de rendu demandés
* Ajout de nouveaux formats publicitaires : publicité native, bannière fixe, message instantané pour le Web et les appareils mobiles
* Nommage dynamique de l’objet ExoLoader au cas où les bloqueurs de publicité le rendraient immuable
* Petites modifications pour faciliter l’installation via Phar et le plug-in WordPress
* Vérification automatique de la version de PHP pour multi curl

**2.25 (12.10.2017)**

* Correction de la vérification du changement de texte du corps de la réponse dans la requête de diagnostic des publicités
* Journalisation des erreurs renvoyées par le serveur publicitaire
* Correction des diagnostics de détection d’adresse IP (utilisation de la configuration de backend\_loader.php)

**2.24 (15.08.2017)**

* Vérification de la détection d’adresse IP dans le script de diagnostic
* Possibilité d’héberger backend\_loader.php sur un domaine différent

**2.22 (13.06.2017)**

* Détection : empêcher le style box-sizing du site d’influencer les paramètres du piège DOM

**2.21 (09.06.2017)**

* Résolution du problème de faux positifs lors de la détection des bloqueurs de publicité

**2.20 (01.06.2017)**

* Modification de la détection des bloqueurs
* Correction du problème où plusieurs appels à serve() écrasaient le cookie des uns des autres

**2.19 (24.05.2017)**

* Résolution du problème avec les campagnes d’échange et les bannières 404
* Petites corrections pour PHP 5.2

**2.18 (07.04.2017)**

* Envoi de l’en-tête correct pour JavaScript en cas de validation stricte des en-têtes

**2.17 (27.03.2017)**

* Correction de l’erreur d’interface avec les anciennes versions de PHP dans backend\_loader.php
* Correction du problème de lien ouvert dans frontend\_loader.php lorsque LINK\_URL\_PREFIX est spécifié

**2.16 (14.03.2017)**

* Possibilité d’ajouter des zones dynamiquement, pas uniquement au chargement de la page
* Ajout d’une référence au conteneur comme paramètre de addZone

**2.15 (08.03.2017)**

* Ajout du cache de fichiers.
* Réduction du volume de données transférées.
* Chargement des bannières via `<img>`, plutôt qu’avec un style d’arrière-plan en base64.

**2.14 (30.09.2016)**

* Correction de resolveMulti pour qu’elle renvoie toujours un tableau

**2.13 (14.09.2016)**

* Transmission correcte des paramètres POST pour openLink

**2.12 (12.09.2016)**

* Déplacement complet des styles intégrés vers des classes CSS

**2.11 (09.09.2016)**

* Correction du problème document.contains undefined dans IE

**2.10 (07.09.2016)**

* Correction des problèmes de connectivité IPv6 et de curl
* Correction des problèmes de liens de clic incorrects dus aux alias côté serveur

**2.9 (02.09.2016)**

* Modification du mécanisme d’ouverture des liens pour passer par le chargeur principal

**2.8 (30.08.2016)**

* Résolution du problème des publicités HTTPS en effectuant la résolution DNS et la mise en cache hors de curl

**2.7 (22.08.2016)**

* Passage des points de terminaison publicitaires à HTTPS pour éviter les problèmes de contenu mixte

**2.6 (17.08.2016)**

* Espace réservé DOM plus générique pour les bannières
* Correction d’un problème avec les en-têtes
* Séparation des erreurs et des messages de débogage dans le chargeur frontal
* Instructions de dépannage

**2.5 (02.08.2016)**

* Ajout de journaux pour les requêtes ayant expiré et les autres erreurs
* Correction d’une erreur JavaScript lorsqu’un élément remplace l’espace réservé DOM de la publicité

**2.4 (22.07.2016)**

* Délais d’attente améliorés
* Fichier de diagnostic et débogage amélioré

**2.3 (20.07.2016)**

* Correction d’un problème mineur lors de l’envoi d’une requête au chargeur du backend, lorsqu’aucune zone n’avait été ajoutée

**2.2 (15.07.2016)**

* Nouveau domaine pour ads-endpoint, avec un meilleur équilibrage de charge

**2.1 (27.06.2016)**

* Correction d’une incompatibilité avec le framework Prototype

**2.0 (14.06.2016)**

* Version publique
* Une seule requête pour plusieurs annonces
* Chargeur unifié pour les bannières

### Journal des modifications de NeverBlock Proxy

**1.0.1**

* Possibilité de transmettre la langue et le référent dans la requête
* Exemples mis à jour

**1.0.0**

* Version initiale


---

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