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

    広告イベントと広告オブジェクト

    このドキュメントでは、広告イベントと広告オブジェクトの一般的なセットの使用について説明し、 videojs-contrib-ads プラグイン。

    概要

    videojs / videojs-contrib-ads GitHubリポジトリにある videojs-contrib-ads は、ビデオ広告ライブラリとビデオ広告の統合に必要な共通の機能を提供し、特定の広告統合のために記述しなければならないコードを削減します。

    これらのイベントとオブジェクトは、 Brightcove FreeWheelとIMA3プラグインを提供。 以下を除いて、これらと同じイベントおよびオブジェクトがSSAIプラグインに実装されています。

    • player.ads.pod インタフェース
    • player.ads.provider オブジェクト

    広告イベント

    各広告プロバイダは、独自のイベントセットを発行できます。 一般に、これらのイベントは、メトリクスの目的での広告再生の状態を追跡し、カスタムUIを作成するために使用されます。 統一性を促進し、広告プロバイダーに依存のないようにするために、以下のイベントを実装することをお勧めします。

    イベント 次の場合に送出されます。
    ads-request 広告データがリクエストされました
    ads-load 広告リクエスト後に広告データを利用できます
    ads-pod-started リニア広告ポッドが開始されました
    ads-pod-ended リニア広告ポッドが完了しました
    ads-allpods-completed すべてのリニア広告が完了しました
    ads-ad-started 広告の再生が開始されます
    ads-ad-ended 広告の再生が完了しました
    ads-first-quartile 広告再生ヘッドが第1四分位を横切る
    ads-midpoint 広告再生ヘッドが中点を横切る
    ads-third-quartile 広告再生ヘッドが第3四分位を横切る
    ads-pause 広告は一時停止中です
    ads-play 広告が再開されました
    ads-volumechange 広告のボリュームが変更されました
    ads-click 広告がクリックされました

    これらのイベントは、プレーヤーオブジェクトからリッスンすることができます。 以下のコードは、 ads-ad-started イベントをリッスンして、イベントハンドラに渡されたオブジェクトの内容を表示させています。

    videojs.getPlayer('myPlayerID').on('loadedmetadata',function(){
      var myPlayer = this;
      ...
      myPlayer.on('ads-ad-started',function( evt ){
        console.log('ads-ad-started event passed to event handler', evt);
      });
    広告イベントオブジェクト

    広告オブジェクト

    ご覧のとおり、イベントハンドラーに渡されたイベントオブジェクトはひどく情報を提供しません。 このため、より多くの広告情報を収集できるXNUMXつのオブジェクトを活用できます。 player.ads.adplayer.ads.pod.

    下のスクリーンショットから、 player.ads.ad オブジェクトには広告に関する情報が含まれています typeduration 他の詳細の中で、広告の。

    player 広告

    player.ads.pod オブジェクトに類似した情報が含まれています player.ads.ad、ポッド内の広告数が追加されます。 下の最初のスクリーンショットは単一の広告を含む広告ポッドを示していますが、XNUMX番目のスクリーンショットはXNUMXつの広告を含むポッドを示しています。

    広告ポッドオブジェクト
    複数の広告ポッド

    GoogleのAdsManager

    Googleから利用できるメソッドとプロパティがあります google.ima.AdsManager インタフェース。 情報を取得するインタフェースのプロパティ/メソッドを使用することができます。 アクションを実行するメソッドを使用することはお勧めしません。 destroy , setAutoPlayAdBreaks stop 。 たとえば、使用できる方法は次のとおりです。

    AdsManager.getRemainingTime

    タイプ: google.ima.AdsManager.getRemainingTime

    使用法: myPlayer.ima3.adsManager.getRemainingTime()

    このメソッドを呼び出すと、現在の広告の残り時間が返されます。 広告が利用できない場合、または再生が終了した場合は、-1が返されます。 詳細については、Googleの ドキュメント メソッドに。


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