[광고주] CPE/CPA (App - SDK 연동)
Abstract: SDK 연동이란?
광고주 모바일 앱에 SDK를 설치해 연동에 필요한 함수를 사용하는 방식입니다.
안드로이드용 SDK만 지원하고 있습니다 (iOS 앱의 경우 MMP 연동 사용 가능)
SDK 연동에서 주요 시점은 다음 2가지 입니다.
앱 실행
: 사용자가 앱을 실행한 시점전환 행위 완료
: 사용자가 앱에서 필요한 전환 행위를 완료한 시점
SDK 연동에서 사용되는 주요 함수는 다음 3가지 입니다.
이름 | 코드 | 설명 | |
---|---|---|---|
1 | 초기화 |
|
|
2 | 실행 완료 |
본 메소드 호출 시 Logcat (태그:buzzad-analytics) 에서 재설치의 경우를 제외하고 |
|
3 | 액션 완료 |
본 메소드 호출 시 Logcat (태그:buzzad-analytics) 에서 재설치의 경우를 제외하고 |
|
Process: SDK 연동 방법
다음 요건이 충족되면 연동이 완료됩니다!
STEP 1. 준비
API Level 16 이상
인지 확인해 주세요버즈빌 연동ID
를 발급 받아 주세요STEP 2. SDK 설치
SDK 다운로드 및 압축 해제한 뒤, 압축 해제한 폴더 내
buzzad-android-sdk-advertiser-1.1.0.jar
파일을 프로젝트(ex. libs 폴더) 안에 추가해 주세요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:17.1.0' }
[참고] “구글 플레이 서비스 라이브러리 설정 가이드”를 참고해 주세요.
[주의]
com.google.android.gms:play-services-ads-identifier:17.1.0
이상으로 설정해 주세요.
AndroidManifest.xml
에 아래와 같이 권한을 추가해 주세요. (이미 있는 경우 생략)<manifest> ... <!-- Permission for BuzzAd--> <uses-permission android:name="android.permission.INTERNET" /> </manifest>
STEP 3. 함수 호출용 스크립트 추가
해당 캠페인 유형에 따라 적절한 함수를 호출해 주세요.
a) CPE 캠페인
앱 실행 후, 첫번째로 호출되는 액티비티 생성 시점에 아래와 같이 두 개의 함수를 호출해 주세요
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ... // event_source_id : 담당자에게 발급받은 버즈빌 연동 ID BATracker.init(this, "event_source_id"); BATracker.cpeCompleted(this); }
BATracker.cpeCompleted
메소드 호출 시 Logcat (태그:buzzad-analytics) 에서api call success
를 확인해 주세요.
재설치의 경우를 제외하고 api call success
는 한번만 확인 가능합니다.
b) CPA 캠페인 (ex. 회원가입, 튜토리얼 완수 등)
앱 실행 후, 첫번째로 호출되는 액티비티 생성 시점에
BATracker.init
를 호출해 주세요@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ... // event_source_id : 담당자에게 발급받은 버즈빌 연동 ID BATracker.init(this, "event_source_id"); }
전환 행위 완료 시점에
BATracker.cpaCompleted
를 호출해 주세요void onAction() { ... // 전환 행위 완료시 호출! BATracker.cpaCompleted(this); }
BATracker.cpaCompleted
메소드 호출 시 Logcat (태그:buzzad-analytics) 에서api call success
를 확인해 주세요.
재설치의 경우를 제외하고 api call success
는 한번만 확인 가능합니다.
STEP 4. 연동 테스트 진행
SDK 연동을 진행한 버전을 스토어에 배포하기 전이라면, 별도 APK 파일로 추출해 테스트를 진행해주세요
테스트 도구를 사용해 연동 테스트를 진행해주세요.
FAQ
연동 과정에서 기술적인 문제가 발생하는 경우 기술 지원팀으로 문의주시기 바랍니다.
버즈빌 기술지원팀: csm@buzzvil.com