Integration Guide For Flutter Android - adbcsdk/QTracker GitHub Wiki

build.gradle 설정

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

(Project script)

allprojects {
    repositories {
        ...
        maven {
            url 'http://repo.adbc.io:8081/repository/QTracker/'
        }
    }
}

(Module script)

android{
    defaultConfig {
        // 최소 sdk 버전 21 이상 지원합니다.
        minSdkVersion 21
    }
}

dependencies {
    ...
    // adid 사용을 위해 필요
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'

    implementation 'com.android.installreferrer:installreferrer:1.1.1'
    implementation 'com.adbc.tracker:qtracker:1.9@aar'
}

프로젝트에 Package,Module 파일 추가

QTrackerForFlutter.zip

  1. 아래의 경로에 QTrackerPlugin.java 파일을 복사합니다.

android/app/src/main/java/com/adbc/qtracker

  1. MainActivity.java 파일을 열어 QTrackerPlugin 을 import 하고, configureFlutterEngine 메서드에 QTrackerPlugin 클래스를 추가해줍니다.
import com.adbc.qtracker.QTrackerPlugin;
...
@Override
public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) {
...
super.configureFlutterEngine(flutterEngine);
flutterEngine.getPlugins().add(new QTrackerPlugin());
GeneratedPluginRegistrant.registerWith(flutterEngine);
...

}
  1. qtracker.dart 파일을 프로젝트로 복사한 후 사용하고자 하는 화면에 import 합니다.
import 'package:flutter_app/qtracker.dart';

Proguard 설정

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

AndroidManifest.xml 설정

안드로이드 12버전 이상에서 ADID 수집을 위하여 아래의 퍼미션을 추가해주세요 (필수)

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

Tracker 사용법

Tracker 초기화

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

QTracker tracker = QTracker();
tracker.init();

앱 실행 및 리텐션

앱 실행 시 아래의 코드를 1회 호출하여 앱의 실행 및 리텐션을 트래킹합니다.

tracker.sendOpen();

커스텀 이벤트

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

tracker.sendEvent("임의의 이벤트명");
⚠️ **GitHub.com Fallback** ⚠️