Show Menu
TOPICS×

iOS での広告の追跡

以下の手順は、SDK 2.x を使用した実装についてのガイダンスです。1.x バージョンの SDK を実装する場合は、1.x の開発ガイドをこちら( SDK のダウンロード )からダウンロードできます。

広告トラッキングの定数

定数名
説明  
ADBMediaHeartbeatEventAdBreakStart
追跡する AdBreak Start イベントの定数
ADBMediaHeartbeatEventAdBreakComplete
追跡する AdBreak Complete イベントの定数
ADBMediaHeartbeatEventAdStart
追跡する Ad Start イベントの定数
ADBMediaHeartbeatEventAdComplete
追跡する Ad Complete イベントの定数
ADBMediaHeartbeatEventAdSkip
追跡する Ad Skip イベントの定数

実装手順

  1. プリロールを含め、いつ広告ブレークの境界が開始するかを識別し、広告ブレーク情報を使用して
    AdBreakObject
    を作成します。
    AdBreakObject
    リファレンス:
    変数名
    説明
    必須
    name
    プリロール、ミッドロール、ポストロールなど、広告ブレークの名前
    position
    コンテンツ内の広告ブレークの位置番号(1 から始まる)。
    startTime
    広告ブレーク開始時の再生ヘッド値
    広告ブレークオブジェクトの作成:
    id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME] position:[POSITION] startTime:[START_TIME]];
  2. MediaHeartbeat
    インスタンスの
    AdBreakStart
    trackEvent()
    を呼び出し、広告ブレークの追跡を開始します。
    - (void)onAdBreakStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart mediaObject:adBreakObject data:nil]; }
  3. いつ広告が開始するかを識別し、広告情報を使用して
    AdObject
    インスタンスを作成します。
    AdObject
    リファレンス:
    変数名
    説明
    必須
    name
    広告のわかりやすい名前.
    adId
    広告の一意の識別子。
    position
    広告ブレーク内の広告の位置番号(1 から始まる)。
    length
    広告の長さ
    広告オブジェクトの作成:
    id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME] adId:[AD_ID] position:[POSITION] length:[LENGTH]];
  4. オプションで、コンテキストデータ変数を使用して標準または広告メタデータをメディアトラッキングセッションにアタッチします。
    • カスタムの広告メタデータ
      - カスタムのメタデータの場合は、カスタムデータ変数の変数オブジェクトを作成し、現在の広告のデータを設定します。
      NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init]; [adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"]; [adDictionary setObject:@"Sample campaign" forKey:@"campaign"]; [adDictionary setObject:@"Sample creative" forKey:@"creative"];
  5. MediaHeartbeat
    インスタンスの
    AdStart
    イベントで
    trackEvent()
    を呼び出し、広告再生の追跡を開始します。
    カスタムメタデータ変数(または空のオブジェクト)への参照を、イベント呼び出しの 3 番目のパラメーターとして含めます。
    - (void)onAdStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart mediaObject:adObject data:adDictionary]; }
  6. 広告の再生が広告の終わりに到達したら、
    AdComplete
    イベントで
    trackEvent()
    を呼び出します。
    - (void)onAdComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete mediaObject:nil data:nil]; }
  7. ユーザーが広告のスキップを選択したので広告再生が完了しなかった場合は、
    AdSkip
    イベントを追跡します。
    - (void)onAdSkip:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip mediaObject:nil data:nil]; }
  8. 同じ
    AdBreak
    にその他の広告がある場合、手順 3 ~ 7 を繰り返します。
  9. 広告ブレークが完了したら、
    AdBreakComplete
    イベントを使用して追跡します。
    - (void)onAdBreakComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete mediaObject:nil data:nil]; }
詳しくは、追跡シナリオの プリロール広告のある VOD 再生 を参照してください。