Adfit Bizboard 연동 가이드

Adfit Bizboard 네이티브 연동만을 사용하고자 할 경우, 아래의 순서대로 연동을 진행하시면 됩니다.

단, SDK 설치, SSP 초기화, IDFA 설정, 로그 수준 설정 등은 [기본 연동가이드]를 통해 확인 후 선 진행 하시기 바랍니다.

1. Adfit SDK 다운로드

[AdFit SDK 설치 가이드] 문서에 나와 있는 순서대로 설정하여 AdFit SDK를 프로젝트에 추가합니다.

2. Adfit Mediation Adapter 다운로드

[AdFit Mediation Adapter]를 다운로드 하신 뒤, Adfit 폴더에 포함된, AdFitAdapter.h, AdFitAdapter.m 파일을 프로젝트에 추가합니다.

최신 AdFit Mediation Adapter의 경우 Adfit 3.12.22 버전과 호환됩니다. 3.12.22 미만의 버전을 사용하고 계실 경우 업데이트 해주시기 바랍니다.

3. 네이티브 광고 인스턴스 생성

StoryBoard에 AdPopcornSSPNativeAd 영역 지정 후 아래와 같이 Outlet 연결합니다.

#import <AdPopcornSSP/AdPopcornSSPNativeAd.h>

@property (strong, nonatomic) IBOutlet AdPopcornSSPNativeAd *adPopcornSSPNativeAd;

class ViewController: UIViewController, APSSPNativeAdDelegate
{	
    // AdPopcornSSPNativeAd
    var apSSPNativeAdRenderer: APSSPNativeAdRenderer!
    @IBOutlet var adPopcornSSPNativeAd: AdPopcornSSPNativeAd!
}

4. AppKey, PlacementId, ViewController 설정

ViewController.m을 수정하여 생성한 인스턴스에 setPlacementInfoWithAppkey API를 이용하여 아래와 같이 AppKey , PlacementId , ViewController를 설정 합니다.

#import <AdPopcornSSP/AdPopcornSSPNativeAd.h>	
#import "AdFitAdapter.h"

- (void)viewDidLoad
{	
    [super viewDidLoad];	
    [_adPopcornSSPNativeAd setPlacementInfoWithAppKey:@“발급받은앱키” placementId:@“발급받은 네이티브 PlacementId” viewController:self]; 
    _adPopcornSSPNativeAd.delegate = self;
}

class ViewController: UIViewController, APSSPNativeAdDelegate
{	
    // AdPopcornSSPNativeAd
    var apSSPNativeAdRenderer: APSSPNativeAdRenderer!
    @IBOutlet var adPopcornSSPNativeAd: AdPopcornSSPNativeAd!
    
    override func viewDidLoad() {
        super.viewDidLoad()
	adPopcornSSPNativeAd.setPlacementInfoWithAppKey("YOUR_APP_KEY", 
	placementId: "YOUR_PLACEMENT_Id", viewController: self)
	adPopcornSSPNativeAd.delegate = self
    }
}

5. Adfit Bizboard Template 설정

AdFit BizBoard 영역 생성 후, AdPopcorn SSP SDK에 전달합니다.

#import <AdPopcornSSP/AdPopcornSSPNativeAd.h>	
#import "AdFitAdapter.h"

@implementation AdPopcornSSPNativeViewController	
- (void)viewDidLoad
{	
	[super viewDidLoad];	
	[_adPopcornSSPNativeAd setPlacementInfoWithAppKey:@“발급받은앱키” placementId:@“발급받은 네이티브 PlacementId” viewController:self]; 
	_adPopcornSSPNativeAd.delegate = self;

	APAdFitNativeAdRenderer *apAdFitNativeAdRenderer = [[APAdFitNativeAdRenderer alloc] init];
	BizBoardTemplate *bizBoardTemplate = [[BizBoardTemplate alloc] init];
	apAdFitNativeAdRenderer.adfitBizBoardTemplate = bizBoardTemplate;
	[_adPopcornSSPNativeAd setAdFitRenderer:apAdFitNativeAdRenderer superView:bizBoardTemplate];
}
@end

