本文档介绍了与使用适用于 Unity 的 Google Analytics(分析)插件相关的重要概念。
准备工作
开始之前,请确保已完成以下步骤:
- 您应该至少有一个 Google Analytics(分析)媒体资源和一个数据视图(配置文件),以便从游戏向其发送数据。
- 从适用于 Unity 的 Google Analytics(分析)插件代码库下载合适的 Unity 软件包,并将其导入您的 Unity 项目中(您应该能够通过双击该文件来执行此操作)。
设置和配置
选择配置详细信息的平台:
- 如果您的项目在 <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/ 中的 AndroidManifest.xml 中的
<application>
标记上方:<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 预设件,请按以下步骤操作:
- 点击
GAv4.prefab
Prefab 对象(位于 Project View 的 Assets/Plugins/GoogleAnalyticsV4 中)。将该对象拖至游戏层次结构中。 - “Inspector”(检查器)视图将显示附加到预设件的脚本组件,并列出了一些媒体资源。
使用项目的正确值填充这些属性。这将填充该对象,使其可以在项目中的任何位置使用。例如:
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 Analytics(分析)跟踪对象,请按以下步骤操作:
- 确定要跟踪的 GameObject(例如 Player 对象),然后在“Object Hierarchy”(对象层级)视图中点击该对象。如果您要跟踪的对象上尚未附加任何脚本,请使用“Inspector”(检查器)视图中的“Add Component”(添加组件)按钮创建一个新脚本。
- 在类中创建一个公共变量来保存 GoogleAnalyticsV4 对象。例如:
public GoogleAnalyticsV4 googleAnalytics;
- 保存脚本并返回到 Unity 窗口。
- 在您要跟踪的 GameObject 的“检查器”视图中,您会看到自己创建的脚本以及一个名为 Google Analytics(或您所选择的变量名称)且需要填充的字段。将 GAv4 对象从对象层次结构视图中拖到该字段上。
- 现在,您可以开始跟踪该 GameObject。使用同一预制件对您要跟踪的其他对象重复此流程。
后续步骤
- 查看 API参考,了解您可以发送给 Google Analytics(分析)的点击类型。
- 阅读移动应用实现指南,了解如何使用 Google Analytics(分析)来衡量用户互动并回答关于游戏使用的问题。