QTracker V2 Integration Guide - adbcsdk/QTracker GitHub Wiki

QTracker v2 변경사항

  • 앱 등록 방법이 변경되었습니다.
  • 어뷰징에 대한 방어기능이 강화되었습니다.
  • open 이벤트가 자동으로 등록되도록 변경되었습니다.
  • 사용하는 외부 라이브러리가 변경되었습니다.
  • init 함수에서 SDK 연동 여부를 점검하는 listener 가 추가되었습니다. ( optional )

    ( QTracker 1.x 버전과 'ADBCTrackerAppKey'가 호환되지 않습니다.
    1.x 버전을 사용중인 매체에서는 ADBC 홈페이지를 통해 새로 앱을 등록해주셔야 하며, 등록 시 앱키가 변경됩니다. )

App Key 발급

ADBC 홈페이지 에서 App Key 를 발급받을 수 있습니다.

  1. ADBC 홈페이지 로그인 후 앱 등록
  1. 앱이름, 패키지명 및 앱 서명 키 지문 등록
    앱 서명 키 지문에 대해서는 아래 항목을 확인해주세요.
    ( 디버그 키와 과 배포 키가 다를 수 있으므로 사용하시는 키에 대한 지문을 모두 등록해주세요 )

앱 서명 키 지문 등록

2.0 버전부터는 앱의 유효성 검증을 위해 앱 서명 키 SHA-256 인증서 지문 등록이 필요합니다.
내부 유효성 검증을 위해 반드시 'SHA-256' 지문으로 등록해주셔야 합니다.

1. 구글 플레이에 앱 서명 키가 등록된 경우

플레이콘솔 > 앱 선택 > 앱 무결성 > 앱 서명 항목으로 이동하시면 인증서 지문을 확인하실 수 있습니다.

2. 앱 서명 키가 등록되지 않은 경우

  • debug.keystore
    keytool -v -list -alias androiddebugkey -keystore debug.keystore -storepass android -keypass android

  • release keystore
    keytool -v -list -alias {release key alias} -keystore {release key path / key}
    명령어를 입력하면 아래와 같이 패스워드를 입력하는 프롬프트가 출력됩니다.
    Enter keystore password :

build.gradle 설정

build.gradle 파일에 아래의 내용을 추가합니다.

(Project script)

allprojects {
    repositories {
        ...
        maven {
            url "https://nexus.adbc.io/repository/QTracker/"
            // https 보안관련 에러가 발생하면 아래의 코드를 추가해주세요
            // allowInsecureProtocol true
        }
    }
}

(Module script)

dependencies {
    ...
    implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.6.0'
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.1"
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
    implementation 'com.android.installreferrer:installreferrer:2.2'

    implementation 'com.adbc.tracker:qtracker:2.2@aar'
}

Proguard 설정

-dontwarn com.adbc.tracker.** 
-keep class com.adbc.tracker.** { *; }

AndroidManifest.xml 설정

안드로이드 12버전 이상에서 ADID 수집을 위하여 "com.google.android.gms.permission.AD_ID" 퍼미션을 추가해주세요

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
<application>
    ...
    <meta-data
    android:name="ADBCTrackerAppKey"
    android:value="발급받은 코드" />
    ...
</application>

Tracker 사용법

Tracker 초기화

앱 실행 시 아래의 코드를 1회 호출하여 SDK 를 초기화합니다.

@ Params
- Context context
- ADBCTracker.InitListener listener (SDK 연동여부 검사 결과 수신 listener)
  onResult(boolean result, String msg) 연동여부, 연동오류 시 메시지
ADBCTracker.init(context);
//optional
ADBCTracker.init(context, listener);

구매 이벤트

구매 완료 시점에 아래의 코드를 호출하여 이벤트를 기록합니다.

@ Params
- Context context
- int amount (수량)
- int price (금액)
- String productId (상품코드)
ADBCTracker.sendPurchase(context, 1, 1000, "item001");

커스텀 이벤트

트래킹 하고자 하는 시점에 아래의 코드를 호출하여 이벤트를 기록합니다.

@ Params
- Context context
- String eventName (임의의 이벤트명)
ADBCTracker.sendEvent(context, "event");

전환 이벤트

큐트래커는 기본적으로 광고참여를 통한 앱 설치를 전환으로 체크하고 있습니다.
설치가 아닌 별도의 이벤트를 전환으로 체크하고자 하시는 경우 아래의 코드를 호출하여 이벤트를 기록합니다.
(전환으로 체크하실 이벤트명을 미리 공유해주셔야 합니다.)

@ Params
- Context context
- String eventName (임의의 이벤트명)
- String uid (전환 검증을 위한 uid)
ADBCTracker.sendConversion(context, "event", "uid");
⚠️ **GitHub.com Fallback** ⚠️