サーバー側の広告挿入 (SSAI)

Amazon IVS サーバー側の広告挿入 (SSAI) を使用すると、動画広告でストリームを収益化できます。IVS SSAI は AWS Elemental MediaTailor と統合されており、広告の決定、オーディエンスターゲティング、パーソナライゼーションなどの機能にアクセスできます。IVS には、ライブストリームに広告時間枠を挿入する API オペレーションが用意されているため、クリエーターやオペレーターが広告の実行タイミングを制御できるようになります。IVS は広告をビデオストリームに直接ステッチします。これにより、シームレスな表示エクスペリエンスが提供され、複雑なクライアント側のロジックを回避できます。SSAI に関連するコストについては、「IVS コスト」を参照してください。

SSAI の開始方法

このチュートリアルは、Amazon IVS サーバー側の広告挿入 (SSAI) の使用を開始するのに役立ちます。このチュートリアルの最後に、サーバー側の広告挿入用に IVS チャネルが設定され、ライブストリームに広告時間枠を挿入する方法がわかります。IVS SSAI は AWS Elemental MediaTailor と統合されており、広告の決定を処理します。

ステップ 1: IVS チャネルを作成する

IVS チャネルを作成します。次のステップで MediaTailor を設定するには、チャネルの再生 URL が必要です。チャネルを作成したら、次の値を保存します。

ステップ 2: MediaTailor 再生設定を作成する

AWS Elemental MediaTailor 再生設定を作成します。この設定では、広告決定サーバーを IVS に接続し、ストリームの広告挿入を有効にします。

再生設定では、アカウントやリージョンにまたがってすべての IVS チャネルに共通する再生 URL プレフィックスを使用します。つまり、複数の IVS チャネルで単一の MediaTailor 再生設定を使用できます。

手順については、「AWS Elemental MediaTailor ユーザーガイド」の「MediaTailor 再生設定の作成」を参照してください。設定を作成するときは、IVS SSAI に次の設定が必要です。

ステップ 3: IVS 広告設定を作成する

広告設定は、IVS リソースを MediaTailor 再生設定にリンクします。任意の IVS ホームリージョンで作成された MediaTailor 再生設定は、他の IVS ホームリージョンの広告設定で使用できます。IVS ホームリージョンには、us-west-2、us-east-1、eu-west-1、eu-central-1、ap-northeast-1、ap-northeast-2、ap-south-1 などがあります。

単一の広告設定を複数のチャネルで再利用できます。

広告設定を作成するには (AWS CLI):

aws ivs create-ad-configuration --name "my-ad-config" --media-tailor-playback-configurations playbackConfigurationArn="arn:aws:mediatailor:us-west-2:123456789012:playbackConfiguration/my-mediatailor-config"

レスポンスから ARN を保存します。それは次の手順で必要となります。

ステップ 4: 広告設定でチャネルを更新する

IVS チャネルを更新して、作成した広告設定に関連付けます。チャネルを更新するには (AWS CLI):

aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/ABcdef12ghIJ" --ad-configuration-arn "arn:aws:ivs:us-west-2:123456789012:ad-configuration/ABcdef12ghIJ"

ステップ 5: ストリーミングを開始する

チャネルから取り込んだエンドポイントとストリームキーを使用してストリーミングを開始します。

ステップ 6: 広告時間枠を挿入する

ストリームのライブ中に InsertAdBreak オペレーションを呼び出して、広告時間枠を挿入します。チャネル ARN と広告時間枠の期間 (秒単位) を指定します。

広告時間枠を挿入するには (AWS CLI):

aws ivs insert-ad-break --channel-arn "arn:aws:ivs:us-west-2:123456789012:channel/ABcdef12ghIJ" --duration-seconds 30

InsertAdBreak が正常に返されると、広告時間枠が視聴者プレイリストに挿入される予定時刻を示すタイムスタンプを含む EventBridge イベント (IVS 広告時間枠状態変更) を受信できます。これは、広告がコンテンツの置き換えを開始することをブロードキャスターが合理的に期待できる時間です。広告を埋められない場合 (広告決定サーバーが広告を返さない場合や MediaTailor によって広告をトランスコーディングする必要がある場合など)、代わりにソースコンテンツが表示されます。

EventBridge 統合

SSAI では、IVS 広告時間枠状態変更イベント (広告時間枠挿入と呼ばれます) が追加され、次のフィールドが表示されます。

ステップ 7: Player SDK イベント

