QTracker V2 Integration Guide - adbcsdk/QTracker GitHub Wiki
- 앱 등록 방법이 변경되었습니다.
- 어뷰징에 대한 방어기능이 강화되었습니다.
- open 이벤트가 자동으로 등록되도록 변경되었습니다.
- 사용하는 외부 라이브러리가 변경되었습니다.
- init 함수에서 SDK 연동 여부를 점검하는 listener 가 추가되었습니다. ( optional )
( QTracker 1.x 버전과 'ADBCTrackerAppKey'가 호환되지 않습니다.
1.x 버전을 사용중인 매체에서는 ADBC 홈페이지를 통해 새로 앱을 등록해주셔야 하며, 등록 시 앱키가 변경됩니다. )
ADBC 홈페이지 에서 App Key 를 발급받을 수 있습니다.
- ADBC 홈페이지 로그인 후 앱 등록
- 앱이름, 패키지명 및 앱 서명 키 지문 등록
앱 서명 키 지문에 대해서는 아래 항목을 확인해주세요.
( 디버그 키와 과 배포 키가 다를 수 있으므로 사용하시는 키에 대한 지문을 모두 등록해주세요 )
2.0 버전부터는 앱의 유효성 검증을 위해 앱 서명 키 SHA-256 인증서 지문 등록이 필요합니다.
내부 유효성 검증을 위해 반드시 'SHA-256' 지문으로 등록해주셔야 합니다.
플레이콘솔 > 앱 선택 > 앱 무결성 > 앱 서명 항목으로 이동하시면 인증서 지문을 확인하실 수 있습니다.
-
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 파일에 아래의 내용을 추가합니다.
(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'
}
-dontwarn com.adbc.tracker.** -keep class com.adbc.tracker.** { *; }
안드로이드 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>
앱 실행 시 아래의 코드를 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");