Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

목차

Table of Contents
minLevel1
maxLevel1
exclude목차

기본 요건

  • minSdkVersion Android 4.1 (API level 16) 이상

  • Android Studio 3.2 이상

  • Gradle 4.0.1 이상

  • compileSdkVersion 29 이상

  • Android X

준비 사항

BuzzAd Android SDK를 연동하기 위해서 아래 사항을 준비해야 합니다.

ID

설명

비고

App ID

앱별 고유 식별자

발급이 필요한 경우는 버즈빌 담당자에게 문의 바랍니다.

Unit ID

광고 지면별 고유 식별자

포인트 적립 서버 연동

버즈빌 광고는 참여 시 포인트를 지급하는 보상형 광고와 지급하지 않는 비보상형 광고가 있습니다.

사용자가 보상형 광고에 참여하면 포인트 적립 요청을 처리할 수 있는 서버가 필요할 수 있습니다. 연동하는 방식에 따라 차이가 있으니, 아래 표를 확인하여 진행하시기 바랍니다.

광고 포인트 지급 여부

자체 포인트 시스템 여부

설명

지급하지 않음

-

비보상형 광고로 연동합니다.
서버 간 연동은 불필요합니다.

지급을 원함

없음

네이버페이 포인트 등 제3의 포인트 시스템을 이용하여 포인트를 부여할 수 있습니다.

버즈빌 담당자에게 문의하시기 바랍니다.

있음

포스트백 연동 가이드을 참고하여 서버간 연동 진행할 수 있습니다.

SDK 설치

버즈빌 SDK 연동을 위해 build.gradle 에 라이브러리를 추가해야합니다.

Code Block
languagebash
// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        ...생략...

        // 버즈빌 저장소 추가
        maven { url "https://dl.buzzvil.com/public/maven" }
        
        ...생략...
    }
}
Code Block
languagebash
// 모듈 레벨의 build.gradle 

dependencies {
    ...생략...

    // BuzzAd benefit SDK 추가
    implementation ("com.buzzvil:buzzad-benefit:2.25.+")

    ...생략...
}
Info

오프라인 빌드가 필요하시면 버즈빌 매니저에게 문의 바랍니다.
버즈빌 매니저가 SDK 연동에 필요한 라이브러리를 JAR/AAR로 준비해드립니다.

이 단계에서 문제가 발생했다면 빌드 Trouble Shooting를 참고하시기 바랍니다.

SDK 초기화

Table of Contents
minLevel1
maxLevel7
include(APP ID 추가)|(BuzzAdBenefit 초기화)|(사용자 프로필 설정)

APP ID 추가

AndroidManifest.xml에 APP_ID 를 추가합니다. 아래 예시의 app-pub-000000000000 중 숫자 부분(000000000000)을 발급받은 APP_ID로 대체합니다.
예시) 발급받은 APP_ID 가 123456789123 일 경우, android:value="app-pub-123456789123”

Code Block
languagexml
<manifest>
    <application>
    
        <!-- App id 추가 -->
        <meta-data  
          android:name="com.buzzvil.APP_KEY"  
          android:value="app-pub-000000000000" />
        
    </application>
</manifest>

BuzzAdBenefit 초기화

Application의 onCreate에서 BuzzAdBenefit을 초기화합니다.

Code Block
languagejava
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
colourYellow
title필수
정보를 등록하지 않으면 광고 할당이 되지 않습니다.
Status
title권장
정보를 제외할 경우에는 유저 정보 기반의 광고가 할당에서 제외됩니다.

유저 프로필

설명

비고

Status
colourYellow
title필수
userId

사용자 고유 식별자

서비스 도중에 변하지 않는 값

Note

앱 삭제 후 재설치 시 유저 ID 값이 변경되는 등, 고정된 유저 ID를 사용하지 못하는 경우 버즈빌 담당자에게 문의바랍니다.

Status
title권장
gender

사용자의 성별

  • 남성: UserProfile.Gender.MALE

  • 여성: UserProfile.Gender.FEMALE

Status
title권장
birthYear

사용자의 출생연도

-

Code Block
languagejava
// 유저 정보를 등록합니다.
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
minLevel1
maxLevel7
include(BuzzAd Android SDK의 UI 만 다크테마가 적용되어 어색합니다.)|(BuzzAd Android SDK의 UI를 일괄 변경하고 싶습니다.)|(문의하기 버튼을 추가해야하는 이유를 알고 싶습니다.)|(광고를 WebView로 연결하고 싶습니다.)

BuzzAd Android SDK의 UI 만 다크테마가 적용되어 어색합니다.

앱에서 다크테마를 비활성화하는 방법을 참고하여 앱 내 다크테마를 비활성화할 수 있습니다.

BuzzAd Android SDK의 UI를 일괄 변경하고 싶습니다.

→ 테마를 설정하여 SDK 전반의 색상과 아이콘을 변경할 수 있습니다.
자세한 사항은 테마 적용을 참고하여 변경할 수 있습니다.

문의하기 버튼을 추가해야하는 이유를 알고 싶습니다.

→ 액션형 광고를 할당할 경우, 문의하기 기능은 필수입니다.
자세한 사항은 액션형 광고 주의 사항을 참고하시기 바랍니다.

광고를 WebView로 연결하고 싶습니다.

커스텀 런처 설정을 참고하여 연동할 수 있습니다.

동영상 광고 재생 옵션을 변경하고 싶습니다.

동영상 광고 재생 옵션을 참고하시기 바랍니다.


광고 지면 추가

BuzzAd Android SDK 연동을 위한 기본적은 기본적인 설정은 완료하였습니다. 아래 지면별 연동 가이드에 따라 진행하시기 바랍니다.

Feed

Feed 연동하기

리스트 형태의 광고 지면입니다.

Native

Native 연동하기

커스텀 광고 지면입니다.

Info

배너 타입의 광고도 Native 지면으로 연동할 수 있습니다. 지면 크기별 Native 광고 layout 가이드를 참고하시기 바랍니다.

Interstitial

Interstitial 연동하기

전면 광고 지면입니다.