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!