适用于 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/<application> 标签上方的 AndroidManifest.xml 中:
    <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(分析)来衡量用户互动并回答关于游戏使用的问题。

资源