このガイドでは、Video Stitcher API でサポートされている広告メタデータ機能について説明します。広告メタデータは、広告タグ レスポンスの VAST 広告から抽出されます。広告メタデータには、広告トラッキング イベントとコンパニオン広告が含まれます。広告タグの URL は、セッション作成リクエストで構成されます。詳細については、ライブ セッションを管理するとVOD セッションを管理するをご覧ください。
始める前に
Video Stitcher API の基本的なコンセプトと用語に精通していることを確認してください。詳細については、技術的な概要をご覧ください。
はじめに
広告メタデータには、ステッチされた広告に関連付けられた広告トラッキング イベントとコンパニオン広告が含まれます。広告トラッキング イベントには、VAST 広告と視聴者のインタラクションをトラッキングするために使用されるコールバック ピングが含まれています。コンパニオン広告は、親の VAST 広告を補完する広告です。クライアントサイド トラッキング モードでは、視聴者の行動に基づいてイベントをトリガーする責任はお客様にあります。
サーバーサイド広告トラッキング
サーバーサイド トラッキング モードでは、各広告セグメント URI はリダイレクト URI でラップされ、プレーヤーがこれらのセグメントをリクエストするたびに、Video Stitcher API が進行状況イベントの処理を処理します。ただし、pause
などのアクティビティ イベントは、動画スティッチャー API では処理されません。
クライアントサイド広告トラッキング
クライアントサイド トラッキング モードでは、クライアントがイベントをトリガーします。詳細については、イベントのドキュメントをご覧ください。
進行状況イベントは、広告の再生中に指定された時間が経過したときにトリガーされるイベントです。たとえば、イベント Start
は広告の開始時にトリガーする必要があります。進行状況イベントの詳細については、進行状況イベント オブジェクトをご覧ください。
アクティビティ イベントは、視聴者が特定のアクティビティを実行したときにトリガーされるイベントです。たとえば、視聴者が広告動画を一時停止したときにイベント pause
をトリガーする必要があります。アクティビティ イベントの詳細については、アクティビティ イベント オブジェクトをご覧ください。
VOD クライアントサイド広告トラッキング
インタースティシャル オブジェクトは、VOD セッション作成リクエストのレスポンスで返されます。VOD セッションの作成方法については、VOD セッションを作成するをご覧ください。
インタースティシャルには、挿入された各広告のメタデータが含まれています。クライアント広告トラッキング モードが有効になっている場合、クライアントは必要に応じてトラッキング イベントをトリガーする責任を負います。詳しくは、interstitials オブジェクトをご覧ください。
ライブ クライアントサイド広告トラッキング
Video Stitcher API は、ライブ配信に広告を継続的に挿入します。新しい広告が挿入されるたびに、広告メタデータ情報が生成されます。
HLS の場合、広告メタデータを取得する AdMetadataURI
は #EXT-X-DATERANGE
タグにあります。
DASH の場合、広告メタデータを取得する AdMetadataURI
は、各 <Period>
要素の <EventStream>
要素にあります。
詳しくは、ライブ クライアントサイド トラッキングを処理する方法をご覧ください。
コンパニオン広告
コンパニオン広告は、挿入されたリニア広告とともに表示される補足広告です。詳しくは、コンパニオン広告オブジェクトをご覧ください。
次のステップ
- 特定の Video Stitcher API タスクを完了する方法を学習する。