バナー広告 - Ad Control Help Center

概要

バナー広告は、画面の一部領域に表示される長方形の広告です。UIKitとSwiftUIの両方で使用できます。

主な特徴

画面の上部、下部、または中央に固定配置可能
画像および動画広告に対応
UIKitおよびSwiftUIの両方をサポート
デリゲートによる広告イベント処理

開発環境ではテストユニットIDを使用してください: PUBLIC_TEST_UNIT_ID_320_100

UIKit実装

UIKit環境ではAdropBannerクラスを使用してバナー広告を実装します。

基本実装

import UIKit
import AdropAds

class ViewController: UIViewController {
    private var banner: AdropBanner?

    override func viewDidLoad() {
        super.viewDidLoad()

        // 1. バナーインスタンスの生成
        banner = AdropBanner(unitId: "YOUR_UNIT_ID")

        // 2. デリゲートの設定
        banner?.delegate = self

        // 3. ビュー階層に追加
        if let bannerView = banner {
            view.addSubview(bannerView)

            // 4. Auto Layoutの設定
            bannerView.translatesAutoresizingMaskIntoConstraints = false
            NSLayoutConstraint.activate([
                bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
                bannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
                bannerView.widthAnchor.constraint(equalToConstant: 320),
                bannerView.heightAnchor.constraint(equalToConstant: 100)
            ])
        }

        // 5. 広告の読み込み
        banner?.load()
    }

    deinit {
        // 6. メモリ解放前にバナーリソースを解放
        banner?.destroy()
        banner = nil
    }
}

// MARK: - AdropBannerDelegate
extension ViewController: AdropBannerDelegate {
    func onAdReceived(_ banner: AdropBanner) {
        print("バナー広告受信成功")
    }

    func onAdFailedToReceive(_ banner: AdropBanner, _ errorCode: AdropErrorCode) {
        print("バナー広告受信失敗: \(errorCode)")
    }

    func onAdImpression(_ banner: AdropBanner) {
        print("バナー広告表示")
    }

    func onAdClicked(_ banner: AdropBanner) {
        print("バナー広告クリック")
    }
}

AdropBannerの初期化

String

必須

Adropコンソールで作成したユニットID

let banner = AdropBanner(unitId: "YOUR_UNIT_ID")

広告の読み込み

バナーを画面に追加した後、load()メソッドを呼び出して広告をリクエストします。

banner?.load()

バナーが画面に表示されているタイミングでload()を呼び出してください。画面に表示されていない状態で読み込むと、インプレッションが正確に測定されない可能性があります。

Context IDの設定

コンテキストターゲティングのためにContext IDを設定できます。

// contextIdは読み取り専用 — 初期化時に設定
let banner = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: "sport")

SwiftUI実装

SwiftUI環境ではAdropBannerRepresentedを使用してバナー広告を実装します。

基本実装

import SwiftUI
import AdropAds

struct ContentView: View {
    @State private var represented = AdropBannerRepresented(unitId: "YOUR_UNIT_ID")

    var body: some View {
        VStack {
            Spacer()

            Text("メインコンテンツ")

            Spacer()

            // バナー広告
            represented
                .frame(width: 320, height: 100)
                .onAppear {
                    represented.banner.load()
                }
        }
    }
}

デリゲート処理

デリゲートを通じて広告イベントを処理できます。

import SwiftUI
import AdropAds

struct ContentView: View {
    @StateObject private var bannerDelegate = BannerDelegate()
    @State private var represented = AdropBannerRepresented(unitId: "YOUR_UNIT_ID")

    var body: some View {
        VStack {
            Spacer()

            if bannerDelegate.isLoaded {
                Text("広告読み込み完了")
            }

            represented
                .frame(width: 320, height: 100)
                .onAppear {
                    represented.delegate = bannerDelegate
                    represented.banner.load()
                }
        }
    }
}

// デリゲートの実装
class BannerDelegate: NSObject, ObservableObject, AdropBannerDelegate {
    @Published var isLoaded = false

    func onAdReceived(_ banner: AdropBanner) {
        print("バナー広告受信成功")
        isLoaded = true
    }

