iOS_Type C_Interstitial(インタースティシャル)

BuzzAd-Benefit SDK: Type C - Interstitial

本ドキュメントは BuzzAd-Benefit SDKのType C(インタースティシャル広告)を実装する際に必要な技術情報をまとめた文書です。

※ 注意事項

Interstitialタイプの実装を行う前に、導入ガイドの内容がすべて適用されているかどうかを確認してください。

※Type C選択の前にご確認ください

Interstitial(インタースティシャル広告)タイプはネイティブ広告の情報の取得とレイアウトまでをSDK側で行います。パブリッシャーは取得したViewを表示するだけで広告を表示することができるため、実装の手間を省くことができます。

実装にかかる工数を最小限におさえるため、Type C(インタースティシャル)でカスタマイズできる項目はテキストやカラーなどUIの一部に限られます。既存UIに合わせた自由なデザイン・カスタマイズの適用を希望する場合はiOS_Type A_Nativeをお選びください。

index

1 基本設定 Basic Usage
- 1.1 BABInterstitialAdHandler 設定
- 1.2 Interstitial Type 設定
2 応用設定 Advanced Usage
- 2.1 BABInterstitialConfigの設定
  - 2.1.1 共通Config
  - 2.1.2 Dialog(ポップアップ)専用
  - 2.1.3 Bottom Sheet 専用
- 2.2 Interstitial広告の読み込み結果についてのイベント登録

基本設定 Basic Usage

`BABInterstitialAdHandler` 設定

unitIdと type (Dialog またはBottomsheet, 詳細は下図を参照)を使用して BABInterstitialAdHandlerを生成します。
show:withConfigを呼び出して広告を表示させます。

// Objective-C
BABInterstitialAdHandler *interstitialAdHandler = [[BABInterstitialAdHandler alloc] initWithUnitId:YOUR_INTERSTITIAL_AD_UNIT_ID type:BABInterstitialDialog];
[interstitialAdHandler show:self withConfig:nil];

// Swift
let interstitialAdHandler = BABInterstitialAdHandler(unitId: YOUR_INTERSTITIAL_AD_UNIT_ID, type: BABInterstitialDialog)
interstitialAdHandler.show(self, with: nil)

`Interstitial Type` 設定

Interstitial広告は2種類の形式をサポートしています。(Dialog・BottomSheet)

Dialog:画面中央にポップアップで出てくるインタースティシャル広告。表示される広告は1件のみ。
Bottom sheet: 画面下部から出てくるインタースティシャル広告。一度に複数件の広告が表示可能。

上記のInterstitialAdHandler 設定時に希望するタイプに合わせてBABInterstitialDialog または BABInterstitialBottomSheetを設定してください。

応用設定 Advanced Usage

`BABInterstitialConfig`の設定

Interstitial 広告のデザイン領域および広告リクエスト件数についてはパブリッシャー側で調整が可能です。設定された InterstitialAdConfigはshow:withConfigをコールするときに挿入して呼び出します。

共通Config

topIcon : Interstitial広告上段にあるアイコン(下記サンプルコードのようにdrawableのidで指定するか、 drawable typeで指定可能) (UIImage)
titleText : Interstitial 広告の上段にあるタイトルテキスト(NSString)
titleTextColor : titleTextのカラー (UIColor)
backgroundColor : Interstitial広告全体の背景色(UIColor)
ctaViewBackgroundColor : CTAボタンのカラー (BABStateValue<UIColor *>)
ctaViewIcon : CTAに含まれる基本アイコン (BABStateValue<UIImage *>)
ctaViewTextColor : CTAボタンのテキストカラー(BABStateValue<UIColor *>)

Dialog(ポップアップ)専用

closeText : 「閉じる」ボタンのテキスト

Bottom Sheet 専用

adCount : 一度にリクエストする広告件数。1 ~ 5の間で設定可能で、デフォルトは5件

// Objective-C
BABInterstitialConfig *config = [[BABInterstitialConfig alloc] init];
[config setTopIcon:[UIImage imageNamed:@"top_icon"]];
[config setTitleText:@"今すぐ参加してポイントゲット!"];
[config setTitleTextColor:UIColor.blackColor];
[config setBackgroundColor:UIColor.whiteColor];
[config setCtaViewIcon:[[BABStateValue<UIImage *> alloc] initWithEnabled:[UIImage imageNamed:@"cta_enabled_icon"] disabled:[UIImage imageNamed:@"cta_disabled_icon"]]];
[config setCtaViewTextColor:[[BABStateValue<UIColor *> alloc] initWithEnabled:RGB(255, 255, 255) disabled:RGB(177, 177, 177)]];
[config setCtaViewBackgroundColor:[[BABStateValue<UIColor *> alloc] initWithEnabled:RGB(240, 89, 82) disabled:RGB(253, 133, 135)]];

[interstitialAdHandler show:self withConfig:config];

Interstitial広告の読み込み結果についてのイベント登録

BABInterstitialAdHandlerDelegateを実装すると広告読み込みの成功/失敗イベントを受け取ることができるようになります。