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 56 Next »

기본 요건

  • 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: 광고 지면마다 하나씩 부여되는 아이디

  • 포인트 적립 요청을 받을 수 있는 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.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);

유저 ID와 타게팅 정보 (성별, 출생년도)는 광고 할당 및 원활한 서비스 운영을 위해 제공해야 할 필수 항목입니다.

타게팅 정보(성별/출생연도)을 제공할 수 없는 경우라면 버즈빌 담당자에게 문의바랍니다.

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

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

광고 지면 추가

1. Feed

연동하기

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

2. Native

연동하기

커스텀 광고 지면입니다.

배너 타입의 광고도 Native 지면으로 연동할 수 있습니다. 배너형 디자인 가이드을 참고해주십시오.

3. Interstitial

연동하기

전면 광고 지면 입니다.

샘플앱 코드

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

테마 변경 (Optional)

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


  • No labels