Unity v3용 Google 애널리틱스 플러그인 (기존) - 개발자 가이드

이 문서에서는 Unity용 Google 애널리틱스 플러그인 사용에 관한 중요한 개념을 설명합니다.

시작하기 전에

시작하기 전에 다음 항목을 완료했는지 확인하세요.

게임에서 데이터를 전송할 Google 애널리틱스 속성과 보기 (프로필)가 하나 이상 있어야 합니다.
전자상거래를 추적하려면 보고서에서 전자상거래를 사용 설정하세요.
Unity용 Google 애널리틱스 플러그인 저장소에서 LINKv3.unitypackage를 다운로드하여 Unity 프로젝트로 가져옵니다. 파일을 더블클릭하면 됩니다.

설정 및 구성

구성 세부정보를 확인할 플랫폼을 선택하세요.

Android

프로젝트의 <YOUR PROJECT ROOT>/Assets/Plugins/Android/ 디렉터리에 AndroidManifest.xml이라는 파일이 아직 없다면 Android용 프로젝트를 빌드하고 Temp/StagingArea/ 디렉터리 (빌드할 디렉터리 아래에 위치)에서 AndroidManifest.xml을 복사합니다. <YOUR PROJECT ROOT>/Assets/Plugins/Android/에 붙여넣습니다.

<YOUR PROJECT ROOT> /Assets/Plugins/Android/의 <application> 태그 위 AndroidManifest.xml에 다음 권한을 추가합니다.

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

캠페인 추적을 사용 설정하려면 다음과 같이 서비스를 추가하세요.

<service android:name="com.google.analytics.tracking.android.CampaignTrackingService" />
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver"
          android:exported="true" >
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

iOS

다음 라이브러리를 Xcode 프로젝트에 추가합니다.
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
iOS용으로 빌드할 때 라이브러리가 자동으로 추가되도록 하려면 iOS Extras 디렉터리에서 PostProcessBuildPlayer_GA 파일을 복사하여 <YOUR PROJECT ROOT>/Assets/Editor 디렉터리에 넣습니다.
mod_pbxproj.py 스크립트를 다운로드하여 Editor 디렉터리에 복사합니다. 이제 라이브러리가 빌드 중에 자동으로 추가됩니다.

참고: libsqlite3.dylib는 Xcode에서 -ObjC 링커 플래그를 사용하는 경우에만 필요하며 이 플래그를 사용하지 않으면 PostProcessBuildPlayer_GA 파일에서 안전하게 삭제할 수 있습니다.

GAv3 프리패브 구성

GAv3 프리패브를 구성하려면 다음 단계가 필요합니다.

Project View의 Assets/Plugins/GoogleAnalyticsV3에서 찾을 수 있는 GAv3.prefab prefab 객체를 클릭합니다.
Inspector 뷰에는 여러 속성이 나열된 것과 함께 prefab에 연결된 스크립트 구성요소가 표시됩니다. 이러한 속성을 프로젝트에 적합한 값으로 채웁니다. 그러면 객체가 채워져 프로젝트의 모든 위치에서 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- Android Property ID: UA-XXXXXXX-1
- iOS Property ID: UA-XXXXXXX-2
- Other Property ID: UA-XXXXXXX-3
- App Name: MyGame
- Bundle ID: com.example.games
- App Version: 1.0
- Dispatch Period: 5
- Sample Frequency: 100
- Debug Mode: VERBOSE
- Anonymize IP: false
- Dry Run: false
채워진 GAv3를 Project 뷰에서 객체 계층 구조로 드래그합니다.

객체 추적

GAv3 프리패브를 구성한 후에는 다음 단계를 따라 Google 애널리틱스를 사용하여 객체 추적을 시작할 수 있습니다.

추적할 GameObject (예: Player 객체)를 식별하고 Object Hierarchy 뷰에서 클릭합니다. 추적하려는 객체에 아직 첨부된 스크립트가 없다면 Inspector view의 Add Component 버튼을 사용하여 새 스크립트를 만듭니다.
클래스에 GoogleAnalyticsV3 객체를 보유할 공개 변수를 만듭니다. 예를 들면 다음과 같습니다.
```
public GoogleAnalyticsV3 googleAnalytics;
```
스크립트를 저장하고 Unity 창으로 돌아갑니다.
추적하려는 GameObject의 Inspector 뷰에 생성한 스크립트와 Google 애널리틱스라는 필드 (또는 선택한 변수 이름)가 표시됩니다. 객체 계층 구조 뷰에서 GAv3 객체를 필드로 드래그합니다.
GAv3 prefab을 추가할 필드가 표시되지 않으면 스크립트에 컴파일 오류가 없는지 확인합니다. 기존 오류가 있는 경우 Inspector(검사기)가 업데이트되지 않습니다.
이제 GameObject를 추적할 준비가 되었습니다. 동일한 프리패브를 사용하여 추적하려는 다른 객체에 대해 이 과정을 반복합니다.

다음 단계

API 참조를 검토하여 Google 애널리틱스로 전송할 수 있는 조회의 종류를 알아보세요.
모바일 앱 구현 가이드에서 Google 애널리틱스를 사용하여 사용자 상호작용을 측정하고 게임 사용 관련 질문에 답하는 방법을 알아보세요.

Unity v3용 Google 애널리틱스 플러그인 (기존) - 개발자 가이드

시작하기 전에

설정 및 구성

GAv3 프리패브 구성

객체 추적

다음 단계

자료