この記事では、VAST エラーコードの原因と、VAST 動画広告のテストとトラブルシューティングを行う方法について説明します。VAST エラーは、広告リクエスト、広告レスポンス、動画プレーヤー、URL 自体の問題によって発生することがあります。
サイトにディスプレイ広告が配信されるとき、ブラウザでは HTML、JavaScript、CSS を使用して広告が表示されます。動画の場合は少し複雑になります。VAST XML は、広告について記述したデータの集まりです。動画プレーヤーは、VAST XML を受信して読み取り、再生するメディア ファイルを特定します。その後、広告サーバーにメッセージを送り返して、広告が視聴されたかどうかと視聴時間を報告します。
テスト済みの VAST タグのサンプルを使って、プレーヤーをテストすることもできます。
動画広告をテストする際は、Chrome デベロッパー ツールやサードパーティ ソフトウェアを使って、ネットワークのリクエストやレスポンスを確認し、広告に関する情報を取得できます。
env=vp を指定してネットワーク リクエストをフィルタし、アド マネージャーの動画広告サーバーに送信された動画リクエストのみを表示できます。
リクエスト内では、次のような情報を確認できます。
iuパラメータ（アド マネージャーのネットワーク コード）sizeパラメータ（リクエストされた広告サイズ）
広告リクエストで予期しない動作が発生した場合は、動画プレーヤーのデベロッパーにお問い合わせのうえ、問題を解決してください。
動画広告のレスポンスは、VAST XML ファイルでなければなりません。VAST XML ファイルには、インラインとリダイレクトの 2 種類があります。タイプは XML で確認できます。インライン XML ファイル（例）には、実際のクリエイティブがリストで表示されています。リダイレクト XML ファイル（例）には、追加のリダイレクトまたは最終的にインライン バージョンの URL にリンクする VAST 広告タグ URI が記述されています。
クリエイティブとメディア ファイル
VAST XML ファイルでは、<Creatives> 要素を使用できます。この要素には、プレーヤーが選択できるさまざまな <MediaFiles> を含める必要があります。プレーヤーで再生できるメディア ファイルがない場合、広告は再生されません。このような場合は、広告担当者またはクリエイティブの提供元に連絡し、プレーヤーで再生できるメディア ファイルをリクエストします。
イベントのトラッキング
トラブルシューティングを行う際は、トラッキングするイベントが VAST XML で明確に定義されていることをご確認ください。たとえば、アド マネージャーでは、プレーヤーから XML で定義されたイベントを使ってメッセージが送信されないと、ユーザーが広告を操作したかどうかを確認できません。XML で完全なトラッキング イベントが定義されていない場合、アド マネージャーではユーザーが広告視聴を完了したことをトラッキングできません。
空の VAST XML
レスポンスが空の VAST タグの場合は通常、広告リクエストに一致するクリエイティブが広告サーバーにないか、このタイプのリクエストをターゲットとする広告がないことを示します。プレーヤーに空の VAST XML が返される場合は、プレーヤーで適切な Key-Value、広告ユニット、サイズをリクエストしているか確認する必要があります。また、アド マネージャーでターゲット設定を確認し、配信する広告申込情報がリクエストと一致しているかどうかを確認してください。
クリエイティブのレンダリング率
合計コード配信数と合計インプレッション数に 25% を超える違いがある場合は、クリエイティブのレンダリング率が原因と考えられます。この問題は、ユーザー、サイト、またはプレーヤー側に遅延や問題が発生し、プレーヤーで広告が再生される前やプリフェッチがリクエストされる前に、ユーザーがページを離れた場合に発生します。
プリフェッチが原因の場合、これは想定される動作のため、対応は必要ありません。プレーヤーやサイト側に問題がある場合は、原因を調査して解決する必要があります。
動画エラーの重大度
動画プレーヤーでは、エラーが発生しても、広告はそのまま再生されることがあります。こうしたエラーは「致命的ではないと考えられる」エラーです。それ以外は「致命的」なエラーであり、検知された場合、通常その動画プレーヤーでは問題のある広告のリクエストを停止し、別の広告をリクエストするか、動画コンテンツの再生を再開します。この動作は、プレーヤーの実装方法によって異なります。
| 致命的なエラー（多くの場合、広告リクエストは停止されます）。 | |
| 致命的ではないと考えられるエラー（広告はそのまま再生される可能性があります）。 |
VAST エラー
VAST 100 エラーの推定原因
この致命的なエラーは、購入者のレスポンスの形式に問題があるか、有効な XML ドキュメントでない場合、またはリダイレクト VAST URL を正常に解決できない場合に発生します。
推奨される対処方法
| パブリッシャー | 購入者に通知します。 |
| 購入者 | VAST XML の形式が正しく、必須の要素と属性がすべて含まれていることを確認します。詳しくは、IAB の VAST 仕様をご覧ください。 |
VAST 101 エラーの推定原因
この致命的なエラーは、購入者のレスポンスに、IAB 標準規格が定める必須の XML 要素または属性が指定されていない、または認識できない要素が含まれている場合に発生します。
推奨される対処方法
| パブリッシャー | 購入者に通知します。 |
| 購入者 | VAST XML の形式が正しく、必須の要素と属性がすべて含まれていることを確認します。詳しくは、IAB の VAST 仕様をご覧ください。 |
VAST 102 エラーの推定原因
この致命的なエラーは、入札リクエストで指定された VAST バージョンを動画プレーヤーがサポートしていない場合に発生します。
推奨される対処方法
| パブリッシャー | 購入者に通知します。 |
| 購入者 | サポートされている VAST バージョンのみをレスポンスで送信していることを確認します。 |
VAST 200 エラーの推定原因
致命的でないと考えられるこのエラーは、入札リクエストで指定された広告タイプを動画プレーヤーが想定またはサポートしていない場合に発生します。たとえば、リニア広告のみを表示するよう設定されているプレーヤーにスキップ可能な広告が送信された場合や、スキップまでの再生時間が想定より長い場合などです。
推奨される対処方法
| パブリッシャー | 入稿に問題がないかどうか確認するか、購入者に通知します。 |
| 購入者 | 指定された広告タイプのみをレスポンスで送信していることと、スキップ可能なリニア クリエイティブで「スキップまでの再生時間」属性を遵守していることを確認します。 |
VAST 201 エラーの推定原因
致命的でないと考えられるこのエラーは、購入者のレスポンスに含まれるリニア特性が動画プレーヤーのリクエストと一致しない場合に発生します。たとえば、リニア広告のリクエストへのレスポンスでノンリニア広告が送信された場合などです*。
推奨される対処方法
| パブリッシャー | 広告リクエストでリニア特性を正しく指定していることを確認します。 |
| 購入者 | リクエストで指定されたリニア特性のみをレスポンスに含めていることを確認します。 |
*認定バイヤー RTB ではリニア広告のみがサポートされています。
VAST 202 エラーの推定原因
致命的でないと考えられるこのエラーは、返されたクリエイティブの再生時間が指定されたものと異なる場合に発生します。たとえば、返されたクリエイティブの再生時間が 30 秒で、実際の MediaFile の再生時間が 60 秒の場合などです。
推奨される対処方法
| パブリッシャー | アド マネージャーでクリエイティブの再生時間が適切に設定されていることを確認します。 |
| 購入者 | リクエストで指定された最大再生時間をレスポンスで遵守していることを確認します。 |
VAST 203 エラーの推定原因
致命的でないと考えられるこのエラーは、購入者から返された MediaFile が、入札リクエストの送信元のデバイスでサポートされていない場合に発生します。多いのは、高ビットレートのクリエイティブがモバイル デバイスに返されるケースです。
推奨される対処方法
| パブリッシャー | 購入者に通知します。 |
| 購入者 | 各種の技術やデバイス（ビットレートを含む）に適合する MediaFile をレスポンスに含めていることを確認します。 |
VAST 300 エラーの推定原因
この致命的なエラーは、一般的なラッパーエラーで対処方法はありません。
VAST 301 エラーの推定原因
この致命的なエラーは、ラッパー要素で指定されたタイムアウト時間（デフォルトでは 5 秒）内に VAST リダイレクト タグからレスポンスが返されなかった場合に発生します。無効な URI、URI にアクセス不能、URI のリクエストのタイムアウト、セキュリティの問題、VAST URI のリクエストに関するその他の例外など、リクエストに関するエラーが原因の場合もあります。また、接続の待ち時間が長い（3G の場合など）場合や、単純に購入者からのレスポンスが遅い場合にも発生します。
推奨される対処方法
| パブリッシャー | SDK でプレーヤーのタイムアウトの制限値を増やします。 |
| 購入者 | VAST リダイレクト URI がアクセス可能なことと、プロトコルに関する問題（HTTP でホストされているレスポンスを HTTPS サイトに送信しているなど）がないことを確認します。 |
VAST 302 エラーの推定原因
この致命的なエラーは、動画プレーヤーで定義されているラッパーの制限値に達した場合に発生します。インライン レスポンスのないラッパー レスポンスが大量に返されている、デイジー チェーンの循環ループが起きている（ネットワーク間で次々と中継が行われている）、または動画の代替で空の VAST レスポンスが大量に返されていることが原因です。
推奨される対処方法
| パブリッシャー | SDK でプレーヤーのラッパーの制限値を増やします。 |
| 購入者 | VAST リダイレクトで別のネットワークへの再リダイレクトが行われていないことを確認します。動画プレーヤーでは、有効な MediaFile が返される前に大量のリダイレクトが呼び出された場合、広告リクエストが中止されることがあります。 |
VAST 303 エラーの推定原因
この致命的なエラーは、1 つ以上のラッパーの後の 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 エラーの推定原因
この致命的なエラーは、使用可能なすべての MediaFile に対応していない MIME タイプが VAST レスポンスで宣言されている場合に発生します（モバイルで Flash、iOS で WebM など）。不適切なクリエイティブ タイプを再生しようとした可能性があります。
このエラータイプは、モバイルで比較的よく発生します。
推奨される対処方法
| パブリッシャー | 動画プレーヤーのデバイスおよびプラットフォームで表示可能なクリエイティブのフォーマットまたは技術をリクエストしていることを確認します。たとえば、モバイルアプリから VPAID クリエイティブをリクエストすることはできません。 |
| 購入者 | 入札リクエストで指定された動画フォーマットに一致するクリエイティブを返していることを確認します。 |
VAST 405 エラーの推定原因
この致命的なエラーは、問題のあるクリエイティブが返された場合に発生します。MIME タイプと動画ファイル形式が一致しない、またはクリエイティブの CDN での CORS 設定やトランスコードに問題があることが原因です。
推奨される対処方法
| パブリッシャー | 購入者に通知します。 |
| 購入者 | すべてのクリエイティブの MIME タイプと CDN の設定が正しいことを確認します。 |
VAST 406 エラーの推定原因
この致命的なエラーは、返された VAST レスポンスに必須のメザニン ファイルがない場合に発生します。パブリッシャーがサーバーサイドで広告を実装している場合は、通常、メザニン ファイルが必要となります。メザニン ファイルは未加工の高品質動画ファイルで、これをもとに広告や適切な品質の動画ファイルが生成されます*。
推奨される対処方法
| パブリッシャー | 購入者に通知します。 |
| 購入者 | パブリッシャーの指定に応じてレスポンスにメザニン ファイルを含めていることを確認します。 |
*これは VAST 4 の機能です。
VAST 407 エラーの推定原因
この致命的なエラーは、メザニン ファイルが初めてダウンロードされ、広告が配信されなかった場合に発生します。クリエイティブがトランスコード中のために広告挿入が失敗した場合にも発生します。クリエイティブが挿入可能になるまで、エラーは繰り返し表示されます*。
推奨される対処方法
これは動画のトランスコード中に想定されるエラーで、対処は必要ありません。
*これは 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 エラーよりも一般的です。
**RTB 解析のレポートには、ほとんどの場合、致命的でない警告であるこのタイプの 900 エラーは表示されません。
RTB 解析のレポートに表示される 900 エラーについては、900 未定義の VAST 3 エラーをご覧ください。
VAST 900 エラーの推定原因
この致命的なエラーは、不明な VAST 3 エラーの結果として発生します。多くの場合、広告リクエストは停止されます。
推奨される対処方法
| パブリッシャー | 購入者に通知します*。 |
| 購入者 | パブリッシャーとともに原因を究明して解決します**。 |
*レポートには 900 エラーが集約されて表示されます。このタイプの 900 エラーは、900 VAST 2 エラーと比べて一般的ではありません。
**2 つのタイプの VAST 900 エラーのうち、RTB 解析のレポートに記録されるのはこのタイプのみです。
VAST 901 エラーの推定原因
この致命的なエラーは、VPAID に関して次のいずれかの問題が起きた場合に発生します。
- SSP VPAID ラッパーで購入が行われなかった
- SSP VPAID ラッパーでタイムアウトが発生した
- VPAID クリエイティブでセキュアでないモードが要求された
- 認定バイヤーの「IMA アダプタ」タグを IMA SDK と併用している場合に、VPAID 広告が返された（「Direct SDK」タグを使用する必要があります）
推奨される対処方法
| パブリッシャー | デバイスおよびプレーヤーが VPAID クリエイティブのリクエストに対応していることを確認します。配信可能なクリエイティブを管理するには、動画クリエイティブ プロファイルを使用できます。 |
| 購入者 | IAS、DV、MOAT から HTML5 VPAID ラッパーを返す VAST レスポンスに MP4 アセットを含めていることと、そのラッパーによって再生が中止されていないことを確認します。また、広告主または購入者を決めずにインプレッションに入札したり、クライアント サイドの再販を開始しようとしたりしていないことも確認します。 |
VAST 1009 エラーの推定原因
VAST 1009 エラーは、返された VAST レスポンスに動画ファイルまたはトラッキング イベントが含まれていない場合に報告されます。パブリッシャーの広告ユニットの設定か、オーダーまたは広告申込情報の入稿に問題があることが原因と考えられます。
推奨される対処方法
| パブリッシャー | オーダーまたは広告申込情報の開始日と終了日に問題がなく、ターゲットに設定したすべての Key-Value が有効であることを確認します。また、ターゲットに設定した広告ユニットが正しく、広告申込情報で設定したサイズがターゲットに設定した広告ユニットのサイズと一致していることを確認します。 |
| 購入者 | パブリッシャーに通知します。 |
IMA SDK エラー
このエラーは、VAST 仕様には含まれません。
1005 IMA SDK エラーの推定原因
この致命的なエラーは、URL のエンコードまたはデコードに失敗した場合に発生します。
推奨される対処方法
| パブリッシャー | URL 文字列に含まれる特殊文字が正しくエンコードされていることを確認します。 |
| 購入者 | パブリッシャーに通知します。 |
