Bloccare l'IMA SDK: come funziona davvero

Che cos'è davvero l'IMA SDK

La Interactive Media Ads (IMA) SDK è la libreria client di Google per la pubblicità video. Un sito che vuole monetizzare un video di norma non costruisce un player di annunci tutto suo: carica imasdk.googleapis.com/js/sdkloader/ima3.js (o la variante dinamica ima3_dai.js), inizializza un AdDisplayContainer e passa all'SDK l'URL di un ad tag. L'SDK scarica una risposta VAST, disegna l'annuncio dentro il player, traccia impression e quartili e alla fine restituisce il controllo al contenuto dell'editore.

Essendo un unico script servito da un unico dominio, l'IMA SDK è il punto più strategico di tutta la pubblicità video sul web: neutralizzarlo una volta sola fa smettere di consegnare annunci ogni player costruito sopra.

Il ciclo di vita di una richiesta pubblicitaria

Quando lo spettatore preme play, il player esegue in genere questa sequenza:

1. La pagina carica ima3.js dai server di Google.
2. Il player crea un ads loader e richiede gli annunci con un ad tag che punta a un ad server.
3. L'SDK scarica l'annuncio (di solito un documento VAST/VMAP tramite DoubleClick), lo interpreta e ne disegna il media in un contenitore sovrapposto al video.
4. Partono i pixel di tracciamento; il player attende.
5. Quando l'annuncio termina (o va in errore), l'SDK emette CONTENT_RESUME_REQUESTED e il player riprende il vero video.

Questo ultimo evento è la chiave: il player è scritto per aspettare. Chi controlla l'SDK controlla quando il contenuto riprende.

Perché bloccare e basta rompe i player

L'approccio grossolano è bloccare imasdk.googleapis.com a livello di rete e dirsi a posto. Il problema: molti player interpretano un SDK mancante o in errore come un errore fatale e si rifiutano di far partire il video, mostrando uno spinner o un muro anti-adblock al posto del contenuto.

È per questo che i blocker tradizionali faticano con gli annunci video: possono fermare la richiesta dell'annuncio, ma non possono rispondere alla domanda del player — "posso riprendere adesso?". Solo qualcosa che fa le veci dell'SDK può farlo.

La neutralizzazione per sostituzione: lo stub

AdOff prende una strada diversa: invece di bloccare l'SDK lo sostituisce. Uno stub che replica l'API pubblica dell'IMA SDK viene messo al suo posto, così il player continua a "vedere" un SDK funzionante — uno che si comporta come se ogni interruzione pubblicitaria fosse vuota.

Quando il player chiama adsManager.start(), lo stub emette subito CONTENT_RESUME_REQUESTED. Il player riprende il contenuto all'istante. Nessun annuncio viene richiesto, nessun annuncio viene mostrato, e il player non entra mai in uno stato di errore perché non si accorge che manchi nulla.

Due canali di consegna per lo stesso stub

AdOff distribuisce lo stesso stub attraverso due canali, perché i siti diversi caricano l'SDK in modi diversi:

• Iniezione in-pagina. Sui siti non esclusi, uno script nel MAIN world definisce window.google.ima prima che il player si inizializzi: l'SDK, sia caricato esternamente sia incluso nel codice del sito, viene surclassato dallo stub.
• Reindirizzamento di rete. Per un insieme di 42 domini di broadcaster europei, regole declarativeNetRequest redirigono la richiesta di ima3.js e ima3_dai.js verso il file stub incluso nell'estensione. La pagina carica quello che crede essere l'SDK di Google e riceve invece quello di AdOff.

I due canali convergono sullo stesso risultato: il player riceve un SDK reattivo, lo spettatore riceve il contenuto.

Dove arriva e dove non arriva questo approccio

Lo stub neutralizza la pubblicità client-side basata su IMA. Non tocca l'inserimento lato server (SSAI), dove gli annunci vengono cuciti nel flusso video prima della consegna: lì non c'è nessuna chiamata SDK da intercettare. I servizi in abbonamento con pipeline pubblicitarie proprietarie sono esclusi di proposito, perché i loro player continuino a funzionare.

La piattaforma video principale ha in più una pipeline dedicata: la pianificazione degli annunci viene rimossa dalla risposta del player prima che la pagina la legga, e ciò che sfugge viene fatto andare avanti veloce.

Perché conta per il futuro dell'ad blocking

Le piattaforme pubblicitarie spostano sempre più peso sugli SDK client-side proprio perché i blocker semplicisti faticano con loro. Un approccio che risponde al player invece di affamarlo è solido: non dipende dall'elencare ogni URL di annuncio, ma solo dal contratto stesso dell'SDK — il contenuto deve riprendere.

AdOff è un'estensione Manifest V3 gratuita, senza account, per Chrome, Firefox, Safari, Edge e Opera, e il suo strato di neutralizzazione video è incluso per tutti.

Domande frequenti

Bloccare l'IMA SDK è la stessa cosa che sostituirlo?

No. Bloccarlo a livello di rete spesso impedisce al video di partire, perché il player attende che l'SDK segnali che il contenuto può riprendere. Sostituirlo con uno stub mantiene il player pienamente funzionante e fa sì che nessun annuncio venga mai richiesto.

Cosa succede quando lo stub riceve una richiesta di annuncio?

Lo stub espone la stessa API che i player si aspettano. Quando gli viene chiesto di avviare gli annunci, emette immediatamente l'evento di ripresa del contenuto: la riproduzione continua senza che alcun annuncio venga scaricato o mostrato.

Lo stub funziona anche contro l'inserimento lato server?

No. Con l'SSAI gli annunci sono cuciti nel flusso video dal server prima della consegna: non esiste una chiamata client-side da intercettare. L'inserimento lato server richiede contromisure diverse e resta fuori dalla portata di un'estensione per browser.

Quali browser possono far girare questo tipo di estensione?

AdOff è costruita su Manifest V3 e funziona su Chrome, Firefox, Safari, Edge e Opera. La neutralizzazione dell'IMA è inclusa nella versione gratuita, senza account né registrazione.

Un sito può accorgersi che l'SDK è stato sostituito?

È proprio il compito dello strato stealth: lo spoofing delle esche e l'intercettazione di fetch/XHR fanno sembrare l'ambiente normale agli script anti-adblock. Nessun metodo è permanente, perché le piattaforme cambiano spesso i loro sistemi di rilevamento.

Approfondimenti: Blocco delle pubblicità nello streaming: la guida completa, Pre-roll, mid-roll, post-roll: i formati degli annunci video, Come funziona AdOff, livello per livello.