모달 광고

모달 형태의 광고를 제공 합니다.

1. 인스턴스 생성

아래 코드를 추가하여 모달광고 인스턴스를 생성 합니다.

Objective-C

MainViewController.m에 AdPopcornSSPModalAd.h 를 import 하고 인스턴스 변수를 선언합니다.

#import <AdPopcornSSP/AdPopcornSSPModalAd.h>					
@interface AdPopcornSSPModalAd() <APSSPModalAdDelegate>	
{										
    AdPopcornSSPModalAd *_sspModalAd;					
} 										
@end	

Swift

MainViewController.swift 에 AdPopcornSSPModalAd 인스턴스 변수를 선언합니다.

class MainViewController: UIViewController, APSSPModalAdDelegate
{	
    // AdPopcornSSPModalAd
    var sspModalAd: AdPopcornSSPModalAd!
}

Objective-C

MainViewController.m 을 수정하여 생성한 인스턴스를 구현합니다.

@implementation MainViewController 

- (void)viewDidLoad { 
   [super viewDidLoad]; 
    
   _sspModalAd = [[AdPopcornSSPModalAd alloc] initWithKey:@"YOUR_APP_KEY" placementId:@"YOUR_PLACEMENT_ID" viewController:self];
   _sspModalAd.delegate = self;
   _sspModalAd.closeBtnType = 0;
   [_sspModalAd loadRequest];
}
@end

Swift

MainViewController.swift 을 수정하여 생성한 인스턴스를 구현합니다.

class MainViewController: UIViewController, APSSPModalAdDelegate
{	
    // AdPopcornSSPModalAd
    var sspModalAd: AdPopcornSSPModalAd!
    override func viewDidLoad() {
        super.viewDidLoad()
	sspModalAd = AdPopcornSSPModalAd(key: "YOUR_APP_KEY", placementId: "YOUR_PLACEMENT_ID", viewController: self)
	sspModalAd.delegate = self
    }
}

• YOUR_APP_KEY : 애드팝콘 SSP 콘솔 페이지에서 앱을 등록하고 발급 받은 앱 키

• YOUR_PLACEMENT_ID : 애드팝콘 SSP 콘솔 페이지에서 생성한 배너 광고 PlacementId

2. 모달 광고 닫기 버튼 타입 설정

모달 광고 닫기 버튼의 타입을 설정할 수 있습니다.

Objective-C

_sspModalAd.closeBtnType = 0 // 기본값 : 0

Swift

sspModalAd.setCloseBtnType(0) // 기본값 : 0

Default 값은 0 이며, 지원하는 닫기 버튼의 형태는 총 2가지입니다.

value	설명
0	광고 닫기 (기본 값)
1	오늘 하루 안보기 (00시 기준으로 리셋)

3. 모달 광고 요청

loadRequest API를 호출하여모달 광고를 요청합니다.

Objective-C

[_sspModalAd loadRequest];

Swift

sspModalAd.loadRequest()

4. 모달 광고 노출

모달 광고를 성공적으로 로드 한 뒤, 아래 API를 호출하여 모달 광고를 노출하여 줍니다.

Objective-C

[_sspModalAd presentFromViewController:viewController];

Swift

sspModalAd.present(from:self)

5. 델리게이트 설정

모달 광고에서 발생하는 이벤트에 대한 델리게이트를 제공 합니다.

델리게이트를 사용하기 위해서는 APSSPModalAdDelegate를 추가 하여야 합니다.

Objective-C

_sspModalAd 인스턴스에 delegate를 설정하고 구현하여야 합니다.

delegate	설명
APSSPModalAdLoadSuccess	모달 광고 로드 성공
APSSPModalAdLoadFail, error	모달 광고 로드 실패. 에러코드 값
APSSPModalAdShowSuccess	모달 광고 화면 노출 성공
APSSPModalAdShowFail	모달 광고 노출 실패
APSSPModalAdClicked	모달 광고 클릭
APSSPModalAdClosed	모달 광고 닫기

Swift

sspModalAd 인스턴스에 delegate를 설정하고 구현하여야 합니다.

