기본 요건
minSdkVersion Android 4.1 (API level 16)이상Android Studio 3.2이상Gradle 4.x.x이상compileSdkVersion 29이상Android X
준비 사항
BuzzAdBenefit BuzzAd SDK를 연동하기 전, 아래 사항을 먼저 준비해야 합니다.
App ID: 앱 마다 하나씩 부여되는 고유의 아이디
Unit ID: 광고 지면마다 하나씩 부여되는 아이디
1. Feed 적용 시 Feed Unit ID 준비
2. Native Ads 적용 시 Native Ad Unit ID 준비
3. Interstitial 적용 시 Interstitial Ad Unit ID 준비
포인트 적립 요청을 받을 수 있는 API 서버 - 매체사 포인트 적립 포스트백 API 연동
자체 포인트 시스템을 가지고 있고, 광고를 통한 포인트 적립이 필요한 경우만 해당합니다.해당
Postback(포인트 적립요청) 수신 url 생성 후 버즈빌 담당자에게 전달
SDK 설치
버즈빌 SDK 연동을 위해 build.gradle 에 라이브러리를 추가해야합니다.
Step 1. 프로젝트 레벨의 build.gradle 에 버즈빌 저장소를 추가
| Code Block | ||
|---|---|---|
| ||
allprojects {
repositories {
...(생략)...
// 버즈빌 저장소 추가
maven { url "https://dl.buzzvil.com/public/maven" }
...(생략)...
}
} |
Step 2. 모듈레벨의 build.gradle 에 SDK 를 추가
| Code Block | ||
|---|---|---|
| ||
dependencies {
...(생략)...
// BuzzAd benefit SDK 추가
implementation ("com.buzzvil:buzzad-benefit:2.1921.+")
...(생략)...
} |
| Info |
|---|
오프라인 빌드가 필요한 경우 버즈빌 매니저에게 알려주세요. |
이 단계에서 문제가 발생했다면 여기를 참고해주세요
SDK 초기화
Step 1. APP ID 추가
AndroidManifest.xml에 아래와 같이 APP_ID 를 추가합니다.
아래 예시의 app-pub-000000000000 중 숫자 부분(000000000000)을 APP_ID 로 대체합니다.
예시) 발급받은 APP_ID 가 123456789123 일 경우, android:value="app-pub-123456789123”
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.buzzvil.packagename">
<application>
...(생략)...
<!-- Caution: Replace `000000000000` with Your App ID -->
<meta-data
android:name="com.buzzvil.APP_KEY"
android:value="app-pub-000000000000" />
</application>
</manifest> |
Step 2. BuzzAdBenefit 초기화
Application Class의 onCreate에 아래 코드를 추가합니다.
| Code Block | ||
|---|---|---|
| ||
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
BuzzAdBenefit.init(this, new BuzzAdBenefitConfig.Builder(this).build());
...(생략)...
}
} |
Step 3. 로그인
광고 할당을 위해 유저의 성별/출생년도를 SDK에 등록해야 합니다. 유저가 앱에 로그인한 시점에 아래와 같이 UserProfile 을 설정합니다.
userId : 서비스 도중에 변하지 않는 유저 고유 식별값
gender
UserProfile.Gender.MALE: 남성UserProfile.Gender.FEMALE: 여성
birthYear: 출생년도
| Code Block | ||
|---|---|---|
| ||
final UserProfile.Builder builder = new UserProfile.Builder(BuzzAdBenefit.getUserProfile());
final UserProfile userProfile = builder
.userId("Your_Service_User_ID")
.gender(UserProfile.Gender.MALE)
.birthYear(1985)
.build();
BuzzAdBenefit.setUserProfile(userProfile); |
유저가 앱에서 로그아웃하는 시점에 UserProfile 설정값을 지워 유저의 사용 시점에 등록된 정보를 삭제합니다.
| Code Block | ||
|---|---|---|
| ||
BuzzAdBenefit.setUserProfile(null); |
| Note |
|---|
User 유저 ID와 타게팅 정보 (성별, 출생년도)는 광고 할당 및 원활한 서비스 운영을 위해 제공해야 할 필수 항목입니다. 타게팅 정보(성별/출생연도)을 제공할 수 없는 경우라면 버즈빌 담당자에게 문의바랍니다. |
| Note |
|---|
앱 삭제 후 재설치 시 userId 유저 ID 값이 변경되는 등, 고정된 userId를 유저 ID를 사용하지 못하는 경우 버즈빌 담당자에게 문의바랍니다. |
이후 광고 할당에 문제가 있다면 여기를 참고하세요.
광고 지면 추가
2. Native
연동하기
인앱 디자인과 자연스럽게 어우러지도록 광고를 노출시키고자 하는 경우 Native 타입으로 연동할 수 있습니다.
Banner 타입의 광고 역시 Native 타입이며, 베너형 디자인 가이드에 따라 구현해주십시오.
샘플앱 코드
github 셈플코드를 통해, 실제 구현에 사용된 예제를 참고할 수 있습니다.
테마 변경 (Optional)
아래와 같이 앱 Theme 변경을 통해 자신의 브랜드를 나타낼 수 있는 색상과 아이콘을 적용 할 수 있습니다. 자세한 사항은 LINK 를 참고 하세요.
