Unity Gradle 플러그인 연동가이드

1. 플러그인 설치 (AOS 설정)

1.1 유니티 패키지 다운로드

유니티 플러그인 패키지(RW.gradle.unitypackage)를 다운로드 해주세요. 패키지 다운로드

1.2 패키지 임포트

Unity Tools에서 Assets -> Import Package -> Custom Package 메뉴 선택 -> 다운로드 받은 RW.gradle.unitypackage 파일을 선택해 주세요.

1.3 Gradle Export

Unity 프로젝트에서 Gradle Export 진행해 주세요.

1.4 Android Studio 실행

Export 진행한 Gradle 프로젝트를 Android Studio를 통해 열어 주세요.

1.5 SDK Download

Android 프로젝트 build.gradle(unity_plugin) 파일의 dependencies 블록에 의존성을 추가해 주세요.
1
dependencies {
2
implementation fileTree(dir: 'libs', include: ['*.jar'])
3
....
4
implementation 'com.sdk.wisetracker.base:base_module:1.0.26' // BASE
5
implementation 'com.sdk.wisetracker.new_dot:new_dot_module_test:1.0.26' // DOT
6
}
Copied!

2. Android 설정

AuthorizationKey 설정

프로젝트의 app/res/values/strings.xml 파일에 아래 코드를 추가합니다.
1
<string-array name="dotAuthorizationKey">
2
<item name="useMode">1</item>
3
<item name="serviceNumber">xxxxx</item>
4
<item name="expireDate">14</item>
5
<item name="isDebug">false</item>
6
<item name="isInstallRetention">true</item>
7
<item name="isFingerPrint">true</item>
8
<item name="accessToken"></item>
9
</string-array>
Copied!
추가한 코드 중 serviceNumber의 value를 올바른 값으로 변경해야 합니다. 와이즈트래커에 로그인하여 화면 상단의 Service 부분을 선택하면 앱 이름과 함께 올바른 Service Number 가 나타납니다. Service No. 옆의 숫자를 복사하여 serviceNumber의 value로 입력해주세요.

HTTP 통신 허용

프로젝트의 Target API가 API Level 28 이상일 경우에 적용하는 설정입니다. 아래와 같이 HTTP 통신을 허용하는 두 가지 설정을 추가해주세요.

AndroidManifest.xml 설정

1
<!-- AndroidManifest.xml -->
2
<application
3
android:icon="@mipmap/ic_launcher"
4
android:label="@string/app_name"
5
android:networkSecurityConfig="@xml/network_security_config"
6
android:theme="@style/AppTheme">
Copied!

app/res/xml/network_security_config.xml 설정

1
<?xml version="1.0" encoding="utf-8"?>
2
<network-security-config>
3
<domain-config cleartextTrafficPermitted="true">
4
<domain includeSubdomains="true">trk.analytics.wisetracker.co.kr</domain>
5
</domain-config>
6
</network-security-config>
Copied!

유입 경로 분석

딥링크 분석

AndroidManifest.xml 파일에서 앱의 환경에 맞춰 딥링크로 오픈되는 Activityandroid:host, android:scheme 값을 변경해 주세요.
1
<!-- 예시는 wisetracker://wisetracker.co.kr 링크로 앱 진입 경우 -->
2
<activity android:name="com.sample.DeepLinkActivity"
3
android:launchMode="singleTop" >
4
<intent-filter>
5
<action android:name="android.intent.action.VIEW" />
6
<category android:name="android.intent.category.DEFAULT" />
7
<category android:name="android.intent.category.BROWSABLE" />
8
<!-- 딥링크로 진입될 스키마와 호스트 정보 수정 -->
9
<data android:host="wisetracker.co.kr"
10
android:scheme="wisetracker" />
11
</intent-filter>
12
</activity>
Copied!

2.2.2 딥링크 수신

딥링크가 실행되는 Activity에서 아래와 같은 코드를 적용해 주세요.
1
public class DeepLinkActivity extends Activity {
2
@Override
3
protected void onCreate(@Nullable Bundle savedInstanceState) {
4
super.onCreate(savedInstanceState);
5
/* 중략.. */
6
DOT.setDeepLink(applicationContext, intent)
7
}
8
@Override
9
protected void onNewIntent(Intent intent) {
10
super.onNewIntent(intent);
11
DOT.setDeepLink(applicationContext, intent)
12
}
13
}
Copied!

3. 기본 설정

3.1 초기화

앱 시작시 아래와 같이 초기화 코드를 삽입합니다. 초기화 시 아래와 같은 기본 분석이 가능합니다.
  • 앱 실행 및 방문수, 일/주/월순수방문수 등 방문과 관련된 지표
  • 통신사, 단말기, 국가 등 방문자의 단말기 환경으로 부터 추출될 수 있는 지표
1
void Awake()
2
{
3
4
DOT.initialization();
5
}
Copied!
Last modified 8mo ago