    func onAdFailedToReceive(_ banner: AdropBanner, _ errorCode: AdropErrorCode) {
        print("バナー広告受信失敗: \(errorCode)")
        isLoaded = false
    }

    func onAdImpression(_ banner: AdropBanner) {
        print("バナー広告表示")
    }

    func onAdClicked(_ banner: AdropBanner) {
        print("バナー広告クリック")
    }
}

Context IDの設定

AdropBannerRepresented(
    unitId: "YOUR_UNIT_ID",
    contextId: "sport"
)
.frame(width: 320, height: 100)

Objective-C実装

Objective-C環境でバナー広告を実装する方法です。

基本実装

@import AdropAds;

@interface ViewController () <AdropBannerDelegate>
@property (nonatomic, strong) AdropBanner *banner;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // 1. バナーインスタンスの生成
    self.banner = [[AdropBanner alloc] initWithUnitId:@"YOUR_UNIT_ID"];

    // 2. デリゲートの設定
    self.banner.delegate = self;

    // 3. ビュー階層に追加
    [self.view addSubview:self.banner];

    // 4. Auto Layoutの設定
    self.banner.translatesAutoresizingMaskIntoConstraints = NO;
    [NSLayoutConstraint activateConstraints:@[
        [self.banner.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
        [self.banner.bottomAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.bottomAnchor],
        [self.banner.widthAnchor constraintEqualToConstant:320],
        [self.banner.heightAnchor constraintEqualToConstant:100]
    ]];

    // 5. 広告の読み込み
    [self.banner load];
}

- (void)dealloc {
    [self.banner destroy];
    self.banner = nil;
}

#pragma mark - AdropBannerDelegate

- (void)onAdReceived:(AdropBanner *)banner {
    NSLog(@"バナー広告受信成功");
}

- (void)onAdFailedToReceive:(AdropBanner *)banner :(AdropErrorCode)errorCode {
    NSLog(@"バナー広告受信失敗: %ld", (long)errorCode);
}

- (void)onAdImpression:(AdropBanner *)banner {
    NSLog(@"バナー広告表示");
}

- (void)onAdClicked:(AdropBanner *)banner {
    NSLog(@"バナー広告クリック");
}

@end

Context IDの設定

// contextIdは読み取り専用 — 初期化時に設定
AdropBanner *banner = [[AdropBanner alloc] initWithUnitId:@"YOUR_UNIT_ID" contextId:@"sport"];

デリゲートメソッド

AdropBannerDelegateプロトコルは広告のライフサイクルイベントを処理します。

onAdReceived (必須)

広告受信が成功したときに呼び出されます。

func onAdReceived(_ banner: AdropBanner) {
    print("バナー広告受信成功")
    // 広告ローディングインジケータを非表示にするなどの処理
}

onAdFailedToReceive (必須)

広告受信が失敗したときに呼び出されます。

func onAdFailedToReceive(_ banner: AdropBanner, _ errorCode: AdropErrorCode) {
    print("バナー広告受信失敗: \(errorCode)")
    // エラー処理および代替コンテンツの表示
}

AdropErrorCode

エラータイプを示すコード。詳細はリファレンスを参照してください。

onAdImpression (オプション)

広告が画面に表示されたときに呼び出されます。

func onAdImpression(_ banner: AdropBanner) {
    print("バナー広告表示")
    // インプレッション分析ロギングなどの処理
}

onAdClicked (オプション)

ユーザーが広告をクリックしたときに呼び出されます。

func onAdClicked(_ banner: AdropBanner) {
    print("バナー広告クリック")
    // クリック分析ロギングなどの処理
}

onAdVideoStart (オプション)

動画広告の再生が開始されたときに呼び出されます。

func onAdVideoStart(_ banner: AdropBanner) {
    print("バナー動画再生開始")
    // 動画開始の分析ロギングなどの処理
}

onAdVideoEnd (オプション)

動画広告の再生が完了したときに呼び出されます。

func onAdVideoEnd(_ banner: AdropBanner) {
    print("バナー動画再生完了")
    // 動画終了の分析ロギングなどの処理
}