class ViewController: UIViewController, APSSPNativeAdDelegate
{	
	// AdPopcornSSPNativeAd
    var apSSPNativeAdRenderer: APSSPNativeAdRenderer!
    @IBOutlet var adPopcornSSPNativeAd: AdPopcornSSPNativeAd!
    
    override func viewDidLoad() {	
        super.viewDidLoad()
	adPopcornSSPNativeAd.setPlacementInfoWithAppKey("YOUR_APP_KEY", 
	placementId: "YOUR_PLACEMENT_Id", viewController: self)
	adPopcornSSPNativeAd.delegate = self

	let apAdFitNativeAdRenderer = APAdFitNativeAdRenderer.init()
	let bizBoardTemplate = BizBoardTemplate()
	apAdFitNativeAdRenderer.adfitBizBoardTemplate = bizBoardTemplate
	adPopcornSSPNativeAd.setAdFitRenderer(apAdFitNativeAdRenderer, superView: bizBoardTemplate)
    }
}

6. 광고 요청

네이티브 인스턴스 생성과 UI 구성 요소 배치가 완료 된 경우 , 광고 요청 loadRequest API를 호출 하여 광고를 받아 옵니다.

[_sspNativeAd loadRequest];

adPopcornSSPNativeAd.loadRequest()

광고 수신이 정상적으로 완료 된 경우 아래 스크린샷과 같이 광고가 노출 됩니다.

7. AdInfoIcon 위치 커스터마이징

우측 상단의 물음표 아이콘의 경우 APAdFitNativeAdRenderer의 아래 property를 통해 위치 조정이 가능합니다.

bizBoardInfoIconTopConstant
bizBoardInfoIconBottomConstant
bizBoardInfoIconLeftConstant
bizBoardInfoIconRightConstant

#import <AdPopcornSSP/AdPopcornSSPNativeAd.h>	
#import "AdFitAdapter.h"

@implementation AdPopcornSSPNativeViewController	
- (void)viewDidLoad
{
	[super viewDidLoad];	
	[_adPopcornSSPNativeAd setPlacementInfoWithAppKey:@“발급받은앱키” placementId:@“발급받은 네이티브 PlacementId” viewController:self]; 
	_adPopcornSSPNativeAd.delegate = self;

	APAdFitNativeAdRenderer *apAdFitNativeAdRenderer = [[APAdFitNativeAdRenderer alloc] init];
	BizBoardTemplate *bizBoardTemplate = [[BizBoardTemplate alloc] init];
	apAdFitNativeAdRenderer.adfitBizBoardTemplate = bizBoardTemplate;
	apAdFitNativeAdRenderer.bizBoardInfoIconRightConstant = -16;
	[_adPopcornSSPNativeAd setAdFitRenderer:apAdFitNativeAdRenderer superView:bizBoardTemplate];
}
@end

class ViewController: UIViewController, APSSPNativeAdDelegate
{	
	// AdPopcornSSPNativeAd
	var apSSPNativeAdRenderer: APSSPNativeAdRenderer!
	@IBOutlet var adPopcornSSPNativeAd: AdPopcornSSPNativeAd!

	override func viewDidLoad() {	
		super.viewDidLoad()	
		adPopcornSSPNativeAd.setPlacementInfoWithAppKey("YOUR_APP_KEY", 
			placementId: "YOUR_PLACEMENT_Id", viewController: self)
		adPopcornSSPNativeAd.delegate = self

		apAdFitNativeAdRenderer = APAdFitNativeAdRenderer.init()
		bizBoardTemplate = BizBoardTemplate()
		apAdFitNativeAdRenderer.adfitBizBoardTemplate = bizBoardTemplate
		apAdFitNativeAdRenderer.bizBoardInfoIconRightConstant = -16;
		adPopcornSSPNativeAd.setAdFitRenderer(apAdFitNativeAdRenderer, superView: bizBoardTemplate)
		adPopcornSSPNativeAd.loadRequest()
	}
}

8. 네이티브 광고 이벤트 처리

네이티브광고에서 발생하는 이벤트에 대한 델리게이트를 제공합니다.델리게이트를 사용하기 위해서는 APSSPNativeAdDelegate를 추가하여야 합니다.

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

delegate

설명

APSSPNativeAdLoadSuccess

네이티브 광고 로드 성공

