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