翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# サーバーガイド広告挿入によるサーバー側の追跡 (SGAI)
<a name="ad-reporting-server-side-sgai"></a>

サーバーガイド広告挿入 (SGAI) を使用する場合、サーバー側の追跡は、上記のステッチモードアプローチとは異なる*セッションレスビーコン*メカニズムを使用します。MediaTailor が広告セグメントをコンテンツマニフェスト (`/v1/segment`リクエストを追跡する場所) にステッチする代わりに、SGAI は広告参照を個別のプレイリストとしてアセットリストレスポンスに返し、ビーコンメタデータが広告 URIs。

## セッションレスサーバー側のビーコンの仕組み
<a name="ad-reporting-server-side-sgai-how-it-works"></a>

次の手順では、SGAI セッションでサーバー側のビーコンがどのように機能するかについて説明します。

1. **セッションの初期化**: プレイヤーは を使用して HLS マルチバリアントプレイリストをリクエストします`aws.insertionMode=GUIDED`。サーバー側のレポートはデフォルトです (`aws.reportingMode`パラメータは必要ありません）。ステッチモードとは異なり、セッション初期化レスポンスには *は含まれません*`trackingUrl`。

1. **キャッシュ可能なマニ**フェスト: MediaTailor は、MediaTailor インタースティシャルアセットリストエンドポイントを指す `CLASS="com.apple.hls.interstitial"`および `X-ASSET-LIST` 属性を持つ`EXT-X-DATERANGE`タグを含むキャッシュ可能なマニフェストを返します。

1. **ビーコンメタデータを含むアセットリスト**: プレイヤーが広告時間枠に遭遇すると、アセットリストが取得されます。MediaTailor は、各広告 URI に暗号化されたビーコンメタデータが含まれる JSON レスポンスを返します。

   ```
   {
     "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` ディレクティブを使用して、URI クエリ文字列から HLS 変数置換を介してセグメント 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 を経由します。サービスはビーコンデータを復号し、広告内のセグメントの位置 (インプレッション、第 1 四分位、中間、第 3 四分位、または完了) を決定し、適切な VAST 追跡ビーコンを広告サーバーに発射します。MediaTailor は、プレイヤーを実際の広告コンテンツセグメントにリダイレクトします。

## SGAI サーバー側のビーコンのプレイヤー要件
<a name="ad-reporting-server-side-sgai-requirements"></a>

SGAI でサーバー側のビーコンを使用するには、プレイヤーが次の要件を満たしている必要があります。
+ HLS バージョン 11 以降
+ HLS Interstitials の `CLASS` 属性`EXT-X-DATERANGE`を使用した のサポート
+ `#EXT-X-DEFINE:QUERYPARAM` 可変置換 (RFC 8216bis) のサポート。プレイヤーは、クエリパラメータ値をセグメント URLs に置き換える前に、それらをパーセントデコードする必要があります。

**注記**  
SGAI サーバー側のビーコンは現在、HLS でのみサポートされています。DASH は、SGAI サーバー側のビーコンではまだサポートされていません。

## ステッチモードのサーバー側の追跡との比較
<a name="ad-reporting-server-side-sgai-comparison"></a>

次の表は、ステッチ広告挿入とサーバーガイド広告挿入でサーバー側の追跡がどのように異なるかをまとめたものです。


| 側面 | ステッチ (SSAI) | サーバーガイド (SGAI) | 
| --- | --- | --- | 
| マニフェストのキャッシュ可能性 | セッションごと、キャッシュ不可 | キャッシュ可能、ビューワー間で共有 | 
| 広告セグメントのルーティング | セッション ID /v1/segment/を使用する | 暗号化されたビーコンデータ BLOB /v1/segment/を使用する | 
| ビーコンのセッション状態 | MediaTailor にセッションごとに保存 | セッションレス — すべての状態は暗号化されたawsBeaconDataパラメータで伝送されます | 
| セッション開始時の追跡 URL | セッション初期化レスポンスで返されます | 指定なし — ビーコンデータは各アセットリストレスポンスの広告 URIs に埋め込まれます | 
| DASH サポート | サポート | まだサポートされていません。 | 

**注記**  
ライブ SGAI セッションでは、 を使用してマニフェストベースの広告プリフェッチを有効にできます`aws.guidedPrefetchMode=MANIFEST`。これは、スティッチド (SSAI) セッションで使用されるスケジュールベースのプリフェッチ API とは異なります。詳細については、「[マニフェストハートビートを使用したガイド付きプリフェッチ](sgai-guided-prefetch.md)」を参照してください。