1. 광고주 CPA AOS SDK

Introduction

버즈애드를 통해 광고 (실행형, 액션형) 를 진행하기 위한 버즈애드 광고주 트래킹 라이브러리입니다.

Requirements

항목

내용

항목

내용

1

안드로이드 지원 버전

API Level 16 이상

2

app_id

라이브러리 연동을 위해 필요한 값입니다.

버즈빌 담당자로부터 발급받아 주세요.

 

Installation

  1. SDK 다운로드 후 압축 해제

    • 압축 해제한 폴더 내의 buzzad-android-sdk-advertiser-1.1.0.jar 파일을 프로젝트 내 (예를 들면 libs 폴더 안) 에 추가합니다.

  2. AndroidManifest.xml에 아래와 같이 권한을 추가 (이미 있는 경우 다음 단계로 이동)

    1 2 3 4 5 <manifest> ... <!-- Permission for BuzzAd--> <uses-permission android:name="android.permission.INTERNET" /> </manifest>
  3. 구글 플레이 서비스 라이브러리 를 설정 - 구글 플레이 서비스 라이브러리 설정방법 을 참고하세요.

    1 2 3 dependencies { implementation 'com.google.android.gms:play-services-ads-identifier:15.0.0' }

com.google.android.gms:play-services-ads-identifier:15.0.0 이상으로 설정 부탁드립니다.

Call Methods

항목

코드

호출 위치

항목

코드

호출 위치

1

초기화

BATracker.init(Context context, String appId)

반드시 BATracker.actionCompleted 호출하기 전에 BATracker.init를 호출해야 함

실행형, 액션형 공통

  • 앱 실행 후 처음 호출되는 액티비티의 onCreate에서 호출

2

실행 완료

BATracker.cpeCompleted(Context context)

본 메소드 호출 시 Logcat (태그:buzzad-analytics) 에서 api call success 를 확인해야 합니다.

재설치의 경우를 제외하고 api call success 는 한번만 확인 가능합니다.

  • 앱 실행 시 호출

아래 케이스별 예시 참조

3

액션 완료

BATracker.cpaCompleted(Context context)

본 메소드 호출 시 Logcat (태그:buzzad-analytics) 에서 api call success 를 확인해야 합니다.

재설치의 경우를 제외하고 api call success 는 한번만 확인 가능합니다.

  • 액션 완료 시 호출

아래 케이스별 예시 참조

Use Case 1. 실행형

앱 실행 후 처음 호출되는 액티비티 생성 시점에 아래와 같이 두 개의 함수를 추가합니다.

1 2 3 4 5 6 7 8 9 10 @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ... // app_id : 담당자에게 발급받은 키값 BATracker.init(this, "app_id"); BATracker.cpeCompleted(this); }

Use Case 2. 액션형 (ex. 회원가입, 튜토리얼 완수 등)

  • 앱 실행 시 처음 호출되는 액티비티 생성 시점에 BATracker.init 를 호출하고,

  • 액션완료 시점에 BATracker.cpaCompleted 를 호출합니다.

1) 앱 실행 시

1 2 3 4 5 6 7 8 9 @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ... // app_id : 담당자에게 발급받은 키값 BATracker.init(this, "app_id"); }

2) 액션 완료 시

1 2 3 4 5 6 7 void onAction() { ... // 액션 완료시 호출! BATracker.cpaCompleted(this); }

 

Test & Go Live

위 과정을 통해 연동한 apk 파일을 담당자에게 전해주면 테스트 후에 광고가 진행됩니다.

연동 과정에서 기술적인 문제가 발생하는 경우 기술 지원팀으로 문의주시기 바랍니다.

버즈빌 기술 지원팀: csm@buzzvil.com