プラットフォーム全体で、Player SDK は広告時間枠が再生されたときのイベントを表示し、広告が開始、進行、および停止したタイミングを通知します。利用可能なイベントとタイミングの概要を次に示します。

各プラットフォームの特定のイベント名とペイロード名については、次の Player SDK ドキュメントを参照してください。

以下は、ウェブ SDK で広告イベントを使用して、広告時間枠中にシンプルな広告カウントダウン UI コンポーネントを作成する例です。

// State 
let podLength = 0;  
let podIndex = 0; 
let remainingSeconds = 0; 
 
// Fired every second during the ad break 
player.addEventListener(PlayerEventType.AD_TIME_UPDATE, (payload) => { 
    podLength = payload.podLength; 
    podIndex = payload.podIndex; 
    remainingSeconds = Math.round(payload.creativeDuration - payload.creativeElapsed); 
    const text = `Ad ${podIndex} of ${podLength} · ${remainingSeconds}s remaining` 
    // Ad 1 of 2 · 20s remaining 
    console.log('Ad countdown text', text); 
    UpdateAdOverlay(text); 
}); 

// Fired when the ad break ends  
player.addEventListener(PlayerEventType.AD_BREAK_ENDED, (payload) => { 
    hideAdOverlay(); 
});

記録されたコンテンツの広告マーカー

Amazon S3 への自動録画を使用してライブストリームが記録されると、IVS はライブストリーム中に広告がトリガーされた位置に SCTE-35 広告マーカーを含む VOD プレイリストを生成して S3 に書き込みます。詳細については、「SSAI プレイリストリファレンス」を参照してください。

視聴者エクスペリエンス

デフォルトでは、広告時間枠を挿入すると、MediaTailor はすべての視聴者に広告を埋めて配信します。ストリームに再生認可トークンを使用している場合は、再生認可 JWT トークンにクレーム "aws:ads-opt-out": true を追加することで、視聴者による広告の受信をオプトアウトできます。

視聴者が広告時間枠の途中でストリーミングを開始すると、IVS は広告時間枠の期間を 15 秒単位に切り上げます。例えば、60 秒の広告時間枠に残り 35 秒で参加する視聴者には、45 秒の広告時間枠が発生します。

MediaTailor の再生設定を更新したり、新しい広告を追加したりすると、MediaTailor はまず広告をトランスコーディングする必要があるため、広告時間枠を初めてリクエストしたときに視聴者に広告が表示されないことがあります。数分後に改めて InsertAdBreak を呼び出すと、視聴者に広告が表示されます。MediaTailor のトランスコーディングログは、これらのトランスコーディングを記録します。

視聴者追跡パラメータ

Elemental MediaTailor PlaybackConfiguration で広告決定サーバー (ADS) を設定する場合、テンプレートを使用して ADS にパラメータを渡すことができます (「MediaTailor が ADS にパラメータを渡す」を参照)。IVS SSAI では、次の形式のクレームを追加することで、そのユーザーの再生認可トークンを使用して各視聴者のパラメータを渡すことができます。

"aws:ads-player-params": { 
   "key1": "value1", 
   "key2": "value2" 
}

これらのパラメータは Elemental MediaTailor に渡され、[player_params.key1] および [player_params.key2] テンプレート変数として入力されます。このリストに入力したキーは、常に player_params テンプレートパラメータとして名前空間化されます。

すべてのキーと値の合計ペイロードサイズは 1000 バイトに制限されています。

レポートモード

視聴者が広告を視聴すると、クライアントまたはサーバーは各広告クリエイティブの再生の進行状況を示すビーコンを送信できます。デフォルトでは、MediaTailor はサーバー側でビーコン送信を処理します。再生認可トークンに次のクレームを追加することで、レポートモードを制御できます。

"aws:ads-reporting-mode": "CLIENT" | "SERVER"

デフォルト値は SERVER です。SERVER に設定すると、MediaTailor はサーバー側でビーコンを送信します。CLIENT に設定すると、サーバー側のビーコン送信が無効になり、IVS Player SDK adBreakStarted イベントの metadata.trackingData フィールドに追跡データが提供されます。IVS プレイヤー SDK はビーコン URL 呼び出しません。

既知の問題

SSAI プレイリストリファレンス

SSAI を使用したライブバリアントプレイリスト

広告がストリームにステッチされると、IVS は広告セグメントの前に以下に記載されているタグを挿入します。

1. ステッチ広告宣言