クロージャコールバック

デリゲートの代わりにクロージャベースのコールバックを使用できます。

let banner = AdropBanner(unitId: "YOUR_UNIT_ID")

banner.onAdReceived = { banner in
    print("バナー広告受信成功")
}

banner.onAdFailedToReceive = { banner, errorCode in
    print("バナー広告受信失敗: \(errorCode)")
}

banner.onAdImpression = { banner in
    print("バナー広告表示")
}

banner.onAdClicked = { banner in
    print("バナー広告クリック")
}

banner.onAdVideoStart = { banner in
    print("バナー動画再生開始")
}

banner.onAdVideoEnd = { banner in
    print("バナー動画再生完了")
}

デリゲートとクロージャの両方を設定すると、両方が呼び出されます。

ライフサイクル管理

destroy()

バナーを使用しなくなったら destroy() を呼び出してリソースを解放してください。WebView、トラッキング、動画再生などバナーが保持しているリソースを能動的にクリーンアップします。 destroy() は idempotent なので複数回呼び出しても安全ですが、呼び出し後は該当インスタンスを再利用できません。

deinit {
    banner?.destroy()
    banner = nil
}

- (void)dealloc {
    [self.banner destroy];
    self.banner = nil;
}

ビューコントローラーの解放時に destroy() を呼び出さないと、WebView と関連リソースが解放されずメモリリークやパフォーマンス低下が発生する可能性があります。特に動画バナーで影響が大きいです。

広告サイズ

バナー広告は、ユニットに設定したサイズに合わせてビューのサイズを指定する必要があります。

一般的なバナーサイズ

サイズ	用途
320 x 50	小型バナー
320 x 100	大型バナー
16:9比率	動画バナー

UIKit

bannerView.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    bannerView.widthAnchor.constraint(equalToConstant: 320),
    bannerView.heightAnchor.constraint(equalToConstant: 100)
])

SwiftUI

represented
    .frame(width: 320, height: 100)
    .onAppear {
        represented.banner.load()
    }

ベストプラクティス

1. メモリ管理

ビューコントローラーが解放されるときに destroy() を呼び出してバナーリソースをクリーンアップしてください。

deinit {
    banner?.destroy()
    banner = nil
}

2. 画面の可視性

バナーが画面に表示されるときに広告を読み込んでください。

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    banner?.load()
}

3. バナーインスタンスの再利用

AdropBanner インスタンスは1つだけ保持し、新しい広告が必要になるたびに load() を再度呼び出してください。広告更新のたびに新しい AdropBanner を作成しないでください。バナーを毎回作り直すと、リクエストごとに新しい WKWebView と WebContent プロセスが割り当てられます。特にビデオバナーで頻繁に更新を繰り返すと、リソースが蓄積してレンダリングパフォーマンスに影響する可能性があります。

class ViewController: UIViewController {
    private var banner: AdropBanner?

    override func viewDidLoad() {
        super.viewDidLoad()
        banner = AdropBanner(unitId: "YOUR_UNIT_ID")
        banner?.delegate = self
        // ビュー階層に追加...
        banner?.load()
    }

    func refreshAd() {
        // 既存のインスタンスを再利用
        banner?.load()
    }
}

func refreshAd() {
    // 広告更新のたびに新しい AdropBanner を作成しないでください
    banner?.destroy()
    banner = AdropBanner(unitId: "YOUR_UNIT_ID")
    banner?.delegate = self
    // ...ビュー階層に再度追加
    banner?.load()
}

load() を再度呼び出すたびに onAdReceived が再度呼び出されるため、既存のデリゲートが新しい広告を自動的に処理します。

4. エラー処理

広告読み込み失敗時に適切なエラー処理を実装してください。

func onAdFailedToReceive(_ banner: AdropBanner, _ errorCode: AdropErrorCode) {
    switch errorCode {
    case .ERROR_CODE_NETWORK:
        print("ネットワークエラー: 接続を確認してください")
    case .ERROR_CODE_AD_NO_FILL:
        print("表示可能な広告がありません")
    default:
        print("広告読み込み失敗: \(errorCode)")
    }

    // 広告領域を非表示にするか、代替コンテンツを表示
    bannerContainerView.isHidden = true

    // または自社プロモーションバナーを表示
    showPromotionBanner()
}

