기본 요건

deployment target 10 이상
Xcode 12 이상 사용

준비 사항

BuzzAd iOS SDK를 연동하기 위해서 아래 사항을 준비해야 합니다.

ID	설명	비고

ID	설명	비고
App ID	앱별 고유 식별자	발급이 필요한 경우는 버즈빌 담당자에게 문의 바랍니다.
Unit ID	광고 지면별 고유 식별자	발급이 필요한 경우는 버즈빌 담당자에게 문의 바랍니다.

포인트 적립 서버 연동

버즈빌 광고는 참여 시 포인트를 지급하는 보상형 광고와 지급하지 않는 비보상형 광고가 있습니다.

사용자가 보상형 광고에 참여하면 포인트 적립 요청을 처리할 수 있는 서버가 필요할 수 있습니다. 연동하는 방식에 따라 차이가 있으니, 아래 표를 확인하여 진행하시기 바랍니다.

광고 포인트 지급 여부	자체 포인트 시스템 여부	설명

광고 포인트 지급 여부

자체 포인트 시스템 여부

설명

지급하지 않음

-

비보상형 광고로 연동합니다.
서버 간 연동은 불필요합니다.

지급을 원함

없음

네이버페이 포인트 등 제3의 포인트 시스템을 이용하여 포인트를 부여할 수 있습니다.

버즈빌 담당자에게 문의하시기 바랍니다.

있음

포스트백 연동 가이드을 참고하여 서버간 연동 진행할 수 있습니다.

SDK 설치

Cocoapods 을 사용하여 라이브러리를 추가합니다. 연동하는 지면을 확인한 후, 지면별 라이브러리를 추가합니다.

// Podfile

pod 'BuzzAdBenefitFeed', '= 2.4.8' // feed 지면 라이브러리

pod 'BuzzAdBenefitNative', '= 2.4.8' // native 지면 라이브러리

pod 'BuzzAdBenefitInterstitial', '= 2.4.8' // interstitial 지면 라이브러리

오프라인 빌드가 필요하시면 버즈빌 매니저에게 문의 바랍니다.
버즈빌 매니저가 SDK 연동에 필요한 라이브러리를 준비해드립니다.

자세한 내용은 오프라인 빌드를 적용하는 예시를 확인하시기 바랍니다.

SDK 초기화

1 BuzzAdBenefit 초기화
2 사용자 프로필 설정

BuzzAdBenefit 초기화

BABConfig에 App ID를 추가하고 AppDelegate의 application:didFinishLaunchingWithOptions에서 SDK 를 초기화합니다.

다음은 BuzzAdBenefit을 초기화하는 예시입니다.

@interface AppDelegate ()
@end

@implementation AppDelegate {
  ...
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  ...
  BABConfig *config = [[BABConfig alloc] initWithAppId:@"YOUR_APP_ID"];
  [BuzzAdBenefit initializeWithConfig:config];
  ...
}
@end

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    ...
    let config = BABConfig(appId: "YOUR_APP_ID")
    BuzzAdBenefit.initialize(with: config)
    ...    
  }
}

사용자 프로필 설정

사용자 프로필은 광고 할당 요청 전에 등록해야 합니다. 필수 정보를 등록하지 않으면 광고 할당이 되지 않습니다. 권장 정보를 제외할 경우에는 유저 정보 기반의 광고가 할당에서 제외됩니다.

사용자 프로필 설정 완료 콜백을 받을 수 있습니다. 완료 콜백을 참고하여 사용할 수 있습니다.

유저 프로필	설명	비고

유저 프로필	설명	비고
필수 userId	사용자 고유 식별자	서비스 도중에 변하지 않는 값 앱 삭제 후 재설치 시 유저 ID 값이 변경되는 등, 고정된 유저 ID를 사용하지 못하는 경우 버즈빌 담당자에게 문의 바랍니다.
권장 gender	사용자의 성별	남성: `BABUserGenderMale` 여성: `BABUserGenderFemale`
권장 birthYear	사용자의 출생연도	-

다음은 사용자 프로필을 설정하는 예시입니다.

자주하는 질문

iOS 14 지원을 위해 별도로 조치해야 할 내용은 없나요?

→ iOS 14를 위한 준비를 참고하시기 바랍니다.

동영상 광고 재생 옵션을 변경하고 싶습니다.

→ 동영상 광고 재생에 대한 설명을 참고하시기 바랍니다.

문의하기 기능이 필요한가요?

→ 액션형 광고를 노출하는 경우 문의하기 기능이 필요합니다. 자세한 사항은 참여형 광고에 대한 설명을 참고하시기 바랍니다.

광고를 인앱의 브라우저에서 표시하고 싶습니다.

→ 커스텀 런처 사용방법을 참고하여 구현하실 수 있습니다.

deployment target 9 인 앱에서 연동하고 싶습니다.

→ deployment target 9 앱에서도 연동 가능합니다. 단, iOS 10 이상에서만 SDK가 동작하도록 구현해야합니다.

샘플앱 코드

Github 샘플코드를 통해, 실제 구현에 사용된 예제를 참고할 수 있습니다.

광고 지면 추가

BuzzAd iOS SDK 연동을 위한 기본적인 설정을 완료하였습니다. 아래 지면별 연동 가이드에 따라 진행하시기 바랍니다.

Feed

Feed 연동하기

리스트 형태의 광고 지면입니다.

Native

Native 연동하기

커스텀 광고 지면입니다.

배너 타입의 광고도 Native 지면으로 연동할 수 있습니다. 지면 크기별 Native 광고 layout 가이드를 참고하시기 바랍니다.

Interstitial

Interstitial 연동하기

전면 광고 지면입니다.

Buzzvil Developer Guides

2. iOS 2.4.x 시작하기

목차