Abstract: SDK 연동이란?

광고주 모바일 앱에 SDK를 설치해 연동에 필요한 함수를 사용하는 방식입니다.

  • 안드로이드용 SDK만 지원하고 있습니다 (iOS 앱의 경우

MMP 연동 사용 가능)

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

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

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

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

이름

코드

설명

1

초기화
함수

BATracker.init(Context context, String appId)

BATracker.cpeCompleted 또는BATracker.actionCompleted 함수를 호출하기 전에 반드시 BATracker.init를 호출해야 합니다.

  • CPE/CPA 공통

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

  • 단말기의 광고 식별자 수집 후 저장

2

실행 완료
함수

BATracker.cpeCompleted(Context context)

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

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

  • CPE 전용

  • 앱 실행 시 호출

  • 광고식별자등의 정보를 포함한 전환 포스트백(http request)를 버즈빌 서버로 송신

3

액션 완료
함수

BATracker.cpaCompleted(Context context)

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

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

  • CPA 전용

  • 전환 기준이 되는 액션 완료 시 호출

  • 광고식별자등의 정보를 포함한 전환 포스트백(http request)를 버즈빌 서버로 송신

Process: SDK 연동 방법

다음 요건이 충족되면 연동이 완료됩니다!

STEP 1. 준비

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:17.1.0'
}

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

    2. [주의] com.google.android.gms:play-services-ads-identifier:17.1.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 를 확인해 주세요.

재설치의 경우를 제외하고 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 를 확인해 주세요.

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

STEP 4. 연동 테스트 진행

SDK 연동을 진행한 버전을 스토어에 배포하기 전이라면, 별도 APK 파일로 추출해 테스트를 진행해주세요

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

FAQ

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

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