6. 퍼블리셔 오퍼월 iOS SDK
Introduction
버즈애드를 아이폰 어플리케이션에 연동하기 위한 라이브러리입니다. 유저가 여러 액션형 광고에 참여할 수 있는 오퍼월 지면을 손쉽게 연동할 수 있습니다.
Github repository: buzzad-sdk-publisher-ios
Requirements
1 | 아이폰 버전 지원 | iOS8 이상 |
2 |
| SDK 연동 및 샘플 어플리케이션 실행을 위해 필요 버즈애드 퍼블리셔 어드민에서 확인 가능합니다. |
Installation
SDK 다운로드 후 압축 해제
압축 해제한 폴더 내의
BuzzvilSDK.framework
를 개발중인 iOS 어플리케이션에 포함하고 Embedded Binaries에 추가합니다.
앱 타겟의 "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
호출 위치
오퍼월을 보여주려는
ViewController
의viewDidLoad
또는
AppDelegate
의application: didFinishLaunchingWithOptions
에서 호출합니다.
|
|
|
앱 재설치 또는 일정 주기에 따라 |
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 | 애플리케이션의
|
유저 연령 설정 | 성별, 나이별 타게팅 정보를 가진 광고를 유저에게 보여주려 할 때 다음의 메소드를 통해 유저의 정보를 입력할 수 있습니다. 1
2
3
4
5
6
@interface BuzzvilCore : NSObject
+ (void)setGender:(NSString *)gender;
+ (void)setBirthYear:(NSInteger)birthYear;
@end |
|
유저 성별 설정 |
|
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/1756004654 문서를 참고하여 API 연동 후, endpoint url을 버즈빌 매니저에게 전달해주세요.