テストユニットID

開発およびテスト時には以下のテストユニットIDを使用してください。

広告タイプ	テストユニットID	サイズ
バナー (320x50)	`PUBLIC_TEST_UNIT_ID_320_50`	320 x 50
バナー (320x100)	`PUBLIC_TEST_UNIT_ID_320_100`	320 x 100
カルーセルバナー	`PUBLIC_TEST_UNIT_ID_CAROUSEL`	可変
バナービデオ (16:9)	`PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_16_9`	16:9比率
バナービデオ (9:16)	`PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_9_16`	9:16比率

使用例

let banner = AdropBanner(unitId: AdropUnitId.PUBLIC_TEST_UNIT_ID_320_100)

AdropBanner *banner = [[AdropBanner alloc] initWithUnitId:PUBLIC_TEST_UNIT_ID_320_100];

動画再生制御

動画バナー広告の場合、play()とpause()を使用してビデオ再生を手動で制御できます。

play()

動画の再生を再開します。ポップアップが閉じたり、アプリがバックグラウンドから復帰してバナーが再び表示されるときに呼び出してください。

banner?.play()

[self.banner play];

pause()

動画の再生を一時停止します。バナーがポップアップで隠れたり、アプリがバックグラウンドに移行するときに呼び出してください。

banner?.pause()

[self.banner pause];

例：バックグラウンド/フォアグラウンドの処理

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    banner?.play()
}

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    banner?.pause()
}

play()とpause()は動画バナー広告にのみ影響します。画像バナーには効果がありません。

カスタムクリック処理

useCustomClickを使用して、広告クリック動作を直接制御できます。有効にすると、SDKはクリック時に自動的にデスティネーションURLを開かず、自分で処理できます。

useCustomClick

let banner = AdropBanner(unitId: "YOUR_UNIT_ID")
banner.useCustomClick = true
banner.delegate = self
banner.load()

useCustomClickがtrueの場合、広告クリック時にSDKが自動的にデスティネーションURLを開きません。onAdClickedデリゲートコールバックは引き続き呼び出され、open()メソッドを使用するか、ナビゲーションを自分で処理できます。

open()

広告のデスティネーションURLを開きます。オプションでカスタムURLを渡すことができます。

// 広告のデフォルトデスティネーションURLを開く
banner?.open()

// カスタムURLを開く
banner?.open("https://example.com")

// アプリ内ブラウザで開く
banner?.open(nil, useInAppBrowser: true)

一括ロード (loads)

AdropBanner.loads(...)を使用すると、1回の呼び出しで複数のバナー広告をまとめてリクエストできます。カルーセルやページネーション付きフィード、広告プールのプリフェッチなどに有用です。

シグネチャ

AdropBanner.loads(
    unitId: String,
    contextId: String = "",
    delegate: AdropBannerDelegate
)

[AdropBanner loadsWithUnitId:@"YOUR_UNIT_ID"
                   contextId:@""
                    delegate:delegate];

使用方法

class ViewController: UIViewController {
    private var banners: [AdropBanner] = []

    override func viewDidLoad() {
        super.viewDidLoad()
        AdropBanner.loads(unitId: "YOUR_UNIT_ID", delegate: self)
    }
}

extension ViewController: AdropBannerDelegate {
    // 単体用コールバック — バッチ経路では使用されません。
    func onAdReceived(_ banner: AdropBanner) { /* batch path */ }
    func onAdFailedToReceive(_ banner: AdropBanner, _ errorCode: AdropErrorCode) {}

    // バッチ成功 — 最大5個の準備済みバナーが渡されます。
    func onAdsReceived(_ banners: [AdropBanner]) {
        self.banners = banners
        banners.forEach { banner in
            // ビュー階層へ追加 (UIScrollView、UIPageViewControllerなど)
            stackView.addArrangedSubview(banner)
        }
    }

