手動で広告ブレークを再生

このガイドは、広告ブレークの再生タイミングを手動で制御したいユーザーを対象としています。デフォルトの実装では、SDK によりスケジュール設定された時間にミッドロールが自動的に再生されます。SDK がこうしたミッドロール挿入点を自動的に再生しないようにしたい場合があります。手動の広告ブレーク再生を実装すると、SDK はミッドロールが読み込まれたときに AD_BREAK_READY イベントを発生させ、ユーザーがブレークの再生を開始するのを待ちます。

前提条件

  • IMA SDK が実装された iOS アプリ

参考情報

引き続き IMA SDK をアプリに実装する必要がある場合は、スタートガイドをご覧ください。

広告ブレークの手動再生の設定

手動広告ブレークの再生を設定するには、次の 3 つの手順を行います。

  1. 広告ブレークの再生を制御するよう SDK に指示します。
  2. AD_BREAK_READY イベントをリッスンします。
  3. 準備ができたら、広告を再生するように SDK に指示します。
以下のスニペットは、手動広告ブレークの再生を実装するために高度な例で必要となる変更を示しています。
- (void)setUpAdsLoader {
  ...
  IMASettings settings = [[IMASettings alloc] init];
  // Tell the SDK that you want to control ad break playback.
  settings.autoPlayAdBreaks = NO;
  self.adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];
  ...
}

- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {
  ...
  switch (event.type) {
    // Listen for the AD_BREAK_READY event
    case kIMAAdEvent_AD_BREAK_READY:
      // Tell the SDK to play ads when you're ready. To skip this ad break,
      // simply return from this handler without calling [adsManager start].
      [adsManager start];
      break;
    ...
  }
}

よくある質問

IMA SDK の実装に必須ですか?
残念ながらできません。この機能は、広告ルールまたは VMAP レスポンスでスケジュール設定されている時間に IMA SDK でミッドロール広告を自動的に再生することを希望していないパブリッシャー様にのみ提供されています。