常见 VAST 错误代码及其解决方法

已发表: 2022-09-04

根据Cisco Systems 编制的统计数据，互联网上所有已发布内容的 80% 以上是视频流量。 因此，视频广告是当今最重要的在线广告形式之一。

互联网上的大多数视频广告都必须遵守视频广告投放模板 (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 错误代码。今天与我们联系以获取更多信息。