6. 퍼블리셔 오퍼월 iOS SDK

Introduction

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

Github repository: buzzad-sdk-publisher-ios

Requirements

항목

내용

항목

내용

1

아이폰 버전 지원

iOS8 이상

2

app_key

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

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

Installation

  1. SDK 다운로드 후 압축 해제

    • 압축 해제한 폴더 내의 BuzzvilSDK.framework를 개발중인 iOS 어플리케이션에 포함하고 Embedded Binaries에 추가합니다.

       

  2. 앱 타겟의 "Build Phases" 에 "Run Script Phase" 를 추가하고 아래 코드를 붙여넣습니다.

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

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

Initialization

1 2 3 4 5 6 @interface BuzzvilCore : NSObject + (void)initWithAppKey:(NSString *)appKey; + (void)setUserId:(NSString *)userId; @end
  • 호출 위치

    • 오퍼월을 보여주려는 ViewControllerviewDidLoad

    • 또는 AppDelegateapplication: didFinishLaunchingWithOptions 에서 호출합니다.

항목

내용

항목

내용

appKey

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

userId

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

Call Methods

항목

코드

내용

항목

코드

내용

Title 설정

1 2 3 4 5 6 @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에 원하는 값을 전달합니다.

유저 연령 설정

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

1 2 3 4 5 6 @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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 #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/384696503 문서를 참고하여 API 연동 후, endpoint url을 버즈빌 매니저에게 전달해주세요.