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

# ADS リクエストの MediaTailor セッション変数
<a name="variables-session"></a>

AWS Elemental MediaTailor テンプレート ADS URL のこのセクションに記載されている 1 つ以上の変数を指定する AWS Elemental MediaTailor ように を設定すると、 はセッションデータを広告決定サーバー (ADS) に送信します。個々の変数を使用する、および複数の変数を連結して単一の値を作成することが可能です。MediaTailor は一部の値を生成し、マニフェスト、およびプレイヤーのセッション開始リクエストといったソースから残りの値を取得します。

次の表は、テンプレート ADS リクエスト URL 設定で使用できるセッションデータ変数を示しています。表に記載されているセクション番号は、米国ケーブル電気通信技術者協会 (SCTE)-35 仕様の 2019 年版、[デジタルプログラム挿入キューイングメッセージに対応しています。広告プリフェッチの詳細については、](https://account.scte.org/standards/library/catalog/scte-35-digital-program-insertion-cueing-message/)「」を参照してください[広告のプリフェッチ](prefetching-ads.md)。


| 名前 | 広告プリフェッチに使用可能 | SCTE-35 仕様セクション | [Description] (説明) | 
| --- | --- | --- | --- | 
| [avail.index] | はい |  | インデックス内の広告表示の位置を表す数値。再生セッションの開始時に、MediaTailor はマニフェスト内のすべての ad avail のインデックスを作成し、セッションが継続する間そのインデックスを保存します。MediaTailor が avail を埋めるために ADS に対してリクエストを行うときは、そのリクエストに ad avail インデックス番号を含めます。このパラメータにより、ADS は、競合相手の除外や頻度の上限設定などの機能を使用して広告の選択を改良できます。 | 
| [avail.random] | はい |  | MediaTailor が ADS へのリクエストごとに生成する 0～10,000,000,000 の乱数。競合する会社から広告を切り離すなどの機能を有効にするために、このパラメータを使用する広告サーバーもあります。 | 
| [scte.archive\$1allowed\$1flag] | はい | 10.3.3.1 | オプションのブール値。この値が 0 の場合、記録制限はセグメントでアサートされます。この値が 1 の場合、記録の制限はセグメントでアサートされません。 | 
| [scte.avail\$1num] | はい | 9.7.2.1 | 長い数値としてavail\$1num、SCTE-35 フィールド から MediaTailor によって解析された値。MediaTailor はこの値を使用して、リニア ad avail 番号を指定できます。値は整数である必要があります。 | 
| [scte.avails\$1expected] | はい | 9,7.2.1 | 現在のイベント内の予想可用性数を指定するオプションのロング値。 | 
| [scte.delivery\$1not\$1restricted\$1flag] | はい | 10.3.3.1 | オプションのブール値。この値が 0 の場合、次の 5 ビットが予約されます。この値が 1 の場合、SCTE-35 仕様で説明されているように、次の 5 ビットが意味を持ちます。 | 
| [scte.device\$1restrictions] | はい | 10.3.3.1 | デバイスの 3 つの事前定義された独立した非階層グループにシグナルを送信するオプションの整数値。この変数の詳細については、SCTE-35 仕様の segments\$1expected の説明を参照してください。 | 
| [scte.event\$1id] | はい | 9.1 および 9.7.2.1 | 長い数値としてsplice\$1event\$1id、SCTE-35 フィールド から MediaTailor によって解析された値。MediaTailor はこの値を使用して、リニア ad avail 番号の指定や、広告ポッドの位置などの広告サーバークエリ文字列の入力を行います。値は整数である必要があります。 | 
| [scte.no\$1regional\$1blackout\$1flag] | はい | 10.3.3.1 | オプションのブール値。この値が 0 の場合、リージョンのブラックアウト制限がセグメントに適用されます。この値が 1 の場合、リージョンのブラックアウト制限はセグメントには適用されません。 | 
| [scte.segment\$1num] | はい | 10.3.3.1 | セグメントのコレクション内のセグメントに番号を付けるオプションの整数値。この変数の詳細については、SCTE-35 仕様の segment\$1num の説明を参照してください。 | 
| [scte.segmentation\$1event\$1id]  | はい | 10.3.3.1 | MediaTailor はこの変数を として公開します[scte.event_id](#scte.event_id)。 | 
| [scte.segmentation\$1type\$1id] | はい | 10.3.3.1 | セグメンテーションタイプを指定するオプションの 8 ビット整数値。この変数の詳細については、SCTE-35 仕様の segmentation\$1type\$1id の説明を参照してください。 | 
| [scte.segmentation\$1upid] |  `segmentation_upid_type`: はい `private_data`: はい  |  **segmentation\$1upid**: 10.3.3.1 マネージドプライベート UPID: 10.3.3.3  |  SCTE-35 `segmentation_upid`要素に対応します。`segmentation_upid` 要素には、`segmentation_upid_type` と `segmentation_upid_length` が含まれます。 MediaTailor は以下の `segmentation_upid` タイプをサポートします。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/variables-session.html)  | 
| [scte.segmentation\$1upid.assetId] | はい |  | ポッドバスターワークフローsegmentation\$1 upid\$1type用の Managed Private UPID (0xC) と組み合わせて使用します。MediaTailor は、この値を MPU の private\$1data JSON 構造内の assetId パラメータから取得します。詳細については、「[Managed Private UPID JSON structure for a podbuster workflow](#podbuster-workflow)」を参照してください。 | 
| [scte.segmentation\$1upid.cueData.key] | はい |  | ポッドバスターワークフローsegmentation\$1 upid\$1type用の Managed Private UPID (0xC) と組み合わせて使用します。MediaTailor は、この値を MPU の private\$1data JSON 構造内の cueData.key パラメータから取得します。詳細については、「[Managed Private UPID JSON structure for a podbuster workflow](#podbuster-workflow)」を参照してください。 | 
| [scte.segmentation\$1upid.cueData.value] | はい |  | ポッドバスターワークフローsegmentation\$1 upid\$1type用の Managed Private UPID (0xC) と組み合わせて使用します。MediaTailor は、この値を MPU の private\$1data JSON 構造内の cueData.key パラメータから取得します。詳細については、「[Managed Private UPID JSON structure for a podbuster workflow](#podbuster-workflow)」を参照してください。値は文字列にすることができます。 | 
| [scte.segmentation\$1upid.private\$1data.\$1index\$1] | はい |  | ターゲットを絞った広告ワークフローsegmentation\$1upid\$1typeの Managed Private UPID (0xC) と組み合わせて使用します。MediaTailor は、コロン区切りのセグメンテーション UPID トークンを分割し、インデックス付きセッション変数を作成します。インデックスはコロン区切りリスト内の位置に対応し、最初のコロンの先頭の空白は無視されます。たとえば、 の場合`segmentation_upid = ":3213214:2313321/5:3943"`、次のようになります。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/variables-session.html) 値は文字列にすることができます。 | 
| [scte.segments\$1expected] | はい | 10.3.3.1 | セグメントのコレクション内の個々のセグメントの予想数を指定するオプションの整数値。この変数の詳細については、SCTE-35 仕様の segments\$1expected の説明を参照してください。 | 
| [scte.sub\$1segment\$1num] | はい | 10.3.3.1 | サブセグメントのコレクション内の特定のサブセグメントを識別するオプションの整数値。この変数の詳細については、SCTE-35 仕様の sub\$1segment\$1num の説明を参照してください。 | 
| [scte.sub\$1segments\$1expected] | はい | 10.3.3.1 | サブセグメントのコレクション内の個々のサブセグメントの予想数を指定するオプションの整数値。この変数の詳細については、SCTE-35 仕様の sub\$1segments\$1expected の説明を参照してください。 | 
| [scte.unique\$1program\$1id] | はい | 9.7.2.1 | SCTE-35 splice\$1insertフィールド から MediaTailor によって解析された整数値unique\$1program\$1id。ADS は、一意のプログラムID (UPID) を使用して、ライブリニアストリームにプログラムレベルの広告ターゲティングを提供します。SCTE-35 コマンドがスプライス挿入ではない場合、MediaTailor はこれを空の値に設定します。値は整数である必要があります。 | 
| [session.avail\$1duration\$1ms] | はい |  |  広告可用性スロットのミリ秒単位の期間。デフォルト値は 300,000 ms です。次のように入力マニフェストから期間値 AWS Elemental MediaTailor を取得します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/variables-session.html)  | 
| [session.avail\$1duration\$1secs] | はい |  | 最も近い秒に丸められた、広告可用性スロットまたは広告表示の秒単位の期間。MediaTailor は、[session.avail\$1duration\$1ms] を判断するときと同じ方法でこの値を判断します。 | 
| [session.client\$1ip] | いいえ |  | MediaTailor リクエストの送信元のリモート IP アドレス。X-forwarded-for ヘッダーが設定されている場合、その値は MediaTailor が client\$1ip に使用する値です。 | 
| [session.id] | いいえ |  | 現在の再生セッションの一意の数値識別子。プレイヤーがセッションに対して行うリクエストにはすべて同じ ID が割り当てられるため、その ID は同一の視聴に対するリクエストを関連付けるための ADS フィールドに使用できます。 | 
| [session.referer] | いいえ |  | 通常、動画プレーヤーをホストしているページの URL。MediaTailor はこの変数を、プレイヤーが MediaTailor に対するリクエストで使用した Referer ヘッダーの値に設定します。プレイヤーがこのヘッダーを提供しない場合、MediaTailor は [session.referer] を空のままにしておきます。マニフェストエンドポイントの前にコンテンツ配信ネットワーク (CDN) またはプロキシを使用し、この変数を表示する場合は、ここでプレイヤーから正しいヘッダーをプロキシします。 | 
| [session.user\$1agent] | いいえ |  | MediaTailor がプレイヤーのセッション初期化リクエストから受け取ったUser-Agentヘッダー。マニフェストエンドポイントの前で CDN またはプロキシを使用している場合は、ここでプレイヤーからの正しいヘッダーをプロキシする必要があります。 | 
| [session.uuid] | いいえ |  |  の代わりに を使用します**[session.id]**。これは、以下のような現在の再生セッションの一意の識別子です。 <pre>e039fd39-09f0-46b2-aca9-9871cc116cde</pre>  | 
| [avail.source\$1content\$1time\$1epoch\$1ms] | いいえ |  |  HLS の場合、値は表示を開始したオリジンセグメントの PDT です。DASH の場合、値は `<Period>`を含む `<SupplementalProperty> urn:scte:dash:utc-time` の です`<EventStream>`。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/variables-session.html)  | 

**Example**  
ADS で一意のセッション識別子を付けて渡される `deviceSession` というクエリパラメータが必要な場合、 AWS Elemental MediaTailor のテンプレート ADS URL は以下のようになります。  

```
https://my.ads.server.com/path?deviceSession=[session.id]
```
AWS Elemental MediaTailor は、ストリームごとに一意の識別子を自動的に生成し、 の代わりに識別子を入力します`session.id`。識別子が `1234567` である場合、MediaTailor が ADS に対して行う最終リクエストは、以下のようになります。  

```
https://my.ads.server.com/path?deviceSession=1234567
```
ADS で複数のクエリパラメータを渡す必要がある場合、 のテンプレート ADS URL は次の AWS Elemental MediaTailor ようになります。  

```
https://my.ads.server.com/sample?e=[scte.avails_expected]&f=[scte.segment_num]&g=[scte.segments_expected]&h=[scte.sub_segment_num]&j=[scte.sub_segments_expected]&k=[scte.segmentation_type_id]
```
次の DASH マーカーの XML フラグメントの例は、 の使用方法を示しています`scte35:SpliceInsert`。  

```
<Period start="PT444806.040S" id="123456" duration="PT15.000S">
  <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml">
    <Event duration="1350000">
      <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="180832" tier="4095">
        <scte35:SpliceInsert spliceEventId="1234567890" spliceEventCancelIndicator="false" outOfNetworkIndicator="true" spliceImmediateFlag="false" uniqueProgramId="1" availNum="1" availsExpected="1">
          <scte35:Program><scte35:SpliceTime ptsTime="5672624400"/></scte35:Program>
          <scte35:BreakDuration autoReturn="true" duration="1350000"/>
        </scte35:SpliceInsert>
      </scte35:SpliceInfoSection>
```
次の DASH マーカーの XML フラグメントの例は、 の使用方法を示しています`scte35:TimeSignal`。  

```
<Period start="PT346530.250S" id="123456" duration="PT61.561S">
  <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml">
    <Event duration="5310000">
      <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="183003" tier="4095">
        <scte35:TimeSignal>
          <scte35:SpliceTime ptsTime="3442857000"/>
        </scte35:TimeSignal>
        <scte35:SegmentationDescriptor segmentationEventId="1234567" segmentationEventCancelIndicator="false" segmentationDuration="8100000" segmentationTypeId="52" segmentNum="0" segmentsExpected="0">
          <scte35:DeliveryRestrictions webDeliveryAllowedFlag="false" noRegionalBlackoutFlag="false" archiveAllowedFlag="false" deviceRestrictions="3"/>
          <scte35:SegmentationUpid segmentationUpidType="12" segmentationUpidLength="2">0100</scte35:SegmentationUpid>
        </scte35:SegmentationDescriptor>
      </scte35:SpliceInfoSection>
    </Event>
```
次の DASH マーカーの XML フラグメントの例は、 の使用方法を示しています`scte35:Binary`。  

```
<Period start="PT444806.040S" id="123456" duration="PT15.000S">
  <EventStream schemeIdUri="urn:scte:scte35:2014:xml+bin" timescale="1">
    <Event presentationTime="1541436240" duration="24" id="29">
      <scte35:Signal xmlns="http://www.scte.org/schemas/35/2016">
        <scte35:Binary>/DAhAAAAAAAAAP/wEAUAAAHAf+9/fgAg9YDAAAAAAAA25aoh</Binary>
      </scte35:Signal>
    </Event>
    <Event presentationTime="1541436360" duration="24" id="30">
      <scte35:Signal xmlns="http://www.scte.org/schemas/35/2016">
        <scte35:Binary>QW5vdGhlciB0ZXN0IHN0cmluZyBmb3IgZW5jb2RpbmcgdG8gQmFzZTY0IGVuY29kZWQgYmluYXJ5Lg==</Binary>
      </scte35:Signal>
    </Event>
```
次の HLS タグの例は、 の使用方法を示しています`EXT-X-DATERANGE`。  

```
#EXT-X-DATERANGE:ID="splice-6FFFFFF0",START-DATE="2014-03-05T11:
15:00Z",PLANNED-DURATION=59.993,SCTE35-OUT=0xFC002F0000000000FF0
00014056FFFFFF000E011622DCAFF000052636200000000000A0008029896F50
000008700000000
```
次の HLS タグの例は、 の使用方法を示しています`EXT-X-CUE-OUT`。  

```
#EXT-OATCLS-SCTE35:/DA0AAAAAAAAAAAABQb+ADAQ6QAeAhxDVUVJQAAAO3/PAAEUrEoICAAAAAAg+2UBNAAANvrtoQ==  
#EXT-X-ASSET:CAID=0x0000000020FB6501  
#EXT-X-CUE-OUT:201.467
```
次の HLS タグの例は、 の使用方法を示しています`EXT-X-SPLICEPOINT-SCTE35`。  

```
#EXT-X-SPLICEPOINT-SCTE35:/DA9AAAAAAAAAP/wBQb+uYbZqwAnAiVDVUVJAAAKqX//AAEjW4AMEU1EU05CMDAxMTMyMjE5M19ONAAAmXz5JA==
```
次の例は、`scte35:Binary`デコードの使用方法を示しています。  

```
{
  "table_id": 252,
  "section_syntax_indicator": false,
  "private_indicator": false,
  "section_length": 33,
  "protocol_version": 0,
  "encrypted_packet": false,
  "encryption_algorithm": 0,
  "pts_adjustment": 0,
  "cw_index": 0,
  "tier": "0xFFF",
  "splice_command_length": 16,
  "splice_command_type": 5,
  "splice_command": {
    "splice_event_id": 448,
    "splice_event_cancel_indicator": false,
    "out_of_network_indicator": true,
    "program_splice_flag": true,
    "duration_flag": true,
    "splice_immediate_flag": false,
    "utc_splice_time": {
      "time_specified_flag": false,
      "pts_time": null
    },
    "component_count": 0,
    "components": null,
    "break_duration": {
      "auto_return": false,
      "duration": {
        "pts_time": 2160000,
        "wall_clock_seconds": 24.0,
        "wall_clock_time": "00:00:24:00000"
      }
    },
    "unique_program_id": 49152,
    "avail_num": 0,
    "avails_expected": 0
    "segment_num": 0,
    "segments_expected": 0,
    "sub_segment_num": 0,
    "sub_segments_expected": 0
  },
  "splice_descriptor_loop_length": 0,
  "splice_descriptors": null,
  "Scte35Exception": {
    "parse_status": "SCTE-35 cue parsing completed with 0 errors.",
    "error_messages": [],
    "table_id": 252,
    "splice_command_type": 5
  }
}
```