    // バッチ失敗
    func onAdsFailedToReceive(_ errorCode: AdropErrorCode) {
        print("バッチロード失敗: \(errorCode)")
    }

    // クリック/インプレッション/動画コールバックは各インスタンスで通常通り呼ばれます。
    func onAdClicked(_ banner: AdropBanner) {
        print("バナークリック")
    }

    func onAdImpression(_ banner: AdropBanner) {
        print("バナーインプレッション")
    }
}

@interface ViewController () <AdropBannerDelegate>
@property (nonatomic, strong) NSArray<AdropBanner *> *banners;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    [AdropBanner loadsWithUnitId:@"YOUR_UNIT_ID" contextId:@"" delegate:self];
}

#pragma mark - AdropBannerDelegate

- (void)onAdReceived:(AdropBanner *)banner { /* batch path */ }
- (void)onAdFailedToReceive:(AdropBanner *)banner :(AdropErrorCode)errorCode {}

- (void)onAdsReceived:(NSArray<AdropBanner *> *)banners {
    self.banners = banners;
    for (AdropBanner *banner in banners) {
        [self.stackView addArrangedSubview:banner];
    }
}

- (void)onAdsFailedToReceive:(AdropErrorCode)errorCode {
    NSLog(@"バッチロード失敗: %ld", (long)errorCode);
}

- (void)onAdClicked:(AdropBanner *)banner {
    NSLog(@"バナークリック");
}

- (void)onAdImpression:(AdropBanner *)banner {
    NSLog(@"バナーインプレッション");
}

@end

デリゲートメソッド

メソッド	呼び出されるタイミング
`onAdsReceived(_:)`	バッチ配信完了。各`AdropBanner`にはデリゲートがすでに付与され、広告データが適用されています。
`onAdsFailedToReceive(_:)`	リクエスト拒否、ネットワーク失敗、または表示可能な広告がなかった場合 (`ERROR_CODE_AD_NO_FILL`)。
`onAdClicked` / `onAdImpression` / `onAdVideoStart` / `onAdVideoEnd`	単体`load()`と同様に、各バナーごとに呼ばれます。

単体onAdReceived(_:) / onAdFailedToReceive(_:_:)コールバックはloads経路では呼ばれません。バッチ結果は必ずonAdsReceived(_:) / onAdsFailedToReceive(_:)で受け取ってください。

定数

Int

デフォルト:"5"

1回のloads(...)呼び出しで返却される広告の最大数。

制約事項

呼び出しあたり最大5個。 サーバーがそれ以上を返しても先頭の5個のみ配信されます。
バックフィルは適用されません。 ダイレクト広告が埋まらない場合、バックフィル設定に関わらずonAdsFailedToReceiveがERROR_CODE_AD_NO_FILLで呼ばれます。
onAdsReceived の中で destroy() を呼び出さないでください。 まず各バナーをビュー階層に追加してから、ビューコントローラーが解放されるタイミングで destroy() を呼び出してください。
onAdsReceivedは広告データが適用され次第発火し、単体load()と同じ動作です — ビューに追加後にクリエイティブが描画されます。
返却されたバナーへの強参照を保持してください(例: ビューコントローラーに保存)。ビュー階層に追加される前に解放されると黙って破棄されます。

バックフィル広告

バックフィル広告が有効な場合、ダイレクト広告がない時に自動的にバックフィル広告がロードされます。isBackfilledプロパティでバックフィル広告かどうかを確認できます。

class ViewController: UIViewController, AdropBannerDelegate {
    private var banner: AdropBanner?

    func onAdReceived(_ banner: AdropBanner) {
        if banner.isBackfilled {
            print("バックフィル広告がロードされました")
        } else {
            print("ダイレクト広告がロードされました")
        }
    }

    func onAdFailedToReceive(_ banner: AdropBanner, _ errorCode: AdropErrorCode) {
        switch errorCode {
        case .ERROR_CODE_AD_NO_FILL:
            print("ダイレクト広告なし、バックフィル広告をリクエスト中...")
        case .ERROR_CODE_AD_BACKFILL_NO_FILL:
            print("バックフィル広告もありません")
            // 広告領域を非表示にする
            banner.isHidden = true
        default:
            print("広告ロード失敗: \(errorCode)")
        }
    }
}

