Roku での広告の追跡

以下の手順は、SDK 2.x を使用した実装についてのガイダンスです。

広告トラッキングの定数

実装手順

1. プリロールを含め、いつ広告ブレークの境界が開始するかを識別し、広告ブレーク情報を使用して AdBreakObject を作成します。

   AdBreakObject リファレンス：

   変数名	説明	必須
   name	プリロール、ミッドロール、ポストロールなど、広告ブレークの名前	○
   position	広告ブレークの位置番号（1 から始まる）	○
   startTime	広告ブレーク開始時の再生ヘッド値	○

   ‘ Create an adbreak info object
   adBreakInfo = adb_media_init_adbreakinfo()
   adBreakInfo.name = <ADBREAK_NAME>
   adBreakInfo.startTime = <START_TIME>
   adBreakInfo.position = <POSITION>
   

2. MediaHeartbeat インスタンスの AdBreakStart で trackEvent() を呼び出し、広告ブレークの追跡を開始します。

   contextData = {}
   ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)
   

3. いつ広告アセットが開始するかを識別し、広告情報を使用して AdObject インスタンスを作成します。

   adInfo =  
     adb_media_init_adinfo(ad.title,  
                           ad.id,  
                           ad.position,  
                           ad.duration)
   

4. オプションで、コンテキストデータ変数を使用して標準または広告メタデータをメディアトラッキングセッションにアタッチします。

   • Roku での標準広告メタデータの実装

   • カスタムの広告メタデータ - カスタムのメタデータの場合は、カスタムデータ変数の変数オブジェクトを作成し、現在の広告アセットのデータを設定します。

     contextData = {}
     contextData["adinfo1"] = "adinfo2"
     contextData["adinfo2"] = "adinfo2"
     

5. MediaHeartbeat インスタンスの AdStart イベントで trackEvent() を呼び出し、広告再生の追跡を開始します。

   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)
   

6. 広告の再生が広告の終わりに到達したら、AdComplete イベントで trackEvent() を呼び出します。

   standardAdMetadata = {}
   contextData = {}
   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData)
   

7. ユーザーが広告のスキップを選択したので広告再生が完了しなかった場合は、AdSkip イベントを追跡します。

   contextData = {}
   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData
   

8. 同じ AdBreak にその他の広告がある場合、手順 3 ～ 7 を繰り返します。

9. 広告ブレークが完了したら、AdBreakComplete イベントを使用して追跡します。

   contextData = {}
   ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
   

詳しくは、追跡シナリオのプリロール広告のある VOD 再生を参照してください。