Roku での広告の追跡 track-ads-on-roku
以下の手順は、SDK 2.x を使用した実装についてのガイダンスです。
IMPORTANT
1.x バージョンの SDK を実装する場合は、1.x の開発ガイドをこちら(SDK のダウンロード)からダウンロードできます。
広告トラッキングの定数
定数名
説明
AdBreakStart追跡する AdBreak Start イベントの定数
AdBreakComplete追跡する AdBreak Complete イベントの定数
AdStart追跡する Ad Start イベントの定数
AdComplete追跡する Ad Complete イベントの定数
AdSkip追跡する Ad Skip イベントの定数
実装手順
-
プリロールを含め、いつ広告ブレークの境界が開始するかを識別し、広告ブレーク情報を使用して
AdBreakObjectを作成します。AdBreakObjectリファレンス:table 0-row-3 1-row-3 2-row-3 3-row-3 3-align-center 7-align-center 11-align-center 15-align-center 変数名 説明 必須 name広告ブレーク名(プリロール、ミッドロール、ポストロールなど)。 ○ position広告ブレークの位置番号(1 から始まる) ○ startTime広告ブレーク開始時の再生ヘッド値 ○ code language-none ‘ Create an adbreak info object adBreakInfo = adb_media_init_adbreakinfo() adBreakInfo.name = <ADBREAK_NAME> adBreakInfo.startTime = <START_TIME> adBreakInfo.position = <POSITION> -
MediaHeartbeatインスタンスのAdBreakStartでtrackEvent()を呼び出し、広告ブレークの追跡を開始します。code language-none contextData = {} ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData) -
いつ広告アセットが開始するかを識別し、広告情報を使用して
AdObjectインスタンスを作成します。code language-none adInfo = adb_media_init_adinfo(ad.title, ad.id, ad.position, ad.duration) -
オプションで、コンテキストデータ変数を使用して標準または広告メタデータをメディアトラッキングセッションにアタッチします。
-
カスタムの広告メタデータ - カスタムのメタデータの場合は、カスタムデータ変数の変数オブジェクトを作成し、現在の広告アセットのデータを設定します。
code language-none contextData = {} contextData["adinfo1"] = "adinfo2" contextData["adinfo2"] = "adinfo2"
-
MediaHeartbeatインスタンスのAdStartイベントでtrackEvent()を呼び出し、広告再生の追跡を開始します。code language-none ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData) -
広告の再生が広告の終わりに到達したら、
AdCompleteイベントでtrackEvent()を呼び出します。code language-none standardAdMetadata = {} contextData = {} ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData) -
ユーザーが広告のスキップを選択したので広告再生が完了しなかった場合は、
AdSkipイベントを追跡します。code language-none contextData = {} ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData -
同じ
AdBreakにその他の広告がある場合、手順 3 ~ 7 を繰り返します。 -
広告ブレークが完了したら、
AdBreakCompleteイベントを使用して追跡します。code language-none contextData = {} ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
詳しくは、追跡シナリオのプリロール広告のある VOD 再生を参照してください。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb