本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# MediaTailor 廣告略過疑難排解指南
<a name="troubleshooting-ad-skipping-overview"></a>

略過廣告是 MediaTailor 客戶回報的最常見問題之一。本指南可協助您識別廣告略過問題，並提供step-by-step疑難排解程序。

## 症狀和影響
<a name="ad-skipping-symptoms"></a>

發生廣告略過時，您可能會觀察到下列症狀：
+ 廣告不會在預期的廣告休息時間出現
+ 廣告休息時間顯示內容而非廣告
+ 不同檢視工作階段之間的不一致廣告播放
+ CloudWatch 日誌顯示具有各種略過原因`AdSkipped`的事件

跳過廣告會直接影響收入，並可能導致瀏覽者體驗不佳。立即解決這些問題，以維持最佳效能。

## 識別略過原因
<a name="identifying-skip-reasons"></a>

使用 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 廣告略過疑難排解
<a name="troubleshooting-new-creative-skipping"></a>

當廣告略過`NEW_CREATIVE`原因時， AWS Elemental MediaTailor 遇到需要轉碼再插入的廣告。此故障診斷指南說明原因，並提供step-by-step解決程序。

## 造成 NEW\$1CREATIVE 略過的原因
<a name="new-creative-causes"></a>

MediaTailor 會根據三個關鍵因素轉碼廣告：創意 ID、AWS 帳戶 ID 和轉碼變體集 （基礎內容串流的播放轉譯）。當創意 ID 或轉碼變體集的任何部分不同時，MediaTailor 會將廣告辨識為需要轉碼的新變體。

### 位元速率變更
<a name="bitrate-changes-cause"></a>

當位元速率四捨五入至最接近的 8，000 位元後不相符時，位元速率變更可能會導致 NEW\$1CREATIVE 略過。這通常發生在下列情況：
+ 基礎內容串流會變更主要資訊清單
+ 使用與現有工作階段不同的變體建立新工作階段
+ 內容串流位元速率在播放工作階段之間不一致

#### 收集任務頻寬差異
<a name="harvest-job-bandwidth-variance"></a>

對於收集任務，MediaTailor 在將廣告與內容串流比對時，會使用 15% 的頻寬差異閾值。如果即時串流的頻寬與收集的 HLS 檔案的頻寬之間有 15% 或更多的差異，則廣告將再次轉碼。這可能會導致 NEW\$1CREATIVE 在轉碼程序期間略過。

此行為通常會在以下情況下發生：
+ 即時串流和 VOD 內容都使用相同的預先轉碼廣告
+ 收集的內容具有與原始即時串流不同的編碼參數
+ 頻寬差異超過即時和收集內容之間的 15% 閾值

### Creative ID 衝突
<a name="creative-id-conflicts-cause"></a>

當 MediaTailor 針對已轉碼的媒體檔案遇到不同的創意 ID 時，會發生下列順序：

1. 廣告會略過原因 NEW\$1CREATIVE

1. 這會導致不必要的轉碼嘗試

1. 創意標示為 DUPLICATE\$1TRANSCODE 或 COPY\$1DEDUP

**注意**  
MediaTailor 不會過期或刪除轉碼廣告。我們將它們無限期存放在 MediaTailor 擁有的 S3 儲存貯體中。

## 解決步驟
<a name="new-creative-resolution-steps"></a>

若要解決 NEW\$1CREATIVE 廣告略過問題：

1. 確認您的廣告決策伺服器傳回相同廣告內容的一致創意 IDs。

1. 檢查您的內容串流是否維持一致的位元速率和變體集。

1. 請考慮實作廣告預先擷取，以確保在播放之前已轉碼廣告。如需詳細資訊，請參閱[預先擷取廣告](prefetching-ads.md)。

