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

# 伺服器端追蹤與伺服器引導廣告插入 (SGAI)
<a name="ad-reporting-server-side-sgai"></a>

當您使用伺服器引導廣告插入 (SGAI) 時，伺服器端追蹤會使用與上述拼接模式方法不同的*無工作階段信標*機制。SGAI 不會將廣告區段 MediaTailor 拼接到內容資訊清單 （追蹤`/v1/segment`請求的位置），而是在資產清單回應中以個別播放清單的形式傳回廣告參考，並在廣告 URIs中內嵌信標中繼資料。

## 無工作階段伺服器端信標的運作方式
<a name="ad-reporting-server-side-sgai-how-it-works"></a>

下列步驟說明伺服器端信標如何用於 SGAI 工作階段：

1. **工作階段初始化**：玩家使用 請求 HLS 多變量播放清單`aws.insertionMode=GUIDED`。伺服器端報告是預設值 （不需要`aws.reportingMode`參數）。與拼接模式不同，工作階段初始化回應*不包含* `trackingUrl`。

1. **可快取資訊**清單：MediaTailor 傳回可快取資訊清單，其中包含指向 MediaTailor 間質資產清單端點的`EXT-X-DATERANGE`標籤`CLASS="com.apple.hls.interstitial"`和`X-ASSET-LIST`屬性。

1. **具有信標中繼資料的資產清單**：當玩家遇到廣告休息時間時，它會擷取資產清單。MediaTailor 會傳回 JSON 回應，其中每個廣告 URI 都包含加密的信標中繼資料：

   ```
   {
     "ASSETS": [
       {
         "DURATION": 30.0,
         "URI": "https://cdn.example.com/ad/master.m3u8?awsBeaconData=<encrypted>&awsBeaconDomain=<MediaTailor-endpoint>&awsConfigurationName=<config-name>"
       }
     ]
   }
   ```

   當伺服器端報告處於作用中狀態時，回應*不包含* `TRACKING`區段。廣告 URIs 會攜帶所有信標資料。

1. **HLS 變數替換**：玩家擷取廣告多變數播放清單。廣告資訊清單使用 `#EXT-X-DEFINE:QUERYPARAM` 指令，透過 HLS 變數替換，將指標參數從 URI 查詢字串傳遞至區段 URLs：

   ```
   #EXTM3U
   #EXT-X-DEFINE:QUERYPARAM="awsBeaconData"
   #EXT-X-DEFINE:QUERYPARAM="awsBeaconDomain"
   #EXT-X-DEFINE:QUERYPARAM="awsConfigurationName"
   #EXTINF:5.0,
   {$awsBeaconDomain}/segment/hash/{$awsConfigurationName}/{$awsBeaconData}/0/0?aws.segmentRelativePath=asset_00001.ts
   ```

   播放器會使用廣告資訊清單 URI `{$awsBeaconData}`查詢字串中的值來解析 `{$awsBeaconDomain}`、 和 `{$awsConfigurationName}`變數，然後透過 MediaTailor 請求每個廣告區段。

1. **區段請求的信標射擊**：當玩家請求每個廣告區段時，請求會透過 MediaTailor 路由。服務會解密信標資料，判斷區段在廣告中的位置 （壓縮、第一分位數、中點、第三分位數或完整），並將適當的 VAST 追蹤信標發射到廣告伺服器。MediaTailor 接著會將玩家重新導向至實際的廣告內容區段。

## SGAI 伺服器端信標的玩家需求
<a name="ad-reporting-server-side-sgai-requirements"></a>

若要搭配 SGAI 使用伺服器端信標，您的玩家必須符合下列要求：
+ HLS 11 版或更新版本
+ 支援 `EXT-X-DATERANGE`搭配 HLS Interstitials `CLASS` 屬性
+ 支援`#EXT-X-DEFINE:QUERYPARAM`變數替換 (RFC 8216bis)。玩家必須先對查詢參數值進行百分比解碼，才能將其替換為區段 URLs。

**注意**  
SGAI 伺服器端信標目前僅支援 HLS。SGAI 伺服器端信標尚不支援 DASH。

## 與拼接模式伺服器端追蹤的比較
<a name="ad-reporting-server-side-sgai-comparison"></a>

下表摘要說明拼接和伺服器引導廣告插入之間的伺服器端追蹤差異：


| 面向 | 拼接 (SSAI) | 伺服器引導 (SGAI) | 
| --- | --- | --- | 
| 資訊清單快取能力 | 每個工作階段，無法快取 | 可快取、跨檢視器共用 | 
| 廣告客群路由 | 透過/v1/segment/使用工作階段 ID | 透過/v1/segment/使用加密的信標資料 Blob | 
| 信標的工作階段狀態 | 在 MediaTailor 中儲存每個工作階段 | 無工作階段 — 所有狀態都以加密awsBeaconData參數傳送 | 
| 在工作階段初始化時追蹤 URL | 在工作階段初始化回應中傳回 | 未提供 — 信標資料內嵌在每個資產清單回應中的廣告 URIs中 | 
| DASH 支援 | 支援 | 尚未支援 | 

**注意**  
對於即時 SGAI 工作階段，您可以使用 啟用資訊清單型廣告預先擷取`aws.guidedPrefetchMode=MANIFEST`。這與與與拼接 (SSAI) 工作階段搭配使用的排程型預先擷取 API 不同。如需詳細資訊，請參閱[具有資訊清單活動訊號的引導式預先擷取](sgai-guided-prefetch.md)。