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

# 即時串流的 MediaTailor 伺服器引導廣告插入組態
<a name="sgai-live-configuration"></a>

AWS Elemental MediaTailor 伺服器引導的即時內容廣告插入透過可快取的資訊清單提供顯著的效能優勢。為即時內容設定 SGAI 使用與 VOD 相同的核心參數，並考量即時串流特性和即時處理的特定考量。

## 即時 SGAI 的需求
<a name="sgai-live-requirements"></a>

為即時內容啟用 SGAI 之前，請確定您有下列項目：
+ 您的即時串流包含格式正確的 DATERANGE 標記
+ 廣告休息時間是一致且可預測的
+ 您的 CDN 已設定為適當地快取 SGAI 資訊清單
+ 玩家支援伺服器引導廣告插入工作流程
+ 您的廣告決策伺服器可以處理即時內容的即時請求

### 玩家需求
<a name="sgai-live-player-integration"></a>

玩家必須設定為正確處理 SGAI 即時資訊清單：
+ 支援伺服器引導式廣告插入工作流程
+ 能夠處理資訊清單的廣告插入指引
+ 正確處理即時串流計時和同步
+ 針對 HLS 內容：支援 HLS 第 8 版和 EXT-X-DATERANGE 搭配 CLASS 屬性。伺服器端信標的版本 11。
+ 對於 HLS 內容：EXT-X-DEFINE 變數替換支援

## 即時播放組態
<a name="sgai-live-playback-config"></a>

若要為即時內容啟用 SGAI，請建立具有下列設定的播放組態：

**Example SGAI 即時播放組態**  

```
{
  "Name": "LiveSGAIConfig",
  "VideoContentSourceUrl": "https://your-live-origin.com/live/stream.m3u8",
  "AdDecisionServerUrl": "https://your-ads.com/ads",
  "PersonalizationThresholdSeconds": 1,
  "InsertionMode": "PLAYER_SELECT"
}
```

以下是即時 SGAI 組態的重要考量：

`VideoContentSourceUrl`  
必須指向具有正確格式 SCTE-35 DATERANGE 標記的即時 HLS 串流。串流應維持一致的區段持續時間和位元速率變體。

## SGAI 即時資訊清單請求
<a name="sgai-live-manifest-requests"></a>

SGAI 即時資訊清單使用與傳統廣告插入相同的 URL 模式：

```
https://your-config.mediatailor.region.amazonaws.com/v1/master/config-name/manifest.m3u8?aws.insertionMode=GUIDED
```

## 即時 SGAI 以資訊清單為基礎的預先擷取
<a name="sgai-live-guided-prefetch"></a>

對於即時 SGAI 工作流程，您可以啟用資訊清單型預先擷取活動訊號，以減少廣告填充延遲。將 `aws.guidedPrefetchMode=MANIFEST`新增至資訊清單請求：

```
https://your-config.mediatailor.region.amazonaws.com/v1/master/config-name/manifest.m3u8?aws.insertionMode=GUIDED&aws.guidedPrefetchMode=MANIFEST
```

啟用時，MediaTailor 會將工作階段識別符 (`?aws.sessionId=<id>`) 做為查詢參數附加到多變量播放清單中的每個間質媒體資訊清單 (`/v1/i-media`) URL。每次播放器重新整理 i-media 資訊清單時，請求都會使用工作階段 ID 到達 MediaTailor，MediaTailor 會使用此 ID 來識別工作階段，並排入近期廣告休息時間的預先擷取請求佇列。

**重要**  
**使用引導式預先擷取時，請勿在 CDN 中快取 i-media 資訊清單。**預先擷取活動訊號機制取決於直接到達 MediaTailor 的玩家資訊清單重新整理請求。如果您的 CDN 快取並提供`/v1/i-media`回應，MediaTailor 不會接收活動訊號請求，也無法觸發預先擷取。將 CDN 設定為在使用`aws.guidedPrefetchMode=MANIFEST`中時將`/v1/i-media/*`請求傳遞至 MediaTailor。

引導式預先擷取與報告模式無關。無論您是使用伺服器端 （預設） 或用戶端 (`aws.reportingMode=CLIENT`) 追蹤， 信標都會在播放時間觸發，而不是在預先擷取廣告時觸發。如需廣告預先擷取如何在 MediaTailor 中運作的一般資訊，請參閱 [預先擷取廣告](prefetching-ads.md)。

## 測試 SGAI 即時組態
<a name="sgai-live-testing"></a>

使用以下驗證步驟驗證您的 SGAI 即時設定：

1. **測試資訊清單產生**

   請求 SGAI 即時資訊清單 URL，並驗證其傳回具有適當廣告插入指引的可快取內容。

1. **驗證 CDN 快取**

   檢查您的 CDN 根據設定的 TTL 值快取 SGAI 資訊清單。

1. **測試廣告插入**

   確認玩家可以使用 SGAI 資訊清單中提供的指引成功插入廣告。

1. **監控效能**

   使用 CloudWatch 指標來驗證降低的原始負載並改善快取命中率。