APSSPNativeAdLoadFail : error

네이티브 광고 로드 실패. 에러코드 값

APSSPNativeAdImpression

네이티브 광고 화면 노출

APSSPNativeAdClicked

네이티브 광고 클릭

#import <AdPopcornSSP/AdPopcornSSPNativeAd.h>	
#import "AdFitAdapter.h"

@interface AdPopcornSSPNativeViewController () <APSSPNativeAdDelegate>	
{	
} 
@property (strong, nonatomic) IBOutlet AdPopcornSSPNativeAd *adPopcornSSPNativeAd; 

@end	
@implementation AdPopcornSSPNativeViewController	

- (void)viewDidLoad
{	
	[super viewDidLoad];	
	[_adPopcornSSPNativeAd setPlacementInfoWithAppKey:@"발급받은앱키" placementId:@"발급받은 네이티브 PlacementId" viewController:self]; 
	_adPopcornSSPNativeAd.delegate = self; 

	APAdFitNativeAdRenderer *apAdFitNativeAdRenderer = [[APAdFitNativeAdRenderer alloc] init];
	BizBoardTemplate *bizBoardTemplate = [[BizBoardTemplate alloc] init];
	apAdFitNativeAdRenderer.adfitBizBoardTemplate = bizBoardTemplate;
	[_adPopcornSSPNativeAd setAdFitRenderer:apAdFitNativeAdRenderer superView:bizBoardTemplate];

	[_sspNativeAd loadRequest];
} 

#pragma AdPopcornSSPNativeAdDelegate 
- (void)AdPopcornSSPLoadNativeAdFailedWithError:(AdPopcornSSPError *)error 
{ 
} 

- (void)APSSPNativeAdLoadSuccess:(AdPopcornSSPNativeAD *)native Ad 
{ 
} 

- (void)APSSPNativeAdLoadFail:(AdPopcornSSPNativeAD *)nativeAd error:(AdPopcornSSPError) error 
{ 
}

- (void)APSSPNativeAdImpression:(AdPopcornSSPNativeAd *)nativeAd 
{ 
}

- (void)APSSPNativeAdClicked:(AdPopcornSSPNativeAd *)nativeAd 
{ 
}
@end

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

delegate

설명

apsspNativeAdLoadSuccess

네이티브 광고 로드 성공

apsspNativeAdLoadFail: error

네이티브 광고 로드 실패. 에러코드 값

apsspNativeAdImpression

네이티브 광고 화면 노출

apsspNativeAdClicked

네이티브 광고 클릭

class ViewController: UIViewController, APSSPNativeAdDelegate
{	
    // AdPopcornSSPNativeAd
    var apSSPNativeAdRenderer: APSSPNativeAdRenderer!
    @IBOutlet var adPopcornSSPNativeAd: AdPopcornSSPNativeAd!

    override func viewDidLoad() {	
        super.viewDidLoad()
	adPopcornSSPNativeAd.setPlacementInfoWithAppKey("YOUR_APP_KEY", 
	    placementId: "YOUR_PLACEMENT_Id", viewController: self)
	adPopcornSSPNativeAd.delegate = self

	apAdFitNativeAdRenderer = APAdFitNativeAdRenderer.init()
        bizBoardTemplate = BizBoardTemplate()
	apAdFitNativeAdRenderer.adfitBizBoardTemplate = bizBoardTemplate
	apAdFitNativeAdRenderer.bizBoardInfoIconRightConstant = -16;
	adPopcornSSPNativeAd.setAdFitRenderer(apAdFitNativeAdRenderer, superView: bizBoardTemplate)
	adPopcornSSPNativeAd.loadRequest()
    } 

    // Native Delegate
    func apsspNativeAdLoadSuccess(_ nativeAd: AdPopcornSSPNativeAd!) {
    }
    func apsspNativeAdLoadFail(_ nativeAd: AdPopcornSSPNativeAd!, error: AdPopcornSSPError!) {
    }
    func apsspNativeAdImpression(_ nativeAd: AdPopcornSSPNativeAd!) {
    }
    func apsspNativeAdClicked(_ nativeAd: AdPopcornSSPNativeAd!) {
    }
}

Last updated 11 months ago

Was this helpful?