Abstract: SDK 연동이란?

SDK 연동에서 주요 시점은 다음 2가지 입니다.

1. 앱 실행: 사용자가 앱을 실행한 시점

2. 전환 행위 완료: 사용자가 앱에서 필요한 전환 행위를 완료한 시점

SDK 연동에서 사용되는 주요 함수는 다음 3가지 입니다.

Process: SDK 연동 방법

STEP 1. 준비

• 연동할 앱의 안드로이드 버전이 API Level 16 이상인지 확인해 주세요
• 버즈빌 담당자로부터 버즈빌 연동ID를 발급 받아 주세요

STEP 2. SDK 설치

1. SDK 다운로드 및 압축 해제한 뒤, 압축 해제한 폴더 내 buzzad-android-sdk-advertiser-1.1.0.jar 파일을 프로젝트(ex. libs 폴더) 안에 추가해 주세요

2. app/build.gradle 파일에 다음 내용을 추가해 주세요
   (각기 버즈빌 SDK와 구글 플레이 서비스 라이브러리 관련 내용입니다.)

   dependencies {
       implementation files('libs/buzzad-android-sdk-advertiser-1.1.0.jar')
       implementation 'com.google.android.gms:play-services-ads-identifier:15.0.0'
   }

   1. [참고] “구글 플레이 서비스 라이브러리 설정 가이드”를 참고해 주세요.

   2. [주의] com.google.android.gms:play-services-ads-identifier:15.0.0 이상으로 설정해 주세요.

3. AndroidManifest.xml에 아래와 같이 권한을 추가해 주세요. (이미 있는 경우 생략)

   <manifest>
       ...
       <!-- Permission for BuzzAd-->
       <uses-permission android:name="android.permission.INTERNET" />
   </manifest>

STEP 3. 함수 호출용 스크립트 추가

a) CPE 캠페인

1. 앱 실행 후, 첫번째로 호출되는 액티비티 생성 시점에 아래와 같이 두 개의 함수를 호출해 주세요

   @Override
   protected void onCreate(Bundle savedInstanceState) {
   	super.onCreate(savedInstanceState);
   	
   	...
   	
   	// event_source_id : 담당자에게 발급받은 버즈빌 연동 ID
   	BATracker.init(this, "event_source_id");
   	BATracker.cpeCompleted(this);
   }

2. BATracker.cpeCompleted 메소드 호출 시 Logcat (태그:buzzad-analytics) 에서 api call success 를 확인해 주세요.

b) CPA 캠페인 (ex. 회원가입, 튜토리얼 완수 등)

1. 앱 실행 후, 첫번째로 호출되는 액티비티 생성 시점에 BATracker.init 를 호출해 주세요

   @Override
   protected void onCreate(Bundle savedInstanceState) {
   	super.onCreate(savedInstanceState);
   	
   	...
   	
   	// event_source_id : 담당자에게 발급받은 버즈빌 연동 ID
   	BATracker.init(this, "event_source_id");
   }

2. 전환 행위 완료 시점에 BATracker.cpaCompleted 를 호출해 주세요

   void onAction() {
   	
   	...
   	
   	// 전환 행위 완료시 호출!
   	BATracker.cpaCompleted(this);
   }

3. BATracker.cpaCompleted 메소드 호출 시 Logcat (태그:buzzad-analytics) 에서 api call success 를 확인해 주세요.

STEP 4. 연동 테스트 진행

테스트 도구를 사용해 연동 테스트를 진행해주세요.

FAQ