목차
기본 요건
minSdkVersion Android 4.1 (API level 16)이상Android Studio 3.2이상Gradle 4.0.1이상compileSdkVersion 29이상Android X
준비 사항
BuzzAd Android SDK를 연동하기 위해서 아래 사항을 준비해야 합니다.
ID | 설명 | 비고 |
|---|---|---|
App ID | 앱별 고유 식별자 | 발급이 필요한 경우는 버즈빌 담당자에게 문의 바랍니다. |
Unit ID | 광고 지면별 고유 식별자 |
포인트 적립 서버 연동
버즈빌 광고는 참여 시 포인트를 지급하는 보상형 광고와 지급하지 않는 비보상형 광고가 있습니다.
사용자가 보상형 광고에 참여하면 포인트 적립 요청을 처리할 수 있는 서버가 필요할 수 있습니다. 연동하는 방식에 따라 차이가 있으니, 아래 표를 확인하여 진행하시기 바랍니다.
광고 포인트 지급 여부 | 자체 포인트 시스템 여부 | 설명 |
|---|---|---|
지급하지 않음 | - | 비보상형 광고로 연동합니다. |
지급을 원함 | 없음 |
버즈빌 담당자에게 문의하시기 바랍니다. |
있음 | 포스트백 연동 가이드을 참고하여 서버간 연동 진행할 수 있습니다. |
SDK 설치
버즈빌 SDK 연동을 위해 build.gradle 에 라이브러리를 추가해야합니다.
// 프로젝트 레벨의 build.gradle
allprojects {
repositories {
...생략...
// 버즈빌 저장소 추가
maven { url "https://dl.buzzvil.com/public/maven" }
...생략...
}
}
// 모듈 레벨의 build.gradle
dependencies {
...생략...
// BuzzAd benefit SDK 추가
implementation ("com.buzzvil:buzzad-benefit:2.25.+")
...생략...
}
오프라인 빌드가 필요하시면 버즈빌 매니저에게 문의 바랍니다.
버즈빌 매니저가 SDK 연동에 필요한 라이브러리를 JAR/AAR로 준비해드립니다.
이 단계에서 문제가 발생했다면 빌드 Trouble Shooting를 참고하시기 바랍니다.
SDK 초기화
APP ID 추가
AndroidManifest.xml에 APP_ID 를 추가합니다. 아래 예시의 app-pub-000000000000 중 숫자 부분(000000000000)을 발급받은 APP_ID로 대체합니다.
예시) 발급받은 APP_ID 가 123456789123 일 경우, android:value="app-pub-123456789123”
<manifest>
<application>
<!-- App id 추가 -->
<meta-data
android:name="com.buzzvil.APP_KEY"
android:value="app-pub-000000000000" />
</application>
</manifest>
BuzzAdBenefit 초기화
Application의 onCreate에서 BuzzAdBenefit을 초기화합니다.
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
// BuzzAdBenefit 초기화
final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context)
.build();
BuzzAdBenefit.init(this, buzzAdBenefitConfig);
}
}
사용자 프로필 설정
사용자 프로필은 광고 할당 요청 전에 등록해야 합니다. 필수 정보를 등록하지 않으면 광고 할당이 되지 않습니다. 권장 정보를 제외할 경우에는 유저 정보 기반의 광고가 할당에서 제외됩니다.
유저 프로필 | 설명 | 비고 |
|---|---|---|
필수 userId | 사용자 고유 식별자 | 서비스 도중에 변하지 않는 값 앱 삭제 후 재설치 시 유저 ID 값이 변경되는 등, 고정된 유저 ID를 사용하지 못하는 경우 버즈빌 담당자에게 문의바랍니다. |
권장 gender | 사용자의 성별 |
|
권장 birthYear | 사용자의 출생연도 | - |
// 유저 정보를 등록합니다.
final UserProfile.Builder builder = new UserProfile.Builder(BuzzAdBenefit.getUserProfile());
final UserProfile userProfile = builder
.userId("USER_ID")
.gender(UserProfile.Gender.MALE)
.birthYear(1985)
.build();
BuzzAdBenefit.setUserProfile(userProfile);
// SDK에 등록한 사용자 프로필을 삭제합니다.
// BuzzAdBenefit.setUserProfile(null);
이후 광고 할당에 문제가 있다면 광고 할당 trouble shooting을 참고하시기 바랍니다.
샘플앱 코드
Github 샘플코드를 통해, 실제 구현에 사용된 예제를 참고할 수 있습니다.
자주 하는 질문
BuzzAd Android SDK의 UI 만 다크테마가 적용되어 어색합니다.
→ 앱에서 다크테마를 비활성화하는 방법을 참고하여 앱 내 다크테마를 비활성화할 수 있습니다.
BuzzAd Android SDK의 UI를 일괄 변경하고 싶습니다.
→ 테마를 설정하여 SDK 전반의 색상과 아이콘을 변경할 수 있습니다.
자세한 사항은 테마 적용을 참고하여 변경할 수 있습니다.
문의하기 버튼을 추가해야하는 이유를 알고 싶습니다.
→ 액션형 광고를 할당할 경우, 문의하기 기능은 필수입니다.
자세한 사항은 액션형 광고 주의 사항을 참고하시기 바랍니다.
광고를 WebView로 연결하고 싶습니다.
→ 커스텀 런처 설정을 참고하여 연동할 수 있습니다.
동영상 광고 재생 옵션을 변경하고 싶습니다.
→ 동영상 광고 재생 옵션을 참고하시기 바랍니다.
광고 지면 추가
BuzzAd Android SDK 연동을 위한 기본적은 설정은 완료하였습니다. 아래 지면별 연동 가이드에 따라 진행하시기 바랍니다.