NextGen Live SSAI のプレーヤー機能拡張の実装

概要

NextGen Live 向け Brightcove Player SSAI プラグインは、ユーザー体験を向上させるサーバーサイド広告挿入機能を提供します。このプラグインは、従来の Live SSAI 実装に対していくつかの主要な機能拡張を提供します：

広告オーバーレイ：広告ブレーク中に残り時間を表示します
PAL 連携：ノンス生成を含む Google Publisher Advertiser Identity Reconciliation（PAL）サポート
Open Measurement 連携：既存の OM フローを通じた広告検証
シンプルな設定：追加の広告設定は不要 - すべてがプレーヤーで設定されます

このガイドを完了すると、次のことができるようになります：

NextGen Live 向け SSAI プラグインを搭載した Brightcove Player の作成
最適な広告体験のためのプラグインオプションの設定
SSAI 対応 NextGen Live ストリーム向けの埋め込みコードの作成
従来の Live SSAI 実装との主な違いの理解

前提条件

NextGen Live アクセスおよび SSAI が有効化されたアカウント
プレーヤー管理のための Brightcove Studio へのアクセス
アカウントに設定された有効な広告設定
Brightcove Player 設定の理解

ワークフロー

NextGen Live SSAI Player プラグインを実装するには、次の手順に従います：

SSAI プラグインを使用したプレーヤーの作成
プラグインオプションの設定
SSAI 対応ストリームの埋め込みコードの作成
実装のテスト

SSAI プラグインを使用したプレーヤーの作成

NextGen Live SSAI 機能を使用するには、特定のバージョンと SSAI プラグイン設定を持つプレーヤーを作成する必要があります。

Players モジュールの使用

Studio の Players モジュールに移動します。
Add Player をクリックします。
プレーヤーの Name を入力します。
Player Version を 7.38.4 以降に設定します。

バージョン 7.38.4 はこの機能に必要な最小バージョンです。7.38.4 以降であれば任意のバージョンを使用できます。

Plugins セクションに移動し、次の JSON ブロックを追加して SSAI プラグインを含めます：

        "plugins": [
          {
            "name": "ssai",
            "is_packaged": true,
            "options": {
              "trackingBeacons": false,
              "googlePal": true,
              "hideOverlays": false
            }
          }
        ]

必要に応じてプラグインオプションを設定します（詳細についてはプラグインオプションの設定セクションを参照してください）。
Save をクリックし、プレーヤーを Publish します。

プラグインオプションの設定

NextGen Live 向け SSAI プラグインは、広告体験をカスタマイズするためのいくつかの設定オプションをサポートしています：

オプション	タイプ	デフォルト	説明
`trackingBeacons`	Boolean	`false`	広告イベントのトラッキングビーコンを有効または無効にします
`googlePal`	Boolean	`true`	Google Publisher Advertiser Identity Reconciliation（PAL）連携を有効にします。広告リクエストに使用するためにバックエンドに渡される `givn` ノンスを生成します
`hideOverlays`	Boolean	`false`	広告ブレーク中に残り時間を表示する広告オーバーレイを非表示にします。オーバーレイ表示を無効にするには `true` に設定します

プラグイン設定のサンプル

    {
      "name": "ssai",
      "is_packaged": true,
      "options": {
        "trackingBeacons": false,
        "googlePal": true,
        "hideOverlays": false
      }
    }

SSAI 対応ストリームの埋め込みコードの作成

SSAI プラグインを使用してプレーヤーを設定したら、Studio を使用して NextGen Live SSAI ストリームの埋め込みコードを簡単に作成できます。

Studio の Live モジュールに移動します。
SSAI が有効化された NextGen Live チャンネルを選択します。
調整室で Embed on Web をクリックします。
Player ドロップダウンから新しく作成したプレーヤーを選択します。
ドロップダウンから適切な Ad Configuration を選択します。
ウェブサイトまたはアプリケーションで使用する埋め込みコードをコピーします。

従来の Live SSAI との主な違い

NextGen Live SSAI Player プラグインは、従来の Live SSAI 実装からいくつかの重要な変更を導入します：

シンプルな設定

追加の広告設定不要：すべての広告設定は NextGen Live でデフォルトで有効化されています
プレーヤーレベルの設定：すべての機能拡張オプションは、プレーヤーと広告設定に分散されるのではなく、プレーヤープラグインで設定されます

以前はプレーヤーと広告設定の両方で設定されていた詳細は、現在はプレーヤーのみで利用できます。これらのオプションには以下が含まれます：

    "client_options": {
      "show_ad_break_remaining_time": true / false,
      "show_ad_remaining_time": true / false,
      "show_number_of_remaining_ads": true / false,
      "client_only_tracking": true / false
    }

実装のテスト

NextGen Live SSAI Player プラグインの設定が完了したら、次の手順に従って実装をテストします：

SSAI を有効にした NextGen Live ストリームを開始します。
埋め込みコードまたは URL を使用してプレーヤーを読み込みます。
調整室または SCTE-35 シグナリングを使用してテスト広告ブレークを挿入します。
広告オーバーレイが正しく表示されていることを確認します（hideOverlays が false の場合）。
PAL 連携をノンス生成のネットワークリクエストを監視して確認します（googlePal が true の場合）。
有効になっている場合は、トラッキングビーコンをテストして適切な広告イベントレポートが行われていることを確認します。