サポート問い合わせ先| システムステータス
ページコンテンツ

    ネイティブSDKを使用したクライアントサイド広告の実装

    このトピックでは、Brightcove NativeSDKを使用してクライアント側の広告を再生する方法を学習します。

    概要

    クライアント側広告では、クライアントデバイスから広告サーバーにリクエストを送信することが含まれます。これにより、広告動画の取得中にバッファリング時間がかかります。テレビのようなエクスペリエンスを実現するには、サーバー側の広告挿入を使用できます。

    クライアント側広告では、広告キューポイントが検出されるか、VMAP 応答からの広告のタイミングに到達するまで、コンテンツ動画が再生されます。設定された広告サーバーにリクエストが行われ、広告の詳細が応答します。その後、プレーヤーは要求された広告の再生を開始します。

    Brightcoveのネイティブ SDK は、次のテクノロジ用のプラグインを提供します。

    ネイティブSDKは、Googleの広告マネージャとGoogleのAdSenseネットワークであるパブリッシャーのためのDoubleClick（DFP）を使用するときに生成された VMAP をサポートしています。

    広告の種類

    動画で使用できる広告には、主に次の 3 種類があります。

    リニア広告 -メインコンテンツのビデオを一時停止し、プレーヤーの全フレームに表示される広告

    ノンリニア広告 -メインコンテンツ動画の上にオーバーレイ広告が表示されます。これらは、テキスト、グラフィカル画像、またはビデオオーバーレイであっても可能です。

    コンパニオン広告 -動画プレーヤーの外に表示される広告

    広告スタンダード

    標準の XML ファイルを使用して、広告を再生するタイミングと再生する広告をプレーヤーに通知できます。インタラクティブ広告局（IAB）は、動画プレーヤーと広告ユニットの間で次の共通インターフェイスを思いつきました。

    動画広告配信テンプレート（VAST） -デジタル動画プレーヤーに広告を配信するための汎用的な XML スキーマ。このファイルには、表示する広告を指定します。

    動画複数広告プレイリスト（VMAP） -このファイルには、プリロール、ミッドロール、ポストロール、ノンリニア広告など、VAST 広告のプレイリストが記述されています。ここでは、広告が中断するタイミングと、各休憩中にどの広告を再生するかを指定できます。

    動画プレーヤー広告配信インターフェイスの定義（Vペイド） -インタラクティブな広告体験を提供するための共通のインターフェイスを確立します。

    広告用語を初めて使用する場合は、まず「動画広告用ラーニングガイド」をご覧ください。

    アプリから広告を再生する

    クライアント側広告を再生するには、次の手順に従います。

    1. 広告タグを定義する
    2. 広告タグを確認する
    3. キューポイントを作成する

    4. アプリを構築する

    広告タグを定義する

    広告タグは、取得および再生される広告を定義します。次のいずれかの形式を使用できます。

    広告タグを確認する

    広告タグが有効で、期待どおりに機能することを確認することをお勧めします。これは、実装プロセス中に他の問題をデバッグするのに役立ちます。

    Google では、広告タグを確認するためのビデオスイートのインスペクタが用意されています。

    FreeWheel には、広告サーバーの応答を確認するための広告プレビューアーが用意されています。

    キューポイントを作成する

    VMAP 広告タグを使用している場合は、この手順を省略できます。VMAP では、広告の再生リストを定義し、その再生時期を指定します。なお、 GoogleのIMA広告ルールはVMAPを使用している。

    VAST 広告タグを使用している場合は、キューポイントを作成して、広告を挿入するタイミングをプレイヤーに通知する必要があります。アプリ内でこれらを作成する必要があります。それを行う方法の例をいくつか挙げます。

    Android

    iOS

    Androidの実装

    Android 版ネイティブ SDK では、VMAP、VAST、サーバーサイド広告ルール、コンパニオン広告がサポートされています。

    グーグルIMA

    Google IMA広告ルールを使用するには、次の手順に従います。

    1. 広告ルール IMA サンプルアプリを見つけて確認します。
    2. MainActivity.java ファイルを開きます。

    3. あなたの値でプロジェクトをカスタマイズします。Video Cloud ライブラリからコンテンツを取得するには、次の値が必要です。

      • 再生 API ポリシーキー
      • アカウントID
      • 動画ID

    4. IMA 広告にアクセスするための値を含めます。

      • 広告ルール URL
    5. setupGoogleIMA()このメソッドは、Brightcove IMA プラグインとの接続を確立します。
    6. GoogleIMAEventType.ADS_REQUEST_FOR_VIDEOイベントを聞いて。ここでは、広告リクエストオブジェクトを作成し、広告タグ URL を指定します。この場合、これは広告ルール VMAP ファイルです。
    7. setupAdMarkers()メソッドはオプションです。このメソッドは IMA AdManager を呼び出し、シークバーに広告マーカーを作成します。これにより、ユーザーは広告がいつ再生されるかを視覚的に確認できます。

    広告なしでシークする

    ユーザーが動画を検索している間に広告の再生を無効にする場合は、広告コードなしの Seek を参照してください。

    コードサンプル

    完全なコードサンプルは次のとおりです。

    • 基本IMAの広大なプレイヤー :VAST タグを使用するには、アプリで Playback API Video呼び出しから返されたオブジェクトメタデータからキューポイントのセットを作成する必要があります。メタデータには、Video Cloud Studio で作成した広告キューポイントが含まれます。

    • IMA広告ルールIMAプレーヤー :または、アプリで Player Activityクラスにキューポイントオブジェクトのセットを作成することもできます。

    • 広告ルール IMA Widevine モジュラー :クライアント側の広告とコンテンツ保護を組み合わせます。

    FreeWheel

    これらの広告では、FreeWheel AdManager ライブラリを購入する必要があります。

    FreeWheel 広告を使用するには、次の手順に従います。

    1. FreeWheel に連絡して admanager.aar ライブラリアーカイブを購入し、libs/ ディレクトリにインストールしてください。これは通常、/home/ ディレクトリのルートにあります。Android 用ネイティブ SDK と FreeWheel サンプルアプリには、FreeWheel AdManager ライブラリバージョン 6.28.0 が必要です。
    2. FreeWheel サンプルアプリを見つけて確認します。
    3. MainActivity.java ファイルを開きます。
    4. あなたの値でプロジェクトをカスタマイズします。このサンプルでは、リモートビデオアセットを使用しています。

    5. FreeWheel 広告にアクセスするための値を含めます。

      • 広告URL
      • 広告ネットワーク ID
      • 広告プロフィール
    6. setupFreeWheel()このメソッドは、Brightcove FreeWheel プラグインとの接続を確立します。
    7. 広告の URL を指すように FreeWheel コントローラーを設定します。freeWheelController.setAdURL("http://demo.v.fwmrm.net/");
    8. これは、後で FreeWheel AdRequestConfigurationクラスをインスタンス化するために使用されます。
    9. FreeWheelEventType.WILL_SUBMIT_AD_REQUESTイベントを聞いて。ここでは、FreeWheel コントローラーを入手し、プリロール、ミッドロール、ポストロール、オーバーレイ広告スロットをセットアップします。

    広告なしでシークする

    ユーザーが動画を検索している間に広告の再生を無効にする場合は、広告コードなしの Seek を参照してください。

    コードサンプル

    完全なコードサンプルは次のとおりです。

    iOSの実装

    iOS 版ネイティブ SDK では、VMAP、VAST、サーバーサイド広告ルール、コンパニオン広告がサポートされています。

    グーグルIMA

    インストール、クイックスタート、使用の詳細については、 iOS 用 IMA プラグイン Brightcove Player SDK リファレンスを参照してください。

    Google IMA広告を使用するには、次の手順に従います。

    1. 基本的な IMA Player サンプルアプリを見つけて確認します。
    2. ViewController ファイルを開きます。

    3. あなたの値でプロジェクトをカスタマイズします。Video Cloud ライブラリからコンテンツを取得するには、次の値が必要です。

      • 再生 API ポリシーキー
      • アカウントID
      • 動画ID

    4. IMA 広告にアクセスするための値を含めます。

      • パブリッシャーID
      • 言語
      • 広告タグ URL
    5. 広告リクエストポリシー（VAST、VMAP、またはサーバー側の広告ルール）を含む、適切な IMA 設定を使用してを作成します。playbackController
    6. 広告イベントは、ライフサイクルイベントを通じて BCOVIMA プラグインによって放出されます。これらのイベントは、 bcovimacomponent.h ファイルで定義されています。
    7. サンプルアプリには、広告の再生中にプレーヤーコントロールを非表示にし、広告が終了したときにそれらを表示する機能が含まれています。

    広告なしでシークする

    ユーザーが動画を検索している間に広告の再生を無効にする場合は、プラグインリファレンスの「広告なし検索」セクションを参照してください。

    コードサンプル

    完全なコードサンプルは次のとおりです。

    FreeWheel

    Freeheel ADManager SDK は、CocoaPods を使用してインストールされません。代わりに、プロジェクトのアプリケーションターゲットに手動で追加する必要があります。

    FreeWheel 広告を使用するには、次の手順に従います。

    1. FreeWheel Admananger SDK をプロジェクトに手動で追加します。詳細な手順については、基本的な Freewheel プレーヤーの README ファイルを参照してください。
    2. 基本的な FreeWheel Player サンプルアプリを見つけて確認します。
    3. ViewController ファイルを開きます。

    4. あなたの値でプロジェクトをカスタマイズします。Video Cloud ライブラリからコンテンツを取得するには、次の値が必要です。

      • 再生 API ポリシーキー
      • アカウントID
      • 動画ID
    5. FreeWheel アドマネージャーを作成します。これは、すべての広告コンテキストに責任があります。
    6. 広告コンテキストポリシーを使用して、セッションプロバイダーと再生コントローラーを作成します。
    7. 独自の FreeWheel 設定値でプロジェクトをカスタマイズします。FreeWheel のマニュアルを参照するか、FreeWheel アカウントマネージャーにお問い合わせください。
    8. 広告ビュー、広告コントロール、コンパニオンスロットを設定します。

    広告なしでシークする

    ユーザーが動画を検索している間に広告の再生を無効にする場合は、プラグインリファレンスの「広告なし検索」セクションを参照してください。

    コードサンプル

    完全なコードサンプルは次のとおりです。

    ページの最終更新日04 Oct 2021