[광고주] CPE/CPA (App - SDK 연동)

Owned by Jen Yoon (Unlicensed)
Last updated: Jul 02, 2024 by Toy Yu
3 min read

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)

  • CPA 전용

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

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

 

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: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 를 확인해 주세요.

 

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

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

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

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

STEP 4. 연동 테스트 진행

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

FAQ