@interface ViewController () <AdropBannerDelegate>
@property (nonatomic, strong) AdropBanner *banner;
@end

@implementation ViewController

- (void)onAdReceived:(AdropBanner *)banner {
    if (banner.isBackfilled) {
        NSLog(@"バックフィル広告がロードされました");
    } else {
        NSLog(@"ダイレクト広告がロードされました");
    }
}

- (void)onAdFailedToReceive:(AdropBanner *)banner :(AdropErrorCode)errorCode {
    if (errorCode == AdropErrorCodeAdNoFill) {
        NSLog(@"ダイレクト広告なし、バックフィル広告をリクエスト中...");
    } else if (errorCode == AdropErrorCodeBackfillNoFill) {
        NSLog(@"バックフィル広告もありません");
        // 広告領域を非表示にする
        banner.hidden = YES;
    } else {
        NSLog(@"広告ロード失敗: %ld", (long)errorCode);
    }
}

@end

バックフィル広告を使用するには、AdropAds-Backfill依存性を追加する必要があります。はじめにを参照してください。

バックフィル広告のプリロード (preload)

SDK 1.17.0から、AdropBanner.preload()でバックフィルバナー広告をプリロードしておくことができます。同じユニットIDと同じサイズでload()したバナーが、ダイレクト広告なしでバックフィル広告に切り替わると、バックフィル広告を再度リクエストせず、プリロードしておいた広告をすぐに表示します。 load()はpreloadに関係なく、まずダイレクト広告をリクエストします。ダイレクト広告が表示された場合、プリロードしておいた広告はそのまま残ります。preloadを呼び出さなければ、動作はこれまでと同じです。

動作条件

adrop-adsとadrop-ads-backfillの両方が1.17.0以降である必要があります。
現在表示するダイレクト広告がないとサーバーからアプリに通知されている状態でのみ、バックフィル広告を受信します。それ以外の場合は、バックフィル広告をリクエストせずにERROR_CODE_AD_PRELOAD_SKIPPEDで終了します。ダイレクト広告のキャンペーンがあるアプリでは正常な結果です。
アプリのインストール直後、アプリキーを変更した直後、setUIDで別のユーザーに切り替えた直後は、サーバーの応答を受信するまでERROR_CODE_AD_PRELOAD_SKIPPEDで終了します。
テストユニットIDでは常にERROR_CODE_AD_PRELOAD_SKIPPEDで終了します。

使用方法

バナーがある画面を表示する直前に呼び出してください。プリロードした広告は使用されないと30分後に破棄されるため、すぐに表示するバナーに対してのみ呼び出してください。結果を待ってからload()する必要はありません。まだ受信中の場合は、load()がその結果を待って使用します。 delegateは弱参照で保持されます。結果コールバックを受け取るには、結果が届くまでdelegateオブジェクトを保持してください。

import UIKit
import AdropAds

final class HomeViewController: UIViewController, AdropBannerDelegate {
    // バナーがある画面を表示する直前に呼び出します。
    func preloadFeedBanner() {
        AdropBanner.preload(
            unitId: "YOUR_UNIT_ID",
            adSize: CGSize(width: 320, height: 50), // 省略すると320x50
            delegate: self
        )
    }

    func onAdPreloadReceived(_ unitId: String, _ contextId: String) {
        print("プリロード完了: \(unitId)")
    }

    func onAdPreloadFailedToReceive(_ unitId: String, _ contextId: String, _ errorCode: AdropErrorCode) {
        // ERROR_CODE_AD_PRELOAD_SKIPPEDは正常な結果です。
        // ここでpreloadをすぐに再度呼び出さないでください。
        print("プリロードされませんでした: \(errorCode.rawValue)")
    }

    // preloadでは呼び出されません。
    func onAdReceived(_ banner: AdropBanner) {}
    func onAdFailedToReceive(_ banner: AdropBanner, _ errorCode: AdropErrorCode) {}
}

