本文將說明 VAST 錯誤代碼的成因,以及測試與排解 VAST 影片廣告問題的位置。VAST 錯誤的成因可能是廣告請求、廣告回應、影片播放器或網址本身發生問題。
您的網站放送多媒體廣告時,瀏覽器會使用 HTML、JavaScript 和 CSS 來顯示廣告。如果廣告包含影片,流程會稍微複雜一點。VAST XML 是一組用來描述廣告的資料。影片播放器會接收並讀取 VAST XML,以判斷系統播放的媒體檔案。接著,影片播放器會將訊息傳回廣告伺服器,回報是否有使用者觀看廣告,以及觀看時間長度。
測試影片廣告時,您可使用 Chrome 開發人員工具或任何第三方軟體,查看聯播網請求和回應,以便取得廣告相關資訊。
如果只想查看發送至 Ad Manager 影片廣告伺服器的影片請求,請使用 env=vp
篩選聯播網請求。
請求中會顯示下列內容:
iu
參數:表示 Ad Manager 聯播網代碼size
參數:表示請求的廣告大小
如果廣告請求中顯示非預期的內容,請與影片播放器的開發人員聯絡,以解決所有問題。
影片廣告回應必須是 VAST XML 檔案,這類檔案分為兩種類型:「內嵌」與「重新導向」。您可以在 XML 檔案中看出類型;內嵌 XML 檔案 (查看範例) 會列出實際的廣告素材,重新導向 XML 檔案 (查看範例) 則包含 VAST 廣告代碼 URI,該 URI 會連往其他重新導向網址,或最終導向內嵌檔案的網址。
廣告素材和媒體檔案
VAST XML 檔案中會顯示 <Creatives>
元素,該元素含有可供播放器選用的不同 <MediaFiles>
。如果播放器無法播放任何可用的媒體檔案,就無法對使用者放送廣告。在這種情況下,請與廣告投放專員或廣告素材供應方聯絡,索取播放器可以播放的媒體檔案版本。
追蹤事件
排解問題時,請務必確認 VAST XML 明確指定了要追蹤的事件。舉例來說,除非播放器使用 XML 中定義的事件向 Ad Manager 傳送訊息,否則 Ad Manager 無法得知使用者與廣告是否有互動。如果 XML 未指定「播放完畢」追蹤事件,Ad Manager 就無法追蹤使用者是否已看完廣告。
VAST XML 沒有任何內容
如果您的回應是沒有任何內容的 VAST 代碼,通常表示您的廣告伺服器中沒有能滿足廣告請求的可用廣告素材,或者沒有指定此類請求的廣告。如果您的播放器收到沒有任何內容的 VAST XML,您必須仔細檢查播放器發出的廣告請求,確認所請求的鍵/值、廣告單元和大小都正確無誤。您也可以查看 Ad Manager 中的指定目標,確認您要放送的委刊項與請求相符。
廣告素材顯示率
如果您發現程式碼調用次數總計與曝光總數相差了 25% 以上,很可能是因為廣告素材顯示率所導致。
廣告素材顯示率可能受以下情況影響:
- 使用者、網站或播放器發生延遲或當機
- 使用者在播放器有機會播放廣告前離開網頁
- 要求預先擷取
如果是因為無法預先擷取廣告所造成,則屬正常現象,您不需採取任何行動,如果是播放器和網站的問題,則應該調查並找出可行的解決方案。
影片錯誤的嚴重程度
在觸發某些錯誤的情況下,影片播放器仍然可以播放廣告。這些錯誤會歸類為「潛在的非嚴重」錯誤。其他的「嚴重」錯誤通常會導致影片播放器停止請求失敗的廣告,改為請求另一則廣告或繼續播放影片內容。實際行為會因為導入的影片播放器不同而有所差異。
可能停止請求廣告的嚴重錯誤。 | |
廣告仍可繼續播放的潛在非嚴重錯誤。 |
VAST 錯誤
100 VAST XML 剖析錯誤VAST 100 錯誤的可能原因
當買方回應的格式錯誤、買方回應是無效的 XML 文件,或重新導向 VAST 網址無法順利解決,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確認 VAST XML 格式正確,並包含一切必要的元素和屬性。詳情請參閱 IAB 發布的 VAST 規格。 |
VAST 101 錯誤的可能原因
當買方回應缺少 IAB 標準所規定的必要 XML 元素或屬性,或包含無法辨識的元素,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確認 VAST XML 格式正確,並包含一切必要的元素和屬性。詳情請參閱 IAB 發布的 VAST 規格。 |
VAST 102 錯誤的可能原因
當影片播放器不支援出價要求中指定的 VAST 版本,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保所傳送的回應中只包含支援的 VAST 版本。 |
VAST 200 錯誤的可能原因
當影片播放器並未預期或不支援出價要求所請求的廣告類型,就會導致這項潛在的非嚴重錯誤。舉例來說,播放器設為只支援線性廣告,系統卻傳回可略過廣告,或者「略過開始計費前的播放時長」超出預期。
建議採取的行動
發布商 | 檢查廣告投放錯誤或提醒買方。 |
買方 | 確保所傳送的回應中只包含指定的廣告類型,而且可略過線性廣告素材符合「略過開始計費前的播放時長」屬性。 |
VAST 201 錯誤的可能原因
當買方回應中的線性廣告與影片播放器發出的廣告請求不符,就會導致這項潛在的非嚴重錯誤。舉例來說,播放器請求的是線性廣告,系統卻在回應中傳送非線性廣告。*
建議採取的行動
發布商 | 確保廣告請求中指定的是正確的線性廣告。 |
買方 | 確保回應中只包含廣告請求所指定的線性廣告。 |
* Authorized Buyers RTB 只支援線性廣告。
VAST 202 錯誤的可能原因
當系統傳回的廣告素材時間長度與指定的時間不同,就會導致這項潛在的非嚴重錯誤。舉例來說,系統傳回的廣告素材時間長度為 30 秒,但是實際 MediaFile 的時間長度為 60 秒。
建議採取的行動
發布商 | 確保在 Ad Manager 中設定適當的廣告素材時間長度。 |
買方 | 確保回應中指定的時間長度上限符合廣告請求設定。 |
VAST 203 錯誤的可能原因
當買方傳回的 MediaFile 與發出出價要求的裝置不相容,就會導致這項潛在的非嚴重錯誤,通常在系統傳回高位元率廣告素材給行動裝置時發生。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保您的回應中包含與不同技術和裝置 (包括位元率) 均相容的 MediaFile。 |
VAST 300 錯誤的可能原因
這是一般包裝函式嚴重錯誤,您無法採取行動加以修正。
VAST 301 錯誤的可能原因
當 VAST 重新導向廣告代碼沒有在包裝函式元素中指定的逾時 (預設為 5 秒) 時限內傳回回應,就會導致這項嚴重錯誤。這可能包含請求錯誤,例如無效的 URI、無法連上 URI 或 URI 要求逾時,以及與 VAST URI 要求相關的安全問題或其他例外情形,也可能是因為連線極度延遲 (例如 3G),或單純是買方回應較慢。
建議採取的行動
發布商 | 透過 SDK 延長播放器逾時上限。 |
買方 | 確保能連上 VAST 重新導向 URI,而且沒有通訊協定方面的問題 (例如 HTTP 上代管並放送到 HTTPS 網站的回應)。 |
VAST 302 錯誤的可能原因
達到影片播放器所定義的包裝函式上限時,就會導致這項嚴重錯誤。這可能是因為收到太多包裝函式回應但沒有內置回應、發生串連的連環效應 (從一個聯播網跳到一個又一個的聯播網),或從影片備用廣告收到太多沒有內容的 VAST 回應。
建議採取的行動
發布商 | 透過 SDK 延長播放器包裝函式上限。 |
買方 | 確認 VAST 重新導向廣告代碼均不會再次重新導向其他聯播網。當影片播放器在系統傳回有效 MediaFile 前呼叫太多次重新導向廣告代碼,播放器可能會取消廣告請求。 |
VAST 303 錯誤的可能原因
當一或多個包裝函式後的 VAST 回應沒有傳回任何廣告,就會導致這項嚴重錯誤。這也包含來自影片備用廣告的無內容 VAST 回應。
在第三方廣告聯播網中,廣告供應率可能小於 100%。如果是的話,這是預期的錯誤。舉例來說,如果第三方預計 60% 的時間都會填入廣告,則預期的錯誤率就是 40%。
建議採取的行動
發布商 | 確保錯誤率與第三方聯播網的供應率一致。影片備用廣告可能有助於避免錯失曝光機會。 |
買方 | 確保傳回的出價不包含無內容的 VAST 回應,代管廣告素材的廣告客戶或代理商也沒有傳回無內容的回應。 |
VAST 400 錯誤的可能原因
當影片播放器無法顯示線性廣告,就會導致這項嚴重錯誤。這可能是因為 MediaFile 不是指定的影片檔案格式、瀏覽器限制了自動播放聲音的功能或其他不明原因。
建議採取的行動
發布商 | 檢查播放器是否有問題、允許播放器偵測是否啟用了限制自動播放功能,或提醒買方。 |
買方 | 確保 VAST 回應傳回有效的廣告素材。 |
VAST 401 錯誤的可能原因
當您無法從 MediaFile URI 中找到檔案,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保 VAST 回應中的所有 MediaFile URI 均傳回有效的影片廣告素材。 |
VAST 402 錯誤的可能原因
當擷取或播放 MediaFile 時發生問題,就會導致這項嚴重錯誤;可能的原因如下:
- IMA SDK 中的
loadVideoTimeout
設得太短。預設為 8 秒。 - 低頻寬,或網站不當導入會延緩 MediaFile 載入的競爭請求。
- 影片在行動裝置環境中自動播放 (因為原本應該是在使用者點擊後才播放,但有部分例外)。
- 在自動播放環境 (例如播放清單) 中顯示影片廣告,但未選取視窗 (可能是選取另一個分頁或將視窗最小化)。*
對於使用 IMA SDK 的播放器,影片備用廣告可能有助於避免錯失曝光機會。
建議採取的行動
發布商 | 透過 SDK 延長播放器逾時上限。 |
買方 | 確保 CDN 代管的任何廣告素材均在指定的媒體逾時時限內傳回。 |
* 只會發生於 Chrome 網路瀏覽器。
VAST 403 錯誤的可能原因
當 VAST 回應宣告所有可用 MediaFile (例如行動裝置上的 Flash 或 iOS 上的 WebM) 均不支援的 MIME 類型,就會導致這項嚴重錯誤。這可能表示系統試圖播放錯誤的廣告素材類型。
行動裝置上較常發生這種錯誤類型。
建議採取的行動
發布商 | 確保影片播放器的裝置和平台支援所請求的廣告素材格式或技術。舉例來說,VPAID 廣告素材的請求不應來自行動應用程式。 |
買方 | 確保傳回的一切廣告素材均符合出價要求中的影片格式。 |
VAST 405 錯誤的可能原因
當系統傳回包含錯誤的廣告素材,就會導致這項嚴重錯誤。廣告素材的故障原因包括 MIME 類型和影片檔案類型不符、廣告素材 CDN 上的 CORS 設定,或其他轉碼相關問題。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保所有廣告素材 MIME 類型和 CDN 設定正確無誤。 |
VAST 406 錯誤的可能原因
當傳回的 VAST 回應中沒有必要的 Mezzanine 檔案,就會導致這項嚴重錯誤。從伺服器端導入廣告的發布商通常需要 Mezzanine 檔案,也就是用來拼接廣告或產生適當品質影片檔案的原始高品質影片檔案。*
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保發布商請求廣告回應時,該回應中包含 Mezzanine 檔案。 |
* 這是 VAST 4 的一項功能。
VAST 407 錯誤的可能原因
當 Mezzanine 檔案是第一次下載,因此未放送廣告,就會導致這項嚴重錯誤。或是廣告素材因轉碼而錯過廣告插播時機,也可能導致這項錯誤。等到廣告素材可以插播廣告後,這項錯誤才會消失。*
建議採取的行動
這是影片轉碼過程中預期會發生的錯誤,因此不必採取任何行動。
* 這是 VAST 4 的一項功能。
VAST 408 錯誤的可能原因
當 VAST 回應中傳回的廣告遭到拒絕,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保您的 VAST 回應只會傳回已核准的廣告素材,或確保代管廣告素材的任何廣告客戶或代理商均瞭解廣告素材遭拒的情形。 |
VAST 409 錯誤的可能原因
當 InteractiveCreativeFile
節點中定義的廣告素材未執行,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 在接獲請求時,確保您回應中傳回的任何互動式廣告素材播放成功。 |
VAST 410 錯誤的可能原因
當 AdVerification
節點中參照的程式碼未執行,就會導致這項嚴重錯誤。*
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保回應中參照的驗證程式碼按照驗證廠商的指示正確導入。 |
* 這是 VAST 4 的一項功能。
VAST 500 錯誤的可能原因
當影片播放器因不明原因而無法顯示非線性廣告,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 檢查影片播放器是否有問題或提醒買方。 |
買方 | 確保 VAST 回應傳回有效的廣告素材。 |
VAST 501 錯誤的可能原因
當非線性廣告因廣告素材尺寸與廣告素材顯示區不符 (廣告素材尺寸太大) 而無法播放,就會導致這項嚴重錯誤。如果您使用 CSS 樣式設定影片內容元素的寬度和高度,就可能發生這項錯誤。
建議採取的行動
發布商 | 確保所設定的寬度和高度符合顯示區。如果您使用 CSS 樣式來設定影片內容元素的寬度和高度,請改用 HTML 屬性來設定。 |
買方 | 提醒發布商。 |
VAST 502 錯誤的可能原因
當買方回應包含無法傳回有效廣告素材的非線性廣告,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保非線性廣告回應傳回有效的廣告素材。 |
VAST 503 錯誤的可能原因
當發布商請求的廣告素材大小大於影片播放器尺寸,或請求無效的媒體類型,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 確保請求的是影片播放器可接受的廣告素材大小和媒體類型。 |
買方 | 提醒發布商。 |
VAST 600 錯誤的可能原因
當發布商因不明原因而無法顯示隨播廣告,就會導致這項潛在的非嚴重錯誤。
建議採取的行動
發布商 | 檢查廣告放送是否有問題或提醒買方。 |
買方 | 確保 VAST 回應傳回有效的廣告素材。 |
VAST 601 錯誤的可能原因
當隨播廣告素材尺寸超出隨播廣告顯示區大小,就會導致這項潛在的非嚴重錯誤。
建議採取的行動
發布商 | 確保請求的隨播廣告大小小於發出請求的廣告單元尺寸。 |
買方 | 提醒發布商。 |
VAST 602 錯誤的可能原因
當發布商無法顯示 VAST 回應中傳回的隨播廣告素材,就會導致這項潛在的非嚴重錯誤。
建議採取的行動
發布商 | 檢查廣告放送是否有問題或提醒買方。 |
買方 | 確保 VAST 回應傳回有效的廣告素材。 |
VAST 603 錯誤的可能原因
當買方回應包含無法傳回有效廣告素材的隨播廣告,就會導致這項潛在的非嚴重錯誤。
建議採取的行動
發布商 | 提醒買方。 |
買方 | 確保隨播廣告回應傳回的是有效的廣告素材。 |
VAST 604 錯誤的可能原因
當發布商為隨播廣告版位請求不支援的廣告素材類型,就會導致這項潛在的非嚴重錯誤。
建議採取的行動
發布商 | 確保隨播廣告版位支援指定的廣告素材類型。 |
買方 | 提醒發布商。 |
VAST 900 錯誤的可能原因
當發生任何 VAST 2 錯誤,即使系統請求 VAST 3 或您的聯播網預設為 VAST 3,仍會導致這項潛在的非嚴重錯誤。
建議採取的行動
發布商 | 改為請求 VAST 3 或為您的聯播網啟用 VAST 3。* |
買方 | 與發布商合作解決實際發生的問題,或傳回 VAST 3 回應。** |
* 報表會顯示多個 900 錯誤。這類 900 錯誤比 900 未定義的 VAST 3 錯誤更常見。
** 即時出價明細不會回報這類 900 錯誤,因為這多半不是嚴重錯誤。
如要瞭解即時出價明細回報的 900 錯誤,請參閱 900 未定義的 VAST 3 錯誤。
VAST 900 錯誤的可能原因
這項嚴重錯誤是由可能停止請求廣告的不明 VAST 3 錯誤所造成。
建議採取的行動
發布商 | 提醒買方。* |
買方 | 與發布商合作解決實際發生的問題。** |
* 報表會顯示多個 900 錯誤。這類 900 錯誤比 900 VAST 2 錯誤更少見。
** 在兩種 VAST 900 錯誤中,即時出價明細只會回報這種類型的錯誤。
VAST 901 錯誤的可能原因
這項嚴重錯誤可能是由任何 VPAID 錯誤所造成,可能原因如下:
- SSP VPAID 包裝函式未購買
- SSP VPAID 包裝函式逾時
- VPAID 廣告素材需要非安全模式
- Authorized Buyers「IMA 轉接程式」廣告代碼與 IMA SDK 搭配使用,並傳回 VPAID 廣告 (應使用「Direct SDK」廣告代碼)
建議採取的行動
發布商 | 確保裝置和播放器支援任何 VPAID 廣告素材請求。您可以使用影片廣告素材設定檔來控制哪些廣告素材有資格放送。 |
買方 | 確保從 IAS/DV/MOAT 傳回 HTML5 VPAID 包裝函式的任何 VAST 回應均包含 MP4 素材資源,而且包裝函式沒有取消播放。同時也請勿在未決定廣告客戶或買方的情況下針對曝光出價,或嘗試開始用戶端轉售。 |
VAST 1009 錯誤的可能原因
如果傳回的 VAST 回應中沒有影片檔案或追蹤事件,系統就會回報 VAST 1009 錯誤。這個錯誤的原因可能是發布商在廣告單元中的設定,或是訂單或委刊項的廣告投放錯誤。
建議採取的行動
發布商 | 確保訂單或委刊項的開始或結束日期沒有錯誤,且所有指定的鍵/值均為有效。此外,請確保已指定正確的廣告單元,而且委刊項中設定的大小與指定廣告單元的大小相符。 |
買方 | 提醒發布商。 |
IMA SDK 錯誤
這類錯誤不屬於 VAST 規格。
1005 網址格式錯誤1005 IMA SDK 錯誤的可能原因
當網址未成功編碼或解碼時,就會導致這項嚴重錯誤。
建議採取的行動
發布商 | 確認網址字串中的任何特殊字元都已正確編碼。 |
買方 | 提醒發布商。 |