ワイプアド（iOS）

アプリの画面上に、ワイプのように動画広告を表示するフォーマットになります。
表示の初期位置は画面上の四隅(右上,右下,左上,左下)をお選びいただき、
アプリの配色にあわせて、Light/Darkのテーマをご指定いただけます。

サイズ仕様について

表示サイズについては横幅のみ任意の数値をご指定いただけますが、視認性確保のために、サイズについて上限と下限が定められております。
基本的に400(dp)などの大きな値を横幅としてご指定いただき、最大サイズ(デフォルト)で表示いただくことを想定しておりますが、
アプリ状況により細かくサイズをご指定いただく必要がある場合は、下記の最大サイズ〜最小サイズの範囲内でご指定ください。

最大サイズ（デフォルト）

表示対象となる画面の高さと横幅を比較し、
画面の高さ < 画面の横幅 の場合は、高さの35%を最大値として、16:9の比率で横幅を算出して表示いたします。
画面の高さ > 画面の横幅 の場合は、横幅の53%を最大値として、16:9の比率で高さを算出して表示いたします。
最大サイズより大きな横幅の値をご指定いただいた場合は、上記のルールに基づいてリサイズされます。

最小サイズ

最小横幅は 135dp です。
指定値が 135dp 未満の場合は最小サイズにリサイズされます。

表示の初期位置について

画面上の四隅(右上,右下,左上,左下)をお選びいただくことが可能です。
アプリ状況により、表示位置をずらしたい場合、マージンの値をご指定いただくことで、
右上 または 左上 をお選びいただいた場合は、ワイプアドに対してトップマージンが追加されます。
右下 または 左下 をお選びいただいた場合は、ワイプアドに対してボトムマージンが追加されます。

対応SDK

• Ad Generation SDK iOS v2.19.0 以降

対応バージョン

• iOS 12.0以降

SDK 実装について

ADGWipeクラスのインスタンスを生成し、事前に preload() メソッドをコールいただき、広告をロードしてください。
正常にロード完了した場合、iOS : ADGManagerViewControllerReceiveAd() のコールバックがおこなわれますので、
その後は任意のタイミングで show() メソッドをコールいただき、広告の表示をおこなってください。
ロード完了後、即時表示をおこないたい場合は、iOS : ADGManagerViewControllerReceiveAd() のコールバック内に show() メソッドをコールいただくように記述してください。

API Reference

• iOS リファレンス

Swift

import ADG

class SampleWipeViewController: UIViewController {

    private var adgWipe: ADGWipe?

    override func viewDidLoad() {
        super.viewDidLoad()

        // ADGWipeインスタンスを生成してください
        // [広告枠ID, 表示位置, 表示位置に対してのマージン, ワイプアド横幅, 表示対象VC] が必要です
        adgWipe = ADGWipe(
            locationID: "xxxxxx",
            position: kADGWipePosition.adgWipePositionBottomRight,
            margin: 0,
            width: 200,
            rootViewController: self
        )

        // デリゲートをセットしてください
        adgWipe?.delegate = self

        // テストモードをONにする場合は有効化してください
        // ※リリース時は必ずfalse or 記述を削除してください
        adgWipe?.setEnableTestMode(true)

        // フレームのテーマ色を指定（未指定時は Light）
        adgWipe?.setWipeViewTheme(kADGWipeTheme.adgWipeThemeDark)

        // 広告のプリロード
        adgWipe?.preload()
    }

    override func viewDidDisappear(_ animated: Bool) {
        super.viewDidDisappear(animated)
        // ワイプアドを非表示にする
        adgWipe?.dismiss()
    }
}

extension SampleWipeViewController: ADGWipeDelegate {

    // ワイプアドのレシーブ時に呼ばれるデリゲートメソッド
    func adgManagerViewControllerReceiveAd(_ adgManagerViewController: ADGManagerViewController) {
        print("Received an ad.")
        // 広告表示
        adgWipe?.show()
    }