delegate	설명
apsspModalAdLoadSuccess	모달 광고 로드 성공
apsspModalAdLoadFail(error)	모달 광고 로드 실패. 에러코드 값
apsspModalAdShowSuccess	모달 광고 화면 노출 성공
apsspModalAdShowFail	모달 광고 노출 실패
apsspModalAdClicked	모달 광고 클릭
apsspModalAdClosed	모달 광고 닫기

Objective-C

#import <AdPopcornSSP/AdPopcornSSPModalAd.h>

@interface MainViewController() <APSSPModalAdDelegate>
{ 
    AdPopcornSSPModalAd *_sspModalAd;
}
@end

@implementation MainViewController 

- (void)viewDidLoad { 
    [super viewDidLoad]; 
    
    _sspModalAd = [[AdPopcornSSPModalAd alloc] initWithKey:@"YOUR_APP_KEY" placementId:@"YOUR_PLACEMENT_ID" viewController:self];
    _sspModalAd.delegate = self;
    _sspModalAd.closeBtnType = 0;
    [_sspModalAd loadRequest];
}
@end

#pragma APSSPModalAdDelegate 
	/*!
 @abstract
 modal 광고 load 완료시(성공시), 호출된다.
 */
- (void)APSSPModalAdLoadSuccess:(AdPopcornSSPModalAd *)modalAd
{
    NSLog(@"APSSPModalAdLoadSuccess : %@", modalAd);
    [modalAd presentFromViewController:self];
}

/*!
 @abstract
 modal 광고 load 실패시, 호출된다.
 */
- (void)APSSPModalAdLoadFail:(AdPopcornSSPModalAd *)modalAd error:(AdPopcornSSPError *)error
{
    NSLog(@"APSSPModalAdLoadFail : %@, error : %@", modalAd, error);
}
/*!
 @abstract
 modal 광고 close시, 호출된다.
 */
- (void)APSSPModalAdClosed:(AdPopcornSSPModalAd *)modalAd
{
    NSLog(@"APSSPModalAdClosed : %@", modalAd);
}

/*!
 @abstract
 modal 광고 클릭시, 호출된다.
 */
- (void)APSSPModalAdClicked:(AdPopcornSSPModalAd *)modalAd
{
    NSLog(@"APSSPModalAdClicked : %@", modalAd);
}

/*!
 @abstract
 modal 광고 show 완료시(성공시), 호출된다.
 */
- (void)APSSPModalAdShowSuccess:(AdPopcornSSPModalAd *)modalAd
{
    NSLog(@"APSSPModalAdShowSuccess : %@", modalAd);
}

/*!
 @abstract
 modal 광고 show 실패시, 호출된다.
 */
- (void)APSSPModalAdShowFail:(AdPopcornSSPModalAd *)modalAd error:(AdPopcornSSPError *)error
{
    NSLog(@"APSSPModalAdShowFail : %@, error : %@", modalAd, error);
}
@end

Swift

class MainViewController: UIViewController, APSSPModalAdDelegate
{	
    // AdPopcornSSPModalAd
    var sspModalAd: AdPopcornSSPModalAd!
    override func viewDidLoad() {
        super.viewDidLoad()
	sspModalAd = AdPopcornSSPModalAd(key: "YOUR_APP_KEY", placementId: "YOUR_PLACEMENT_ID", viewController: self)
	sspModalAd.delegate = self
        sspModalAd.loadRequest()
    }
}

// ModalAd Delegate
func apsspModalAdLoadSuccess(_ modalAd: AdPopcornSSPModalAd!) {
    sspModalAd.present(from:self)
}
func apsspModalAdLoadFail(_ modalAd: AdPopcornSSPModalAd!, error: AdPopcornSSPError!) {
}
func apsspModalAdShowSuccess(_ modalAd: AdPopcornSSPModalAd!) {
}
func apsspModalAdShowFail(_ modalAd: AdPopcornSSPModalAd!) {
}
func apsspModalAdClicked(_ modalAd: AdPopcornSSPModalAd!) {
}
func apsspModalAdClosed(_ modalAd: AdPopcornSSPModalAd!) {
}