(ver 2.29.x) 2. 시작하기

목차

기본 요건

  • 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

설명

비고

ID

설명

비고

App ID

앱별 고유 식별자

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

Unit ID

광고 지면별 고유 식별자

 

포인트 적립 서버 연동

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

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

광고 포인트 지급 여부

자체 포인트 시스템 여부

설명

광고 포인트 지급 여부

자체 포인트 시스템 여부

설명

지급하지 않음

-

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

지급을 원함

없음

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

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

있음

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

 

 

SDK 설치

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

// 프로젝트 레벨의 build.gradle allprojects { repositories { ...생략... // 버즈빌 저장소 maven { url "https://dl.buzzvil.com/public/maven" } ...생략... } }
// 모듈 레벨의 build.gradle dependencies { ...생략... // BuzzAd SDK implementation ("com.buzzvil:buzzad-benefit:2.29.+") ...생략... }

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

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

 

SDK 초기화

APP ID 추가

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

<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을 초기화합니다.

 

사용자 프로필 설정

사용자 프로필은 광고 할당 요청 전에 등록해야 합니다. 필수 정보를 등록하지 않으면 광고 할당이 되지 않습니다. 권장 정보를 제외할 경우에는 유저 정보 기반의 광고가 할당에서 제외됩니다.

유저 프로필

설명

비고

유저 프로필

설명

비고

필수 userId

사용자 고유 식별자

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

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

권장 gender

사용자의 성별

  • 남성: UserProfile.Gender.MALE

  • 여성: UserProfile.Gender.FEMALE

권장 birthYear

사용자의 출생연도

-

이후 광고 할당에 문제가 있다면 광고 할당 trouble shooting을 참고하시기 바랍니다.

샘플앱 코드

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


자주 하는 질문

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

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

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

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

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

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

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

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

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

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


광고 지면 추가

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

Feed

Feed 연동하기

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

Native

Native 연동하기

커스텀 광고 지면입니다.

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

Interstitial

Interstitial 연동하기

전면 광고 지면입니다.