ガイド:広告パートナーとの連携
概要
たとえば、広告システムがGoogle IMA3に準拠している場合、この情報は必要ありませんが、既存のプラグインをIMA3に使用するだけで済みます。 IMA3 Plugin Guideによる広告.
この機能が必要であると判断した場合、このコンテンツは、Brightcove Player との広告連携に必要な広告APIフレームワークについて説明します 。 このフレームワークの3つの実装を見ることができます Brightcove GoogleのIMAXNUMXとFreeWheel(次の段落に示すドキュメント)用のものが作成されています。
ここでも、このドキュメントは、既存の広告フレームワークを動画で使用したいユーザー向けのものではありません。 これらの顧客に適したドキュメントは次のとおりです。
広告フレームワーク機能
Brightcove カスタム広告プラグインの基礎として広告APIフレームワークを提供します。 フレームワークは、ビデオ広告ライブラリが必要とする共通の機能を提供します。 Brightcove Player広告統合のために作成しなければならないコードを減らすことができます。 このフレームワークは、あなたが構築できるオープンソースプロジェクトとして提供されています。 プロジェクトコードはGitHubリポジトリから入手できます videojs-contrib-ads.
広告フレームワークにより、広告パートナーは次のことが可能になります。
- 広告エクスペリエンス(つまり、広告の外観と動作)を完全に制御する player 広告の再生中)。
- カスタムまたは専用の広告サーバーで作業します。
- 広告リクエストがいつ行われたか、クリエイティブがどのようにバッファされるかを判断するなど、低水準の広告実装の詳細を管理します。
- Brightcove Player エコシステムとビデオアナリティクスプロバイダとの簡単な相互運用性。
基礎知識
広告APIフレームワークを使用して構築するには、詳細な理解が必要です。次の Brightcove 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>
この表には、オプションのリストがあります。
オプション | 種類 | デフォルト | 説明 |
---|---|---|---|
timeout |
数 | 5000 | 再生前に広告実装が初期化されるまでの最大待機時間(ミリ秒単位) |
prerollTimeout |
数 | 1000 | 広告の実装がプリロールを開始するまでの最大待機時間(ミリ秒単位) |
postrollTimeout |
数 | 100 | 広告実装がポストロールを開始するまでの最大待機時間(ミリ秒単位) |
debug |
ブール値 | false | debugがtrueに設定されている場合、広告プラグインは再生中に現在の状態に関する追加情報を出力します |
イベント
以下のイベントは、2つの異なるタイプに分類されます。 グループ化とその説明が続きます。
adstart
更に adend
イベントは、広告インテグレータからのメソッド呼び出しに応じてフレームワークによってトリガされます。 これらのイベントは、広告インテグレータによって直接トリガされるべきではありません。
イベント | 説明 |
---|---|
adstart | プレーヤーがリニア広告再生モードに入った |
adend | プレーヤーはリニア広告再生モードから復帰しました |
adskip
更に adtimeout
イベントは、広告インテグレーターがトリガーを選択して、 player プレロールまたはポストロールの機会をスキップする必要があります。
イベント | 説明 |
---|---|
adskip | プレーヤーはリニア広告の機会をスキップし、コンテンツの再生はすぐに再開する必要があります |
adtimeout | プラグインによって管理されているタイムアウトが切れており、通常のビデオコンテンツが再生を開始しています |
ランタイム設定
プラグインが初期化されると、その動作を変更するために使用できるプロパティがあります。
プロパティ | 説明 |
---|---|
contentSrc | このプロパティは、新しいビデオがいつ読み込まれるかを決定するために使用されます。 player 「プレロールを表示する準備をする」状態にリセットできます。 広告プロバイダーは通常それと対話しませんが、たとえばレンディションセレクターを実装するためにビデオソースを変更したいプラグインの作成者は、 contentSrc レンディションスイッチが発生したときにプリロールが開始されないようにしました。 |
例
サンプル実装
実践的な運動のセクション 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()
ミッドロールを開始する。 キューポイントをリスンしたり設定したりする方法については、 キューポイントの使用 の資料をご参照ください。