시작하기
Buzzvil iOS SDK(이하 Buzzvil SDK)에서 제공하는 기능을 사용하기 전 완료해야 하는 설정에 대해 알아보세요.
요구 사양
- deployment target
- 최소 지원: iOS 15.0 이상
- Xcode 26.0 이상
연동용 ID 발급받기
Buzzvil SDK를 연동하려면 반드시 연동하려는 앱의 고유 식별자(App ID)와 광고 지면의 고유 식별자(Unit ID)가 필요합니다. ID를 발급받으려면 버즈빌 담당자(help@buzzvil.com)에게 연락하세요.

| ID 유형 | 설명 |
|---|---|
| App ID | Buzzvil SDK를 연동하는 앱별로 부여하는 고유 식별자입니다. |
| Unit ID | Buzzvil SDK를 통해 생성하는 지면별로 부여하는 고유 식별자입니다. |
포인트 적립 서버 연동하기
버즈빌이 공급하는 광고는 유저에게 포인트를 지급하는 보상형 광고와 지급하지 않는 비보상형 광고로 분류됩니다.
- 비보상형 광고: 논리워드 광고라고도 합니다. 유저가 광고에 참여해도 별도의 포인트를 지급할 필요가 없으므로 포인트 처리 서버를 연동하지 않아도 됩니다.
- 보상형 광고: 리워드 광고라고도 합니다. 유저가 광고에 참여하면 포인트를 지급해야 하므로 클라이언트의 포인트 적립 요청을 처리할 수 있는 서버가 필요합니다.
보상형 광고의 포인트 적립 요청을 처리할 수 있는 자체 서버를 보유한 경우, 포스트백 연동 가이드를 참고해 포인트 처리 서버를 연동하세요.

SDK 설치하기
Swift Package Manager
Swift Package Manager를 사용하여 Buzzvil SDK를 설치하려면 아래 단계를 따르세요.
-
Xcode에서
File > Add Package Dependencies로 이동합니다. -
Buzzvil SDK Swift Package GitHub 저장소를 검색합니다.
https://github.com/Buzzvil/buzzvil-ios-sdk
-
사용할 버전을 선택합니다. Up to Next Minor Version(최대 다음 마이너 버전) 사용을 권장합니다.
-
패키지 프로덕트에서
BuzzvilSDK를 선택합니다.
패키지 종속 항목을 추가하는 방법에 관한 자세한 내용은 Apple Developer 공식 문서를 참고하세요.
Cocoapods
CocoaPods를 사용하여 Buzzvil SDK를 설치하려면 Podfile에 BuzzvilSDK를 추가하세요.
pod 'BuzzvilSDK', '~> 6.10'
SDK 초기화하기
Buzzvil SDK를 설치한 후 App ID, 유저 프로필 등 필요한 정보를 추가해 SDK를 초기화하세요.
Buzzvil SDK 초기화하기
- 원하는 위치에서
BuzzBenefit.shared.initialize()를 호출해 SDK를 초기화하세요.
🚨 경고
BuzzBenefit.shared.initialize()호출하기 이전에 다른 모든 함수들이 호출되면 정상동작 하지 않습니다. 초기화 함수를 다른 함수 이전에 꼭 호출 해 주세요.
import BuzzvilSDK
let config = BuzzBenefitConfig.Builder(appId: "YOUR_APP_ID")
.build()
BuzzBenefit.shared.initialize(with: config)
@import BuzzvilSDK;
BuzzBenefitConfig *config = [BuzzBenefitConfig configWith:^(BuzzBenefitConfigBuilder * _Nonnull builder) {
builder.appId = @"YOUR_APP_ID";
}];
[[BuzzBenefit sharedInstance] initializeWith:config];
로그인 요청하기
광고 할당을 요청하려면 로그인을 요청해야 합니다. 로그인 요청을 구성하는 항목에 대해서는 아래 표를 참고하세요.
❗️❗️❗️ 중요 ❗️❗️❗️
성별과 출생연도 정보는 권장으로 표기되어 있으나 등록하지 않으면 타겟팅 광고 송출이 불가능합니다. 버즈빌의 광고는 타겟팅 광고가 대부분이기에 해당 정보를 등록해야 정상적인 광고 할당이 가능합니다.
| 필수/권장 | 유저 프로필 | 설명 |
|---|---|---|
| 필수 | userId | 유저별로 고유하게 생성하는 ID로, 개인정보 식별은 불가능한 값입니다 (로그인 ID, 이메일 사용 불가). 서비스 도중 변하지 않는 고정 값이며, 광고 할당을 위한 필수 정보입니다. ASCII 형식의 255자 이하로 제한됩니다. ⚠️ 주의 앱을 삭제 후 재설치하여 유저의 ID 값이 변경되거나 다른 사유로 인해 고정 ID를 사용하지 못하는 경우, 어뷰징 발생 가능성으로 인해 액션형 광고 송출이 불가능합니다. 유저 고유 식별자가 변동되는 경우 버즈빌 사업 담당자에게 문의하세요. |
| 권장 | gender | 유저의 성별입니다. 남성: BuzzBenefitUserGender.male, 여성: BuzzBenefitUserGender.female |
| 권장 | birthYear | 유저의 출생연도입니다. |
다음은 SDK에 유저 프로필을 등록하는 예시입니다. 등록한 유저 프로필은 삭제할 수도 있습니다.
// 로그인을 요청하는 코드입니다.
let buzzBenefitUser = BuzzBenefitUser.Builder(userId: "USER_ID")
.setGender(.male)
.setBirthYear(YYYY)
.build()
BuzzBenefit.shared.login(
with: buzzBenefitUser,
onSuccess: {
// 로그인이 성공한 경우 호출됩니다.
},
onFailure: { error in
// 로그인이 실패한 경우 호출됩니다.
}
)
// 로그인 상태를 확인하는 코드입니다.
BuzzBenefit.shared.isLoggedIn()
// 로그아웃하는 코드입니다.
BuzzBenefit.shared.logout()
BuzzBenefitUser *buzzBenefitUser = [BuzzBenefitUser userWith:^(BuzzBenefitUserBuilder * _Nonnull builder) {
builder.userId = @"USER_ID";
builder.gender = BuzzBenefitUserGenderMale;
builder.birthYear = YYYY;
}];
[[BuzzBenefit sharedInstance] loginWith:buzzBenefitUser onSuccess:^{
// 로그인이 성공한 경우 호출됩니다.
} onFailure:^(NSError * _Nonnull error) {
// 로그인이 실패한 경우 호출됩니다.
}];
// 로그인 상태를 확인하는 코드입니다.
[[BuzzBenefit sharedInstance] isLoggedIn];
// 로그아웃하는 코드입니다.
[[BuzzBenefit sharedInstance] logout];
샘플 코드
GitHub 샘플 코드를 통해 실제 구현에 사용된 예제를 참고할 수 있습니다.
자주 하는 질문
| 질문 | 답변 |
|---|---|
| iOS 17에 대응하기 위해 적용된 사항이 궁금합니다. | iOS 17을 위한 대응 토픽을 참고하세요. |
| 활동 추적 권한(ATT) 허용 유도 모달에 대해 궁금합니다. | 추적을 허용하지 않은 사용자에게 설정 방법을 안내하는 모달은 ATT(App Tracking Transparency, 앱 추적 투명성) 허용 유도 모달 토픽을 참고하세요. |