기본 요건

• minSdkVersion Android 4.1 (API level 16) 이상

• Android Studio 3.2 이상

• Gradle 4.x.x 이상

• 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.21.+")

    ...생략...
}

이 단계에서 문제가 발생했다면 여기를 참고해주세요

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에 아래 코드를 추가합니다.

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: 출생년도

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);

유저가 앱에서 로그아웃하는 시점에 등록된 정보를 삭제합니다.

BuzzAdBenefit.setUserProfile(null);

이후 광고 할당에 문제가 있다면 여기를 참고하세요.

광고 지면 추가

샘플앱 코드

github 샘플코드를 통해, 실제 구현에 사용된 예제를 참고할 수 있습니다.

테마 변경 (Optional)

아래와 같이 앱 Theme 변경을 통해 자신의 브랜드를 나타낼 수 있는 색상과 아이콘을 적용 할 수 있습니다. 자세한 사항은 LINK 를 참고 하세요.