6. 퍼블리셔 오퍼월 iOS SDK

Owned by Jen Yoon (Unlicensed)
Last updated: May 10, 2021 by George Kim (Unlicensed)
2 min read

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" 를 추가하고 아래 코드를 붙여넣습니다.

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

userId

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에 원하는 값을 전달합니다.

유저 연령 설정

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

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

유저 성별 설정

  • setGender : 다음과 같이 미리 정의된 String 형식에 맞춰 성별을 적용해야 합니다.

    • BUZZVIL_GENDER_MALE : 남성인 경우

    • BUZZVIL_GENDER_FEMALE : 여성인 경우

Sample Code

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

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