常見 VAST 錯誤代碼及其解決方法
已發表: 2022-09-04互聯網上的大多數視頻廣告都必須遵守視頻廣告投放模板 (VAST) 標準概述的規範,以確保功能和與視頻播放器的兼容性。 發布商通過 YouTube 和 Google AdSense 等 Google 平台製作視頻廣告時遇到的最常見問題之一是 VAST 錯誤代碼。
了解什麼是 VAST 錯誤代碼、最常見的錯誤代碼以及解決方法。
什麼是 VAST 錯誤?
視頻廣告服務模板錯誤代碼是互動廣告局 (IAB) 定義的眾多可能錯誤狀態之一。 VAST 錯誤表示託管廣告內容的服務器與目標消費者的視頻播放器之間存在問題,這可能會阻礙或阻止廣告的正常顯示。
錯誤的確切性質取決於顯示的代碼; 每個代碼對應一個已識別的問題。
在廣告技術中展示 VAST 廣告的常見挑戰
儘管從長遠來看,展示 VAST 廣告往往比視頻播放器-廣告界面定義 (VPAID) 等替代解決方案更易於實施且更具成本效益,但發布商面臨的主要挑戰是確保廣告可見度。
許多類型的技術問題經常會破壞 VAST 廣告的可見度和功能。 在許多情況下,由於不正確的配置設置而發生中斷,無論是在買方端還是在發布商端。 這些中斷以VAST 錯誤代碼的形式表現出來。
VAST 錯誤代碼分為兩個嚴重級別:致命錯誤和潛在的非致命錯誤。
常見的 VAST 致命錯誤代碼及其解決方法
致命的 VAST 錯誤代碼最為嚴重,因為它最有可能停止廣告請求,從而導致顯示中斷。 一些常見的 VAST 致命錯誤包括:
VAST 錯誤 100:XML 解析錯誤
VAST 錯誤 100 是最常見的致命錯誤之一。 VAST 錯誤 100 背後的潛在原因包括格式錯誤的買家響應或無效、損壞或格式不正確的 XML 文檔。 另一種可能性是 VAST URL 重定向問題,例如,當重定向無法正確解析時。
發現錯誤代碼 100 的發布商應提醒買家。 反過來,買方必須驗證 VAST 網址是否已正確配置,然後確保所有 VAST XML 文檔都可以正常工作,並且格式正確且屬性正確。
VAST 錯誤 101:架構驗證錯誤
當買方的響應缺少所需的 XML 元素或屬性或包含無法識別的元素時,通常會發生架構驗證錯誤。
解決錯誤 101 代碼的最佳方法是讓買家查閱 IAB 文檔,檢查 VAST XML 規範,並確保存在所有必需且格式正確的元素。
VAST 錯誤 102:不支持響應版本
當目標視頻播放器不支持出價請求的 VAST 版本時,會觸發此常見錯誤代碼。 如果交易所發送了錯誤的 VAST 版本,也可能會發生這種情況。
在極少數情況下,VAST 廣告可能未指定版本號。 在這種情況下,也可以認為是模式驗證錯誤。
要修復錯誤 102,買方必須確保響應僅包含受支持的 VAST 版本。
VAST 錯誤 300:包裝器錯誤
VAST 錯誤 300 是一般包裝錯誤。 當達到包裝器限制時觸發。
此錯誤代碼是不可操作的; 沒有解決方法。 但是,有一些補救措施可能會阻止錯誤 300 的顯示,例如定期檢查 VAST URI並確保它們都不會超時。
VAST 錯誤 301:已達到重定向超時
IAB 最初將錯誤代碼 301 定義為指示錯誤、無響應或超時的 VAST URI。 但是,廣告技術專家通常將錯誤 301 與高延遲(俗稱“滯後”)和糟糕或不穩定的互聯網連接聯繫起來。
錯誤 301 的潛在直接原因包括:
- 播放器超時設置太低(默認設置為 5)
- 錯誤的廣告素材尺寸(廣告尺寸)
- 無效的 URI
- VAST URI 超時
- 高延遲
- HTTP 到 HTTPS
- 網站優化不佳
VAST 錯誤 302:已達到包裝器限制
接收廣告的視頻播放器通常配置有自己的預定義包裝限制。 達到此限制是錯誤 302 代碼的最常見原因。
錯誤 302 通常是由於收到過多的包裝器響應而沒有內聯響應。 補救措施是讓發布者增加視頻播放器的包裝限制。
在極少數情況下,錯誤 302 是由菊花鏈引起的:在返回媒體文件之前循環或過多的 VAST 重定向,導致視頻播放器中止廣告請求。 在這種情況下,買方必須確保沒有 VAST 重定向指向另一個重定向。
VAST 錯誤 303:返回空 VAST 響應
錯誤代碼 303 表示 VAST 響應為空,通常是由於第三方包裝器中包含廣告請求。
與第三方網絡合作的買家和發布商必須檢查填充率,該填充率通常低於 100%。 例如,86% 的填充率意味著發生此錯誤的可能性為 14%。
要解決 VAST 錯誤 303,發布商應在 Google Ad Manager 中啟用後備功能。 按著這些次序:
- 登錄您的 Google Ad Manager 帳戶並打開信息中心。
- 單擊左側面板上的管理按鈕,導航到視頻,然後是視頻設置。
- 啟用視頻回退,然後單擊保存。
VAST 錯誤 400:一般線性錯誤
VAST 錯誤 404 通常是視頻播放器無法顯示線性廣告的結果。
無法展示線性廣告的最常見原因包括:
- 網絡瀏覽器限制自動播放(自動播放)有聲
- MediaFile 格式無效(例如,不是有效的視頻文件或錯誤指定的格式)
- 未知或未指定的來源
發現錯誤 400 的發布商應檢查視頻播放器問題並將播放器配置為檢測具有受限自動播放功能的瀏覽器。 如果這些措施不能解決問題,買方應檢查 VAST 響應並確保其返回有效的廣告素材。
VAST 錯誤 401:未找到媒體文件
如果您看到錯誤代碼 401,則表明MediaFile URI 未返回有效的視頻廣告素材或無法找到有效的視頻文件。
發現此錯誤代碼的發布商應盡快提醒買家,並且買家必須確保其所有 MediaFile URI 返回有效的視頻廣告素材。
VAST 錯誤 402:無法下載或 MediaFile URI 超時
VAST 錯誤 402 可能有多種原因。 以下四個問題最有可能:
- 文件的 IMA SDK 中loadVideoTimeout變量的值(以毫秒為單位)過低。 如果頁面加載時間超過此值,則廣告播放將被取消,可能會導致錯誤。
- 網站性能或優化不佳,導致加載時間延遲足以取消廣告播放
- 視頻文件在不打算以這種方式運行的移動環境中自動播放或嘗試自動播放(移動設備上的大多數視頻廣告應該是點擊播放,除非在特定情況下)
- 在 Google Chrome 瀏覽器上,在自動播放環境中顯示視頻廣告,儘管窗口不在焦點上(例如,最小化的窗口、選擇了不同的選項卡或當前處於活動狀態的另一個屏幕上的另一個程序)
儘管並非所有這些原因都有相應的補救措施,但對於發布商的推薦解決方案是檢查視頻播放器的超時限制並將loadVideoTimeout變量設置為更高的值。 默認值為 -1,對應 8 秒(8,000 毫秒)。
其他潛在的解決方案包括網站優化以實現更快的加載速度或調整視頻比特率以提高移動設備上的廣告服務性能。
VAST 錯誤 403:響應聲明所有媒體文件的 MIME 類型不受支持
此錯誤代碼是最常遇到的錯誤代碼之一,並且在移動設備上最常見。
錯誤代碼 403 表示 VAST 響應已為所有可用的 MediaFiles 聲明了一種或多種不受支持的多用途 Internet 郵件擴展 (MIME) 類型(例如,嘗試在移動設備上播放 Flash 內容)。 當嘗試播放錯誤的廣告素材類型時,也可能出現此錯誤代碼。
遇到此錯誤代碼時,發布商必須確保播放器的設備和操作系統支持廣告的文件格式和技術。 買方還必須驗證所有返回的廣告素材是否符合出價請求的視頻格式(例如,移動應用不應請求 VPAID 廣告素材)。
VAST 錯誤 405:媒體文件顯示錯誤
MediaFile 顯示錯誤 (VAST 405) 通常是由於廣告素材錯誤而發生的。 常見的故障類型包括:
- MIME 類型和視頻文件類型不匹配
- 創意 CDN 上的跨域資源共享 (CORS) 配置不正確
- 轉碼問題
要解決此問題,買家必須驗證所有創意 MIME 類型和 CDN 配置選項是否準確。
VAST 錯誤 406:缺少必需的夾層文件
錯誤 406 代碼的最常見原因是返回的 VAST 響應沒有所需的夾層文件。 夾層文件是一種高質量、高分辨率的視頻文件,通常是原始的(未壓縮的)或壓縮的,因此它與原始文件無法區分。
在依賴服務器端廣告實施的環境中通常需要夾層文件。 這些文件用於為目標平台生成適當質量的視頻文件,例如移動環境或執行廣告拼接。
看到錯誤代碼 406 的買家必須確保在 VAST 響應中包含適當的夾層文件。
VAST 錯誤 407:第一次下載夾層文件
錯誤代碼 407 表示第一次下載和轉碼夾層文件,導致無法投放廣告。 此錯誤代碼是預期的且不可操作; 唯一的補救措施是等待轉碼過程完成。

