Codurile de eroare VAST comune și cum să le rezolvi
Publicat: 2022-09-04Majoritatea anunțurilor video de pe internet trebuie să respecte specificațiile prezentate de standardul Video Ad Serving Template (VAST) pentru a asigura funcționalitatea și compatibilitatea cu playerele video. Una dintre cele mai frecvente probleme întâlnite de editorii care produc publicitate video prin intermediul platformelor Google, cum ar fi YouTube și Google AdSense, este codurile de eroare VAST.
Aflați ce sunt codurile de eroare VAST, care sunt cele mai comune coduri de eroare și cum să le rezolvați.
Ce este o eroare VAST?
Codul de eroare al unui șablon de difuzare a anunțurilor video este una dintre numeroasele stări de eroare posibile definite de Interactive Advertising Bureau (IAB) . O eroare VAST indică o problemă între serverul care găzduiește conținutul anunțului și playerul video al consumatorului țintă, care poate împiedica sau împiedica afișarea corectă a anunțului .
Natura exactă a erorii depinde de codul afișat; fiecare cod corespunde unei probleme identificate.
Provocări comune pentru afișarea de anunțuri VAST în Ad Tech
Deși afișarea reclamelor VAST tinde să fie mai simplu de implementat și mai rentabilă pe termen lung decât soluțiile alternative precum Video Player-Ad Interface Definition (VPAID), principala provocare pentru editori este asigurarea vizibilității anunțurilor .
Multe tipuri de probleme tehnice perturbă frecvent vizibilitatea și funcționalitatea anunțurilor VAST. În multe cazuri, întreruperile apar din cauza setărilor de configurare necorespunzătoare , fie din partea cumpărătorului, fie a editorului. Aceste întreruperi se manifestă sub forma codurilor de eroare VAST .
Codurile de eroare VAST sunt clasificate în două niveluri de severitate: erori fatale și potențial non-fatale .
Codurile de eroare fatale VAST comune și cum să le rezolvi
Un cod de eroare VAST fatal este cel mai grav, deoarece este cel mai probabil să fi oprit solicitarea de anunț , ducând la o întrerupere a afișajului. Unele erori comune VAST fatale includ:
Eroare VAST 100: Eroare de analiză XML
Eroare VAST 100 este una dintre cele mai frecvente erori fatale. Cauzele potențiale din spatele erorii VAST 100 includ un răspuns incorect al cumpărătorului sau un document XML nevalid, corupt sau formatat incorect . O altă posibilitate este o problemă de redirecționare URL VAST, de exemplu, atunci când redirecționarea nu se rezolvă corect.
Editorii care observă un cod de eroare 100 ar trebui să avertizeze cumpărătorul . La rândul lor, cumpărătorii trebuie să verifice dacă adresa URL VAST este configurată corect, apoi să se asigure că toate documentele VAST XML sunt funcționale și formatate corect cu atributele adecvate.
Eroare VAST 101: Eroare de validare a schemei
O eroare de validare a schemei apare de obicei atunci când din răspunsul cumpărătorului lipsesc elementele sau atributele XML necesare sau conține elemente nerecunoscute.
Cel mai bun mod de a aborda un cod de eroare 101 este ca cumpărătorul să consulte documentația IAB , să verifice specificațiile VAST XML și să se asigure că sunt prezente toate elementele necesare și formatate corect .
Eroare VAST 102: versiunea de răspuns nu este acceptată
Acest cod de eroare frecvent întâlnit este declanșat atunci când un player video țintă nu acceptă versiunea VAST a cererii de licitare. Acest lucru se poate întâmpla și dacă schimbul a trimis versiunea VAST greșită .
În cazuri rare, este posibil ca anunțul VAST să nu specifice un număr de versiune. În acest caz, poate fi considerată și o eroare de validare a schemei .
Pentru a remedia eroarea 102, cumpărătorul trebuie să se asigure că răspunsurile includ doar versiuni VAST acceptate .
Eroare VAST 300: Eroare Wrapper
Eroare VAST 300 este o eroare generală de wrapper. Este declanșat când este atinsă limita de înveliș .
Acest cod de eroare nu poate fi acționat; nu exista metode de rezolutie . Cu toate acestea, există câțiva pași de remediere care pot împiedica afișarea unei erori 300, cum ar fi revizuirea periodică a URI-urilor VAST și asigurarea că niciunul dintre ele nu expiră.
Eroare VAST 301: a fost atins timpul de expirare a redirecționării
IAB a definit inițial codul de eroare 301 pentru a indica un URI VAST defect, care nu răspunde sau expirat. Cu toate acestea, specialiștii în tehnologie publicitară asociază de obicei eroarea 301 cu o latență ridicată (cunoscută în mod colocvial ca „întârziere”) și conexiuni la internet slabe sau instabile .
Cauzele directe potențiale ale unei erori 301 includ:
- Setarea de timeout a jucătorului este prea mică (setarea implicită este 5)
- Parametrul reclamei greșit (dimensiunea anunțului)
- URI nevalid
- Timeout pentru VAST URI
- Latență mare
- HTTP la HTTPS
- Site web prost optimizat
Eroare VAST 302: Limita Wrapper Atinsă
Playerul video care primește un anunț este de obicei configurat cu propria sa limită de wrapper predefinită. Atingerea acestei limite este cea mai frecventă cauză a unui cod de eroare 302.
Eroarea 302 apare de obicei din cauza unui număr excesiv de răspunsuri wrapper primite fără un răspuns inline. Acțiunea de remediere este ca editorul să mărească limita de wrapper a playerului video .
În cazuri rare, eroarea 302 se întâmplă din cauza conectării în lanț: o buclă sau un număr excesiv de redirecționări VAST înainte de a returna un fișier media, determinând playerul video să anuleze solicitarea de anunț. În acest caz, cumpărătorul trebuie să se asigure că nicio redirecționare VAST nu indică către o altă redirecționare.
Eroare VAST 303: Răspuns VAST gol returnat
Codul de eroare 303 indică un răspuns VAST gol, de obicei din cauza unei solicitări de anunț conținute într-un pachet terță parte .
Cumpărătorii și editorii care lucrează cu rețele terțe trebuie să verifice rata de completare , care este de obicei sub 100%. De exemplu, o rată de umplere de 86% înseamnă că există o șansă de 14% ca această eroare să apară.
Pentru a rezolva o eroare VAST 303, editorii ar trebui să activeze funcția de rezervă în Google Ad Manager . Urmați acești pași:
- Conectați-vă la contul dvs. Google Ad Manager și deschideți tabloul de bord.
- Faceți clic pe butonul Administrator din panoul din stânga, navigați la Video, apoi Setări video.
- Activați Video Fallback, apoi faceți clic pe Salvare.
Eroare VAST 400: Eroare liniară generală
O eroare VAST 404 este de obicei rezultatul faptului că un player video nu poate afișa un anunț liniar .
Cele mai frecvente cauze ale eșecului de a afișa anunțuri liniare includ:
- Browserul web restricționează redarea automată (redarea automată) cu sunet
- Formatul MediaFile este nevalid (de exemplu, nu este un fișier video valid sau formatul specificat incorect)
- Sursă necunoscută sau nespecificată
Editorii care observă o eroare 400 ar trebui să verifice problemele playerului video și să configureze playerul pentru a detecta browserele cu redare automată restricționată . Dacă aceste măsuri nu remediază problema, cumpărătorii ar trebui să verifice răspunsul VAST și să se asigure că returnează o reclamă validă .
Eroare VAST 401: Fișierul media nu a fost găsit
Dacă vedeți un cod de eroare 401, acesta indică URI-ul MediaFile nu returnează o reclamă video validă sau nu poate găsi altfel un fișier video valid.
Editorii care găsesc acest cod de eroare ar trebui să avertizeze cumpărătorii cât mai curând posibil , iar cumpărătorii trebuie să se asigure că toate URI-urile lor MediaFile returnează o reclamă video validă.
Eroare VAST 402: Imposibil de descărcat sau de expirare a URI-ului MediaFile
O eroare VAST 402 poate avea mai multe cauze posibile. Următoarele patru probleme sunt cele mai probabile:
- Valoarea (în milisecunde) la variabila loadVideoTimeout din SDK-ul IMA al fișierului este prea mică. Dacă timpul de încărcare a paginii durează mai mult decât această valoare, redarea anunțului va fi anulată , ceea ce poate duce la o eroare.
- Performanță sau optimizare slabă a site-ului, care provoacă întârzieri suficiente în timpul de încărcare pentru a anula redarea anunțurilor
- Fișierul video se redă automat sau se încearcă redarea automată într-un mediu mobil în care nu se intenționează să se comporte în acest fel (majoritatea anunțurilor video de pe dispozitive mobile ar trebui să fie cu clic pentru redare, cu excepția cazurilor selectate)
- În browserele Google Chrome, afișarea unui anunț video într-un mediu de redare automată, în ciuda faptului că fereastra nu este focalizată (de exemplu, fereastră minimizată, filă diferită selectată sau alt program pe alt ecran activ în prezent)
Deși nu toate aceste cauze au remedii corespunzătoare, soluția recomandată pentru editori este să inspecteze limita de expirare a playerului video și să seteze variabila loadVideoTimeout la o valoare mai mare. Valoarea implicită este -1, corespunzătoare la 8 secunde (8.000 ms).
Alte soluții potențiale includ optimizarea site-ului web pentru a obține viteze de încărcare mai mari sau ajustarea ratei de biți a videoclipurilor pentru o performanță mai bună a difuzării anunțurilor pe dispozitivele mobile.
Eroare VAST 403: răspunsul a declarat tipuri MIME neacceptate pentru toate fișierele media
Acest cod de eroare este printre cele mai frecvent întâlnite și este cel mai frecvent pe dispozitivele mobile.
Codul de eroare 403 indică că un răspuns VAST a declarat unul sau mai multe tipuri de extensii MIME (Multipurpose Internet Mail) neacceptate pentru toate fișierele media disponibile (de exemplu, încercarea de a reda conținut Flash pe mobil). Acest cod de eroare poate apărea și atunci când a încercat redarea unui tip de reclamă greșit .
Când se confruntă cu acest cod de eroare, editorii trebuie să se asigure că formatul și tehnologia fișierului reclamelor sunt acceptate de dispozitivul și sistemul de operare al playerului. Cumpărătorii trebuie, de asemenea, să verifice dacă toate reclamele returnate respectă formatele video ale solicitării de licitare (de exemplu, aplicațiile mobile nu ar trebui să solicite reclame VPAID).
Eroare VAST 405: Eroare de afișare a fișierului media
O eroare de afișare MediaFile (VAST 405) apare de obicei din cauza unei reclame defectuoase . Tipurile comune de defecțiuni includ:
- Tipul MIME și tipul fișierului video nu se potrivesc
- Configurație incorectă de partajare a resurselor între origini (CORS) pe CDN-ul reclamei
- Problemă de transcodare
Pentru a rezolva această problemă, cumpărătorii trebuie să verifice dacă toate tipurile MIME de reclame și opțiunile de configurare CDN sunt corecte .
Eroare VAST 406: Lipsește fișierul mezzanin necesar
Cea mai frecventă cauză a unui cod de eroare 406 este un răspuns VAST returnat fără un fișier mezzanin necesar . Un fișier mezanin este un fișier video de înaltă calitate, de înaltă rezoluție, adesea brut (necomprimat) sau comprimat, astfel încât să nu se distingă de fișierul brut.
Fișierele mezzanine sunt de obicei necesare în mediile care se bazează pe implementări de anunțuri pe partea de server . Aceste fișiere sunt folosite pentru a genera fișiere video de o calitate adecvată pentru platforma țintă, cum ar fi pentru mediile mobile sau pentru a realiza cusături publicitare.
Cumpărătorii care văd un cod de eroare 406 trebuie să se asigure că în răspunsul VAST este inclus un fișier mezzanin adecvat .
Eroare VAST 407: Fișierul Mezanine descărcat pentru prima dată
Codul de eroare 407 indică faptul că fișierul mezanin este descărcat și transcodat pentru prima dată , ceea ce provoacă o eșec la difuzarea unui anunț. Acest cod de eroare este așteptat și nu poate fi acționat; singura acțiune de remediere este să așteptați finalizarea procesului de transcodare .
În funcție de dimensiunea fișierului mezanin, acest proces poate dura câteva ore.
Eroare VAST 408: anunț respins în răspunsul VAST
Dacă vedeți codul de eroare VAST 408, acesta indică faptul că fișierul publicitar returnat în răspunsul VAST a fost respins .
Editorii trebuie să avertizeze cumpărătorii cu privire la eroarea 408 cât mai curând posibil, iar cumpărătorii trebuie să se asigure că răspunsurile VAST conțin numai reclame aprobate . Entitățile care acționează ca gazde de reclame publicitare (de exemplu, agenția de publicitate sau de publicare) ar trebui să fie, de asemenea, la curent cu orice respingere a anunțurilor pentru a lua măsurile corespunzătoare.
Eroare VAST 409: reclama interactivă definită în nodul InteractiveCreativeFile nu a fost executată
Cea mai probabilă cauză a unei erori VAST 409 este redarea eșecului reclamei definite de nodul Cumpărătorii trebuie să se asigure că toate reclamele interactive (de exemplu, o demonstrație care poate fi redată pentru un joc mobil) returnate în răspunsul VAST se joacă corect atunci când sunt solicitate.
Eroare VAST 410: Codul la care se face referire în nodul de verificare nu a fost executat
Erorile VAST 410 apar de obicei din cauza eșecului executării codului definit în nodul Cumpărătorii ar trebui să se asigure că codul AdVerification este funcțional și implementat corect.
Eroare VAST 500: Eroare generală NonLinearAds
Dacă se returnează acest cod de eroare, acesta indică de obicei că playerul video nu a reușit să afișeze un anunț neliniar din motive necunoscute .
Editorii pot încerca să remedieze codul de eroare verificând problemele playerului video , iar cumpărătorii ar trebui să verifice toate răspunsurile VAST pentru a se asigura că returnează reclame valide.
Eroare VAST 501: Dimensiunile reclamei publicitare neliniare nu se aliniază cu zona de afișare a reclamei
O eroare VAST 501 este de obicei rezultatul unei eșecuri în redarea unui anunț neliniar din cauza unei nepotriviri între dimensiunile reclamei (dimensiunea anunțului) și zona de afișare a reclamei (spațiul ecranului). Mai exact, eroarea 501 apare atunci când dimensiunile reclamei sunt prea mari pentru zona de afișare (cu alte cuvinte, anunțul este prea mare pentru ecran).
În cazuri mai rare, o eroare 501 poate fi declanșată de CSS configurat incorect , cum ar fi stilurile CSS care fixează înălțimea și lățimea elementului de conținut video.
Editorii pot remedia acest cod de eroare modificând înălțimea și lățimea setate ale reclamei pentru a se potrivi cu zona de afișare. Dacă editorul a setat dimensiunea elementului de conținut video folosind stiluri CSS, acțiunea recomandată este să folosești în schimb atribute HTML.
Eroare VAST 502: Imposibil de preluat NonLinearAds/NonLinear Resource
Cea mai frecventă cauză a unui cod VAST 502 este răspunsul unui cumpărător care returnează un anunț neliniar care nu a returnat o reclamă validă . Cumpărătorii trebuie să se asigure că toate răspunsurile la anunțuri neliniare returnează reclame valide.
Eroare VAST 503: Nu s-a putut găsi o resursă neliniară cu tipul acceptat
Editorii care solicită o dimensiune de reclamă mai mare decât dimensiunile playerului video pot întâlni un cod de eroare 503. Un tip de media nevalid poate duce la acest cod de eroare în cazuri mai rare.
Acțiunea de remediere recomandată este ca editorul să se asigure că toate dimensiunile și tipurile de materiale media solicitate sunt compatibile cu playerul video.
Eroare VAST 901: Eroare generală VPAID
O eroare 901 este un cod de eroare fatală generic pe care o poate provoca orice eroare VPAID. Cauzele posibile includ:
- Învelișul SSP VPAID a expirat
- Învelișul SSP VPAID nu se cumpără
- Reclamele VPAID necesită un mod nesecurizat
- Utilizarea unei etichete „Adaptor IMA” cu SDK-ul IMA (eticheta VAST corectă de utilizat este „Direct SDK”)
Editorii trebuie să se asigure că toate solicitările VPAID sunt acceptate pentru dispozitivele și playerele video țintă. Funcția de profil a reclamelor video Google vă poate ajuta să vă gestionați reclamele și să evitați acest cod de eroare.
Cumpărătorii pot examina răspunsurile VAST care returnează pachete HTML5 VPAID și se pot asigura că includ un material MP4 și nu întrerup redarea.
Codurile de eroare VAST comune potențial non-fatale și cum să le rezolvi
O eroare nefatală indică o problemă care poate să nu fi împiedicat afișarea anunțului. Cu toate acestea, abordarea cauzei erorii cât mai curând posibil este esențială pentru a asigura o performanță optimă și pentru a preveni erori mai grave. Iată câteva erori VAST nefatale frecvente:
Eroare VAST 200: Playerul video se aștepta la un tip de anunț diferit
O eroare VAST 200 apare de obicei atunci când playerul video nu acceptă sau nu așteaptă tipul de anunț solicitat într-o solicitare de licitație.
Un exemplu de tip de anunț neacceptat sunt anunțurile care se pot închide, trimise jucătorilor, care pot accepta numai anunțuri liniare.
Editorii pot rezolva acest cod de eroare verificând erorile de trafic . Dacă editorul nu poate rezolva problema, cumpărătorul trebuie să se asigure că răspunsurile VAST trimit numai anumite tipuri de anunțuri .
Eroare VAST 201: Playerul video se aștepta la o liniaritate diferită
Acest cod de eroare este cauzat de obicei de o nepotrivire a liniarității între solicitarea playerului video și răspunsul cumpărătorului . Un exemplu de nepotrivire a liniarității este un răspuns VAST care trimite un anunț neliniar atunci când solicitarea a specificat un anunț liniar.
Editorii trebuie să se asigure că solicitările de anunțuri specifică liniaritatea corectă, iar cumpărătorii trebuie să verifice că răspunsurile VAST includ numai liniaritatea specificată în solicitarea de anunț.
Eroare VAST 202: Playerul video a așteptat o durată diferită
Codul de eroare VAST 202 apare atunci când răspunsul returnează o reclamă cu o durată diferită de cea specificată . De exemplu, dacă durata specificată este de 30 de secunde, dar durata reală a fișierului MediaFile este de 45 de secunde, poate avea ca rezultat o eroare 202.
Editorii trebuie să configureze corect durata reclamei în Google Ad Manager , iar cumpărătorii trebuie să se asigure că răspunsul respectă durata maximă specificată pentru solicitare.
Eroare VAST 203: Playerul video se aștepta la o dimensiune diferită
Acest cod de eroare este cel mai frecvent cauzat de o incompatibilitate între MediaFiles returnate și dispozitivul țintă . De exemplu, trimiterea unei reclame cu o rată de biți mare către dispozitive mobile, chiar dacă aceste dispozitive sunt mai potrivite pentru rate de biți mai mici.
Cumpărătorii pot remedia o eroare 203 asigurându-se că toate răspunsurile VAST includ MediaFiles compatibile cu mai multe tipuri de dispozitive și tehnologii , inclusiv compatibilitatea cu rata de biți.
Eroare VAST 600: Eroare generală CompanionAds
Eroarea 600 este o eroare generică non-fatală cauzată de obicei de o problemă nespecificată cu anunțurile însoțitoare. Cel mai frecvent apare atunci când editorul nu poate afișa un anunț însoțitor fără un motiv specificat.
Pentru a rezolva acest cod de eroare, editorii pot încerca să verifice eventualele probleme de difuzare a anunțurilor , iar cumpărătorii trebuie să se asigure că răspunsurile VAST returnează fișiere de reclame valide.
Eroare VAST 601: Dimensiunile reclamei însoțitoare nu s-au aliniat cu zona de afișare însoțitoare
Acest cod de eroare apare de obicei atunci când dimensiunea unei reclame însoțitoare este prea mare pentru a se încadra în zona de afișare a anunțului însoțitor.
Editorii trebuie să se asigure că dimensiunea anunțului însoțitor solicitat (înălțimea și lungimea) se încadrează în dimensiunile unității de anunțuri.
Eroare VAST 602: Nu se poate afișa însoțitorul necesar
O eroare VAST 602 înseamnă că editorul nu a reușit să redă reclama însoțitoare returnată în răspunsul VAST corespunzător .
Acest cod de eroare este de obicei simptomul unei probleme de difuzare a anunțurilor , pe care editorii trebuie să o verifice și să o rezolve. Cumpărătorii ar trebui, de asemenea, să se asigure că răspunsul VAST returnează o reclamă validă.
Eroare VAST 603: Imposibil de preluat Resursa CompanionAds/Companion
Erorile masive 603 apar de obicei atunci când răspunsul cumpărătorului returnează o reclamă însoțitoare care nu a putut returna o reclamă validă . Cumpărătorul trebuie să verifice și să se asigure că toate răspunsurile la anunțurile însoțitoare returnează reclame valide.
Eroare VAST 604: nu s-a putut găsi resursa însoțitoare cu tipul acceptat
O eroare vastă 604 este de obicei rezultatul faptului că un editor solicită un tip de reclamă neacceptat pentru un spațiu publicitar însoțitor.
Pentru a rezolva acest cod de eroare, editorii trebuie să se asigure că spațiul publicitar însoțitor acceptă tipurile de reclame specificate.
Codurile de eroare VAST potențial fatale și non-fatale
Aceste coduri de eroare pot sau nu corespunde erorilor fatale.
Eroare VAST 900: Eroare VAST 2 (potențial nefatală)
Acest cod de eroare specific este cauzat de o eroare VAST 2 de orice tip , chiar dacă sunt solicitate versiuni VAST ulterioare (de exemplu, VAST 3) sau versiunea implicită a rețelei este VAST 3 sau o versiune ulterioară.
Pentru a rezolva acest cod de eroare, editorii ar trebui fie să înceapă să solicite VAST 3, fie să activeze VAST 3 în rețeaua lor . Cumpărătorii sunt sfătuiți să colaboreze cu editorul pentru depanare mai precisă.
Eroare fatală VAST 900: Eroare VAST 3 nedefinită
Acest cod de eroare este returnat atunci când a apărut o eroare VAST 3 necunoscută și a oprit solicitarea de anunț. Datorită naturii nespecifice a acestui cod de eroare, editorii și cumpărătorii sunt sfătuiți să lucreze împreună pentru a identifica problema exactă .
Cele mai bune practici pentru editori pentru a gestiona erorile
Deși cel mai bun mod de a evita codurile de eroare de orice tip este prevenirea condițiilor necesare pentru apariția unui cod de eroare, acestea sunt uneori inevitabile. Iată câteva dintre cele mai bune practici pe care trebuie să le urmeze editorii:
- Acordați o atenție deosebită codului de eroare . Multe erori pot fi rezolvate sau atenuate fără a contacta cumpărătorul, economisind o perioadă semnificativă de timp.
- Asigurați-vă că platformele Demand Side (DSP) au posibilitatea de a scana fiecare reclamă și de a rezolva potențialele probleme care pot cauza erori înainte de a difuza anunțul.
- Comunicați și colaborați cu DSP-urile, platformele de aprovizionare (SSP), rețelele publicitare și serverele de anunțuri pentru a îmbunătăți performanța reclamelor dvs.
Rezolvați codurile de eroare VAST cu CodeFuel
Înțelegerea naturii fiecărei erori VAST este esențială pentru a rezolva toate problemele potențiale de difuzare a anunțurilor și pentru a optimiza performanța reclamelor dvs. video .
Dacă aveți nevoie de asistență pentru rezolvarea erorilor VAST , CodeFuel vă poate ajuta. Echipa noastră de experți în anunțuri video și specialiști în generare de bani poate ajuta și rezolva orice cod de eroare VAST care poate apărea. Contactați-ne astăzi pentru mai multe informații.