Versions Compared

Old Version 3

changes.mady.by.user Jerry Ko

Saved on

compared with

New Version 4

changes.mady.by.user Kaila Kong

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

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

Info

Github repository: buzzad-sdk-publisher-ios

Requirements

항목

내용

1

아이폰 버전 지원

iOS8 이상

2

app_key

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

Info

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

Installation

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

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

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

...

Note

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

...

Initialization

Code Block
languageobjective-c
@interface BuzzvilCore : NSObject

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

@end

...

항목

내용

appKey

Info

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

userId

Note

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

Call Methods

항목

코드

내용

Title 설정

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

유저 연령 설정

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

Code Block
languageobjective-c
@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

Code Block
languageobjective-c
#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 연동

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

Info

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

...