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

概要

NextGen Live 向け Brightcove Player SSAI プラグインは、ユーザー体験を向上させる機能を備えた強化されたサーバーサイド広告挿入機能を提供します。このプラグインは、従来の Live SSAI 実装と比較して以下の主要な拡張機能を備えています:

広告オーバーレイ: 広告ブレーク中に残り時間を表示
PAL 統合: Google Publisher Advertiser Identity Reconciliation (PAL) をサポートし、nonce 生成を実行
Open Measurement 統合: 既存の OM フローを通じた広告検証
設定の簡素化: 追加の広告設定は不要 - すべてプレーヤー側で設定可能

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

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

対象者

Brightcove Player を使用して NextGen Live ストリームに強化された SSAI 機能を実装する必要がある開発者およびコンテンツ制作者。

前提条件

NextGen Live アクセス権と SSAI が有効なアカウントを持っていること。
プレーヤー管理用の Brightcove Studio へのアクセスがあること。
アカウント内に設定された有効な広告設定があること。
Brightcove Player 設定に関する理解があること。

ワークフロー

NextGen Live SSAI プレーヤープラグインを実装するには、以下の手順に従います:

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

SSAI プラグイン付きプレーヤーの作成

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

Players モジュールを使用する

Studio の Players モジュールに移動します。
プレーヤーの追加をクリックします。
プレーヤーの名前を入力します。
JSON エディタで、Player Version を 7.38.4 に手動で設定します。

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

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

必要に応じてプラグインオプションを設定します（詳細はプラグインオプションの設定セクションを参照）。
保存をクリックし、その後公開してプレーヤーを公開します。

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

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

オプション	タイプ	デフォルト	説明
`trackingBeacons`	真偽値	`false`	広告イベント用のトラッキングビーコンを有効または無効にする。
`googlePal`	真偽値	`true`	Google Publisher Advertiser Identity Reconciliation (PAL) の統合を有効化。広告リクエストで使用するためにバックエンドに渡される `givn` nonce を生成。
`hideOverlays`	真偽値	`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 チャンネルを選択します。
調整室で公開と埋め込みをクリックします。
プレーヤー ドロップダウンから新しく作成したプレーヤーを選択します。
ドロップダウンから適切な Ad Configuration を選択します。
ウェブサイトやアプリケーションで使用するために埋め込みコードをコピーします。

従来の Live SSAI との主な違い

NextGen Live SSAI プレーヤープラグインは、従来の 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 プレーヤープラグインを設定した後、以下の手順に従って実装をテストしてください:

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