(ver 2.23.x) 2. 시작하기
기본 요건
minSdkVersion Android 4.1 (API level 16)
이상Android Studio 3.2
이상Gradle 4.0.1
이상compileSdkVersion 29
이상Android X
준비 사항
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 서버 - 연동하기
자체 포인트 시스템을 가지고 있고, 광고를 통한 포인트 적립이 필요한 경우만 해당
Postback(포인트 적립요청) 수신 url 생성 후 버즈빌 담당자에게 전달
자체 포인트 시스템이 없는 경우, 네이버페이 포인트
등을 통해서 포인트 적립을 진행할 수 있습니다. 이 경우 버즈빌 담당자에게 문의 해 주세요.
SDK 설치
버즈빌 SDK 연동을 위해 build.gradle
에 라이브러리를 추가해야합니다.
Step 1. 프로젝트 레벨의 build.gradle
에 버즈빌 저장소를 추가
allprojects {
repositories {
...생략...
// 버즈빌 저장소 추가
maven { url "https://dl.buzzvil.com/public/maven" }
...생략...
}
}
Step 2. 모듈레벨의 build.gradle
에 SDK 를 추가
dependencies {
...생략...
// BuzzAd benefit SDK 추가
implementation ("com.buzzvil:buzzad-benefit:2.23.+") {
// Pop 을 연동하지 않는 경우, 아래 코드를 추가하여 SDK의 용량을 줄일 수 있습니다.
exclude group: 'com.buzzvil', module: 'buzzad-benefit-pop'
}
...생략...
}
오프라인 빌드를 진행하는 경우 버즈빌 매니저에게 알려주세요.
이 단계에서 문제가 발생했다면 여기를 참고해주세요
SDK 초기화
Step 1. APP ID 추가
AndroidManifest.xml에 아래와 같이 APP_ID 를 추가합니다.
아래 예시의 app-pub-000000000000
중 숫자 부분(000000000000
)을 APP_ID 로 대체합니다.
예시) 발급받은 APP_ID 가 123456789123 일 경우, android:value="app-pub-123456789123”
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.buzzvil.packagename">
<application>
...생략...
<meta-data
android:name="com.buzzvil.APP_KEY"
android:value="app-pub-000000000000" />
</application>
</manifest>
Step 2. BuzzAdBenefit 초기화
Application Class의 onCreate
에 아래 코드를 추가합니다.
Step 3. 유저 프로필 설정
광고 할당을 위해 유저의 성별/출생년도를 SDK에 등록해야 합니다. 유저가 앱에 로그인한 시점에 아래와 같이 UserProfile
을 설정합니다.
userId : 서비스 도중에 변하지 않는 유저 고유 식별자
gender
UserProfile.Gender.MALE
: 남성UserProfile.Gender.FEMALE
: 여성
birthYear: 출생년도
유저가 앱에서 로그아웃하는 시점에 등록된 정보를 삭제합니다.
유저 ID와 타게팅 정보 (성별, 출생년도)는 광고 할당 및 원활한 서비스 운영을 위해 제공해야 할 필수 항목입니다.
타게팅 정보(성별/출생연도)을 제공할 수 없는 경우에는 버즈빌 담당자에게 문의바랍니다.
이후 광고 할당에 문제가 있다면 여기를 참고하세요.
광고 지면 추가
샘플앱 코드
github 샘플코드를 통해, 실제 구현에 사용된 예제를 참고할 수 있습니다.
테마 변경
아래와 같이 앱 Theme 변경을 통해 자신의 브랜드를 나타낼 수 있는 색상과 아이콘을 적용 할 수 있습니다. 자세한 사항은 LINK 를 참고 하세요.