목차

요구 사양

• Android 4.1 Jellybean (API 레벨 16) 이상

• Android Studio 3.2 이상

• Gradle 4.0.1 이상

• compileSdkVersion 29 이상

• AndroidX

• JDK 1.8

연동용 ID 발급받기

BuzzAd Android용 SDK를 연동하려면 반드시 연동하려는 앱의 고유 식별자(App ID)와 광고 지면의 고유 식별자(Unit ID)가 필요합니다. ID를 발급 받으려면 버즈빌 담당자에게 연락하세요.

포인트 적립 서버 연동하기

버즈빌이 공급하는 광고는 사용자에게 포인트를 지급하는 보상형 광고와 지급하지 않는 비보상형 광고로 분류됩니다.

비보상형 광고의 경우, 사용자가 광고에 참여해도 별도의 포인트를 지급할 필요가 없으므로 포인트 처리 서버를 연동하지 않아도 됩니다.

보상형 광고의 경우, 사용자가 광고에 참여하면 포인트를 지급해야 하므로 클라이언트의 포인트 적립 요청을 처리할 수 있는 서버가 필요합니다.

자체 서버를 보유한 경우, 포스트백 연동 가이드를 참고해 포인트 처리 서버를 연동하세요.

SDK 설치하기

BuzzAd Android용 SDK를 설치하려면 다음의 절차를 따르세요.

1. 프로젝트 레벨의 build.gradle 파일에 BuzzAd SDK 저장소를 설정하세요.

// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        maven { url "https://dl.buzzvil.com/public/maven" } // 버즈빌 저장소
    }
}

2. 모듈 레벨의 build.gradle 파일에 BuzzAd SDK 라이브러리를 설정하세요.

// 모듈 레벨의 build.gradle 

dependencies {
    implementation ("com.buzzvil:buzzad-benefit:3.1.+") // BuzzAd SDK 라이브러리
}

SDK 초기화하기

BuzzAd Android용 SDK를 설치한 후 App ID, 사용자 프로필 등 필요한 정보를 추가해 SDK 초기화하세요.

App ID 추가하기

AndroidManifest.xml 파일에서 app-pub-000000000000의 000000000000를 버즈빌 담당자로부터 발급받은 App ID로 교체하세요.

<manifest>
    <application>
    
        <!-- BuzzAd SDK App ID -->
        <meta-data  
          android:name="com.buzzvil.APP_KEY"  
          android:value="app-pub-000000000000" />
        
    </application>
</manifest>

앱 충돌 정보 수집 기능 사용하기

버즈빌은 BuzzAd Android용 SDK와 앱의 안정성을 강화하기 위해 Sentry로 SDK에서 발생하는 앱 충돌 정보를 수집합니다. 수집 정보에는 com.buzzvil 패키지 경로가 포함된 함수 호출 스택, SDK 버전, 앱 정보, 고유 식별자를 제외한 기기 정보 등이 포함됩니다. 앱에 이미 Sentry를 연동한 상태에서 자동 초기화 기능을 사용하고 있지 않거나 Sentry를 아예 연동하지 않은 경우에는 별도의 조치를 취하지 않아도 자동으로 앱 충돌 정보 수집 기능이 적용됩니다.

앱에 이미 Sentry를 연동한 상태에서 ContentProvider를 통해 자동 초기화 기능을 사용하고 있는 경우, 다음과 같은 설정이 필요합니다.

AndroidManifest.xml 파일에 tools:node="replace"를 추가하세요.

<manifest>
    <application>
    
        <meta-data
           android:name="io.sentry.dsn"
           android:value="YOUR DSN" //퍼블리셔 DSN
           tools:node="replace" /> 
                  
    </application>
</manifest>

BuzzAd SDK 초기화하기

Application의 onCreate()에서 BuzzAdBenefit.init()을 호출해 BuzzAd Android용 SDK를 초기화하세요.

public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
                
        // BuzzAdBenefit 초기화
        final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context)
            .build();
        BuzzAdBenefit.init(this, buzzAdBenefitConfig);
    }
}

사용자 프로필 등록하기

광고 할당을 요청하려면 사용자 프로필을 등록해야 합니다. 사용자 프로필을 구성하는 항목에 대해서는 아래 표를 참고하세요.

다음은 SDK에 사용자 프로필을 등록하는 예시입니다. 등록한 사용자 프로필은 삭제할 수도 있습니다.

// 사용자 정보를 등록하는 코드입니다.
final UserProfile.Builder builder = new UserProfile.Builder(BuzzAdBenefit.getUserProfile());
final UserProfile userProfile = builder
        .userId("USER_ID")
        .gender(UserProfile.Gender.MALE) //남성 사용자
        .birthYear(YYYY)
        .build();
BuzzAdBenefit.setUserProfile(userProfile);

// SDK에 등록한 사용자 프로필을 삭제하는 코드입니다.
// BuzzAdBenefit.setUserProfile(null);

광고 지면 추가하기

BuzzAd Android용 SDK 연동을 위한 기본 설정이 끝나면, 원하는 유형의 지면을 추가하고 기능, 색상, 아이콘 등을 적용해 구현하세요.

• Feed 지면 추가와 구현, 디자인 커스터마이징에 대한 자세한 내용은 Feed 연동하기를 참고하세요.

• Native 지면 추가와 구현에 대한 자세한 내용은 Native 연동하기를 참고하세요.

• Interstitial 지면 추가와 구현, 디자인 커스터마이징에 대한 자세한 내용은 Interstitial 연동하기를 참고하세요.

샘플 코드

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

자주 하는 질문