翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
セッション変数の使用
を設定するには AWS Elemental MediaTailor セッションデータを広告決定サーバー (ADS) に送信するにはURL、テンプレート ADS で、このセクションにリストされている変数を 1 つ以上指定します。個々の変数を使用できます。また、複数の変数を連結して単一の値を作成できます。 は一部の値 MediaTailor を生成し、マニフェストやプレイヤーのセッション初期化リクエストなどのソースから残りを取得します。
次の表に、テンプレートADSリクエストURL設定で使用できるセッションデータ変数を示します。表に記載されているセクション番号は、ケーブル通信エンジニア協会 (SCTE)-35 仕様の 2019 年版の「ケーブルのデジタルプログラム挿入キューイングメッセージ
| 名前 | 広告プリフェッチで使用可能 | SCTE-35 仕様セクション | [Description] (説明) |
|---|---|---|---|
[avail.index] |
あり | インデックス内の ad avail の位置を表す数値。再生セッションの開始時に、 はすべての ad avail のインデックスをマニフェストに MediaTailor 作成し、残りのセッションのインデックスを保存します。 MediaTailor が に avail を埋めADSるようにリクエストすると、ad avail インデックス番号が含まれます。このパラメータによりADS、 は競合除外や頻度制限などの機能を使用して広告選択を改善できます。 | |
[avail.random] |
あり | へのリクエストごとに が MediaTailor 生成する 0～10,000,000,000 の乱数ADS。競合する会社から広告を切り離すなどの機能を有効にするために、このパラメータを使用する広告サーバーもあります。 | |
[scte.archive_allowed_flag] |
あり | 10.3.3.1 | オプションのブール値。この値が 0 の場合、セグメントで記録制限がアサートされます。この値が 1 の場合、セグメントでは記録制限はアサートされません。 |
[scte.avail_num] |
あり | 9.7.2.1 | SCTE-35 フィールド MediaTailor から によって解析された値はavail_num、長い数値です。この値 MediaTailor を使用して、線形 ad avail 番号を指定できます。 |
[scte.avails_expected] |
あり | 9,7.2.1 | 現在のイベント内の avail の予想数を示すオプションの長い値。 |
[scte.delivery_not_restricted_flag] |
あり | 10.3.3.1 | オプションのブール値。この値が 0 の場合、次の 5 ビットが予約されます。この値が 1 の場合、次の 5 ビットは SCTE-35 仕様で説明されている意味を引き継ぎます。 |
[scte.device_restrictions] |
あり | 10.3.3.1 | デバイスの 3 つの事前定義、独立、非階層グループにシグナルを送信するオプションの整数値。この変数の詳細については、SCTE-35 仕様の segments_expected の説明を参照してください。 |
[scte.event_id] |
あり | 9.1 および 9.7.2.1 | SCTE-35 フィールド MediaTailor から によって解析された値はsplice_event_id、長い数値です。 はこの値 MediaTailor を使用して、線形 ad avail 番号を指定するか、広告ポッドの位置などの広告サーバークエリ文字列を入力します。 |
[scte.no_regional_blackout_flag] |
あり | 10.3.3.1 | オプションのブール値。この値が 0 の場合、リージョンのブラックアウト制限がセグメントに適用されます。この値が 1 の場合、リージョンのブラックアウト制限はセグメントには適用されません。 |
[scte.segment_num] |
あり | 10.3.3.1 | セグメントのコレクション内のセグメントに番号を付けるオプションの整数値。この変数の詳細については、SCTE-35 仕様の segment_num の説明を参照してください。 |
[scte.segmentation_event_id]
|
あり | 10.3.3.1 | MediaTailor は、この変数を として公開しますscte.event_id。 |
[scte.segmentation_type_id] |
あり | 10.3.3.1 | セグメンテーションタイプを指定するオプションの 8 ビット整数値。この変数の詳細については、SCTE-35 仕様の segmentation_type_id の説明を参照してください。 |
[scte.segmentation_upid] |
|
segmentation_upid : 10.3.3.1 マネージドプライベート UPID: 10.3.3.3 |
SCTE-35 MediaTailor では、次の
|
[scte.segmentation_upid.assetId] |
あり | ポッドバスターワークフロー用の Managed Private UPID (0xC) と組み合わせてsegmentation_ upid_type使用します。 MediaTailor は、 MPUの private_dataJSON構造の assetIdパラメータからこの値を取得します。詳細については、「Managed Private UPID JSON structure for a podbuster workflow」を参照してください。 |
|
[scte.segmentation_upid.cueData.key] |
あり | ポッドバスターワークフロー用の Managed Private UPID (0xC) と組み合わせてsegmentation_ upid_type使用します。 MediaTailor は、 MPUの private_dataJSON構造の cueData.keyパラメータからこの値を取得します。詳細については、「Managed Private UPID JSON structure for a podbuster workflow」を参照してください。 |
|
[scte.segmentation_upid.cueData.value] |
あり | ポッドバスターワークフロー用の Managed Private UPID (0xC) と組み合わせてsegmentation_ upid_type使用します。 MediaTailor は、 MPUの private_dataJSON構造の cueData.keyパラメータからこの値を取得します。詳細については、「Managed Private UPID JSON structure for a podbuster workflow」を参照してください。 |
|
[scte.segments_expected] |
あり | 10.3.3.1 | セグメントのコレクション内の個々のセグメントの予想数を指定するオプションの整数値。この変数の詳細については、SCTE-35 仕様の segments_expected の説明を参照してください。 |
[scte.sub_segment_num] |
あり | 10.3.3.1 | サブセグメントのコレクション内の特定のサブセグメントを識別するオプションの整数値。この変数の詳細については、SCTE-35 仕様の sub_segment_num の説明を参照してください。 |
[scte.sub_segments_expected] |
あり | 10.3.3.1 | サブセグメントのコレクション内の個々のサブセグメントの予想数を指定するオプションの整数値。この変数の詳細については、SCTE-35 仕様の sub_segments_expected の説明を参照してください。 |
[scte.unique_program_id] |
あり | 9.7.2.1 | SCTE-35 splice_insertフィールド MediaTailor から によって解析された整数値unique_program_id。ADS は、一意のプログラム ID (UPID) を使用して、ライブリニアストリームのプログラムレベルの広告ターゲティングを提供します。SCTE-35 コマンドがスプライス挿入でない場合、 は MediaTailor これを空の値に設定します。 |
[session.avail_duration_ms] |
あり |
広告可用性スロットのミリ秒単位の期間。デフォルト値は 300,000 ミリ秒です。 AWS Elemental MediaTailor は、次のように入力マニフェストから期間値を取得します。
|
|
[session.avail_duration_secs] |
あり | 最も近い second. MediaTailor determines に四捨五入された広告アベイラビリティースロットまたは ad avail の秒単位の期間は、 を決定するのと同じ方法でこの値を決定します[session.avail_duration_ms]。 |
|
[session.client_ip] |
なし | MediaTailor リクエストの送信元のリモート IP アドレス。X-forwarded-for ヘッダーが設定されている場合、その値は が MediaTailor に使用する値ですclient_ip。 |
|
[session.id] |
なし | 現在の再生セッションの一意の数値識別子。プレイヤーがセッションに対して行うすべてのリクエストは同じ ID を持つため、1 回の視聴のリクエストを関連付けADSるフィールドに使用できます。 | |
[session.referer] |
なし | 通常、ビデオプレーヤーURLをホストしているページの です。 MediaTailor は、この変数を、プレイヤーが へのリクエストで使用した Refererヘッダーの値に設定します MediaTailor。プレイヤーがこのヘッダーを指定しない場合、 MediaTailor は を[session.referer]空のままにします。マニフェストエンドポイントの前にコンテンツ配信ネットワーク (CDN) またはプロキシを使用していて、この変数を表示したい場合は、プレイヤーから正しいヘッダーをここにプロキシします。 |
|
[session.user_agent] |
なし | プレイヤーのセッション初期化リクエストから MediaTailor 受信したUser-Agentヘッダー。マニフェストエンドポイントの前で CDNまたは プロキシを使用している場合は、ここでプレイヤーから正しいヘッダーをプロキシする必要があります。 |
|
[session.uuid] |
なし |
の代わりに を使用します |
ADS 一意のセッション識別子で という名前のクエリパラメータを渡すdeviceSession必要がある場合、 の テンプレートADSURLは AWS Elemental MediaTailor
は次のようになります。
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 } }