@import AdropAds;

@interface HomeViewController () <AdropBannerDelegate>
@end

@implementation HomeViewController

// バナーがある画面を表示する直前に呼び出します。
- (void)preloadFeedBanner {
    [AdropBanner preloadWithUnitId:@"YOUR_UNIT_ID"
                         contextId:@""
                            adSize:CGSizeMake(320, 50)
                          delegate:self];
}

- (void)onAdPreloadReceived:(NSString *)unitId :(NSString *)contextId {
    NSLog(@"プリロード完了: %@", unitId);
}

- (void)onAdPreloadFailedToReceive:(NSString *)unitId :(NSString *)contextId :(AdropErrorCode)errorCode {
    // AdropErrorCodeERROR_CODE_AD_PRELOAD_SKIPPEDは正常な結果です。
    // ここでpreloadをすぐに再度呼び出さないでください。
    NSLog(@"プリロードされませんでした: %ld", (long)errorCode);
}

// preloadでは呼び出されません。
- (void)onAdReceived:(AdropBanner *)banner {}
- (void)onAdFailedToReceive:(AdropBanner *)banner :(AdropErrorCode)errorCode {}

@end

プリロードしておいた広告を使用するには、load()を呼び出す前に、バナーのframeのサイズをpreloadに渡したadSizeと同じに合わせてください。

let banner = AdropBanner(unitId: "YOUR_UNIT_ID")
banner.frame = CGRect(x: 0, y: 0, width: 320, height: 50) // preloadに渡したサイズ
banner.delegate = self
view.addSubview(banner)
banner.load()

AdropBanner *banner = [[AdropBanner alloc] initWithUnitId:@"YOUR_UNIT_ID" contextId:@""];
banner.frame = CGRectMake(0, 0, 320, 50); // preloadに渡したサイズ
banner.delegate = self;
[self.view addSubview:banner];
[banner load];

プリロードした広告が使われる条件

同じユニットIDと同じサイズ: load()するときに、バナーのframeのサイズがpreloadに渡したadSizeと同じである必要があります。Auto Layoutだけでサイズを決める場合、load()の時点ではサイズがまだ決まっていないことがあります。サイズが異なる場合、プリロードした広告はそのまま残り、load()は通常どおりバックフィル広告をリクエストします。
画面とは無関係: preloadはビューコントローラーを受け取りません。別の画面でプリロードした広告も、load()したバナーに使用されます。
一度だけ使用: プリロードした広告は、1回のload()で使用されるとなくなります。再度プリロードするには、preloadをもう一度呼び出してください。
有効期間と個数: 30分以内に使用されなかった広告は破棄されます。同じユニット・サイズには1個のみ保持し、バナーは異なるユニット・サイズの組み合わせを最大5個まで保持します。5個を超えると、最も早く受信した広告から破棄します。
再度呼び出す場合: 同じユニット・サイズで再度呼び出しても、新たにリクエストしません。受信済みの広告がある場合は新しいリクエストなしでonAdPreloadReceivedが呼び出され、受信中の場合はそのロードの結果（成功または失敗）がそのまま伝えられます。広告を更新する用途には使用できません。ただし、その間にユーザーの同意状態が変わった場合は、既存の広告を破棄して新たに受信します。
同意状態の変更: プリロードした後にユーザーの同意状態が変わると、その広告はload()に使用されません。

結果デリゲートメソッド

AdropBannerDelegateに次のオプションメソッドが追加されました。preloadを呼び出すたびに、いずれか一方がメインスレッドで1回呼び出されます。preloadでは、ほかのdelegateメソッドは呼び出されません。

メソッド	呼び出されるタイミング
`onAdPreloadReceived(_:_:)`	プリロードが完了したとき。その結果を待っていた`load()`がすでに使用している場合もあります。
`onAdPreloadFailedToReceive(_:_:_:)`	プリロードできなかったとき

2番目の引数contextIdは、preloadに渡した値をそのまま返します（デフォルト：空文字列）。プリロードした広告の選択には使用されません。

失敗コード