1. 如需持續問題，請聯絡 [AWS Support](https://aws.amazon.com/premiumsupport/) 以取得其他故障診斷協助。

## 監控 NEW\$1CREATIVE 模式
<a name="new-creative-monitoring"></a>

使用此 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 逾時廣告略過疑難排解
<a name="troubleshooting-ads-timeout-skipping"></a>

當因 `ADS_TIMEOUT` 或相關原因而略過廣告時，您的廣告決策伺服器會有連線或效能問題。 AWS Elemental MediaTailor 需要與您的 ADS 進行可靠的通訊，才能成功插入廣告。本故障診斷指南說明如何識別和解決這些連線問題。

## 常見的 ADS 連線問題
<a name="ads-timeout-causes"></a>

常見的 ADS 連線問題包括下列項目：
+ 無法從 MediaTailor 存取廣告決策伺服器
+ ADS 在設定的逾時期間內沒有回應
+ ADS 無法在尖峰時段處理請求量
+ MediaTailor 和 ADS 之間的網路連線問題

## 解決步驟
<a name="ads-timeout-resolution"></a>

若要解決 ADS 逾時問題：

1. 確認您的廣告決策伺服器可從 MediaTailor 存取。

1. 檢查您的 ADS 是否在設定的逾時期間內回應。

1. 確保您的 ADS 可以在尖峰時段處理請求量。

1. 當您的主要 ADS 無法使用時，請考慮為 實作備用廣告策略。

## 監控 ADS 效能
<a name="ads-timeout-monitoring"></a>

為 `AdDecisionServer.Timeouts` 指標設定 CloudWatch 警示，以主動偵測 ADS 連線問題。

# MediaTailor VAST 剖析廣告略過疑難排解
<a name="troubleshooting-vast-parsing-skipping"></a>

使用 `VAST_PARSING_ERROR`或 略過廣告時`MEDIA_FILE_UNAVAILABLE`，您的 VAST 回應或廣告媒體檔案發生問題。 AWS Elemental MediaTailor 需要正確格式化的 VAST 回應和可存取的媒體檔案，才能成功插入廣告。本故障診斷指南說明如何識別和解決這些問題。

## 常見的 VAST 問題
<a name="vast-parsing-causes"></a>

常見的 VAST 問題包括下列項目：
+ VAST 回應格式不符合 VAST 規格
+ VAST 回應中的媒體檔案 URLs 無法公開存取
+ VAST XML 未正確編碼的特殊字元
+ VAST 回應缺少必要的媒體檔案或格式

## 解決步驟
<a name="vast-parsing-resolution"></a>

若要解決 VAST 剖析問題：

1. 根據 VAST 規格驗證您的 VAST 回應格式。

1. 確保 VAST 回應中的所有媒體檔案 URLs 都可公開存取。

1. 檢查 VAST XML 中是否有特殊字元的適當編碼。

1. 確認您的 VAST 回應包含與 MediaTailor 相容格式的媒體檔案。

## VAST 包裝函式疑難排解
<a name="vast-wrapper-issues"></a>

對於 `INVALID_VAST_WRAPPER_AD`或 的問題`REJECTED_REPLICA_VAST`：
+ 根據 VAST 規格驗證 VAST 包裝函式回應
+ 確保所有包裝函式元素格式正確，且包含有效的 VASTAdTagURI
+ 檢查廣告伺服器組態是否有重複的內容偵測政策
+ 確保 VAST 回應在相同工作階段中包含唯一的創意內容

# MediaTailor 持續時間不符廣告略過疑難排解
<a name="troubleshooting-duration-mismatch-skipping"></a>

因 `AVAIL_DURATION_EXCEEDED`、 `LEFTOVER_AVAIL_EXCEEDED_THRESHOLD`或 格式相關原因而略過廣告時，您會出現持續時間或格式相容性問題。 AWS Elemental MediaTailor 需要適當的持續時間格式，並在廣告內容與可用的廣告休息時間之間進行比對。本疑難排解指南說明如何識別和解決這些持續時間相關問題。

## 常見持續時間問題
<a name="duration-mismatch-causes"></a>

常見的持續時間問題包括下列項目：
+ 廣告超過可用的廣告休息時間
+ 內容中不正確的廣告休息時間標記發出錯誤的持續時間訊號
+ 廣告插入不符合個人化閾值
+ EXT-X-CUE-OUT 標籤中的持續時間格式不正確

## 持續時間格式要求
<a name="duration-format-requirements"></a>

EXT-X-CUE-OUT 標籤持續時間參數必須格式化為整數值，而非 ISO 8601 持續時間格式。


**持續時間格式要求**  

| 格式 | 範例 | 狀態 | 
| --- | --- | --- | 
| 整數 （正確） | 32 | 支援 - 代表 32 秒 | 
| 小數 （正確） | 30.000 | 支援 - 代表 30 秒 | 
| ISO 8601 （不正確） | PT32S | 不支援 - 導致插入失敗 | 

## 解決步驟
<a name="duration-mismatch-resolution"></a>

若要解決持續時間不相符的問題：

1. 確保您的 ADS 傳回符合可用廣告休息時間期間的廣告。

1. 檢查內容中的廣告休息時間標記是否正確地發出預期的持續時間訊號。

1. 確認 EXT-X-CUE-OUT 持續時間參數使用整數格式。

1. 如果適用於您的使用案例，請考慮調整個人化閾值。

# MediaTailor 工作階段變數廣告略過疑難排解
<a name="troubleshooting-session-variables-skipping"></a>

工作階段變數在廣告目標和選擇中扮演關鍵角色 AWS Elemental MediaTailor。不正確的工作階段變數組態是廣告略過問題的常見原因。此全方位故障診斷指南說明如何識別和解決可能導致無法成功插入廣告的工作階段變數問題。

## 常見的工作階段變數問題
<a name="session-variable-issues"></a>

常見的工作階段變數問題包括下列項目：
+ **缺少必要的變數**：您的廣告決策伺服器可能需要未提供的特定變數。
+ **變數語法不正確**：變數必須使用正確的語法 （例如，`[session.id]`而非 `${session.id}`)。
+ **URL 編碼問題**：變數值中的特殊字元可能需要適當的 URL 編碼。
+ **不一致的玩家參數**：玩家參數必須一致地跨工作階段傳遞。
+ **動態變數解析失敗**：無法解析的變數會以空字串取代。
+ **SCTE-35 UPID 剖析問題**：分段 UPID 處理的問題可能會導致工作階段變數解析失敗。