根據夾層文件的大小,此過程可能需要幾個小時。
VAST 錯誤 408:VAST 響應中的廣告被拒絕
如果您看到 VAST 錯誤代碼 408,則表明VAST 響應中返回的廣告文件已被拒絕。
發布商應盡快提醒買家注意 408 錯誤,並且買家必須確保 VAST 響應僅包含已獲批准的廣告素材。 作為廣告創意主辦方的實體(例如,廣告或出版機構)也應了解任何廣告被拒絕以採取適當行動。
VAST 錯誤 409:InteractiveCreativeFile 節點中定義的交互式廣告素材未執行
VAST 錯誤 409 最可能的原因是無法播放由視頻廣告的買方必須確保 VAST 響應中返回的任何交互式廣告素材(例如,可玩的移動遊戲演示)在請求時都能正確播放。
VAST 錯誤 410:驗證節點中引用的代碼未執行
VAST 錯誤 410 通常是由於未能執行買方應確保AdVerification代碼正常運行並正確實施。
VAST 錯誤 500:一般非線性廣告錯誤
如果返回此錯誤代碼,通常表示視頻播放器由於未知原因未能展示非線性廣告。
發布商可以嘗試通過檢查視頻播放器問題來修正錯誤代碼,買方應檢查所有 VAST 響應以確保它們返回有效的廣告素材。
VAST 錯誤 501:非線性廣告創意尺寸與創意展示區域不對齊
VAST 501 錯誤通常是由於廣告素材尺寸(廣告尺寸)和廣告素材顯示區域(屏幕空間)不匹配而無法播放非線性廣告的結果。 具體來說,當廣告素材尺寸對於顯示區域而言太大(換句話說,廣告對於屏幕而言太大)時,就會出現錯誤 501。
在極少數情況下,錯誤配置的 CSS可能會觸發錯誤 501,例如固定視頻內容元素高度和寬度的 CSS 樣式。
發布商可以通過更改廣告素材的設置高度和寬度以匹配顯示區域來糾正此錯誤代碼。 如果發布商已使用 CSS 樣式設置視頻內容元素的大小,則建議的操作是改用 HTML 屬性。
VAST 錯誤 502:無法獲取非線性廣告/非線性資源
VAST 502 代碼最常見的原因是買方響應返回的非線性廣告未能返回有效的廣告素材。 買方必須確保所有非線性廣告響應都返回有效的廣告素材。
VAST 錯誤 503:找不到具有支持類型的非線性資源
發布商請求的廣告素材尺寸大於視頻播放器的尺寸可能會遇到錯誤代碼 503。在極少數情況下,無效的媒體類型可能會導致此錯誤代碼。
建議的補救措施是讓發布商確保所有請求的廣告素材尺寸和媒體類型都與視頻播放器兼容。
VAST 錯誤 901:一般 VPAID 錯誤
錯誤 901 是任何 VPAID 錯誤都可能導致的通用致命錯誤代碼。 可能的原因包括:
- SSP VPAID 包裝程序已超時
- SSP VPAID 包裝器未購買
- VPAID 廣告素材需要不安全模式
- 將“IMA Adapter”標籤與 IMA SDK 一起使用(要使用的正確 VAST 標籤是“Direct SDK”)
發布商必須確保目標設備和視頻播放器支持所有 VPAID 請求。 Google 的視頻廣告素材配置文件功能可以幫助您管理廣告素材並避免出現此錯誤代碼。
買家可以檢查返回 HTML5 VPAID 包裝器的 VAST 響應,並確保它們包含 MP4 資產並且不會中止播放。
常見的潛在非致命 VAST 錯誤代碼以及如何解決它們
非致命錯誤表示可能未阻止廣告展示的問題。 但是,盡快解決錯誤原因對於確保最佳性能和防止更嚴重的錯誤至關重要。 以下是一些常見的非致命 VAST 錯誤:
VAST 錯誤 200:視頻播放器需要不同的廣告類型
當視頻播放器不支持或不期望出價請求中請求的廣告類型時,通常會發生 VAST 錯誤 200。
不支持的廣告類型的一個示例是發送給僅支持線性廣告的播放器的可跳過廣告。
發布商可以通過檢查廣告投放管理錯誤來解決此錯誤代碼。 如果發布商無法解決問題,買方必須確保 VAST 響應僅發送指定的廣告類型。
VAST 錯誤 201:視頻播放器需要不同的線性度
此錯誤代碼通常是由視頻播放器的請求和買家的響應之間的線性不匹配引起的。 線性不匹配的一個示例是 VAST 響應在請求指定線性廣告時發送非線性廣告。
發布商應確保廣告請求指定正確的線性度,買方應驗證 VAST 響應僅包含廣告請求中指定的線性度。
VAST 錯誤 202:視頻播放器預期的持續時間不同
當響應返回的廣告素材的持續時間與指定的不同時,就會出現 VAST 錯誤代碼 202。 例如,如果指定的持續時間是 30 秒,但 MediaFile 的實際持續時間是 45 秒,則可能會導致錯誤 202。
發布商必須在 Google Ad Manager 中正確配置廣告素材持續時間,買方必須確保響應符合請求指定的最長持續時間。
VAST 錯誤 203:視頻播放器預期大小不同
此錯誤代碼最常見的原因是返回的 MediaFiles 與目標設備不兼容。 例如,將具有高比特率的廣告素材發送到移動設備,即使這些設備更適合低比特率。
買家可以通過確保所有 VAST 響應包含與多種類型的設備和技術(包括比特率兼容性)兼容的媒體文件來糾正錯誤 203。
VAST 錯誤 600:一般隨播廣告錯誤
錯誤 600 是一般的非致命錯誤,通常由隨播廣告的未指明問題引起。 最常見的情況是發布商無緣無故無法展示隨播廣告。
為了解決此錯誤代碼,發布商可以嘗試檢查潛在的廣告投放問題,並且買方應確保 VAST 響應返回有效的廣告文件。
VAST 錯誤 601:伴隨廣告素材尺寸未與伴隨顯示區域對齊
當隨播廣告的尺寸太大而無法放入隨播廣告的展示區域時,通常會出現此錯誤代碼。
發布商應確保請求的隨播廣告的尺寸(高度和長度)適合廣告單元的尺寸。
VAST 錯誤 602:無法顯示所需的隨播廣告
VAST 錯誤 602 表示發布商未能呈現相應 VAST 響應中返回的隨播廣告素材。
此錯誤代碼通常是廣告投放問題的症狀,發布商必須檢查並解決該問題。 買方還應確保 VAST 響應返回有效的廣告素材。
VAST 錯誤 603:無法獲取隨播廣告/隨播資源
Vast 錯誤 603 通常發生在買方的響應返回無法返回有效廣告的隨播廣告時。 買方必須檢查並確保所有隨播廣告響應都返回有效的廣告素材。
VAST 錯誤 604:找不到支持類型的伴隨資源
Vast 錯誤 604 通常是發布商為隨播廣告位請求不受支持的廣告素材類型的結果。
要解決此錯誤代碼,發布商必須確保隨播廣告位支持指定的廣告素材類型。
潛在致命和非致命 VAST 錯誤代碼
這些錯誤代碼可能對應於致命錯誤,也可能不對應。
VAST 錯誤 900:VAST 2 錯誤(可能非致命)
此特定錯誤代碼是由任何類型的 VAST 2 錯誤引起的,即使請求更高版本的 VAST(例如 VAST 3)或者您的網絡默認版本是 VAST 3 或更高版本也是如此。
要解決此錯誤代碼,發布商應開始請求 VAST 3 或在其網絡上激活 VAST 3 。 建議買家與發布商合作進行更具體的故障排除。
VAST 致命錯誤 900:未定義的 VAST 3 錯誤
當發生未知的 VAST 3 錯誤並停止廣告請求時,將返回此錯誤代碼。 由於此錯誤代碼的非特定性質,建議發布商和買方共同確定確切的問題。
發布者處理錯誤的最佳實踐
儘管避免任何類型的錯誤代碼的最佳方法是防止發生錯誤代碼所需的條件,但它們有時是不可避免的。 以下是一些供發布商遵循的最佳做法:
- 密切注意錯誤代碼編號。 許多錯誤可以在不聯繫買方的情況下解決或減輕,從而節省大量時間。
- 確保需求方平台 (DSP)有機會在投放廣告之前掃描每個創意並解決潛在的錯誤問題。
- 與您的DSP、供應方平台 (SSP)、廣告網絡和廣告服務器溝通和合作,以提高您的廣告素材的性能。
使用 CodeFuel 解決 VAST 錯誤代碼
了解每個 VAST 錯誤的性質對於解決所有潛在的廣告投放問題和優化視頻廣告的效果至關重要。
如果您需要幫助解決 VAST 錯誤,CodeFuel 可以提供幫助。 我們的視頻廣告專家和獲利專家團隊可以協助解決可能出現的任何 VAST 錯誤代碼。 今天與我們聯繫以獲取更多信息。