For the complete documentation index, see llms.txt. This page is also available as Markdown.

Come utilizzare l'API dei domini dinamici di AdBlock

Gli strumenti AdBlock sono sempre più sofisticati e pongono sfide significative per gli editori che cercano di massimizzare i ricavi dalla pubblicità online. Per contribuire a mitigare queste sfide, questa API consente agli editori di adattare dinamicamente i propri script in base ai domini attivi, riducendo notevolmente il rischio che i contenuti vengano bloccati dal software AdBlock.

Garantendo la distribuzione degli annunci tramite domini ruotati regolarmente, gli editori possono:

  • Mantenere i flussi di ricavi: Impedire interruzioni causate da annunci bloccati.

  • Migliorare l'esperienza utente: Erogare i contenuti pubblicitari senza problemi, senza attivare il rilevamento di AdBlock.

  • Automatizzare la gestione dei domini: Eliminare gli aggiornamenti manuali con un ciclo di vita automatico del dominio di 7 giorni.

I nuovi domini vengono generati ogni 3 giorni e sono disponibili tramite l'API. I domini avranno un ciclo di vita di 6 giorni.

  • 3 giorni attivi

  • 3 giorni deprecati

Una volta scaduto il ciclo di vita, il dominio verrà disattivato. Per motivi di prestazioni, si consiglia di memorizzare nella cache il dominio per 24 ore prima di richiederne uno nuovo all'API.

Questa API è disponibile solo per script inline Popunder e Video In-Stream zone.

Requisiti

Per usare questa API, gli editori devono:

  • Effettuare una richiesta GET all'endpoint: https://ads.exoclick.com/adblock-domains.php

  • Riceverai un nuovo dominio di erogazione degli annunci nella risposta

  • Dovrai quindi modificare l'endpoint di syndication usato nel tag della tua ad zone con quello nuovo fornito nella risposta dell'API.

Passaggi per l'implementazione

1

Recupera il dominio attivo

Per recuperare dinamicamente il Dominio attivo, devi effettuare una chiamata API server-to-server. Questo è fondamentale perché le chiamate API possono essere bloccate se effettuate dal lato client.

Ecco un esempio di chiamata server-to-server in PHP:

Ecco la risposta prevista dall'API:

2

Aggiorna il tuo script

Usa la dominio restituito dall'endpoint per aggiornare il dominio usato nella tua ad zone. Il dominio originale dipende dal formato dell'annuncio:

  • Per Video In-Stream zone cambia il Tag VAST:

    • Prima : https://s.magsrv.com/v1/vast.php?t={random}&idzone={zoneId}

    • Dopo : https://newsub.newdomain.com/v1/vast.php?t={random}&idzone={zoneId}

  • Per le zone Popunder cambia il syndication_host nello script inline:

    • Prima : s.pemsrv.com

    • Dopo : newsub.newdomain.com

Rilevamento di AdBlock

Per rilevare se l'utente ha un'estensione adblock attiva, devi ospitare ads.js sul lato dell'editore (il tuo dominio/CDN) e includerlo all'inizio del tuo body tag.

Non devi richiedere https://www.exoclick.com/ads.js direttamente.

Crea il tuo ads.js file:

  1. Crea un file chiamato ads.js in un percorso pubblico del tuo sito web (ad esempio /js/ads.js).

  2. Aggiungi il seguente contenuto a quel file.

  3. Carica quel file dalla tua pagina prima della logica di integrazione degli annunci.

Contenuto del file di riferimento:

Quindi aggiungi la seguente riga all'inizio del tuo body tag:

Questo script verrà bloccato da Adblock nel caso in cui il client lo utilizzi, a causa della presenza delle parole chiave "exoclick" e "ads". Dopo il caricamento di questo script, uno snippet JS tenterà di leggere una variabile specifica. Se la variabile è indefinita o inaccessibile, possiamo determinare che lo script è stato bloccato.

Esempi di integrazione

In questi due esempi stiamo usando fetchAdblockDomain.php come nome della chiamata server-to-server per recuperare il dominio adblock.

In-Stream

Per usare i Dynamic Domains con In-Stream, assicurati di includere il player VAST all'interno dello script, altrimenti il player caricherà la zona pubblicitaria In-Stream predefinita invece di usare il dominio aggiornato. In questo esempio, stiamo usando il player HTML5 Fluidplayer.

Popunder

Risoluzione dei problemi

Nessun dominio restituito

A volte l'endpoint potrebbe restituire domini vuoti.

Registra sempre la risposta dell'endpoint durante il debug per individuare eventuali problemi. Se success è false, contatta il supporto.

Dominio predefinito restituito nonostante Adblock sia abilitato

Ecco alcuni motivi comuni per cui il tuo script potrebbe utilizzare il dominio predefinito nonostante Adblock sia abilitato:

  • ads.js non è ospitato sul lato dell'editore. Questa integrazione richiede di servire ads.js dal tuo dominio (ad esempio /js/ads.js). Richiedere direttamente https://www.exoclick.com/ads.js non è supportato.

  • dominio predefinito renderizzato prima del dominio adblock. Assicurati che lo script che inserisce la ad zone sul tuo sito aspetti sempre la chiamata server-to-server. A seconda della catena di esecuzione, il dominio predefinito potrebbe essere aggiunto al sito prima che venga restituito il dominio adblock, impedendo al tuo sito web di inserire il dominio aggiornato.

Per ulteriore assistenza, contatta il team di supporto qui.

Ultimo aggiornamento

È stato utile?