    // 広告のエラー時に呼ばれるデリゲートメソッド
    func adgManagerViewControllerFailed(toReceiveAd adgManagerViewController: ADGManagerViewController,
                                        code: kADGErrorCode) {
        print("Failed to receive an ad.")
        switch code {
        case .adgErrorCodeNeedConnection, // ネットワーク不通
             .adgErrorCodeExceedLimit,    // エラー多発
             .adgErrorCodeNoAd:           // 広告レスポンスなし
            break
        default:
            break
        }
    }

    // 広告のタップ時に呼ばれるデリゲートメソッド
    func adgManagerViewControllerDidTapAd(_ adgManagerViewController: ADGManagerViewController) {
        print("Did tap ad.")
    }

    // ワイプアドのクローズ時に呼ばれるデリゲートメソッド
    func adgWipeClose() {
        print("Closed wipe ads")
    }
}

Objective-C

#import "ADGWipe.h"

@interface SampleWipeViewController : UIViewController <ADGWipeDelegate>
@property (nonatomic) ADGWipe *wipe;
@end

@implementation SampleWipeViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    if (self.wipe) {
        [self.wipe dismiss];
    }

    // ADGWipeインスタンスを生成してください
    self.wipe = [[ADGWipe alloc] initWithLocationID:@"xxxxxx"
                                           position:kADGWipePositionBottomRight
                                             margin:0.0f
                                              width:200
                                 rootViewController:self];

    // デリゲートをセットしてください
    self.wipe.delegate = self;

    // テストモードをONにする場合は有効化してください（リリース時は無効）
    // [self.wipe setEnableTestMode:YES];

    // フレームのテーマ色を指定（未指定時は Light）
    [self.wipe setWipeViewTheme:kADGWipeThemeDark];

    // 広告のプリロード
    [self.wipe preload];
}

- (void)viewDidDisappear:(BOOL)animated {
    [super viewDidDisappear:animated];
    // ワイプアドを非表示にする
    [self.wipe dismiss];
}

- (void)dealloc {
    self.wipe.delegate = nil;
    self.wipe = nil;
}

// ワイプアドのレシーブ時に呼ばれるデリゲートメソッド
- (void)ADGManagerViewControllerReceiveAd:(ADGManagerViewController *)adgManagerViewController {
    NSLog(@"Received an ad.");
    [self.wipe show];
}

// 広告のエラー時に呼ばれるデリゲートメソッド
- (void)ADGManagerViewControllerFailedToReceiveAd:(ADGManagerViewController *)adgManagerViewController
                                             code:(kADGErrorCode)code {
    NSLog(@"Failed to receive an ad.");
    switch (code) {
        case kADGErrorCodeNeedConnection:   // ネットワーク不通
        case kADGErrorCodeExceedLimit:      // エラー多発
        case kADGErrorCodeNoAd:             // 広告レスポンスなし
            break;
        default:
            break;
    }
}

// 広告のタップ時に呼ばれるデリゲートメソッド
- (void)ADGManagerViewControllerDidTapAd:(ADGManagerViewController *)adgManagerViewController {
    NSLog(@"Did tap ad.");
}

// ワイプアドのクローズ時に呼ばれるデリゲートメソッド
- (void)ADGWipeClose {
    NSLog(@"Closed wipe ads.");
}

@end

Note

ワイプアドは Ad Generation SDK 内包の xib リソースを参照します。マニュアルインストール時は SDK に含まれるリソースを Xcode プロジェクトへ追加してください。 〜v2.22.2 では ADG.framework/ADG-Resources.bundle をプロジェクトへ追加する必要があります（CocoaPods では自動追加）。 v2.23.0 以降は ADG-Resources.bundle を利用しません。詳細は iOS SDK バナー導入マニュアルの「1. SDKをダウンロードする」を参照してください。