## 驗證工作階段變數解析
<a name="session-variable-verification"></a>

若要驗證您的工作階段變數是否已正確解析：

1. 為您的 MediaTailor 組態啟用偵錯記錄

1. 檢查`MediaTailor/AdDecisionServerInteractions`日誌群組是否有實際的 ADS 請求 URLs

1. 確認範本 URL 中的所有變數已取代為適當的值

1. 尋找以空字串取代的任何變數，這可能表示解析失敗

## SCTE-35 UPID 剖析疑難排解
<a name="upid-parsing-troubleshooting"></a>

SCTE-35 分段 UPID 處理的問題可能會導致工作階段變數問題：
+ **格式要求：**UTP 必須具有 `segmentation_upid_type` 12 並包含 `format_identifier`才能正確處理
+ **剖析規則：**解碼的 UPID 可以包含多個值的冒號分隔符號。範本變數和解碼 UPID 字符的數量必須相等
+ **格式無效：**避免沒有值 （例如 `::`或 `:46175218::4053`) 的雙冒號，因為這些會導致剖析失敗

# MediaTailor 廣告略過監控和提醒
<a name="monitoring-ad-skipping-issues"></a>

主動監控可協助您偵測並解決廣告略過問題，再大幅影響您的收入。 AWS Elemental MediaTailor 提供全面的指標和記錄功能，可有效監控廣告插入效能。本指南說明如何設定廣告略過問題的有效監控。

## 要監控的關鍵 CloudWatch 指標
<a name="cloudwatch-metrics-monitoring"></a>

為這些金鑰 MediaTailor 指標設定 CloudWatch 警示：
+ `AdDecisionServer.Ads.Skipped` - 略過的廣告計數
+ `AdDecisionServer.Timeouts` - ADS 逾時計數
+ `Avail.FilledDuration` - 填入廣告休息時間的持續時間
+ `Avail.SlateOnly` - 僅填滿 Slate 的廣告休息時間計數

