このガイドでは、広告または スレート セグメントをリクエストするようにマニフェスト マニピュレータを構成する方法について説明します。広告連続配信広告 セグメント メソッドを使用します。
ストリーミング プロトコルを選択します。
前提条件
続行する前に、Pod サービング リダイレクト ダイナミック広告挿入（DAI）タイプとエンコード プロファイル用のライブ ストリーム イベントを設定する必要があります。ライブ配信イベントを設定するには、次のいずれかの方法を選択します。
- アド マネージャーの管理画面: DAI のライブ ストリームを設定します 。
- Ad Manager API: クライアント ライブラリを使用して
LiveStreamEventService.createLiveStreamEventsメソッドを呼び出します。LiveStreamEvent.dynamicAdInsertionTypeパラメータをPOD_SERVING_REDIRECTに設定します。 - リクエストを認証する: セグメント リダイレクト連続配信広告の配信を使用して行われた各セグメント リクエストには、認証用の HMAC 署名付きトークンを含める必要があります。このトークンはミッドロール挿入点ごとに 1 回計算し、すべてのストリーム セッションで共有します。 HMAC トークンを計算するには、広告連続配信広告リクエストを認証するをご覧ください。
ライブ ストリーム イベントを設定したら、イベントのエンコード プロファイル
をアド マネージャーの管理画面または API から
DaiEncodingProfileService.getDaiEncodingProfilesByStatement
メソッドを呼び出して取得します。
コンテンツ ストリームを取得する
ユーザーがライブ ストリーム イベントを選択すると、クライアント アプリは Google アド マネージャーにストリーム リクエストを送信します。ストリーム レスポンスで、アプリは Google DAI セッション ID とメタデータを抽出して、ストリーム マニフェスト リクエストに含めます。
次の例では、Google DAI セッション ID をマニフェスト マニピュレータに渡します。
https://MANIFEST_MANIPULATOR_URL/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY
動画コンテンツの再生リクエストを処理するときは、広告のステッチに備えて、リクエストから Google DAI セッション ID と CUSTOM_ASSET_KEY を保存します。
ミッドロール挿入点セグメントを特定して不連続性を挿入する
各バリアント マニフェストを処理するときに、ストリーム内の EXT-X-CUE-IN タグと EXT-X-CUE-OUT タグを特定します。これらはミッドロール挿入点の開始と終了を示します。
クライアント動画プレーヤーがコンテンツと広告を切り替えられるように、EXT-X-CUE-IN タグと EXT-X-CUE-OUT タグを EXT-X-DISCONTINUITY 要素に置き換えます。
次のマニフェストの例では、EXT-X-CUE-IN タグと EXT-X-CUE-OUT タグを置き換えています。
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.000,
contentorigin.com/1.ts
#EXTINF:5.000,
contentorigin.com/2.ts
#EXT-X-CUE-OUT:15.000
#EXTINF:5.000,
contentorigin.com/3.ts
#EXTINF:5.000,
contentorigin.com/4.ts
#EXTINF:5.000,
contentorigin.com/5.ts
#EXT-X-CUE-IN
#EXTINF:5.000,
contentorigin.com/6.ts
#EXTINF:5.000,
contentorigin.com/7.mp4
#EXTINF:5.000,
contentorigin.com/8.mp4
次の例は、置き換えられたマニフェストを示しています。
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.000,
contentorigin.com/1.ts
#EXTINF:5.000,
contentorigin.com/2.ts
#EXTINF:5.000,
#EXT-X-DISCONTINUITY
{... Insert ad segments here ...}
#EXT-X-DISCONTINUITY
#EXTINF:5.000,
contentorigin.com/6.mp4
#EXTINF:5.000,
contentorigin.com/7.mp4
#EXTINF:5.000,
contentorigin.com/8.mp4
Google DAI 広告セグメントは暗号化されていません。コンテンツが暗号化されている場合は、各ミッドロール挿入点の最初の広告セグメントの前に EXT-X-KEY:METHOD=NONE 要素を挿入して暗号化を解除します。ミッドロール挿入点の最後に、適切な EXT-X-KEY を挿入して暗号化を元に戻します。
今後のミッドロール挿入点の開始時刻、長さ、インデックスを記録します。
広告セグメントの URL を作成する
EXT-X-DISCONTINUITY タグの間の各コンテンツ セグメントを、広告連続配信広告セグメント メソッドを指す URL に置き換えます。
次の例では、連続配信広告セグメントを組み立てています。広告セグメントでは 0 から始まるインデックスが使用されます。
https://dai.google.com/linear/pods/v1/seg/network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/0.ts?sd=AD_SEGMENT_DURATION&pd=AD_BREAK_DURATION&stream_id=SESSION_ID&auth-token=HMAC
次の例では、連続配信広告セグメントをマニフェストに挿入しています。
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:5.00,
contentorigin.com/1.ts
#EXTINF:5.00,
contentorigin.com/2.ts
#EXT-X-DISCONTINUITY
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/0.ts?sd=5000&so=0&pd=15000&stream_id=SESSION_ID
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/1.ts?sd=5000&so=5000&pd=15000&stream_id=SESSION_ID
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/2.ts?sd=5000&so=10000&pd=15000&stream_id=SESSION_ID
#EXT-X-DISCONTINUITY
#EXTINF:5.00,
contentorigin.com/6.mp4
#EXTINF:5.00,
contentorigin.com/7.mp4
#EXTINF:5.00,
contentorigin.com/8.mp4
省略可: ミッドロール挿入点をスケジュールする
広告掲載率を高めるには、連続配信広告の長さ、カスタム ターゲティング パラメータ、SCTE-35 シグナルデータを含む早期ミッドロール挿入点通知（EABN）を送信します。詳しくは、早期ミッドロール挿入点通知を送信するをご覧ください。