适用于 Unity 的 Google Analytics(分析)插件 - 开发者指南

本文档介绍了与使用适用于 Unity 的 Google Analytics(分析)插件相关的重要概念。

开始之前

在开始之前,请确保您已完成了以下项目:

设置和配置

选择相应的平台以了解配置详情:

Android
  1. 如果您的项目的 <YOUR PROJECT ROOT>/Assets/Plugins/Android/ 目录下没有名为 AndroidManifest.xml 的文件,请构建一个适用于 Android 的项目,然后从 Temp/StagingArea/ 目录下复制 AndroidManifest.xml(该文件位于您选择在其中构建项目的目录下),然后将其粘贴到 <YOUR PROJECT ROOT>/Assets/Plugins/Android/
  2. 将以下权限添加到 <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" />
          
  3. 如果您要启用广告系列跟踪功能,请按照如下所示添加该服务:
    <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
  1. 将以下库添加到您的 Xcode 项目中:
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. 如果您在构建适用于 iOS 的项目时想让这些库能够自动添加,请复制 iOS Extras 目录下的 PostProcessBuildPlayer_GA 文件,然后将其放到 <YOUR PROJECT ROOT>/Assets/Editor 目录中。
  3. 下载 mod_pbxproj.py 脚本,然后将其复制到 Editor 目录中。现在,这些库就会在您构建项目的过程中自动添加。

配置 GAv4 预设件

要配置 GAv4 预设件,请按以下步骤操作:

  1. 点击 GAv4.prefab 预设件对象(位于“Project”(项目)视图中的 Assets/Plugins/GoogleAnalyticsV4 中)。将该对象拖至游戏层次结构中。
  2. “Inspector”(检视)视图将显示附加到预设件的“Script component”(脚本组件)并列出了一些媒体资源。使用与您的项目对应的值填充这些媒体资源。这将填充该对象,以使其可在您项目中的任何位置使用。例如:
    • 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(分析)跟踪对象,请按以下步骤操作:

  1. 确定要跟踪的 GameObject(例如 Player 对象),然后在“Object Hierarchy”(对象层级)视图中点击该对象。如果您还没有附加到您要跟踪的对象上的脚本,请使用“Inspector”(检视)视图中的“Add Component”(添加组件)按钮创建一个新的脚本。
  2. 在类中创建一个公共变量来保存 GoogleAnalyticsV4 对象。例如:
    public GoogleAnalyticsV4 googleAnalytics;
  3. 保存该脚本,然后返回至 Unity 窗口。
  4. 在您要跟踪的 GameObject“Inspector”(检视)视图中,您会看到自己创建的脚本以及一个名为 Google Analytics(分析)(或您所选择的变量名称)且需要填充的字段。从“Object Hierarchy”(对象层次)视图中将 GAv4 对象拖动到该字段。
  5. 现在,您就可以开始跟踪该 GameObject 了。针对您要跟踪的其他对象使用同一预设件重复此流程。

后续步骤

  • 参阅 API 参考,了解您可以向 Google Analytics(分析)发送哪些类型的匹配。
  • 阅读移动应用实现指南,了解如何使用 Google Analytics(分析)衡量用户互动以及有关游戏使用情况的问题解答。

资源