모달 광고

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

1. 인스턴스 생성

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

Objective-C

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

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

Swift

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

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

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

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

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

Objective-C

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

Swift

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

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

3. 모달 광고 요청

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

Objective-C

[_sspModalAd loadRequest];

Swift

4. 모달 광고 노출

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

Objective-C

[_sspModalAd presentFromViewController:viewController];

Swift

5. 델리게이트 설정

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

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

Objective-C

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

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

Swift

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