Unity 플러그인 연동가이드

1. 플러그인 설치 (AOS/IOS 공통 설정)

1.1 유니티 패키지 다운로드

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

1.2 패키지 임포트

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

2. Android 설정

2.1 AuthorizationKey 설정

Assets/Plugins/Android/AndroidManifest.xml 파일에 제공받은 App Analytics Key 정보를 추가해 주세요.
1
<!-- Wisetracker Key -->
2
<meta-data
3
android:name="useMode"
4
android:value="1"/>
5
<meta-data
6
android:name="serviceNumber"
7
android:value="103"/>
8
<meta-data
9
android:name="expireDate"
10
android:value="14"/>
11
<meta-data
12
android:name="isDebug"
13
android:value="true"/>
14
<meta-data
15
android:name="isInstallRetention"
16
android:value="true"/>
17
<meta-data
18
android:name="isFingerPrint"
19
android:value="true"/>
20
<meta-data
21
android:name="accessToken"
22
android:value="access_token"/>
Copied!

2.2 유입 경로 분석

2.2.1 딥링크 분석

딥링크를 통해 앱이 실행되는 경로 분석이 필요한 경우 적용해 주세요.
딥링크 설정
Assets/Plugins/Android/AndroidManifest.xml 파일에서 앱의 환경에 맞춰 android:host, android:scheme 값을 변경해 주세요.
1
<!-- 예시는 wisetracker://wisetracker.co.kr 링크로 진입시 딥링크 분석이 가능 -->
2
<activity android:name="com.sdk.wisetracker.unity.UnityDeepLink"
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!

3. iOS 설정

3.1 CouchbaseLite.framework 추가

당사가 제공한 pacakge파일을 설치하고 Unity에서 iOS로 빌드시 CouchbaseLite.framework를 제외한 아래와 같은 경로 구조를 확인할 수 있습니다.
Plugins - iOS 폴더 하위에 제공한 CouchbaseLite.framework 파일을 추가해주세요.
Targets - General - Frameworkd, Libraries, and embedded Content 메뉴에 Embed & Sign옵션으로 추가합니다.

3.2 Other Linker Flag -ObjC 옵션 추가

Tagets - Build Settings - Other Linker Flags-ObjC 옵션을 추가합니다.

3.3 info.plist 세팅

info.plist 파일을 Open As Source Code 방식으로 오픈한 후, 아래 코드를 추가합니다.
1
<key>dotAuthorizationKey</key>
2
<dict>
3
<key>serviceNumber</key>
4
<string>xxxxx</string>
5
<key>expireDate</key>
6
<string>14</string>
7
<key>isDebug</key>
8
<string>true</string>
9
<key>isInstallRetention</key>
10
<string>true</string>
11
<key>isFingerPrint</key>
12
<string>true</string>
13
<key>accessToken</key>
14
<string></string>
15
<key>useMode</key>
16
<string>2</string>
17
</dict>
Copied!
추가한 코드 중 serviceNumber의 value를 올바른 값으로 변경해야 합니다. 와이즈트래커에 로그인하여 화면 상단의 Service 부분을 선택하면 앱 이름과 함께 올바른 Service Number 가 나타납니다. Service No. 옆의 숫자를 복사하여 serviceNumber의 value로 입력해주세요.
http통신을 허용하기 위해 NSAppTransportSecurity 를 아래와 같이 추가합니다
1
<key>NSAppTransportSecurity</key>
2
<dict>
3
<key>NSAllowsArbitraryLoads</key>
4
<true/>
5
</dict>
Copied!

4. 기본 설정

4.1 초기화

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