Codici di errore VAST comuni e come risolverli
Pubblicato: 2022-09-04La maggior parte degli annunci video su Internet deve rispettare le specifiche delineate dallo standard VAST (Video Ad Serving Template) per garantire funzionalità e compatibilità con i lettori video. Uno dei problemi più comuni riscontrati dagli editori che producono pubblicità video tramite piattaforme Google, come YouTube e Google AdSense, sono i codici di errore VAST.
Scopri quali sono i codici di errore VAST, quali sono i codici di errore più comuni e come risolverli.
Che cos'è un errore VAST?
Un codice di errore del modello di pubblicazione di annunci video è uno dei molti possibili stati di errore definiti dall'Interactive Advertising Bureau (IAB) . Un errore VAST indica un problema tra il server che ospita il contenuto dell'annuncio e il video player del consumatore di destinazione, che potrebbe ostacolare o impedire la corretta visualizzazione dell'annuncio .
L'esatta natura dell'errore dipende dal codice visualizzato; ogni codice corrisponde a un problema identificato.
Sfide comuni per la visualizzazione di annunci VAST in Ad Tech
Sebbene la visualizzazione di annunci VAST tenda a essere più semplice da implementare e più conveniente a lungo termine rispetto a soluzioni alternative come Video Player-Ad Interface Definition (VPAID), la sfida principale per i publisher è garantire la visibilità degli annunci .
Molti tipi di problemi tecnici spesso interrompono la visibilità e la funzionalità degli annunci VAST. In molti casi, si verificano interruzioni dovute a impostazioni di configurazione non corrette , da parte dell'acquirente o dell'editore. Queste interruzioni si manifestano sotto forma di codici di errore VAST .
I codici di errore VAST sono classificati in due livelli di gravità: errori fatali e potenzialmente non fatali .
Codici di errore fatali VAST comuni e come risolverli
Un codice di errore VAST irreversibile è il più grave perché è più probabile che abbia interrotto la richiesta di annuncio , causando un'interruzione della visualizzazione. Alcuni errori fatali VAST comuni includono:
Errore VAST 100: errore di analisi XML
L'errore VAST 100 è uno degli errori fatali più comuni. Le potenziali cause dietro l'errore VAST 100 includono una risposta dell'acquirente non corretta o un documento XML non valido, danneggiato o formattato in modo errato . Un'altra possibilità è un problema di reindirizzamento URL VAST, ad esempio, quando il reindirizzamento non viene risolto correttamente.
Gli editori che notano un codice di errore 100 devono avvisare l'acquirente . A loro volta, gli acquirenti devono verificare che l'URL VAST sia configurato correttamente, quindi assicurarsi che tutti i documenti XML VAST siano funzionali e formattati correttamente con gli attributi appropriati.
Errore VAST 101: errore di convalida dello schema
Un errore di convalida dello schema si verifica in genere quando nella risposta dell'acquirente mancano gli elementi o gli attributi XML richiesti o contengono elementi non riconosciuti.
Il modo migliore per risolvere un codice di errore 101 è che l'acquirente consulti la documentazione IAB , verifichi le specifiche VAST XML e si assicuri che tutti gli elementi richiesti e formattati correttamente siano presenti .
Errore VAST 102: versione risposta non supportata
Questo codice di errore comune viene attivato quando un video player di destinazione non supporta la versione VAST della richiesta di offerta. Ciò può verificarsi anche se lo scambio ha inviato la versione VAST errata .
In rari casi, l'annuncio VAST potrebbe non specificare un numero di versione. In tal caso, può anche essere considerato un errore di convalida dello schema .
Per correggere l'errore 102, l'acquirente deve assicurarsi che le risposte presentino solo versioni VAST supportate .
Errore VAST 300: Errore wrapper
L'errore VAST 300 è un errore di wrapper generale. Viene attivato quando viene raggiunto il limite del wrapper .
Questo codice di errore non è perseguibile; non ci sono metodi di risoluzione . Tuttavia, esistono alcuni passaggi correttivi che possono potenzialmente impedire la visualizzazione di un errore 300, ad esempio la revisione periodica degli URI VAST e la garanzia che nessuno di essi sia scaduto.
Errore VAST 301: raggiunto il timeout di reindirizzamento
L'IAB inizialmente ha definito il codice di errore 301 per indicare un URI VAST difettoso, che non risponde o scaduto. Tuttavia, gli specialisti di tecnologia pubblicitaria in genere associano gli Error 301 a un'elevata latenza (colloquialmente nota come "lag") e connessioni Internet scarse o instabili .
Le potenziali cause dirette di un errore 301 includono:
- L'impostazione del timeout del lettore è troppo bassa (l'impostazione predefinita è 5)
- Dimensione della creatività errata (dimensione dell'annuncio)
- URI non valido
- Timeout dell'URI VAST
- Alta latenza
- Da HTTP a HTTPS
- Sito web poco ottimizzato
Errore VAST 302: Limite wrapper raggiunto
Il video player che riceve un annuncio è in genere configurato con un proprio limite di wrapper predefinito. Il raggiungimento di questo limite è la causa più comune di un codice di errore 302.
Gli errori 302 di solito si verificano a causa di un numero eccessivo di risposte wrapper ricevute senza una risposta inline. L'azione correttiva è che il publisher aumenti il limite di wrapper del video player .
In rari casi, gli errori 302 si verificano a causa del collegamento a margherita: un loop o un numero eccessivo di reindirizzamenti VAST prima di restituire un file multimediale, causando l'interruzione della richiesta di annuncio da parte del lettore video. In tal caso, l'acquirente deve assicurarsi che nessun reindirizzamento VAST punti a un altro reindirizzamento.
Errore VAST 303: risposta VAST vuota restituita
Il codice di errore 303 indica una risposta VAST vuota, in genere dovuta a una richiesta di annuncio contenuta all'interno di un wrapper di terze parti .
Gli acquirenti e gli editori che lavorano con reti di terze parti devono controllare il tasso di riempimento , che di solito è inferiore al 100%. Ad esempio, un tasso di riempimento dell'86% significa che c'è una probabilità del 14% che si verifichi questo errore.
Per risolvere un errore VAST 303, i publisher devono abilitare la funzione di fallback in Google Ad Manager . Segui questi passi:
- Accedi al tuo account Google Ad Manager e apri la dashboard.
- Fai clic sul pulsante Amministratore nel pannello di sinistra, vai su Video, quindi Impostazioni video.
- Abilita Video Fallback, quindi fai clic su Salva.
Errore VAST 400: errore lineare generale
Un errore VAST 404 è in genere il risultato di un video player che non è in grado di visualizzare un annuncio lineare .
Le cause più comuni di mancata visualizzazione degli annunci lineari includono:
- Il browser web limita la riproduzione automatica (autoplay) con l'audio
- Il formato MediaFile non è valido (ad es. file video non valido o formato specificato in modo errato)
- Fonte sconosciuta o non specificata
Gli editori che notano un errore 400 dovrebbero verificare la presenza di problemi con il lettore video e configurare il lettore per rilevare i browser con riproduzione automatica limitata . Se queste misure non risolvono il problema, gli acquirenti devono controllare la risposta VAST e assicurarsi che restituisca una creatività valida .
Errore VAST 401: MediaFile non trovato
Se viene visualizzato un codice di errore 401, significa che l'URI MediaFile non restituisce una creatività video valida o non è in grado di trovare un file video valido.
I publisher che trovano questo codice di errore devono avvisare gli acquirenti il prima possibile e gli acquirenti devono assicurarsi che tutti i loro URI MediaFile restituiscano una creatività video valida.
Errore VAST 402: impossibile scaricare o timeout dell'URI MediaFile
Un errore VAST 402 può avere più possibili cause. I seguenti quattro problemi sono i più probabili:
- Il valore (in millisecondi) nella variabile loadVideoTimeout nell'IMA SDK del file è troppo basso. Se il tempo di caricamento della pagina richiede più tempo di questo valore, la riproduzione dell'annuncio verrà annullata , causando potenzialmente un errore.
- Scarse prestazioni o ottimizzazione del sito Web, che causano ritardi di caricamento sufficienti per annullare la riproduzione degli annunci
- Il file video viene riprodotto automaticamente o tentato di riprodurre automaticamente in un ambiente mobile in cui non è previsto che si comporti in questo modo (la maggior parte degli annunci video sui dispositivi mobili dovrebbe essere click-to-play tranne in casi selezionati)
- Sui browser Google Chrome, visualizzazione di un annuncio video in un ambiente di riproduzione automatica nonostante la finestra non sia a fuoco (ad es. finestra ridotta a icona, scheda diversa selezionata o un altro programma su un'altra schermata attualmente attiva)
Sebbene non tutte queste cause abbiano rimedi corrispondenti, la soluzione consigliata per i publisher consiste nell'esaminare il limite di timeout del video player e impostare la variabile loadVideoTimeout su un valore più alto. Il valore predefinito è -1, corrispondente a 8 secondi (8.000 ms).
Altre potenziali soluzioni includono l'ottimizzazione del sito Web per ottenere velocità di caricamento più elevate o la regolazione del bitrate del video per migliorare le prestazioni della pubblicazione di annunci sui dispositivi mobili.
Errore VAST 403: risposta dichiarata tipi MIME non supportati per tutti i file multimediali
Questo codice di errore è tra i più frequenti ed è più comune sui dispositivi mobili.
Il codice di errore 403 indica che una risposta VAST ha dichiarato uno o più tipi MIME (Multipurpose Internet Mail Extensions) non supportati per tutti i MediaFile disponibili (ad esempio, il tentativo di riprodurre contenuto Flash su dispositivi mobili). Questo codice di errore può verificarsi anche quando il tipo di creatività errato ha tentato la riproduzione .
Quando riscontrano questo codice di errore, i publisher devono assicurarsi che il formato e la tecnologia dei file degli annunci siano supportati dal dispositivo e dal sistema operativo del lettore. Gli acquirenti devono inoltre verificare che tutte le creatività restituite rispettino i formati video della richiesta di offerta (ad es. le app per dispositivi mobili non devono richiedere creatività VPAID).
Errore VAST 405: Errore di visualizzazione MediaFile
In genere si verifica un errore di visualizzazione MediaFile (VAST 405) a causa di una creatività difettosa . I tipi di errore comuni includono:
- Il tipo MIME e il tipo di file video non corrispondono
- Configurazione errata di condivisione delle risorse tra le origini (CORS) sulla rete CDN della creatività
- Problema di transcodifica
Per risolvere questo problema, gli acquirenti devono verificare che tutti i tipi MIME di creatività e le opzioni di configurazione CDN siano accurati .
Errore VAST 406: file mezzanine richiesto mancante
La causa più comune di un codice di errore 406 è una risposta VAST restituita senza un file mezzanine richiesto . Un file mezzanino è un file video di alta qualità e ad alta risoluzione, spesso grezzo (non compresso) o compresso in modo che sia indistinguibile dal file non elaborato.
I file mezzanine sono in genere necessari in ambienti che si basano su implementazioni di annunci lato server . Questi file vengono utilizzati per generare file video di qualità appropriata per la piattaforma di destinazione, ad esempio per ambienti mobili o per eseguire la cucitura degli annunci.
Gli acquirenti che vedono un codice di errore 406 devono assicurarsi che nella risposta VAST sia incluso un file mezzanine appropriato .
Errore VAST 407: file mezzanino scaricato per la prima volta
Il codice di errore 407 indica che il file mezzanino viene scaricato e transcodificato per la prima volta , causando la mancata pubblicazione di un annuncio. Questo codice di errore è previsto e non utilizzabile; l'unica azione correttiva è attendere il completamento del processo di transcodifica .

A seconda delle dimensioni del file mezzanino, questo processo potrebbe richiedere diverse ore.
Errore VAST 408: annuncio rifiutato nella risposta VAST
Se viene visualizzato il codice di errore VAST 408, significa che il file dell'annuncio restituito nella risposta VAST è stato rifiutato .
I publisher devono avvisare gli acquirenti degli errori 408 il prima possibile e gli acquirenti devono assicurarsi che le risposte VAST contengano solo creatività approvate . Anche le entità che agiscono come host di creatività pubblicitaria (ad es. l'agenzia pubblicitaria o editoriale) dovrebbero essere a conoscenza di eventuali rifiuti di pubblicità per intraprendere le azioni appropriate.
Errore VAST 409: la creatività interattiva definita nel nodo InteractiveCreativeFile non è stata eseguita
La causa più probabile di un errore VAST 409 è la mancata riproduzione della creatività definita dal nodo Gli acquirenti devono assicurarsi che tutte le creatività interattive (ad es. una demo riproducibile per un gioco per dispositivi mobili) restituite nella risposta VAST vengano riprodotte correttamente quando richiesto.
Errore VAST 410: il codice a cui si fa riferimento nel nodo di verifica non è stato eseguito
Gli errori VAST 410 si verificano in genere a causa della mancata esecuzione del codice definito nel nodo Gli acquirenti devono assicurarsi che il codice di AdVerification sia funzionale e implementato correttamente.
Errore VAST 500: errore generale NonLinearAds
Se viene restituito questo codice di errore, in genere indica che il video player non è riuscito a visualizzare un annuncio non lineare per motivi sconosciuti .
I publisher possono tentare di correggere il codice di errore verificando la presenza di problemi con il lettore video e gli acquirenti devono controllare tutte le risposte VAST per assicurarsi che restituiscano creatività valide.
Errore VAST 501: le dimensioni della creatività dell'annuncio non lineare non si allineano con l'area di visualizzazione della creatività
Un errore VAST 501 è in genere il risultato della mancata riproduzione di un annuncio non lineare a causa di una mancata corrispondenza tra le dimensioni della creatività (dimensione dell'annuncio) e l'area di visualizzazione della creatività (spazio dello schermo). In particolare, gli Error 501 si verificano quando le dimensioni della creatività sono troppo grandi per l'area di visualizzazione (in altre parole, l'annuncio è troppo grande per lo schermo).
In casi più rari, un errore 501 può essere attivato da CSS configurati in modo errato , come gli stili CSS che fissano l'altezza e la larghezza dell'elemento di contenuto video.
I publisher possono correggere questo codice di errore modificando l'altezza e la larghezza impostate della creatività in modo che corrispondano all'area di visualizzazione. Se il publisher ha impostato la dimensione dell'elemento di contenuto video utilizzando gli stili CSS, l'azione consigliata consiste nell'utilizzare invece gli attributi HTML.
Errore VAST 502: impossibile recuperare annunci non lineari/risorse non lineari
La causa più comune di un codice VAST 502 è la risposta di un acquirente che restituisce un annuncio non lineare che non ha restituito una creatività valida . Gli acquirenti devono assicurarsi che tutte le risposte agli annunci non lineari restituiscano creatività valide.
Errore VAST 503: impossibile trovare una risorsa non lineare con tipo supportato
I publisher che richiedono una dimensione della creatività maggiore delle dimensioni del video player potrebbero riscontrare un codice di errore 503. Un tipo di supporto non valido può generare questo codice di errore in casi più rari.
L'azione correttiva consigliata è che il publisher si assicuri che tutte le dimensioni di creatività e i tipi di media richiesti siano compatibili con il video player.
Errore VAST 901: errore VPAID generale
Un errore 901 è un codice di errore irreversibile generico che può causare qualsiasi errore VPAID. Le possibili cause includono:
- Il wrapper SSP VPAID è scaduto
- Wrapper SSP VPAID non in acquisto
- Le creatività VPAID richiedevano la modalità non protetta
- Utilizzo di un tag "IMA Adapter" con l'IMA SDK (il tag VAST corretto da utilizzare è "Direct SDK")
Gli editori devono assicurarsi che tutte le richieste VPAID siano supportate per i dispositivi di destinazione e i lettori video. La funzione del profilo della creatività video di Google può aiutarti a gestire le tue creatività ed evitare questo codice di errore.
Gli acquirenti possono esaminare le risposte VAST che restituiscono wrapper VPAID HTML5 e assicurarsi che includano una risorsa MP4 e non interrompano la riproduzione.
Codici di errore VAST comuni potenzialmente non irreversibili e come risolverli
Un errore non irreversibile indica un problema che potrebbe non aver interrotto la visualizzazione dell'annuncio. Tuttavia, affrontare la causa dell'errore il prima possibile è fondamentale per garantire prestazioni ottimali e prevenire errori più gravi. Di seguito sono riportati alcuni errori VAST comuni non irreversibili:
Errore VAST 200: il lettore video prevedeva un tipo di annuncio diverso
Un errore VAST 200 di solito si verifica quando il video player non supporta o si aspetta il tipo di annuncio richiesto in una richiesta di offerta.
Un esempio di tipo di annuncio non supportato sono gli annunci ignorabili inviati a giocatori che possono supportare solo annunci lineari.
Gli editori possono risolvere questo codice di errore verificando la presenza di errori di traffico . Se il publisher non riesce a risolvere il problema, l'acquirente deve assicurarsi che le risposte VAST inviino solo tipi di annunci specificati .
Errore VAST 201: il lettore video prevedeva una linearità diversa
Questo codice di errore è in genere causato da una mancata corrispondenza di linearità tra la richiesta del video player e la risposta dell'acquirente . Un esempio di mancata corrispondenza di linearità è una risposta VAST che invia un annuncio non lineare quando la richiesta specifica un annuncio lineare.
I publisher devono assicurarsi che le richieste di annunci specifichino la linearità corretta e gli acquirenti devono verificare che le risposte VAST includano solo la linearità specificata nella richiesta di annuncio.
Errore VAST 202: il lettore video prevedeva una durata diversa
Il codice di errore VAST 202 si verifica quando la risposta restituisce una creatività con una durata diversa da quella specificata . Ad esempio, se la durata specificata è 30 secondi, ma la durata effettiva di MediaFile è 45 secondi, potrebbe risultare un errore 202.
I publisher devono configurare correttamente la durata della creatività in Google Ad Manager e gli acquirenti devono assicurarsi che la risposta rispetti la durata massima specificata della richiesta.
Errore VAST 203: lettore video previsto di dimensioni diverse
Questo codice di errore è più comunemente causato da un'incompatibilità tra i MediaFiles restituiti e il dispositivo di destinazione . Ad esempio, inviare una creatività con una velocità in bit elevata a dispositivi mobili, anche se questi dispositivi sono più adatti per velocità in bit inferiori.
Gli acquirenti possono correggere un errore 203 assicurando che tutte le risposte VAST includano MediaFiles compatibili con più tipi di dispositivi e tecnologie , inclusa la compatibilità con bitrate.
Errore VAST 600: errore CompanionAds generale
L'errore 600 è un errore generico non irreversibile in genere causato da un problema non specificato con gli annunci associati. Si verifica più comunemente quando il publisher non può visualizzare un annuncio companion per nessun motivo specificato.
Per risolvere questo codice di errore, i publisher possono provare a verificare potenziali problemi di pubblicazione degli annunci e gli acquirenti devono assicurarsi che le risposte VAST restituiscano file di creatività validi.
Errore VAST 601: le dimensioni della creatività companion non erano allineate con l'area di visualizzazione companion
Questo codice di errore si verifica in genere quando le dimensioni di una creatività companion sono troppo grandi per rientrare nell'area di visualizzazione dell'annuncio companion.
I publisher devono assicurarsi che le dimensioni dell'annuncio companion richiesto (altezza e lunghezza) rientrino nelle dimensioni dell'unità pubblicitaria.
Errore VAST 602: impossibile visualizzare il compagno richiesto
Un errore VAST 602 significa che il publisher non è riuscito a eseguire il rendering della creatività associata restituita nella risposta VAST corrispondente .
Questo codice di errore è in genere il sintomo di un problema di pubblicazione degli annunci , che i publisher devono verificare e risolvere. Gli acquirenti devono inoltre assicurarsi che la risposta VAST restituisca una creatività valida.
Errore VAST 603: impossibile recuperare CompanionAds/Companion Resource
In genere si verificano numerosi errori 603 quando la risposta dell'acquirente restituisce un companion che non ha potuto restituire una creatività valida . L'acquirente deve verificare e assicurarsi che tutte le risposte agli annunci associati restituiscano creatività valide.
Errore VAST 604: impossibile trovare la risorsa complementare con il tipo supportato
Un errore Vast 604 è in genere il risultato di un publisher che richiede un tipo di creatività non supportato per un'area annuncio companion.
Per risolvere questo codice di errore, i publisher devono assicurarsi che l'area annuncio companion supporti i tipi di creatività specificati.
Sia i codici di errore VAST potenzialmente fatali che quelli non fatali
Questi codici di errore possono corrispondere o meno a errori irreversibili.
Errore VAST 900: Errore VAST 2 (potenzialmente non irreversibile)
Questo codice di errore specifico è causato da un errore VAST 2 di qualsiasi tipo , anche se sono richieste versioni VAST successive (ad es. VAST 3) o la versione predefinita della rete è VAST 3 o successiva.
Per risolvere questo codice di errore, i publisher devono iniziare a richiedere VAST 3 o attivare VAST 3 sulla propria rete . Si consiglia agli acquirenti di collaborare con l'editore per una risoluzione dei problemi più specifica.
Errore irreversibile VAST 900: errore VAST 3 non definito
Questo codice di errore viene restituito quando si è verificato un errore VAST 3 sconosciuto e la richiesta di annuncio è stata interrotta. A causa della natura non specifica di questo codice di errore, si consiglia agli editori e agli acquirenti di collaborare per identificare il problema esatto .
Procedure consigliate per gli editori per la gestione degli errori
Sebbene il modo migliore per evitare codici di errore di qualsiasi tipo sia prevenire le condizioni necessarie affinché si verifichi un codice di errore, a volte sono inevitabili. Di seguito sono riportate alcune best practice che i publisher devono seguire:
- Prestare molta attenzione al numero del codice di errore . Molti errori possono essere risolti o mitigati senza contattare l'acquirente, risparmiando una notevole quantità di tempo.
- Assicurati che le Demand Side Platforms (DSP) abbiano l'opportunità di scansionare ogni creatività e risolvere potenziali problemi che causano errori prima di pubblicare l'annuncio.
- Comunica e collabora con i tuoi DSP, Supply-Side Platforms (SSP), reti pubblicitarie e ad server per migliorare le prestazioni delle tue creatività.
Risolvi i codici di errore VAST con CodeFuel
Comprendere la natura di ogni errore VAST è fondamentale per affrontare tutti i potenziali problemi di pubblicazione degli annunci e ottimizzare il rendimento dei tuoi annunci video .
Se hai bisogno di assistenza per risolvere gli errori VAST , CodeFuel può aiutarti. Il nostro team di esperti di annunci video e di monetizzazione può fornire assistenza e risolvere eventuali codici di errore VAST che potrebbero verificarsi. Contattateci oggi per ulteriori informazioni.