翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# MediaTailor 広告スキップのトラブルシューティングガイド
広告スキップは、MediaTailor のお客様が報告する最も一般的な問題の 1 つです。このガイドは、広告スキップの問題を特定し、step-by-stepトラブルシューティング手順を提供するのに役立ちます。
## 症状と影響
広告スキップが発生すると、次の症状が発生することがあります。
+ 予想される広告時間枠中に広告が表示されない
+ 広告ブレークは広告ではなくコンテンツを表示します
+ 異なる視聴セッション間での広告再生の不整合
+ さまざまなスキップ理由を持つ`AdSkipped`イベントを示す CloudWatch ログ
広告をスキップすると、収益に直接影響し、視聴者のエクスペリエンスが低下する可能性があります。これらの問題に迅速に対処して、最適なパフォーマンスを維持します。
## スキップ理由の特定
CloudWatch Logs Insights を使用して、スキップされた広告の`MediaTailor/AdDecisionServerInteractions`ロググループをクエリします。
```
fields @timestamp, avail.availId, skippedAds.0.skippedReason, skippedAds.0.creativeUniqueId
| filter eventType = "FILLED_AVAIL" and ispresent(skippedAds.0.skippedReason)
| sort @timestamp desc
```
このクエリは、パターンの特定に役立つ特定の理由を含む最新の広告スキップイベントを返します。
**Topics**
+ [症状](#ad-skipping-symptoms)
+ [スキップ理由](#identifying-skip-reasons)
+ [NEW\$1CREATIVE スキップ](troubleshooting-new-creative-skipping.md)
+ [ADS タイムアウトのスキップ](troubleshooting-ads-timeout-skipping.md)
+ [VAST 解析のスキップ](troubleshooting-vast-parsing-skipping.md)
+ [期間不一致のスキップ](troubleshooting-duration-mismatch-skipping.md)
+ [セッション変数のスキップ](troubleshooting-session-variables-skipping.md)
+ [広告スキップのモニタリング](monitoring-ad-skipping-issues.md)
+ [防止のベストプラクティス](preventing-ad-skipping-best-practices.md)
+ [参考資料](ad-skipping-reference-materials.md)
# MediaTailor NEW\$1CREATIVE 広告スキップのトラブルシューティング
広告が`NEW_CREATIVE`理由とともにスキップされると、 は挿入前にトランスコードを必要とする広告 AWS Elemental MediaTailor を検出しました。このトラブルシューティングガイドでは、原因について説明し、step-by-step解決手順を示します。
## NEW\$1CREATIVE スキップの原因
MediaTailor は、クリエイティブ ID、AWS アカウント ID、トランスコードバリアントセット (基盤となるコンテンツストリームの再生レンディション) の 3 つの主要な要因に基づいて広告をトランスコードします。クリエイティブ ID またはトランスコードバリアントセットの一部が異なる場合、MediaTailor は広告をトランスコードを必要とする新しいバリアントとして認識します。
### ビットレートの変更
ビットレートが変更されると、最も近い 8,000 ビットに四捨五入した後にビットレートが一致しない場合、NEW\$1CREATIVE がスキップされる可能性があります。これは通常、以下の状況で発生します。
+ 基盤となるコンテンツストリームがプライマリマニフェストを変更する
+ 新しいセッションは、既存のセッションとは異なるバリアントで作成されます。
+ コンテンツストリームのビットレートが再生セッション間で一貫性がない
#### ジョブ帯域幅分散の収集
収集ジョブの場合、MediaTailor は広告をコンテンツストリームに一致させるときに 15% の帯域幅分散しきい値を使用します。ライブストリームの帯域幅と収集された HLS ファイルの帯域幅に 15% 以上の差がある場合、広告は再度トランスコードされます。これにより、トランスコードプロセス中に NEW\$1CREATIVE がスキップされる可能性があります。
この動作は、一般的に次の場合に発生します。
+ ライブストリーミングと VOD コンテンツの両方で同じトランスコード済み広告が使用されます
+ 収集されたコンテンツには、元のライブストリームとは異なるエンコードパラメータがあります
+ 帯域幅の差がライブコンテンツと収集コンテンツ間の 15% のしきい値を超えている
### クリエイティブ ID の競合
MediaTailor が、既にトランスコードされたメディアファイルの別のクリエイティブ ID を検出すると、次のシーケンスが発生します。
1. 広告は理由 NEW\$1CREATIVE でスキップされます
1. これにより、不要なトランスコーディングが試行されます。
1. クリエイティブが DUPLICATE\$1TRANSCODE または COPY\$1DEDUP としてマークされている
**注記**
MediaTailor は、トランスコードされた広告を有効期限切れにしたり削除したりしません。これらは MediaTailor 所有の S3 バケットに無期限に保存されます。
## 解決の手順
NEW\$1CREATIVE 広告スキップの問題を解決するには:
1. 広告決定サーバーが同じ広告コンテンツに対して一貫したクリエイティブ IDs を返すことを確認します。
1. コンテンツストリームが一貫したビットレートとバリアントセットを維持していることを確認します。
1. 再生前に広告がトランスコードされるように、広告プリフェッチの実装を検討してください。詳細については、「[広告のプリフェッチ](prefetching-ads.md)」を参照してください。
1. 永続的な問題については、[AWS サポート](https://aws.amazon.com/premiumsupport/)にお問い合わせください。
## NEW\$1CREATIVE パターンのモニタリング
この CloudWatch Logs Insights クエリを使用して、NEW\$1CREATIVE 広告スキップのパターンを分析します。
```
fields @timestamp, sessionId, creativeId, skipReason, MediaFileSourceUrl
| filter skipReason = "NEW_CREATIVE"
| stats count() by creativeId, MediaFileSourceUrl
| sort count desc
| limit 50
```
# MediaTailor ADS タイムアウト広告スキップのトラブルシューティング
広告が `ADS_TIMEOUT`または関連する理由でスキップされると、広告決定サーバーとの接続またはパフォーマンスの問題が発生します。広告を正常に挿入するには、ADS との信頼性の高い通信 AWS Elemental MediaTailor が必要です。このトラブルシューティングガイドでは、これらの接続の問題を特定して解決する方法について説明します。
## ADS 接続に関する一般的な問題
ADS 接続に関する一般的な問題は次のとおりです。
+ MediaTailor から広告決定サーバーにアクセスできない
+ 設定されたタイムアウト期間内に ADS が応答しない
+ ADS がピーク期間中にリクエストボリュームを処理できない
+ MediaTailor と ADS 間のネットワーク接続の問題
## 解決の手順
ADS タイムアウトの問題を解決するには:
1. MediaTailor から広告決定サーバーにアクセスできることを確認します。
1. 設定したタイムアウト期間内に ADS が応答することを確認します。
1. ADS がピーク期間中にリクエストボリュームを処理できることを確認します。
1. プライマリ ADS が使用できない場合のフォールバック広告戦略の実装を検討してください。
## ADS パフォーマンスのモニタリング
`AdDecisionServer.Timeouts` メトリクスの CloudWatch アラームを設定して、ADS 接続の問題を積極的に検出します。
# MediaTailor VAST 解析広告スキップのトラブルシューティング
`VAST_PARSING_ERROR` または で広告をスキップすると`MEDIA_FILE_UNAVAILABLE`、VAST レスポンスまたは広告メディアファイルに問題が発生します。広告挿入を成功させるには、適切にフォーマットされた VAST レスポンスとアクセス可能なメディアファイル AWS Elemental MediaTailor が必要です。このトラブルシューティングガイドでは、これらの問題を特定して解決する方法について説明します。
## VAST の一般的な問題
VAST の一般的な問題は次のとおりです。
+ VAST レスポンス形式が VAST 仕様に準拠していない
+ VAST レスポンスのメディアファイル URLsパブリックにアクセスできない
+ VAST XML で正しくエンコードされていない特殊文字
+ VAST レスポンスに必要なメディアファイルまたは形式がありません
## 解決の手順
VAST 解析の問題を解決するには:
1. VAST レスポンス形式を VAST 仕様と照合して検証します。
1. VAST レスポンス内のすべてのメディアファイル URLsがパブリックにアクセス可能であることを確認します。
1. VAST XML で特殊文字が適切にエンコードされていることを確認します。
1. VAST レスポンスに MediaTailor と互換性のある形式のメディアファイルが含まれていることを確認します。
## VAST ラッパーのトラブルシューティング
`INVALID_VAST_WRAPPER_AD` または の問題の場合`REJECTED_REPLICA_VAST`:
+ VAST ラッパーレスポンスを VAST 仕様と照合して検証する
+ すべてのラッパー要素が適切にフォーマットされ、有効な VASTAdTagURI が含まれていることを確認します。
+ 重複コンテンツ検出ポリシーの広告サーバー設定を確認する
+ VAST レスポンスに同じセッション内の一意のクリエイティブコンテンツが含まれていることを確認する
# MediaTailor 期間不一致広告スキップのトラブルシューティング
`AVAIL_DURATION_EXCEEDED`、、`LEFTOVER_AVAIL_EXCEEDED_THRESHOLD`または形式関連の理由で広告をスキップする場合、期間または形式の互換性の問題があります。 には、広告コンテンツと利用可能な広告時間枠間の適切な期間フォーマットとマッチング AWS Elemental MediaTailor が必要です。このトラブルシューティングガイドでは、これらの期間関連の問題を特定して解決する方法について説明します。
## 一般的な期間の問題
一般的な期間の問題は次のとおりです。
+ 利用可能な広告時間枠よりも長い広告
+ コンテンツシグナリングの広告時間枠マーカーが間違っている
+ 広告挿入のパーソナライゼーションしきい値が満たされていない
+ EXT-X-CUE-OUT タグの期間形式が正しくない
## 期間形式の要件
EXT-X-CUE-OUT タグ期間パラメータは、ISO 8601 期間形式ではなく整数値としてフォーマットする必要があります。
**期間形式の要件**
| 形式 | 例 | ステータス |
| --- | --- | --- |
| 整数 (正しい) | 32 | サポート - 32 秒を表します |
| 10 進数 (正しい) | 30.000 | サポート - 30 秒を表します |
| ISO 8601 (誤) | PT32S | サポートされていない - 挿入が失敗する |
## 解決の手順
期間不一致の問題を解決するには:
1. ADS が利用可能な広告時間枠期間内に収まる広告を返すことを確認します。
1. コンテンツ内の広告ブレークマーカーが意図した期間を正しく通知していることを確認します。
1. EXT-X-CUE-OUT 期間パラメータが整数形式を使用していることを確認します。
1. ユースケースに適した場合は、パーソナライゼーションのしきい値を調整することを検討してください。
# MediaTailor セッション変数の広告スキップのトラブルシューティング
セッション変数は、広告のターゲティングと選択において重要な役割を果たします AWS Elemental MediaTailor。セッション変数の設定が正しくないことは、広告スキップの問題の一般的な原因です。この包括的なトラブルシューティングガイドでは、広告挿入の成功を妨げるセッション変数の問題を特定して解決する方法について説明します。
## セッション変数の一般的な問題
一般的なセッション変数の問題には、次のようなものがあります。
+ **必須変数の欠落**: 広告決定サーバーには、指定されていない特定の変数が必要になる場合があります。
+ **変数構文が正しく**ない: 変数は正しい構文を使用する必要があります (たとえば、 `[session.id]`ではなく)`${session.id}`。
+ **URL エンコードの問題**: 変数値の特殊文字には、適切な URL エンコードが必要になる場合があります。
+ **プレイヤーパラメータの不整合**: プレイヤーパラメータはセッション間で一貫して渡す必要があります。
+ **動的変数解決の失敗**: 解決できない変数は空の文字列に置き換えられます。
+ **SCTE-35 UPID 解析の問題**: セグメンテーション UPID 処理の問題により、セッション変数の解決に失敗する可能性があります。
## セッション変数の解決の検証
セッション変数が適切に解決されていることを確認するには:
1. MediaTailor 設定のデバッグログ記録を有効にする
1. 実際の ADS リクエスト URL の`MediaTailor/AdDecisionServerInteractions`ロググループを確認する URLs
1. テンプレート URL 内のすべての変数が適切な値に置き換えられていることを確認します。
1. 解決の失敗を示している可能性のある空の文字列に置き換えられた変数を探します。
## SCTE-35 UPID 解析のトラブルシューティング
SCTE-35 セグメンテーション UPID 処理に関する問題は、セッション変数の問題を引き起こす可能性があります。
+ **形式要件:** UPID は 12 `segmentation_upid_type`で、適切な処理`format_identifier`のために を含める必要があります
+ **解析ルール:** デコードされた UPID には、複数の値のコロン区切り文字を含めることができます。テンプレート変数とデコードされた UPID トークンの数は等しくなければなりません
+ **無効な形式:** 解析の失敗の原因となるため、値のない二重コロン (例: `::`または `:46175218::4053`) は避けてください。
# MediaTailor 広告スキップのモニタリングとアラート
プロアクティブモニタリングは、収益に大きな影響を与える前に広告スキップの問題を検出して解決するのに役立ちます。 は、広告挿入パフォーマンスの効果的なモニタリングを可能にする包括的なメトリクスとログ記録機能 AWS Elemental MediaTailor を提供します。このガイドでは、広告スキップの問題に対する効果的なモニタリングを設定する方法について説明します。
## モニタリングする主要な CloudWatch メトリクス
これらの主要な MediaTailor メトリクスの CloudWatch アラームを設定します。
+ `AdDecisionServer.Ads.Skipped` - スキップされた広告の数
+ `AdDecisionServer.Timeouts` - ADS タイムアウトの数
+ `Avail.FilledDuration` - 埋められた広告時間枠の期間
+ `Avail.SlateOnly` - スレートのみで満たされた広告時間枠の数
## 高度な CloudWatch Logs Insights クエリ
詳細なトラブルシューティングには、次の特殊なクエリを使用します。
### 包括的なセッション分析
特定のセッションの広告挿入動作の詳細な分析:
```
fields @timestamp, sessionId, eventType, creativeId, skipReason, adBreakIndex
| filter sessionId = "your-session-id-here"
| filter eventType in ["FILLED_AVAIL", "SKIPPED_AVAIL", "MAKING_ADS_REQUEST"]
| sort @timestamp asc
| limit 100
```
### クリエイティブ IDs の検索
FILLED\$1AVAIL イベントからクリエイティブ IDs を識別するには:
```
fields @timestamp, sessionId, eventType
| filter sessionId like /sessionId/ and eventType!='BEACON_FIRED'
| sort @timestamp desc
```
**注記**
を、調査している実際のセッション ID `sessionId`に置き換えます。
# MediaTailor 広告スキップ防止のベストプラクティス
これらのベストプラクティスを実装することで、広告スキップの問題が発生する前に防止し、広告挿入のパフォーマンスと収益保護を強化できます AWS Elemental MediaTailor。これらのプロアクティブメジャーは、広告スキップの最も一般的な原因に対処し、一貫した広告配信を維持するのに役立ちます。
## プロアクティブメジャー
+ **広告プリフェッチの実装**: MediaTailor のプリフェッチ機能を使用して、再生前に広告がトランスコードされるようにします。実装の詳細については[広告のプリフェッチ](prefetching-ads.md)、「」を参照してください。
+ **一貫したクリエイティブ IDs を維持する**: 広告決定サーバーがセッション間で同じ広告コンテンツに対して一貫したクリエイティブ IDs を使用していることを確認する
+ **適切な期間フォーマットを確認する**: ISO 8601 形式の代わりに EXT-X-CUE-OUT 期間パラメータに整数値を使用する
+ **VOD 最適化を設定する**: 複数の広告ブレークを持つ VOD ストリームに maxConcurrentAdsRequests を設定し、サーバーの負荷を軽減します
+ **ADS パフォーマンスの最適化**: 迅速に応答し、ピークトラフィック量を処理するように広告決定サーバーを設定する
## 実装ガイドライン
+ **適切なエラー処理を実装**する: 広告を挿入できない場合に広告時間枠を埋めるようにスレートコンテンツを設定する
+ **徹底的にテスト**する: さまざまなデバイスやネットワーク条件にわたって広告挿入ワークフローを検証する
+ **フォールバック戦略の実装**: プライマリ広告ソースが失敗した場合のバックアップ広告ソースまたはデフォルト広告の設定
+ **トランスコードパターンのモニタリング**: CloudWatch ログのトランスコード効率をモニタリングし、トランスコードの問題を示すパターンに気付いた場合は [AWS サポート](https://aws.amazon.com/premiumsupport/)にお問い合わせください。
# MediaTailor 広告スキップリファレンスガイド
このセクションでは、広告スキップの理由に関する包括的なリファレンス情報と、 の関連ドキュメントへのリンクを提供します AWS Elemental MediaTailor。このリファレンスガイドを使用して、さまざまなスキップ理由の具体的な意味を理解し、追加のトラブルシューティングリソースを見つけます。
## 広告スキップ理由のリファレンスを完了する
MediaTailor は、ロググループからの`FILLED_AVAIL`イベントログメッセージで広告がスキップされる特定の理由を`MediaTailor/AdDecisionServerInteractions`ログに記録します。
**広告スキップの理由を完了する**
| 理由のスキップ | 説明 |
| --- | --- |
| NEW\$1CREATIVE | 広告はまだトランスコードされていません。これは、MediaTailor が挿入前にトランスコードを必要とする新しい広告クリエイティブに遭遇した場合に発生します。 |
| PROFILE\$1NOT\$1FOUND | セッションの設定に関連付けられた MediaConvert トランスコードプロファイルが存在しないため、広告の準備ができません。 |
| TRANSCODE\$1ERROR | 広告トランスコードプロセスでエラーが発生し、完了できませんでした。 |
| TRANSCODE\$1IN\$1PROGRESS | 広告トランスコードはまだ進行中であり、挿入する準備ができていません。 |
| INTERNAL\$1ERROR | 広告の処理中に内部 MediaTailor エラーが発生し、挿入が妨げられました。 |
| AVAIL\$1DURATION\$1EXCEEDED | 広告が広告時間枠の残りの期間に収まらない。 |
| LEFTOVER\$1AVAIL\$1EXCEEDED\$1THRESHOLD | 挿入された可能性のあるすべての広告の累積期間は、セッション用に設定されたパーソナライゼーションしきい値を満たしていません。 |
| VAST\$1PARSING\$1ERROR | 広告決定サーバーからの VAST レスポンスにエラーが含まれているか、形式が正しくありません。 |
| ADS\$1TIMEOUT | 広告決定サーバーが設定されたタイムアウト期間内に応答しませんでした。 |
| MEDIA\$1FILE\$1UNAVAILABLE | VAST レスポンスで指定された広告メディアファイルにアクセスできません。 |
| SESSION\$1INITIALIZATION\$1FAILED | MediaTailor セッションは、多くの場合、セッション変数が正しくないため、正しく初期化できませんでした。 |
| EARLY\$1CUE\$1IN | 広告ブレークは、早期のキューインシグナルが原因で予想よりも早く終了し、広告が完全に挿入されなくなりました。 |
| NO\$1VARIANT\$1MATCH | 広告クリエイティブには、コンテンツストリームのエンコードパラメータ (ビットレート、解像度、コーデック) に一致するバリアントがありません。 |
| NO\$1MODEL\$1CREATIVE\$1MATCH | 広告クリエイティブが、現在の再生設定で予想されるモデルまたは形式の要件と一致しません。 |
| REJECTED\$1REPLICA\$1VAST | レプリカまたは重複するコンテンツ検出ポリシーにより、VAST レスポンスが拒否されました。 |
| INVALID\$1VAST\$1WRAPPER\$1AD | VAST ラッパー広告には、広告挿入の成功を妨げる無効なラッパー要素または不正な形式のラッパー要素が含まれています。 |
| IMPORT\$1ERROR | 広告のインポートプロセス中にエラーが発生しました。広告が挿入のために処理されません。 |
| IMPORT\$1IN\$1PROGRESS | 広告インポートプロセスは現在進行中であり、まだ完了していません。 |
## 関連リソース
広告スキップ問題のトラブルシューティングの詳細については、以下の関連トピックを参照してください。
+ [ADS リクエストの MediaTailor 動的広告変数](variables.md) - MediaTailor の動的広告変数に関する包括的なガイド
+ [広告のプリフェッチ](prefetching-ads.md) - トランスコード関連のスキップを防ぐために広告プリフェッチを実装する方法
+ [Amazon CloudWatch メトリクス AWS Elemental MediaTailor によるモニタリング](monitoring-cloudwatch-metrics.md) - CloudWatch メトリクスによる MediaTailor のモニタリング
+ [AWS Elemental MediaTailor ログの表示](monitoring-through-logs.md) - MediaTailor ログを表示および分析する方法
+ [MediaTailor イベントフローの問題のトラブルシューティング](troubleshooting-event-flow.md) - 広告挿入イベントフローを理解する