エラーコード	説明
`ERROR_CODE_AD_PRELOAD_SKIPPED`	ダイレクト広告が表示される可能性があるか、まだ確認されていないため、バックフィル広告をリクエストしませんでした。正常な結果のため、次の画面を表示する直前に再度呼び出してください。
`ERROR_CODE_AD_NO_FILL`	1.17.0以降のバックフィル依存性がないか、デバイスが`Adrop.initialize()`の対象国に属していないか、ユニットにバックフィルが設定されていないか、SDKがその設定をまだ受信していません。しばらくしてから再度呼び出してください。バックフィル依存性がないか、対象国でない場合は、引き続きこのコードで終了します。
`ERROR_CODE_AD_BACKFILL_NO_FILL`	バックフィル広告がありません。
`ERROR_CODE_INITIALIZE`	SDKが初期化されていません。
`ERROR_CODE_INVALID_UNIT`	ユニットIDが空です。

失敗コールバック内でpreloadをすぐに再度呼び出さないでください。バックフィル依存性がない場合のように結果が変わらないと、呼び出しが際限なく繰り返されます。次の画面を表示する前など、後で再度呼び出してください。

次のステップ

ネイティブ広告

UIに合わせてカスタマイズ可能なネイティブ広告の実装

インタースティシャル広告

画面全体を覆うインタースティシャル広告の実装

ターゲティング設定

ユーザー属性とコンテキストターゲティングの設定

リファレンス

クラス、デリゲート、エラーコードの参照

​概要

​主な特徴

​UIKit実装

​基本実装

​AdropBannerの初期化

​広告の読み込み

​Context IDの設定

​SwiftUI実装

​基本実装

​デリゲート処理

​Context IDの設定

​Objective-C実装

​基本実装

​Context IDの設定

​デリゲートメソッド

​onAdReceived (必須)

​onAdFailedToReceive (必須)

​onAdImpression (オプション)

​onAdClicked (オプション)

​onAdVideoStart (オプション)

​onAdVideoEnd (オプション)

​クロージャコールバック

​ライフサイクル管理

​destroy()

​広告サイズ

​一般的なバナーサイズ

​UIKit

​SwiftUI

​ベストプラクティス

​1. メモリ管理

​2. 画面の可視性

​3. バナーインスタンスの再利用

​4. エラー処理

​テストユニットID

​使用例

​動画再生制御

​play()

​pause()

​例：バックグラウンド/フォアグラウンドの処理

​カスタムクリック処理

​useCustomClick

​open()

​一括ロード (loads)

​シグネチャ

​使用方法

​デリゲートメソッド

​定数

​制約事項

​バックフィル広告

​バックフィル広告のプリロード (preload)

​動作条件

​使用方法

​プリロードした広告が使われる条件

​結果デリゲートメソッド

​失敗コード

​次のステップ

ネイティブ広告

インタースティシャル広告

ターゲティング設定

リファレンス

概要

主な特徴

UIKit実装

基本実装

AdropBannerの初期化

広告の読み込み

Context IDの設定

SwiftUI実装

基本実装

デリゲート処理

Context IDの設定

Objective-C実装

基本実装

Context IDの設定

デリゲートメソッド

onAdReceived (必須)

onAdFailedToReceive (必須)

onAdImpression (オプション)

onAdClicked (オプション)

onAdVideoStart (オプション)

onAdVideoEnd (オプション)

クロージャコールバック

ライフサイクル管理

destroy()

広告サイズ

一般的なバナーサイズ

UIKit

SwiftUI

ベストプラクティス

1. メモリ管理

2. 画面の可視性

3. バナーインスタンスの再利用

4. エラー処理

テストユニットID

使用例

動画再生制御

play()

pause()

例：バックグラウンド/フォアグラウンドの処理

カスタムクリック処理

useCustomClick

open()

一括ロード (loads)

シグネチャ

使用方法

デリゲートメソッド

定数

制約事項

バックフィル広告

バックフィル広告のプリロード (preload)

動作条件

使用方法

プリロードした広告が使われる条件

結果デリゲートメソッド

失敗コード

次のステップ