Unity용 Google 애널리틱스 플러그인 - 개발자 가이드

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

시작하기 전에

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

게임에서 데이터를 전송할 Google 애널리틱스 속성과 보기 (프로필)가 1개 이상 있어야 합니다.
Unity용 Google 애널리틱스 플러그인 저장소에서 적절한 Unity 패키지를 다운로드하여 Unity 프로젝트로 가져옵니다. 파일을 더블클릭하면 됩니다.
- 비트코드가 지원되는 경우: GoogleAnalyticsV4_bitcode.unitypackage
- 비트코드가 지원되지 않음: GoogleAnalyticsV4.unitypackage

설정 및 구성

구성 세부정보에 사용할 플랫폼을 선택하세요.

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.android.gms.analytics.CampaignTrackingService" />
<receiver android:name="com.google.android.gms.analytics.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 파일에서 안전하게 삭제할 수 있습니다.

GAv4 프리패브 구성

GAv4 프리패브를 구성하는 방법은 다음과 같습니다.

Project View의 Assets/Plugins/GoogleAnalyticsV4에 있는 GAv4.prefab prefab 객체를 클릭합니다. 게임 계층 구조로 드래그하세요.
Inspector 뷰에 나열된 여러 속성과 함께 prefab에 연결된 스크립트 구성요소가 표시됩니다. 이러한 속성을 프로젝트에 맞는 올바른 값으로 채웁니다. 이렇게 하면 객체가 채워져 프로젝트의 모든 위치에서 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- Android Tracking Code: UA-XXXXXXX-1
- iOS Tracking Code: UA-XXXXXXX-2
- Other Tracking Code: UA-XXXXXXX-3
- Product Name: MyGame
- Bundle Identifier: com.example.games
- Bundle Version: 1.0
- Dispatch Period: 5
- Sample Frequency: 100
- Log Level: VERBOSE
- Anonymize IP: false
- Uncaught Exception Reporting: false
- Send Launch Event: false
- Session Timeout: 1800
- Dry Run: false
- Advertiser Id Support - Send IDFA/AdID: false

객체 추적

GAv4 프리패브를 구성한 후 Google 애널리틱스로 객체를 추적하려면 다음 단계를 따르세요.

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

다음 단계

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

Unity용 Google 애널리틱스 플러그인 - 개발자 가이드

시작하기 전에

설정 및 구성

GAv4 프리패브 구성

객체 추적

다음 단계

자료