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

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

시작하기 전에

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

게임에서 데이터를 보낼 Google 애널리틱스 속성과 뷰 (프로필)가 하나 이상 있어야 합니다.
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/에 붙여넣습니다.

<application> 태그 위에 있는 <YOUR PROJECT ROOT> /Assets/Plugins/Android/의 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 prefab 구성

GAv4 prefab을 구성하는 방법은 다음과 같습니다.

Project View의 Assets/Plugins/GoogleAnalyticsV4에서 찾을 수 있는 GAv4.prefab prefab 객체를 클릭합니다. 게임 계층 구조로 드래그합니다.
Inspector 뷰에는 몇 가지 속성이 나열된 prefab에 연결된 Script 구성요소가 표시됩니다. 이러한 속성을 프로젝트에 올바른 값으로 채웁니다. 이렇게 하면 객체가 프로젝트의 모든 곳에서 사용될 수 있도록 채워집니다. 예를 들면 다음과 같습니다.
- 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 prefab을 구성한 후 Google 애널리틱스로 객체를 추적하는 방법은 다음과 같습니다.

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

다음 단계

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

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

시작하기 전에

설정 및 구성

GAv4 prefab 구성

객체 추적

다음 단계

리소스