Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 46 Next »

기본 요건

  • minSdkVersion Android 4.1 (API level 16) 이상

  • Android Studio 3.2 이상

  • compileSdkVersion 29 이상

  • Android X

준비 사항

BuzzAdBenefit SDK를 연동하기 전, 아래 사항을 먼저 준비해야 합니다.

  • App ID: 앱 마다 하나씩 부여되는 고유의 아이디

  • Unit ID: 광고 지면마다 하나씩 부여되는 아이디

  • 포인트 적립 요청을 받을 수 있는 API 서버 - 매체사 포인트 적립 포스트백 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.19.+")

    ...(생략)...
}

오프라인 빌드가 필요한 경우 버즈빌 매니저에게 알려주세요.

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

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>
        ...(생략)...
        <!-- Caution: Replace `000000000000` with Your App ID  -->
        <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);

유저가 앱에서 로그아웃하는 시점에 UserProfile 설정값을 지워 유저의 사용 정보를 삭제합니다.

BuzzAdBenefit.setUserProfile(null);

User ID와 타게팅 정보 (성별, 출생년도)는 광고 할당 및 원활한 서비스 운영을 위해 제공해야 할 필수 항목입니다. 타게팅 정보(성별/출생연도)을 제공할 수 없는 경우라면 버즈빌 담당자에게 문의바랍니다.

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

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

광고 지면 추가

1. Feed

연동하기

버튼 등 별도의 진입 경로를 통해 광고 목록을 노출시키고자 하는 경우

push 를 통해 지면 윕

2. Native

연동하기

인앱 디자인과 자연스럽게 어우러지도록 광고를 노출시키고자 하는 경우 Native 타입으로 연동할 수 있습니다.


Banner 타입의 광고 역시 Native 타입이며, 베너형 디자인 가이드에 따라 구현해주십시오.

3. Interstitial

연동하기

버즈빌이 사전에 만들어 놓은 레이아웃을 활용하여 Dialog 또는 BottomSheet 형태로 전면 광고를 노출하고자 하는 경우 윕

샘플앱 코드

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

테마 변경 (Optional)

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


  • No labels