以下の手順は、SDK 2.x を使用した実装についてのガイダンスです。1.x バージョンの SDK を実装する場合は、1.x の開発ガイドをこちら(SDK のダウンロード)からダウンロードできます。
定数名 | 説明 |
---|---|
AdBreakStart |
追跡する AdBreak Start イベントの定数 |
AdBreakComplete |
追跡する AdBreak Complete イベントの定数 |
AdStart |
追跡する Ad Start イベントの定数 |
AdComplete |
追跡する Ad Complete イベントの定数 |
AdSkip |
追跡する Ad Skip イベントの定数 |
プリロールを含め、いつ広告ブレークの境界が開始するかを識別し、広告ブレーク情報を使用して 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>
MediaHeartbeat
インスタンスの AdBreakStart
で trackEvent()
を呼び出し、広告ブレークの追跡を開始します。
contextData = {}
ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)
いつ広告アセットが開始するかを識別し、広告情報を使用して AdObject
インスタンスを作成します。
adInfo =
adb_media_init_adinfo(ad.title,
ad.id,
ad.position,
ad.duration)
オプションで、コンテキストデータ変数を使用して標準または広告メタデータをメディアトラッキングセッションにアタッチします。
カスタムの広告メタデータ - カスタムのメタデータの場合は、カスタムデータ変数の変数オブジェクトを作成し、現在の広告アセットのデータを設定します。
contextData = {}
contextData["adinfo1"] = "adinfo2"
contextData["adinfo2"] = "adinfo2"
MediaHeartbeat
インスタンスの AdStart
イベントで trackEvent()
を呼び出し、広告再生の追跡を開始します。
ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)
広告の再生が広告の終わりに到達したら、AdComplete
イベントで trackEvent()
を呼び出します。
standardAdMetadata = {}
contextData = {}
ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData)
ユーザーが広告のスキップを選択したので広告再生が完了しなかった場合は、AdSkip
イベントを追跡します。
contextData = {}
ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData
同じ AdBreak
にその他の広告がある場合、手順 3 ~ 7 を繰り返します。
広告ブレークが完了したら、AdBreakComplete
イベントを使用して追跡します。
contextData = {}
ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
詳しくは、追跡シナリオのプリロール広告のある VOD 再生を参照してください。