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

# Neverblock

## Panoramica

### Anti-Adblock

NeverBlock è una soluzione collaudata per aggirare i blocchi pubblicitari, che massimizza immediatamente i tuoi ricavi.

La nostra tecnologia esclusiva garantisce che i tuoi annunci vengano comunque visualizzati, anche se l’utente ha installato e attivato un software di blocco degli annunci.

La tecnologia avanzata di NeverBlock aggira i blocchi pubblicitari per recuperare tutti i tuoi ricavi pubblicitari e funziona su tutti i browser (inclusi Safari, Chrome, Internet Explorer, Mozilla, ecc.) e su tutte le piattaforme e i dispositivi (computer desktop, smartphone e tablet).

Questa soluzione è gratuita per tutti i clienti ExoClick e si attiva semplicemente inserendo una riga di codice nel tuo sito web.

In questa documentazione illustreremo quattro diverse implementazioni di NeverBlock:

* **NeverBlock PHP** - La soluzione standard, più semplice da implementare e più utilizzata. È quella trattata più approfonditamente in questa documentazione.
* **NeverBlock API** - Quando è necessario usare un linguaggio non supportato, l’API fornisce gli endpoint necessari per ottenere direttamente gli annunci. Da usare quando sono necessarie soluzioni manuali.
* **NeverBlock Proxy** - Un’applicazione multipiattaforma progettata per gestire le richieste API e memorizzare nella cache gli annunci. Questo servizio viene eseguito in background per fornire all’utente un endpoint più diretto da cui recuperare gli annunci.
* **Plugin WordPress** - Un plugin WordPress sviluppato per integrare facilmente le zone pubblicitarie di NeverBlock nel tuo sito WordPress.

## NeverBlock PHP - Installazione automatica

### Scopo

NeverBlock Phar Installer è uno strumento che facilita l’installazione della soluzione NeverBlock PHP (versione 3.0). Può essere usato in alternativa ai passaggi descritti nella [Installazione manuale](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#neverblock-php-manual-installation). Installerà i file nella directory specificata oppure, per impostazione predefinita, in una directory **nb** . L’installer si occuperà di alcune impostazioni di configurazione relative alla [rinomina dei file](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#renaming-the-files-mandatory) e alle [chiavi di identificazione](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#identification-keys).

### Scaricare l’installer

È possibile scaricare la versione più recente dal seguente link:

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

### Eseguire l’installer

Dopo aver scaricato il file phar, inseriscilo nella directory in cui desideri conservare i file di NeverBlock. Quando esegui l’installer, puoi specificare il percorso in cui installare i file oppure lasciare quello predefinito. È disponibile anche un parametro facoltativo per specificare il file di log; il suo scopo è descritto nella sezione [File di log](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#logfile) .

```bash
# Crea e installa i file nella directory predefinita 'nb' 
./neverBlockInstaller.phar
```

Parametri facoltativi:

```bash
# Crea e installa i file nella directory specificata
./neverBlockInstaller.phar --path=specific/path 

# Installa i file nella directory corrente
./neverBlockInstaller.phar --path=.

# Percorso del file di log
./neverBlockInstaller.phar --logfile=path/logfile

# Percorso di writable_path (se APC/APCu non è installato)
./neverBlockInstaller.phar --writable_path=path/writable_path
```

### Analizzare la risposta

Una volta eseguito, verrà mostrata una risposta simile a quella riportata di seguito. Possiamo analizzarla in due sezioni distinte: i risultati diagnostici e gli script necessari.

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

**Risultati della diagnostica**

Dopo aver eseguito il file phar, verranno mostrati i risultati di alcuni test della configurazione. Tieni presente che il **rilevamento dell’IP** richiederà il **diag.php** da eseguire manualmente. Per ulteriori dettagli su questi risultati e sull'esecuzione manuale, consulta le sezioni Esecuzione di diag.php e Possibili risultati di diag.php.

**Script richiesti**

Sotto i risultati della diagnosi sono visualizzati due script, i cui nomi sono stati generati automaticamente. Questi script mostrano i nomi dei nostri **frontend\_loader.js** e **backend\_loader.php**, che saranno i percorsi da utilizzare quando [vengono visualizzati gli annunci](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#adding-zones-to-a-page).

## NeverBlock PHP - Installazione manuale

### Scaricare i file

L'installazione e la maggior parte della configurazione possono essere gestite tramite [il programma di installazione phar](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#neverblock-php-automatic-installation). L'installazione manuale può essere eseguita come segue.

La versione più recente (v3.14) può essere scaricata usando questi link:

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

Oppure usando i seguenti comandi:

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

I file necessari da questa cartella sono:

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

### Rinominare i file (obbligatorio)

Per evitare che i file vengano bloccati immediatamente dagli ad blocker, è necessario rinominarli.

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

Uno dei test in **diag.php** verifica l'esistenza di **backend\_loader.php**, quindi i riferimenti in questo test devono essere aggiornati in modo che corrispondano al nuovo nome del file. L'esempio seguente usa la stessa configurazione mostrata nell'immagine precedente. Aggiorna la seguente riga all'inizio della pagina:

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

### Caricare i file sul server

I file menzionati sopra devono essere collocati sul server in cui desideri mostrare gli annunci.

Copia i file in una directory a tua scelta:

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

### Eseguire diag.php

Ora che i file di NeverBlock si trovano sul server, useremo il file **diag.php** per verificare che fin qui sia tutto a posto. Per farlo, visita l'URL in cui si trova il file diag.php. Usando come esempio lo screenshot precedente, il nostro URL sarebbe il seguente: `https://www.my-example-site.com/nb/diag.php`

Se fin qui è tutto corretto, dovresti vedere quanto segue (configureremo il file di log nella sezione [File di log](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#logfile)):

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

Se visualizzi risultati diversi, potrebbe essere necessaria un'ulteriore configurazione.

### Possibili risultati di diag.php

**Versione di PHP:** Se la versione di PHP non è supportata, riceverai una notifica. La soluzione NeverBlock standard richiede PHP 5.2 o versioni successive.

**Presenza dello script di caricamento del backend:** Se questo controllo non va a buon fine, il file **backend\_loader.php** non può essere trovato da **diag.php**. Ciò potrebbe essere dovuto a una modifica del nome del file o a un problema con il percorso.

**Segnalazione degli errori:** Questo potrebbe essere segnalato come avviso. L'avviso non impedirà il funzionamento della soluzione NeverBlock.

**Presenza della cache** e **libreria cURL:** Se la cache e cURL non sono presenti, riceverai degli avvisi. Questo non impedirà il funzionamento di NeverBlock, ma ne consigliamo la configurazione.

* L'estensione [cURL](https://www.php.net/manual/en/book.curl.php) di PHP *(fortemente consigliata)*
* L'estensione [APCu](https://www.php.net/manual/en/book.apcu.php) di PHP o una cache su file (vedi [Caching](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#caching))

**Rilevamento dell'IP:** Se si verifica un errore relativo alla corrispondenza dell'IP, consulta [Passaggio degli IP](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

**Richieste di annunci:** Se le richieste richiedono più tempo del previsto, potrebbe essere suggerito di aumentare i valori delle impostazioni **REQUEST\_TIMEOUT\_MS** e **CONNECT\_TIMEOUT\_MS** . La procedura è descritta in [Configurazione delle costanti](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#configuring-constants).

## NeverBlock PHP - Configurazione

### Passaggio degli IP (con Cloudflare ecc.)

Se utilizzi un servizio, come CloudFlare, che si trova tra l'utente e i tuoi server, l'IP rilevato in **backend\_loader.php** potrebbe risultare non valido. Ciò potrebbe causare la registrazione errata dei clic o delle impressioni degli annunci. Per risolvere il problema, puoi sostituire il valore `$_SERVER["REMOTE_ADDR"]` passato alla classe *UserEnvironment* in **backend\_loader.php** con il valore corretto trasmesso dal servizio di caching o proxy.

Nel caso di Cloudflare, passeremmo il parametro `$_SERVER["HTTP_CF_CONNECTING_IP"]` . Di seguito è riportato un esempio.

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

Una volta effettuata questa modifica, il nostro *UserEnvironment* avrà il seguente aspetto:

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

Quando si utilizza un altro servizio, come Apache o NGINX, possiamo usare `isset($_SERVER['HTTP_X_REAL_IP']) ? $_SERVER['HTTP_X_REAL_IP'] : $_SERVER['REMOTE_ADDR']` come mostrato di seguito:

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

Ora possiamo eseguire di nuovo **diag.php**, se questo causava il fallimento del test di *rilevamento dell'IP* , ora dovremmo ottenere risultati positivi.

### File di log

Questa era una configurazione facoltativa durante [l'installazione automatica](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#neverblock-php-automatic-installation). Se desideri registrare i timeout delle richieste e altri errori, puoi creare un file di log scrivibile. In questo esempio, il file di log è stato collocato nella stessa directory degli altri file di NeverBlock.

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

Dopo aver creato questo file (assicurati che sia scrivibile), aggiorneremo **backend\_loader.php** per impostarne il percorso. All'inizio del file, `LOGFILE` sarà impostato su **NULL** e dovrà essere aggiornato per impostare il percorso del nuovo file di log, come segue:

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

Fatto questo, possiamo eseguire di nuovo **diag.php**. Se il file è stato creato e il percorso impostato correttamente, ora vedremo quanto segue.

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

### Memorizzazione nella cache

Questa era una configurazione facoltativa durante [l'installazione automatica](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#neverblock-php-automatic-installation). La memorizzazione nella cache può migliorare notevolmente i tempi di risposta degli annunci. Se non disponi di APC o APCu, supportati da **backend\_loader.php** per impostazione predefinita, è consigliabile configurare una cache su file. A tal fine, devi configurare una directory scrivibile da PHP e impostarne il percorso come valore della **WRITABLE\_PATH** costante in **backend\_loader.php**. Se questa costante è impostata, la cache su file verrà usata per impostazione predefinita al posto di qualsiasi altra cache (anche se disponi di APC o APCu).

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

### Chiavi di identificazione

Se hai usato [l'installazione automatica](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#neverblock-php-automatic-installation) questo passaggio è già stato eseguito durante l'installazione. Queste chiavi vengono usate per la crittografia, così da impedire la manomissione degli URL dei banner. Si consiglia vivamente di modificare i valori di *KEY\_1* e *KEY\_2* in **backend\_loader.php** sostituendoli con stringhe univoche.

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

### Cookie

I cookie servono a verificare che NeverBlock funzioni come previsto.

* **yuo1** - il nome predefinito di questo cookie è **yuo1**e questo nome può essere configurato in **frontend\_loader.js**. Questo cookie può anche essere disabilitato impostando [no\_cookie: true](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#how-do-i-configure-neverblock-from-a-different-domain).
* **zone-closed-** - Questo cookie fa sì che la zona rimanga chiusa se l’utente l’ha chiusa con adBlock attivo e poi ha disattivato adBlock.

### Configurazione delle costanti

In **backend\_loader.php**sono definite alcune costanti. Si consiglia di lasciarle invariate, ma in alcuni casi può essere utile modificare alcune configurazioni.

* **CONNECT\_TIMEOUT\_MS** - timeout di connessione in millisecondi utilizzato per le richieste curl/fsock.
* **REQUEST\_TIMEOUT\_MS** - timeout complessivo della richiesta in millisecondi (include anche il tempo di CONNECT\_TIMEOUT\_MS) utilizzato per le richieste curl/fsock.
* **LOGFILE** - percorso di un file scrivibile in cui registrare i messaggi, ad esempio alcuni errori e i casi in cui le richieste scadono.
* **ALLOW\_MULTI\_CURL** - quando possibile, lo script prova a usare curl\_multi\_exec. Se questo comporta un carico eccessivo sulla CPU, è possibile disattivarlo.

Impostazioni della cache APC/APCu e dei file:

* **WRITABLE\_PATH** - percorso della directory scrivibile che conterrà i file della cache (se impostato, la cache su file diventerà quella predefinita).
* **CACHE\_INTERVAL\_BANNERS** - durata della cache delle immagini dei banner (in secondi); se impostata su 0, le immagini NON verranno memorizzate nella cache.
* **CACHE\_INTERVAL\_SCRIPTS** - durata della cache dei file JavaScript; se impostata su 0, non verranno memorizzati nella cache.
* **CACHE\_KEYS\_LIMIT\_BANNERS** - limite al numero di immagini dei banner da conservare nella cache (per evitare di consumare troppe risorse dell’editore); se impostato su 0, non ci sarà alcun limite e tutte le immagini verranno memorizzate nella cache.

Se si configurano regole di riscrittura Apache/Nginx per accedere a **backend\_loader.php** tramite altri URI:

* **LINK\_URL\_PREFIX** - se impostato, diventerà il nuovo URI dei link di clic sul frontend (a cui verrà aggiunto l’hash dell’URL di reindirizzamento)
* **BANNER\_URL\_PREFIX** - se impostato, diventerà il nuovo URI delle immagini dei banner sul frontend (a cui verrà aggiunto l’hash del banner specifico)
* **KEY\_1** - chiave segreta per impedire la manomissione degli URL dei banner (ora vengono reinviati al loader del backend nella richiesta)
* **KEY\_2** - chiave segreta per impedire la manomissione degli URL dei banner (ora vengono reinviati al loader del backend nella richiesta)

## NeverBlock PHP - Visualizzazione degli annunci

### Aggiunta di zone a una pagina

Questi frammenti sono per NeverBlock 3.14 e versioni successive. Nelle versioni precedenti, usare getexoloader invece di getmsgloader.

{% hint style="info" %}
Se si utilizza un’applicazione a pagina singola, [il caricamento dinamico](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#dynamic-loading-single-page-applications) sarà obbligatorio da implementare.
{% endhint %}

Sono supportati i seguenti formati pubblicitari:

* Banner
* Annunci nativi
* Banner fissi
* Messaggi istantanei

{% hint style="info" %}
Gli annunci multiformato non sono ancora supportati. È comunque possibile usare NeverBlock con i singoli banner configurati per l’uso negli annunci multiformato. In questo modo, è possibile utilizzare gli annunci multiformato per gli utenti standard e i banner compatibili con NeverBlock per raggiungere gli utenti con ad blocker.
{% endhint %}

Tieni presente che questo script mostrerà annunci solo quando un utente ha installato e attivato un Ad Blocker. Non rimuovere i tag pubblicitari standard già presenti.

In questo esempio useremo la configurazione descritta in [Rinominare i file](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#renaming-the-files-mandatory). Assicurati che il percorso e i nomi dei file corrispondano alla tua configurazione.

**Passaggio 1 - Inserire frontend\_loader.js nella pagina**

All'interno del tag `<body>` della pagina, all'inizio, aggiungi quanto segue:

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

Questo codice va incluso nella pagina una sola volta. Deve inoltre precedere tutti gli altri script delle zone.

**Passaggio 2 - Aggiungere una zona NeverBlock**

I seguenti frammenti di codice servono a dichiarare le zone pubblicitarie. Vanno inseriti nel DOM nel punto in cui si desidera visualizzare la zona. È possibile aggiungere più blocchi banner di questo tipo nella pagina. **Fai attenzione a non inserirli in div con classi o stili specifici pertinenti alla visualizzazione degli annunci**, perché questi div verranno presi di mira dagli ad blocker (ad es. `class="ad-footer"`, `style="width:300px;height:250px;"`).

Per aggiungere una zona pubblicitaria, procedi come segue (assicurati di sostituire il valore di idzone con l'ID della tua zona):

```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;
        
        //Il codice per aggiungere le zone può essere inserito più volte nella pagina
        ExoLoader.addZone({"idzone":"111"});
        
        //Per usare un sub id, aggiungi all'oggetto un parametro sub numerico, passato a addZone
        //ExoLoader.addZone({"idzone":"111", "sub": "1"});
    })();
</script>
```

**Passaggio 3 - Pubblicare gli annunci (backend\_loader.php)**

Dopo aver incluso tutte le dichiarazioni *addZone()* vogliamo pubblicare gli annunci. Per farlo useremo la funzione *serve* che fornisce i dati per tutte le zone pubblicitarie dichiarate in precedenza e **in genere va chiamata una sola volta nella pagina**. Il **numero massimo di zone richiamabili in una pagina è 20**. Fanno eccezione i casi di caricamento dinamico di una pagina, descritti in [Caricamento dinamico](https://docs.exoclick.com/publishers/it/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>
```

### Caricamento dinamico (applicazioni a pagina singola)

È possibile passare un riferimento al contenitore, ossia all'elemento DOM a cui verrà aggiunto il banner. In questo modo, quando viene chiamata serve, il sistema saprà dove posizionare la zona pubblicitaria. Ecco come fare:

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

È anche possibile chiamare *serve()* con il flag force per pubblicare gli annunci nel momento desiderato (ad es. in una funzione dopo aver renderizzato una parte della pagina), invece che al caricamento della pagina:

```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 funzione *serve()* può essere chiamata più volte. Dopo ogni *serve()* la chiamata a ExoLoader verrà svuotata dei precedenti *addZone()* richiami. Quindi, solo i banner per cui chiami *addZone()* dopo un serve verranno mostrati nel successivo *serve()*.

### Dominio di base

Se sei già cliente ExoClick, potresti avere zone pubblicitarie regolari sul tuo sito. Se utilizzi un dominio diverso da \*.exoclick.com (ad es. **ads.exosrv.com**), dovresti impostare *domain\_base* dell'oggetto detector (`ExoLoader.getDetector()`) su “exosrv.com” prima della prima chiamata a addZone. Ecco come fare:

```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>
...
<!-- Prima chiamata a 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>
```

### Gli annunci non vengono visualizzati

Se non vengono visualizzati annunci, controlla innanzitutto il file diag.php per verificare che non ci siano configurazioni errate. Se tutti i test hanno esito positivo, crea una pagina di prova con una sola zona per assicurarti che funzioni in modo isolato. Se a questo punto gli annunci non vengono ancora visualizzati, consulta la sezione [Assistenza](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#neverblock-php-help) per ulteriori dettagli.

## NeverBlock PHP - Assistenza

### I miei annunci non vengono visualizzati. Cosa devo fare?

**Verifica di utilizzare la versione più recente del codice della soluzione anti-adblock.**

Lavoriamo costantemente per migliorare la soluzione sulla base dei nostri test, dei commenti dei clienti e dei cambiamenti degli ad blocker. Le versioni meno recenti potrebbero presentare problemi che abbiamo già risolto. Prima di verificare gli altri punti riportati di seguito, assicurati quindi di utilizzare la versione più aggiornata.

**Hai eseguito diag.php?**

Potrebbe aiutarti a individuare eventuali problemi nella configurazione del loader sul backend.

**Controlla la scheda “Rete” nella barra degli “Strumenti per sviluppatori” di Chrome/FF.**

Il tuo **frontend\_loader.js** viene caricato correttamente?

**Potrebbe essere necessario specificare un percorso diverso.**

* Prova a inserire in src il percorso completo anziché “/frontend\_loader.js”
* Verifica che *ExoLoader.addZone()* venga chiamato **prima di** *ExoLoader.serve()*
* Controlla la scheda “Console” nella barra degli “Strumenti per sviluppatori” di Chrome/FF. Potrebbero esserci errori relativi a **frontend\_loader.js**
* Esegui `ExoLoader.getDebug();` nella console JavaScript per vedere cosa succede. L'output è simile al seguente:

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

**Controlla gli ID delle zone.**

Assicurati che la zona con l'idzone specificato esista e sia di tua proprietà.

**Stai inserendo codici pubblicitari negli iframe?**

Il contenuto degli iframe viene caricato dopo la pagina principale. Se chiami *addZone()* in un iframe e chiama *serve()* nella pagina principale, il *serve()* verrà eseguito prima di *addZone()*, e non funzionerà. Esistono due modi per usare gli iframe:

1. Inserisci tutto in un iframe: tutti i codici dei passaggi 1, 2 e 3 di [Aggiungere zone a una pagina](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#adding-zones-to-a-page) devono trovarsi al suo interno. Tuttavia, se in una pagina sono presenti diversi iframe di questo tipo, potrebbe verificarsi un conflitto, poiché questa soluzione usa un cookie. Se il nome del cookie è lo stesso, gli annunci negli iframe potrebbero mescolarsi. Puoi rinominare un cookie prima di chiamare serve, in questo modo:

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

Lo svantaggio è che dovrai disporre di diversi backend loader, nei quali imposterai anche nomi di cookie diversi:

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

2. Inserisci nella pagina principale del sito il codice del passaggio 1 (l'inclusione del file frontend loader). Negli iframe, chiama addZone. Per recuperare correttamente l'oggetto ExoLoader, dovrai aggiornare la chiamata standard e usare **window\.top**.document.dispatchEvent; inoltre, passa a addZone il parametro **doc** che punterà alla proprietà document del tuo 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});
})();
```

Chiama serve() anche all'interno dell'ultimo 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"});
})();
```

**Usi un framework JavaScript per il frontend del tuo sito?**

Verifica di non sovrascrivere innerHTML degli elementi in cui hai inserito le chiamate a *addZone()* La *addZone()* chiamata inserisce un segnaposto DOM nel punto in cui viene effettuata. Se qualcosa lo sovrascrive, lo script non potrà riempirlo con i dati degli annunci.

**backend\_loader.php restituisce una risposta vuota?**

In tal caso, controlla il log degli errori di PHP per verificare la presenza di eventuali errori correlati. Dopo aver aperto una pagina contenente il codice ExoLoader, apri: `http://yoursite/backend_loader.php?exoDebug=exoDebug`. Se vengono rilevati errori di timeout *curl/fsock* , potrebbe essere necessario aumentare i valori di **CONNECT\_TIMEOUT\_MS** e **REQUEST\_TIMEOUT\_MS** in **backend\_loader.php**.

### Gli annunci vengono visualizzati, ma le statistiche non mostrano clic o impressioni

**Usi CloudFlare o i tuoi server web sono dietro un proxy?**

Le richieste NeverBlock per gli annunci non raggiungono direttamente il nostro server dal browser dell'utente finale; pertanto, ci affidiamo a **backend\_loader.php** lato publisher per trasmetterci l'IP dell'utente. Lo ricaviamo da `$_SERVER['REMOTE_ADDR']` in questo script, tramite la variabile globale di PHP. Se l'infrastruttura del publisher è configurata in modo tale da non fornire un valore corretto per l'IP dell'utente, potrebbero verificarsi problemi di impressioni o clic non validi. Per risolvere il problema, consulta [Trasmissione degli IP](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#passing-ips-using-cloudflare-etc).

### In modalità privata di Firefox (o di un altro browser) vengono visualizzati sia gli annunci NB sia quelli normali

**Verifica che l'impostazione domain\_base sia configurata correttamente.**

[Qui](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#domain-base) puoi trovare un esempio di configurazione del dominio di base. Il problema è che alcuni browser, soprattutto FF, in modalità privata bloccano le richieste verso alcuni domini. Exoclick.com, ad esempio, è stato inserito nella blacklist. Quindi, se il codice della zona normale contiene il dominio “exoclick.com”, la modalità privata agisce come un ad blocker e la soluzione NB dovrebbe effettivamente mostrare gli annunci. Tuttavia, la modalità privata potrebbe non bloccare gli altri nostri domini. Per evitare la visualizzazione di annunci doppi e consentire al rilevatore NB di verificare correttamente se gli annunci normali vengono bloccati in quel momento, deve sapere da quale dominio vengono richiesti.

### Come si configura NeverBlock da un dominio diverso?

1. In *frontend\_loader.js*, vai alla funzione `serve: function(params)` e decommenta il set di parametri.
2. Aggiungi un altro dominio e imposta `force: true` e `no_cookie: true`:

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

3. Quindi, nella pagina, fai riferimento al percorso NeverBlock usando il nuovo dominio.

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

### E se il rilevamento di Ad Block genera un falso positivo?

A volte, gli utenti che hanno AdBlock disattivato vedono comunque gli annunci NB insieme agli annunci normali. Questo può accadere perché NB prova a includere nella pagina uno script reale per la pubblicazione degli annunci usato come honeypot, per verificare se viene bloccato. A volte, con connessioni lente, il caricamento dello script richiede troppo tempo e NB può ritenere che sia stato bloccato, decidendo quindi di richiedere gli annunci. A causa del funzionamento di alcuni ad blocker, non è possibile sapere se il caricamento è ancora in corso o se non verrà mai completato perché è stato bloccato. Per la maggior parte dei siti e degli utenti non è un problema. Se il problema riguarda una parte significativa dei tuoi utenti, ti consigliamo di impostare un timeout più lungo per il rilevamento NB usando la funzione **setTimeout** dell’oggetto **ExoLoader**, in questo modo:

```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 usa un endpoint semplice per inoltrare le richieste ai server di syndication di ExoClick.

L’endpoint è documentato qui sotto e puoi usarlo liberamente per creare un’integrazione personalizzata nel linguaggio che preferisci.

### API v1

Questa versione dell’API supporta tutti i formati attualmente disponibili per la soluzione NeverBlock (banner, banner sticky, annunci nativi, messaggi istantanei).

**Richiesta per una singola zona**

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

**Richiesta per più zone**

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

Le richieste mostrate sopra sono simili, ma quelle per più zone devono essere strutturate usando una notazione con array incrementale (*ad esempio zones\[0]\[idzone], zones\[1]\[idzone],…*), come illustrato.

{% hint style="info" %}
Le richieste per più zone sono limitate a un massimo di **20** zone per richiesta.
{% endhint %}

**Parametri**

Per **tutte** le richieste, è necessario impostare i seguenti parametri:

* **zones\[N]\[idzone]** - *ID della zona da richiedere*
* **user\_ip** - *Indirizzo IP dell’utente finale (usato per il targeting)*

**Intestazioni**

Le seguenti intestazioni devono essere impostate per **tutte** le richieste:

* **X-Forwarded-For** - *Indirizzo IP di origine del client*
* **Referer** - *Indirizzo del sito web di provenienza*
* **User-Agent** - *Identificativo del client*
* **Accept-Language** - *Lingua e impostazioni locali del client*

**Risposta**

I payload JSON restituiti dagli esempi precedenti sono i seguenti.

Risposta con una singola zona:

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

Risposta con più zone:

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

**Dati della risposta**

I seguenti valori possono essere estratti dall'oggetto **zones** per ogni zona nel payload JSON restituito, allo scopo di pubblicare gli annunci:

* **idzone**: identificativo della zona (utile per distinguere le richieste relative alle zone durante l'elaborazione)
* **type**: tipo di annuncio; in **renderers** è possibile ottenere lo script renderer predefinito corrispondente. (Lo script renderer predefinito richiede che l'oggetto ExoLoader sia presente nel suo ambito.)
* **data**: dati dell'annuncio specifici per il tipo di annuncio indicato. Nella maggior parte dei casi, per i formati banner e simili si trovano **image** e **url** , mentre alcuni tipi includono parametri aggiuntivi.

Se usi l'API, spetta a te scrivere il codice che genera il DOM da visualizzare nel front-end, basandoti sui dati forniti. I nostri renderer predefiniti sono gli script che svolgono questo compito nell'ambito della soluzione NeverBlock predefinita (installazione PHP + JavaScript). Possono essere usati solo con l'oggetto JavaScript ExoLoader, che archivia internamente le risposte post-elaborate nel proprio formato e dispone di diverse funzioni helper utilizzate dai renderer e che si aspettano siano definite.

### API v0

Questa versione dell'API supporta solo i banner. Restituirà *false* per tutte le zone di tipo diverso.

**Richiesta per una singola zona**

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

**Richiesta per più zone**

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

Le richieste mostrate sopra sono simili, ma quelle per più zone devono essere strutturate usando una notazione con array incrementale (*ad esempio zones\[0]\[idzone], zones\[1]\[idzone],…*), come illustrato.

{% hint style="info" %}
Le richieste per più zone sono limitate a un massimo di **20** zone per richiesta.
{% endhint %}

**Parametri**

Per **tutte** le richieste, è necessario impostare i seguenti parametri:

* **zones\[N]\[idzone]** - *ID della zona da richiedere*
* **user\_ip** - *Indirizzo IP dell’utente finale (usato per il targeting)*

**Intestazioni**

Le seguenti intestazioni devono essere impostate per **tutte** le richieste:

* **X-Forwarded-For** - *Indirizzo IP di origine del client*
* **Referer** - *Indirizzo del sito web di provenienza*
* **User-Agent** - *Identificativo del client*
* **Accept-Language** - *Lingua e impostazioni locali del client*

**Risposta**

I payload JSON restituiti dagli esempi precedenti sono i seguenti.

Risposta con una singola zona:

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

Risposta con più zone:

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

**Dati della risposta**

I seguenti valori possono essere estratti dal payload JSON restituito, allo scopo di pubblicare gli annunci:

* **url**: URL di clic da usare per racchiudere l'immagine del banner
* **imgurl**: URL della sorgente dell'immagine del banner
* **idzone**: identificativo della zona (utile per distinguere le richieste relative alle zone durante l'elaborazione)

## NeverBlock Proxy

### Che cos'è?

NeverBlock Proxy è un'applicazione multipiattaforma progettata per gestire le richieste API e memorizzare nella cache gli annunci. Questo servizio viene eseguito in background e fornisce all'utente un endpoint più diretto per recuperare gli annunci. Si sconsiglia di scegliere NeverBlock Proxy al posto della soluzione standard NeverBlock PHP, poiché è meno completa.

A volte i blocchi degli annunci prendono di mira aggressivamente i siti, impedendo il funzionamento di NeverBlock PHP. Se succede sul tuo sito, prendi in considerazione NeverBlock Proxy.

### Scarica NeverBlock Proxy

Scarica un archivio precompilato per la tua piattaforma:

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

I file necessari per eseguire gli annunci NeverBlock sono:

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

### Configurazione del proxy

**Caricare i file sul server**

Dopo aver scaricato i file, puoi caricarli in una directory sul server, come mostrato nello screenshot qui sotto:

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

**Creare la cache**

Crea una directory scrivibile in cui archiviare i file scaricati. Puoi crearla nella stessa cartella, poiché imposteremo il percorso più avanti.

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

**Aggiornare la configurazione obbligatoria**

All'inizio di **neverblock-conf.toml** è presente una sezione contrassegnata come *Obbligatorio*. In questa sezione imposteremo i percorsi in base alla configurazione mostrata negli screenshot precedenti. Tieni presente che saranno specifici della tua configurazione.

```toml
#####################
#     Obbligatorio     #
#####################

## Percorso della cache (ATTENZIONE: tutti i file qui contenuti verranno eliminati a intervalli regolari!)
cache_path = "nb-cache/"

## Percorso relativo alla cache dalla directory principale del server web (ad es. "images/cache/"; se non impostato, verrà usato cache_path)
www_cache_path = "nb-proxy/nb-cache/"

## Percorso e nome del file HTML di reindirizzamento (relativo alla directory principale del server web, ad es. "misc/redirect.html")
www_redirect_path = "nb-proxy/redirect.html"
```

**Avviare il servizio**

Avvia il binario da un prompt dei comandi o da un terminale: questa operazione va eseguita dalla directory in cui si trova. In questo modo avvierai il servizio e potrai effettuare richieste curl a localhost sulla porta 8080.

### Utilizzo

Per ottenere le zone si usa una richiesta cURL. Questa richiesta può essere implementata nel linguaggio che preferisci. La richiesta cURL restituirà un payload JSON contenente un URL di clic e il percorso di un'immagine pertinente. L'immagine è stata inoltre scaricata nel percorso specificato. Quando passi **user\_ip** tieni conto delle indicazioni fornite in [Passaggio degli IP](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#passing-ips-using-cloudflare-etc). La struttura della richiesta è la seguente:

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

Con questa struttura, ecco un esempio di utilizzo in 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);
```

### Configurazione facoltativa

Sono disponibili diverse configurazioni facoltative in **neverblock-conf.toml**:

* **debug** - Abilita la modalità di debug
* **port** - Porta di ascolto del servizio
* **log** - Log dell'applicazione
* **http\_timeout** - Timeout delle richieste HTTP (secondi)
* **cache\_ttl** - Durata (minuti) dei file nella cache
* **cache\_purge\_frequency** - Intervallo tra le operazioni di svuotamento della cache (minuti)
* **syndication** - URL di syndication di Exoclick. Consulta [Dominio base](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#domain-base) per informazioni sui casi in cui modificarlo

### Flag

I flag permettono di sovrascrivere il file di configurazione:

```bash
heisenberg:neverblock-proxy craig$ ./neverblock-proxy -h
Neverblock-Proxy - il sistema di gestione del traffico AdBlock

Uso:
  neverblock-proxy [flags]

Flag:
  -c, --cache-path string    Percorso della cache delle immagini
  -C, --config-file string   File di configurazione
  -l, --log string           File di log
  -p, --port string          Porta del servizio
```

## Plugin WordPress

### Installazione del plugin

Il plugin può essere scaricato dal seguente link:

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

L'installazione del plugin NeverBlock per WordPress non è diversa da quella di qualsiasi altro plugin. Nel menu seleziona **Plugin** -> **Carica plugin** -> seleziona il plugin NeverBlock da installare.

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

**Passaggio 1 - Introduzione**

La prima pagina della procedura guidata di installazione non richiede alcun input.

**Passaggio 2 - Requisiti di sistema**

In questo passaggio vedremo i risultati dei test sulla configurazione. I risultati visualizzati possono variare a seconda della configurazione.

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

Per maggiori dettagli su ciascuno di questi test, sui risultati e sull'esecuzione manuale, consulta le sezioni: Esecuzione di diag.php e Possibili risultati di diag.php.

**Passaggio 3 - Impostazioni del plugin**

Nella sezione di configurazione di NeverBlock PHP è presente una sezione dedicata alla [Configurazione delle costanti](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#configuring-constants). Il passaggio 3 della procedura guidata di installazione consente di configurare queste impostazioni. I dettagli su ciascuna di esse sono trattati nella sezione pertinente e sono descritti anche nella schermata seguente.

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

Queste configurazioni possono essere modificate in qualsiasi momento dopo l'installazione.

**Passaggio 4 - Fine**

Al termine dell'installazione, vedrai l'opzione **NeverBlock** nel menu. Da qui puoi scegliere di modificare le impostazioni del plugin quando necessario:

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

### Aggiungere zone in WordPress

È possibile aggiungere zone NeverBlock alla pagina WordPress in due modi.

**Shortcode**

In TinyMCE, quando crei o modifichi un articolo, aggiungilo come segue, assicurandoti di usare l'idzone corretto:

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

In alternativa, usa il seguente esempio in un modello del tema:

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

Nota che è disponibile un attributo facoltativo `container_id` che può essere usato per fare riferimento all'ID di un nodo DOM. Questo verrà aggiunto al div corrispondente. Affinché funzioni, il div deve essere presente prima dello shortcode; in caso contrario NeverBlock non troverà l'elemento.

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

**Script standard**

Quando modifichi un modello del tema, puoi usare gli script standard descritti in [Visualizzazione degli annunci](https://docs.exoclick.com/publishers/it/adblock/neverblock.md#adding-zones-to-a-page).

## Cronologia delle modifiche

Consulta il file CHANGELOG incluso nel pacchetto software.

### Cronologia delle modifiche di NeverBlock PHP

**3.14 (21.10.2026)**

* Il loader backend di NeverBlock non riesce a pubblicare gli annunci in locale anche dopo aver corretto gli avvisi relativi alle funzioni PHP deprecate e il rilevamento dell'IP
* Dalla versione 3.14, l'evento del loader è getmsgloader. Se esegui l'aggiornamento alla versione 3.14, aggiorna il tuo snippet. Il vecchio snippet (getexoloader) genera l'errore: Cannot read properties of undefined (reading 'addZone').

**3.12 (10.01.2025)**

* Correzione: NeverBlock > diag.php restituisce sempre “Can’t access service to compare IPs” durante il rilevamento dell'IP

**3.11 (11.07.2023)**

* Corretta la compatibilità con PHP 5.2 e versioni successive

**3.10 (12.01.2022)**

* Aggiunto un parametro utilizzabile per garantire la compatibilità futura
* Aggiunto il supporto per il formato WebP

**3.9 (03.12.2021)**

* Aggiunto un timeout al rilevamento per evitare falsi positivi sulle connessioni lente

**3.8 (10.06.2021)**

* Rimosso il codice relativo ai pop-under (si preferisce l'inserimento inline) e il cookie non necessario

**3.7 (05.07.2019)**

* Aggiunte alcune misure contro il filtro “anti-cv”

**3.6 (16.05.2019)**

* Rimosso il riferimento all'oggetto JS, che a volte viene bloccato
* Nuova API di rilevamento dell'IP in diag (supporta IPv6)

**3.5 (14.03.2019)**

* Aggiunta la possibilità di rimuovere gli annunci parzialmente bloccati
* Aggiunto il parametro no\_cookie per consentire di ospitare backend\_loader.php su un dominio diverso
* Aggiunto il supporto per la cache acpu

**3.4 (09.07.2018)**

* Migliorato il rilevamento (attende il caricamento della pagina)

**3.3 (25.05.2018)**

* Aggiornato il link alla documentazione per l'inoltro degli IP
* Risolto l'errore causato da alcuni blocker (uBlock) quando sovrascrivono window\.ExoLoader
* Sostituito il vecchio servizio di rilevamento degli IP

**3.2 (15.03.2018)**

* Risolto un errore con PHP <= 5.3

**3.1 (07.03.2018)**

* Resi casuali automaticamente i nomi dei parametri dei banner e dei link; aggiunto un controllo più flessibile
* Risolto un errore JavaScript se serve() viene chiamato più volte

**3.0 (30.01.2018)**

* Introdotto il concetto di renderer richiesti
* Aggiunti nuovi formati pubblicitari: annuncio nativo, banner adesivo, messaggio istantaneo web e mobile
* Reso dinamico il nome dell'oggetto ExoLoader nel caso in cui venga reso immutabile dagli ad blocker
* Piccole modifiche per facilitare l'installer phar e il plugin WordPress
* La versione di PHP viene verificata automaticamente per multi curl

**2.25 (12.10.2017)**

* Risolto il controllo delle modifiche al testo del corpo della risposta nella richiesta di diagnostica degli annunci
* Registrati gli errori restituiti dal server degli annunci
* Risolta la diagnostica del rilevamento IP (usa la configurazione di backend\_loader.php)

**2.24 (15.08.2017)**

* Aggiunto il controllo del rilevamento IP nello script di diagnostica
* Possibilità di ospitare backend\_loader.php su un dominio diverso

**2.22 (13.06.2017)**

* Rilevamento: impedito agli stili box-sizing del sito di influire sui parametri della trappola DOM

**2.21 (09.06.2017)**

* Risolto il problema dei falsi positivi durante il rilevamento degli ad blocker

**2.20 (01.06.2017)**

* Modificato il rilevamento dei blocker
* Risolto il problema per cui più esecuzioni di serve() sovrascrivevano il cookie l'una dell'altra

**2.19 (24.05.2017)**

* Risolto il problema delle campagne di scambio e dei banner 404
* Piccole correzioni per PHP 5.2

**2.18 (07.04.2017)**

* Inviata l'intestazione corretta per JavaScript in caso di convalida rigorosa delle intestazioni

**2.17 (27.03.2017)**

* Risolto l'errore dell'interfaccia nelle versioni precedenti di PHP in backend\_loader.php
* Risolto il problema di apertura dei link in frontend\_loader.php quando è specificato LINK\_URL\_PREFIX

**2.16 (14.03.2017)**

* Consentito aggiungere zone dinamicamente, non solo al caricamento della pagina
* Aggiunto il riferimento al contenitore come parametro di addZone

**2.15 (08.03.2017)**

* Aggiunta una cache su file.
* Ridotta la quantità di dati trasferiti.
* Caricati i banner tramite `<img>`, invece che con uno stile di sfondo in base64.

**2.14 (30.09.2016)**

* Risolto resolveMulti affinché restituisca sempre un array

**2.13 (14.09.2016)**

* Inoltrati correttamente i parametri POST per openLink

**2.12 (12.09.2016)**

* Spostati completamente gli stili inline nelle classi CSS

**2.11 (09.09.2016)**

* Risolto il problema di document.contains non definito in IE

**2.10 (07.09.2016)**

* Risolti i problemi di connettività IPv6 e curl
* Risolti i problemi con i link di clic errati causati dagli alias lato server

**2.9 (02.09.2016)**

* Modificato il meccanismo di apertura dei link per reindirizzarli tramite il loader backend

**2.8 (30.08.2016)**

* Risolto il problema degli annunci HTTPS con la risoluzione DNS e la memorizzazione nella cache esterne a curl

**2.7 (22.08.2016)**

* Passati gli endpoint degli annunci a HTTPS per evitare problemi di contenuti misti

**2.6 (17.08.2016)**

* Segnaposto DOM più generico per i banner
* Risolto un problema con le intestazioni
* Separati gli errori dai messaggi di debug nel loader frontend
* Istruzioni per la risoluzione dei problemi

**2.5 (02.08.2016)**

* Introdotto un log per le richieste scadute e altri errori
* Risolto un errore JavaScript quando qualcosa sovrascrive il segnaposto DOM dell'annuncio

**2.4 (22.07.2016)**

* Timeout migliorati
* File di diagnostica e debug migliorato

**2.3 (20.07.2016)**

* Corretto un problema minore nell'invio di richieste al loader del backend quando non erano state aggiunte zone

**2.2 (15.07.2016)**

* Nuovo dominio per ads-endpoint con bilanciamento del carico migliorato

**2.1 (27.06.2016)**

* Corretta l'incompatibilità con il framework Prototype

**2.0 (14.06.2016)**

* Release pubblica
* Una singola richiesta per più annunci
* Loader unificato per i banner

### Changelog di NeverBlock Proxy

**1.0.1**

* Possibilità di includere Language e Referer nella richiesta
* Esempi aggiornati

**1.0.0**

* Release iniziale


---

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