이 문서에서는 Unity용 Google 애널리틱스 플러그인 사용에 관한 중요한 개념을 설명합니다.
시작하기 전에
시작하기 전에 다음 항목을 완료했는지 확인하세요.
- 게임에서 데이터를 전송할 Google 애널리틱스 속성과 보기 (프로필)가 1개 이상 있어야 합니다.
- Unity용 Google 애널리틱스 플러그인 저장소에서
적절한 Unity 패키지를 다운로드하여 Unity 프로젝트로 가져옵니다.
파일을 더블클릭하면 됩니다.
- 비트코드가 지원되는 경우:
GoogleAnalyticsV4_bitcode.unitypackage
- 비트코드가 지원되지 않음:
GoogleAnalyticsV4.unitypackage
- 비트코드가 지원되는 경우:
설정 및 구성
구성 세부정보에 사용할 플랫폼을 선택하세요.
- 프로젝트의 <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>
-
다음 라이브러리를 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 디렉터리에 복사합니다. 이제 라이브러리가 빌드 중에 자동으로 추가됩니다.
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 객체를 필드로 드래그합니다.
- 이제 GameObject를 추적할 준비가 되었습니다. 동일한 프리패브를 사용하여 추적하려는 다른 객체에 대해 이 과정을 반복합니다.
다음 단계
- API 참조를 검토하여 Google 애널리틱스로 전송할 수 있는 조회의 종류를 알아보세요.
- 모바일 앱 구현 가이드에서 Google 애널리틱스를 사용하여 사용자 상호작용을 측정하고 게임 사용에 대한 질문에 답하는 방법을 알아보세요.