6. 퍼블리셔 오퍼월 iOS SDK

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 연동

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

https://buzzvil.atlassian.net/wiki/spaces/BDG/pages/1756004654 문서를 참고하여 API 연동 후, endpoint url을 버즈빌 매니저에게 전달해주세요.