概要
2018 年 5 月、ブライトコーブは IMA 広告プラグインのバージョン 3 をリリースしました。この更新プログラムには、信頼性の大幅な向上と、このドキュメントの次のセクションで詳しく説明されているその他の領域が含まれています。アップデートは、Brightcove Player バージョン 6 以降のみを対象としています。既存のバージョン 6 プレイヤーは、新しいバージョンをサポートするために一部のインテグレーションを更新する必要があるため、バージョン 3 に自動的に移行されません。ブライトコーブでは、この文書を完全に読み、アップグレードする前に変更をテストすることをお勧めします。
改善点
以下は、プラグインのバージョン 3 で行われた改善点の一覧です。
- プラグインによるビデオソースの変更の処理が根本的に再加工され、プレイリストで使用する際の信頼性が大幅に向上しました。
- サーバーURLの設定を遅らせることができるため、メディア情報に基づくヘッダー入札やマクロなどの非同期ワークフローを簡単に統合できます。次に、2 つの例を示します。
- ジャンプ開始:ヘッダー入札広告文書。
- ザ・コードを使用して実装する IMA3プラグインドキュメントのセクション。
- 予想よりも長いタイムアウトを引き起こす可能性があるバグが修正されました。
- パフォーマンスを向上させるために、フラッシュのサポートが削除されました。
- さまざまなバグ修正と信頼性の向上が、新しいバージョンに組み込まれています。
-
広告マクロにはデフォルト値を指定できます。マクロ内でデフォルト値を指定できます。この場合、変数が未定義の場合にこの値が使用されます。構文は次のとおりです。
{macro=default}
例えば、
http://example.com/ad/{pageVariable.adConf=1234}
window.adConf
が未定義の場合、次のように解決されます。http://example.com/ad/1234
技術的な詳細
信頼性を向上させるために、ブライトコーブ IMA プラグインは、オープンソースの Video.js 広告フレームワークである videojs-contrib-ads への依存関係をバージョン 6 に更新しました。これは主要なメンテナンスアップデートです。 videojs-contrib-ads バージョン 6 の詳細については、 Video.js ブログを参照してください。
この更新プログラムを適用すると、プレロールの前に現れた一部のコンテンツの点滅の根本原因が削除されます。このソリューションは、 Video.js ミドルウェアを使用して、クイック再生を行い、再生の開始時に一時停止する必要性を排除します。
バージョン 3 への移行
既存のプレーヤーは、ブライトコーブ IMA プラグインのバージョン 3 に自動的にアップグレードされません。デフォルト(レガシー)Studioインターフェイスでは、過去のものと同様に、IMAプラグインのバージョン2が常に使用されます。ベータ(新しい)Studio インターフェイスでは、 Advertising セクションにドロップダウンがあり、使用する IMA プラグインのバージョンを選択できます。この新しいインターフェースは、プレイヤーを移行するために使用できます。ブライトコーブでは、インテグレーションを確認し、アップグレード時にプレーヤーを慎重にテストすることを強くお勧めします。
広告が有効な場合、新しく作成されたプレイヤーは、デフォルトでバージョン 3 を使用します。必要に応じて、手動でバージョン 2 に設定できます。
統合の更新が必要になる可能性のある変更のリストを次に示します。
- 設定で指定されている時間よりも長いタイムアウトに依存していないことを確認するために、テストを行うこともできます。
ended
イベントが 1 秒遅れることがなくなりました。ended
インテグレーションがイベントに応答する場合は、インテグレーションが期待どおりに動作し続けることをテストする必要があります。一般的に、これは、このような統合のパフォーマンスが向上することを意味します。player.ads.state
プロパティは廃止されました。ブライトコーブは、一部のインテグレーションでプレーヤーが広告モードになっているかどうかを確認するために使われていますが、通常は正しく行われていません。より良い選択肢は、player.ads.isInAdMode()
メソッドを使用することです。contentplayback
イベントは削除されました。これはもはや必要のない実装の詳細ですが、一部の統合ではそれが使用されることがわかりました。playing
代わりにイベントを使用してください。- 広告再生の開始は、
ads-ad-started
各広告の開始時に一度だけ起動するイベントによって示されます。adplaying
イベントは引き続き放出されますが、広告再生ごとに複数回放出される可能性があるため、ブライトコーブではads-ad-started
イベントを代わりにします。
メジャーバージョンがアップデートされる理由は何ですか?
変更は控えめに見えますが、インターフェイスのいくつかの重要な側面が変更され、メジャーバージョンの更新が求められます。具体的には、contentplayback
イベントの除去、timeout
およびパラメータの特定の動作。これらは軽微に見えますが、一部の統合は特定の動作に依存する場合があります。わずかな変更でもお客様の実装に大きな違いが生じる可能性があるため、ブライトコーブは、実稼働環境で使用する前に統合を徹底的にテストする必要があることを示すために、メジャーバージョンの増分が適切であると感じています。