#EXT-X-DATERANGE:ID="stitched-ad-1765566299-20000000000",CLASS="live-video-net-stitched-ad",START-DATE="2025-12-12T19:04:59.079Z",DURATION=20.000,X-NET-LIVE-VIDEO-AD-AD-BREAK-ID="test"

2. ストリームソース変更

#EXT-X-DATERANGE:ID="source-1765566299",CLASS="live-video-net-stream-source",START-DATE="2025-12-12T19:04:59.079Z",END-ON-NEXT=YES,X-NET-LIVE-VIDEO-STREAM-SOURCE="0f262e65-a709-4ef1-8741-e82d936c"

3. 不連続マーカー

#EXT-X-DISCONTINUITY

そのエンコード用パラメータを示す標準 HLS タグは、ライブストリームと広告コンテンツでは異なる可能性があります。

広告セグメント

#EXT-X-PROGRAM-DATE-TIME:2025-12-12T19:04:59.079Z 
#EXTINF:2.000,0f262e65-a709-4ef1-8741-e82d936c 
https://4ce388b1cf28.j.cloudfront.hls.live-video.net/v1/segment/CvsCse8Qbs5DU_aRmrVLd72_nK9lo9xS1KjD115LsIXcsD27JfLfkSuamLUivqOTrfHUeGf6Zmx_c9rhq0btTOu7E4F1DaU8knNoebLq6FlKp6q8ysaQdEA10gKCNP92oAQ_0DGLInY462O9HUxgtk5KHj23ZjPhVCxIh3DjWqwaevDci1_q7dYL55rgSKd11SfpsGSS9Yup4g5dfzyGhfz6Y2Skaj34JtoVyd8Nxlppc4jDlZl-6j7YM1i2qdUcM3VNWrZrxCisBXgOPtI3vFdeNcNjPzVdOGjMz5cXcQIp8YOCwnkdkomhn_3xxmB1Zngl3QPao6-oPsjH3qVcMOCuKfKZSmRJGFLvkrO1PefV5ya3eUvihXCMvDE-81EmGp5q9ErEgFpz06rMDbYFWb3z9H8X0t8KzvGDOaqKTYHZ0lgEV-fULeDQ76pDy_OVPwhO2vJMxBpfdQ_IeB1QUK2wJmXJ96Mvv0C2dcb0F7zE3lr_iBGemUjwmb7JmBoM3HdJbpV0TGp8C6vhIAEqCXVzLXdlc3QtMjD3DQ.ts?dna=CmanuVzG9F6kGS2X7ThbGZyZPHWgX2TiBlBMYsvGWLcWaLWyntTaWRp5D9qjZsrGKkzdwoLNY4pri6ZgpxnzqLqWvhcP6zoGu8vifP5NxPgiNKMmYdUmQrqTAf7jbauvE3c6B9ebptAaDEkrbrnG1qF8Cv3kbiABKgl1cy13ZXN0LTIw9w0

SSAI を使用した VOD バリアントプレイリスト

ライブストリームが記録されると、IVS はライブストリーム中に広告がトリガーされた位置に SCTE-35 広告マーカーを含む VOD プレイリストを生成して S3 に書き込みます。VOD 再生中に広告を提供するには、MediaTailor を通じてこの IVS プレイリストを提供します。広告セグメントをプレイリストにステッチングするのは MediaTailor です。MediaTailor は、広告時間枠中に元の VOD セグメントを広告セグメントに置き換えます。

1. 広告時間枠開始マーカー (SCTE35-OUT)

#EXT-X-DATERANGE:ID="12345678",START-DATE="2025-12-06T00:45:45.723Z",PLANNED-DURATION=20.0,SCTE35-OUT=0xFC302000000000000000FFF00F05F8E7AEFC7FFFFE001B7740000000000000340CFD88

2. 広告セグメント (MediaTailor でステッチ)

#EXTINF:2.0, ../../../../segment/b2857627df9428679e888ee8daa979d0b7559801/gk-test-ivs-vod/bd0c7d90-a47c-4a91-b5ec-7d0f9897049b/0/3

3. 広告時間枠終了マーカー (SCTE35-IN)

#EXT-X-DATERANGE:ID="12345678",START-DATE="2025-12-06T00:45:45.723Z",END-DATE="2025-12-06T00:46:07.889Z",DURATION=20.0,SCTE35-IN=0xFC302000000000000000FFF00F05F8E7AEFC7F7FFE001B7740000000000000C23E5851