## 進階 CloudWatch Logs Insights 查詢
<a name="advanced-cloudwatch-queries"></a>

使用這些特殊查詢進行詳細故障診斷：

### 全面的工作階段分析
<a name="comprehensive-session-analysis-query"></a>

如需特定工作階段廣告插入行為的詳細分析：

```
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
```

### 尋找 Creative IDs
<a name="creative-id-identification-query"></a>

若要從 FILLED\$1AVAIL 事件識別 Creative IDs：

```
fields @timestamp, sessionId, eventType
| filter sessionId like /sessionId/ and eventType!='BEACON_FIRED'
| sort @timestamp desc
```

**注意**  
`sessionId` 將 取代為您正在調查的實際工作階段 ID。

# MediaTailor 廣告略過預防最佳實務
<a name="preventing-ad-skipping-best-practices"></a>

實作這些最佳實務有助於防止廣告在問題發生之前略過問題，從而確保更好的廣告插入效能和收入保護 AWS Elemental MediaTailor。這些主動措施可解決廣告略過的最常見原因，並有助於維持一致的廣告交付。

## 主動措施
<a name="proactive-measures"></a>
+ **實作廣告預先擷取**：使用 MediaTailor 的預先擷取功能，以確保在播放之前已轉碼廣告。如需實作詳細資訊[預先擷取廣告](prefetching-ads.md)，請參閱
+ **維持一致的創意 IDs**：確保您的廣告決策伺服器針對跨工作階段的相同廣告內容使用一致的創意 IDs 
+ **確保適當的持續時間格式**：將整數值用於 EXT-X-CUE-OUT 持續時間參數，而非 ISO 8601 格式
+ **設定 VOD 最佳化**：為具有多個廣告休息時間的 VOD 串流設定 maxConcurrentAdsRequests，以減少伺服器負載
+ **最佳化 ADS 效能**：設定廣告決策伺服器以快速回應並處理尖峰流量

## 實作準則
<a name="implementation-guidelines"></a>
+ **實作適當的錯誤處理**：設定 Slate 內容以在無法插入廣告時填補廣告休息時間
+ **徹底測試**：驗證不同裝置和網路條件的廣告插入工作流程
+ **實作備用策略**：設定主要廣告來源失敗時的備份廣告來源或預設廣告
+ **監控轉碼模式**：監控 CloudWatch 日誌的轉碼效率，如果您注意到表示轉碼問題的模式，請聯絡 [AWS Support](https://aws.amazon.com/premiumsupport/) 

# MediaTailor 廣告略過參考指南
<a name="ad-skipping-reference-materials"></a>

本節提供有關廣告略過原因和相關文件連結的完整參考資訊 AWS Elemental MediaTailor。使用此參考指南來了解不同略過原因的特定意義，並尋找其他故障診斷資源。

## 完成廣告略過原因參考
<a name="complete-skip-reasons-reference"></a>

MediaTailor 會在日誌`MediaTailor/AdDecisionServerInteractions`群組`FILLED_AVAIL`的事件日誌訊息中記錄略過廣告的特定原因。


**完成廣告略過原因**  

| 略過原因 | Description | 
| --- | --- | 
| 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 | 廣告匯入程序目前正在進行中，尚未完成。 | 

## 相關資源
<a name="related-resources"></a>

如需疑難排解廣告略過問題的詳細資訊，請參閱下列相關主題：
+ [ADS 請求的 MediaTailor 動態廣告變數](variables.md) - MediaTailor 中動態廣告變數的完整指南
+ [預先擷取廣告](prefetching-ads.md) - 如何實作廣告預先擷取，以防止轉碼相關的略過
+ [AWS Elemental MediaTailor 使用 Amazon CloudWatch 指標進行監控](monitoring-cloudwatch-metrics.md) - 使用 CloudWatch 指標監控 MediaTailor 
+ [檢視 AWS Elemental MediaTailor 日誌](monitoring-through-logs.md) - 如何檢視和分析 MediaTailor 日誌
+ [故障診斷 MediaTailor 事件流程問題](troubleshooting-event-flow.md) - 了解廣告插入事件流程