Home > V2 > Docs > Sdk > Unity > Unity-install-guide

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 정보를 추가해 주세요.

Copy
XML
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"/>

2.2 유입 경로 분석

2.2.1 딥링크 분석

딥링크를 통해 앱이 실행되는 경로 분석이 필요한 경우 적용해 주세요.

딥링크 설정

Assets/Plugins/Android/AndroidManifest.xml 파일에서 앱의 환경에 맞춰 android:host, android:scheme 값을 변경해 주세요.

Copy
XML
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>

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 방식으로 오픈한 후, 아래 코드를 추가합니다.

Copy
XML
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>

추가한 코드 중 serviceNumber의 value를 올바른 값으로 변경해야 합니다. 와이즈트래커에 로그인하여 화면 상단의 Service 부분을 선택하면 앱 이름과 함께 올바른 Service Number 가 나타납니다. Service No. 옆의 숫자를 복사하여 serviceNumber의 value로 입력해주세요.

authKey

http통신을 허용하기 위해 NSAppTransportSecurity 를 아래와 같이 추가합니다

Copy
XML
1<key>NSAppTransportSecurity</key>
2<dict>
3 <key>NSAllowsArbitraryLoads</key>
4 <true/>
5</dict>

4. 기본 설정

4.1 초기화

앱 시작시 아래와 같이 초기화 코드를 삽입합니다. 초기화 시 아래와 같은 기본 분석이 가능합니다.

  • 앱 실행 및 방문수, 일/주/월순수방문수 등 방문과 관련된 지표
  • 통신사, 단말기, 국가 등 방문자의 단말기 환경으로 부터 추출될 수 있는 지표
Copy
CSHARP
1void Awake()
2{
3 DOT.initialization();
4
5}
Table of Contents

© 2020 Wisetracker 주식회사 와이즈트래커
대표이사: 김선준 | 서울시 강남구 테헤란로 415, 스파크플러스 2층 | 02-6925-6636 | contact@wisetracker.co.kr | 사업자등록번호: 261-81-22632 | 통신판매업신고: 2015-서울강남-02766