View Source

Introduction

버즈애드를 아이폰 어플리케이션에 연동하기 위한 라이브러리입니다. 유저가 여러 액션형 광고에 참여할 수 있는 오퍼월 지면을 손쉽게 연동할 수 있습니다.

Github repository: buzzad-sdk-publisher-ios

Requirements

항목

내용

1

아이폰 버전 지원

iOS8 이상

2

app_key

SDK 연동 및 샘플 어플리케이션 실행을 위해 필요

버즈애드 퍼블리셔 어드민에서 확인 가능합니다.

Installation

SDK 다운로드 후 압축 해제
- 압축 해제한 폴더 내의 BuzzvilSDK.framework를 개발중인 iOS 어플리케이션에 포함하고 Embedded Binaries에 추가합니다.
앱 타겟의 "Build Phases" 에 "Run Script Phase" 를 추가하고 아래 코드를 붙여넣습니다.

bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/BuzzvilSDK.framework/strip-framework.sh"

추가한 "Run Script Phase"가 "Embed Frameworks" 아래에 위치하도록 주의합니다.

Initialization

@interface BuzzvilCore : NSObject

+ (void)initWithAppKey:(NSString *)appKey;
+ (void)setUserId:(NSString *)userId;

@end

호출 위치
- 오퍼월을 보여주려는 ViewController의 viewDidLoad
- 또는 AppDelegate의 application: didFinishLaunchingWithOptions 에서 호출합니다.

항목

내용

appKey

appKey는 퍼블리셔 어드민 페이지에 로그인하여 확인 가능

userId

유저에게 적립금을 지급하기 위한 필수적인 설정값
매체사에서 유저를 구분할 수 있는 식별값
적립금 지급 요청 (서버 연동) 시에 전달됨

앱 재설치 또는 일정 주기에 따라 userId 가 변화할 경우, 반드시 BD 매니저와 사전 논의 필요

Call Methods

항목

코드

내용

Title 설정

@interface BuzzOfferwall : NSObject

+ (BOOL)showOfferWallWithTitle:(NSString *)title;
+ (BOOL)showOfferWallWithTitle:(NSString *)title statusBarHidden:(BOOL)statusBarHidden;
+ (BOOL)showOfferWallWithTitle:(NSString *)title statusBarHidden:(BOOL)statusBarHidden presentationStyle:(UIModalPresentationStyle)presentationStyle;
@end

애플리케이션의 Info.plist에 "View controller-based status bar appearance" 가 YES로 설정되어 있는 경우

statusBar를 숨기고 싶다면 statusBarHidden의 인자로 NO를 전달합니다.
modalPresentationStyle을 변경하고 싶다면 presentationStyle에 원하는 값을 전달합니다.

유저 연령 설정

성별, 나이별 타게팅 정보를 가진 광고를 유저에게 보여주려 할 때 다음의 메소드를 통해 유저의 정보를 입력할 수 있습니다.

@interface BuzzvilCore : NSObject

+ (void)setGender:(NSString *)gender;
+ (void)setBirthYear:(NSInteger)birthYear;

@end

setBirthYear : 유저의 출생 년도를 4자리의 숫자로 입력하여 나이를 설정합니다. (예: 1988)

유저 성별 설정

setGender : 다음과 같이 미리 정의된 String 형식에 맞춰 성별을 적용해야 합니다.
- BUZZVIL_GENDER_MALE : 남성인 경우
- BUZZVIL_GENDER_FEMALE : 여성인 경우

Sample Code

#import <BuzzvilSDK/BuzzvilSDK.h>

...

- (void)viewDidLoad {
    [super viewDidLoad];
    
    [BuzzvilCore initWithAppKey:@"appKey"];
    [BuzzvilCore setUserId:@"userId"];
    [BuzzvilCore setGender:BUZZVIL_GENDER_MALE];
    [BuzzvilCore setBirthYear:1985];
}

...

- (IBAction)openButtonTouchUpInside:(id)sender {
    [BuzzOfferwall showOfferWallWithTitle:@"Get point"];
}

포인트 적립 포스트백 API 연동

버즈애드에서 포인트 적립이 발생했을 때 버즈애드에서 직접 매체사 유저들에게 포인트를 지급하는 것이 아닙니다. 버즈애드 서버에서 매체사 서버로 포인트 적립 요청을 보낼 뿐이고, 실제 지급은 매체사 서버에서 처리합니다.

매체사 포인트 적립 포스트백 API 연동 문서를 참고하여 API 연동 후, endpoint url을 버즈빌 매니저에게 전달해주세요.