ガイド：広告パートナーとの連携

概要

たとえば、広告システムがGoogle IMA3に準拠している場合、この情報は必要ありませんが、既存のプラグインをIMA3に使用するだけで済みます。 IMA3 Plugin Guideによる広告.

この機能が必要であると判断した場合、このコンテンツは、Brightcove Player との広告連携に必要な広告APIフレームワークについて説明します 。 このフレームワークの3つの実装を見ることができます Brightcove GoogleのIMAXNUMXとFreeWheel（次の段落に示すドキュメント）用のものが作成されています。

ここでも、このドキュメントは、既存の広告フレームワークを動画で使用したいユーザー向けのものではありません。 これらの顧客に適したドキュメントは次のとおりです。

• IMA3プラグインによる広告
• FreeWheelプラグインによる広告
• サーバーサイド広告の実装 Brightcove Player

広告フレームワーク機能

Brightcove カスタム広告プラグインの基礎として広告APIフレームワークを提供します。 フレームワークは、ビデオ広告ライブラリが必要とする共通の機能を提供します。 Brightcove Player広告統合のために作成しなければならないコードを減らすことができます。 このフレームワークは、あなたが構築できるオープンソースプロジェクトとして提供されています。 プロジェクトコードはGitHubリポジトリから入手できます videojs-contrib-ads.

広告フレームワークにより、広告パートナーは次のことが可能になります。

• 広告エクスペリエンス（つまり、広告の外観と動作）を完全に制御する player 広告の再生中）。
• カスタムまたは専用の広告サーバーで作業します。
• 広告リクエストがいつ行われたか、クリエイティブがどのようにバッファされるかを判断するなど、低水準の広告実装の詳細を管理します。
• Brightcove Player エコシステムとビデオアナリティクスプロバイダとの簡単な相互運用性。

基礎知識

広告APIフレームワークを使用して構築するには、詳細な理解が必要です。次の Brightcove Player プラグインのアーキテクチャドキュメントでは、この知識を提供しています。

• 概要： Player プラグイン
• データをプラグインに渡す
• プラグインのローカライズ

必要な場合は、Brightcove からの視点で見た動画広告の概要を見つけることができます：

• 学習ガイド：動画広告

フレームワークの使用

以下のセクションでは、フレームワークの使用方法について詳しく説明します。

フレームワークリソースを含める

プラグインを使用するには、まずプラグイン用のCSSとJavaScriptを含める必要があります。

<link rel="stylesheet" href="//mypath/videojs.ads.css">
<script src="//mypath/videojs.ads.js"></script>

JavaScriptを含めたら、関数を呼び出して広告フレームワークを初期化できます。

<script type="text/javascript">
  videojs.getPlayer('myPlayerID').one('loadedmetadata', function(){
    var myPlayer = this;
    // Initialize the ad framework
    myPlayer.ads();
  });
</script>

設定オプション

フレームワークにはいくつかの設定オプションが用意されています。 たとえば、 timeout オプション。 このオプションを設定するには、次のコードを使用します。

<script type="text/javascript">
  videojs.getPlayer('myPlayerID').one('loadedmetadata', function(){
    var myPlayer = this;
    // Initialize the ad framework
    myPlayer.ads({
      "timeout": 3000
    });
  });
</script>

この表には、オプションのリストがあります。

イベント

以下のイベントは、2つの異なるタイプに分類されます。 グループ化とその説明が続きます。

　 adstart 更に adend イベントは、広告インテグレータからのメソッド呼び出しに応じてフレームワークによってトリガされます。 これらのイベントは、広告インテグレータによって直接トリガされるべきではありません。

　 adskip 更に adtimeout イベントは、広告インテグレーターがトリガーを選択して、 player プレロールまたはポストロールの機会をスキップする必要があります。

ランタイム設定

プラグインが初期化されると、その動作を変更するために使用できるプロパティがあります。

例

サンプル実装

実践的な運動のセクション IMA3 Plugin Guideによる広告 IMA3の広告にプラグインを使用する簡単な実装を紹介します。

擬似コード統合

ここには、基本的な広告統合の外観を示す疑似コードがあります。 この例では、各コンテンツ動画の前に1つのプリロール広告を表示し、広告プラグインによって提供されるインタラクションポイントを示しています。 実際には実行可能な例ではありません。コードコメントで指定されたより多くの情報が必要なためです。

<script type="text/javascript">
  videojs.getPlayer('myPlayerID').one('loadedmetadata', function(){
    var player = this;
    player.ads(); // initialize the ad framework

    // request ads whenever there's new video content
    player.on('contentupdate', function(){
      // fetch ad inventory asynchronously, then ...
      player.trigger('adsready');
    });

    player.on('readyforpreroll', function() {
      player.ads.startLinearAdMode();
      // play your linear ad content
      player.src('http://url/to/your/ad.content');
      player.one('durationchange', function(){
        player.play();
      });
      // when all your linear ads have finished...
      player.one('ended', function() {
        player.ads.endLinearAdMode();
      });
    });
  });
</script>

よくあるご質問

広告プラグインはメディアメタデータにどのようにアクセスできますか？

COVID-XNUMX Video Cloud 顧客は、プラグインを使用してメタデータにアクセスします mediainfo オブジェクト。メタデータが設定されます。 Video Cloud. Brightcove Player 顧客は、 mediainfoオブジェクトを手動で作成する 彼らは、Video Cloud CMS。

広告プラグインにオプションを指定するにはどうすればよいですか？

プラグインオプションは、 Studio's Players>プラグイン セクション。 の player プラグインを含むオプションは、iframeまたはページはめ込みの埋め込みコードを使用して公開できますが、プラグインオプションには静的な情報（説明など）が含まれます。 に示す手法を使用して、動的データをプラグインに渡すことができます。 データをプラグインに渡す の資料をご参照ください。

広告プラグインはFlashベースの広告をどのようにサポートするべきですか？

Brightcove Flashベースの広告のパッケージ化を推奨 player 広告プラグインの実装とそのオーバーレイの一部として player コンテンツ中 player リニア広告モードです。

キューポイントはミッドロールをどのようにトリガーできますか？

キューの変更については、 startLinearAdMode() ミッドロールを開始する。 キューポイントをリスンしたり設定したりする方法については、 キューポイントの使用 の資料をご参照ください。