サポート サポート問い合わせ先 | システムステータス システムステータス
ページ内容

    IMA3プラグインバージョン3へのアップグレード

    このトピックでは、IMA3 Advertising Pluginバージョン3へのアップグレードについて学びます。

    概要

    2018の5月に Brightcove IMA Advertisingプラグインのバージョン3をリリースしました。 このアップデートには、信頼性の大幅な改善が含まれています。その他の領域については、このドキュメントの次のセクションで詳しく説明します。 更新は Brightcove Player バージョン6以降のみ。 既存のバージョン6 player新しいバージョンをサポートするために一部の統合を更新する必要がある場合があるため、は自動的にバージョン3に移行されません。 Brightcove このドキュメントを完全に読んでから、アップグレードする前に変更をテストすることをお勧めします。

    旧モデルからの改善

    以下は、プラグインのバージョン3で行われた改良の一覧です:

    • プラグインがビデオソースの変更を処理することは基本的に修正されており、プレイリストと併用すると信頼性が大幅に向上します。
    • サーバーURLの設定を遅らせることができるため、ヘッダー入札やメディア情報に基づくマクロなどの非同期ワークフローを簡単に統合できます。 以下は2つの例です。
    • バグが修正され、予想より長いタイムアウトにつながる可能性があります。
    • Flashサポートは、パフォーマンスを向上させるために削除されました。
    • さまざまな追加のバグ修正と信頼性の向上が新しいバージョンに組み込まれています。
    • 広告マクロにデフォルト値を指定できます。 マクロ内にデフォルト値を与えることができます。この場合、この値は変数が未定義の場合に使用されます。 構文は次のとおりです。

      {macro=default}

      例えば、

      http://example.com/ad/{pageVariable.adConf=1234}

      if window.adConf 定義されていません:

      http://example.com/ad/1234

    技術的詳細

    信頼性を向上させるために、 Brightcove IMAプラグインが依存関係を更新しました videojs-contrib-ads、オープンソースのVideo.js広告フレームワーク、バージョン6へ。 これは主要なメンテナンスアップデートです。 詳細については、 videojs-contrib-ads バージョン6 Video.jsのブログ.

    この更新プログラムは、プリロールの前に表示されたコンテンツフラッシュの根本的な原因を取り除きます。 このソリューションは、 Video.jsミドルウェア 再生の開始時にすばやく再生して一時停止する必要性を排除します。

    バージョン3への移行

    既存の playerのバージョン3に自動的にアップグレードされません Brightcove IMAプラグイン。 デフォルト(レガシー) Studio インターフェース、IMAプラグインのバージョン2は、以前と同様に常に使用されます。 ベータ版(新) Studio インターフェース、 Advertising セクションには、使用するIMAプラグインのバージョンを選択できるドロップダウンがあります。 この新しいインターフェースは移行に使用できます players. Brightcove 統合を確認し、慎重にテストすることを強くお勧めします player アップグレード時。

    新しく作成された player■広告が有効な場合、デフォルトでバージョン3を使用します。 必要に応じて手動でバージョン2に設定できます。

    統合の更新が必要になる可能性がある変更の一覧は次のとおりです。

    • あなたの設定で指定されているものより長い時間切れに依存していないことを確かめるためにテストしたいかもしれません。
    • ended イベントはもはや1秒遅れることはありません。 あなたの統合が ended 統合が期待どおりに機能することをテストする必要があります。 一般に、これは、そのような統合がより良く機能することを意味します。
    • player.ads.state プロパティは廃止予定です。 Brightcove いくつかの統合でそれが player は広告モードですが、通常は正しく行われません。 より良い代替手段は、 player.ads.isInAdMode() 方法。
    • contentplayback イベントは削除されました。 もはや必要とされない実装の詳細ですが、いくつかの統合がそれを使用していることがわかりました。 使用 playing 代わりにイベント。
    • 広告の再生の開始は、 ads-ad-started イベントは、各広告の開始時に1回だけ発生します。 一方、 adplaying イベントは引き続き発行されますが、広告再生ごとに複数回送信される可能性があります Brightcove したがって、 ads-ad-started 代わりにイベント。

    なぜメジャーバージョンがアップデートされますか?

    変更は控えめに見えるかもしれませんが、インタフェースのいくつかの重要な側面が変更され、メジャーバージョンの更新が促されます。 具体的には、 contentplayback イベントの特定の動作だけでなく、 timeout パラメータ。 これらはマイナーなように見えるかもしれませんが、一部の統合は特定の動作に依存する場合があります。 小さな変更でさえ、いくつかの顧客の実装に大きな違いをもたらす可能性があるので、 Brightcove 生産に使用する前に統合を完全にテストする必要があることを示すためには、メジャーバージョンの増分が適切であると感じています。


    ページの最終更新日:28年2020月XNUMX日