适用于 Unity v3 的 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.analytics.tracking.android.CampaignTrackingService" />
    <receiver android:name="com.google.analytics.tracking.android.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 目录中。现在,系统将在构建期间自动添加这些库。

配置 GAv3 预设件

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

  1. 点击 GAv3.prefab 预设件(位于“项目”视图中的 Assets/Plugins/GoogleAnalyticsV3 中)。
  2. “检查器”视图将显示附加到预设件的脚本组件并列出了一些媒体资源。使用项目的正确值填充这些媒体资源。这将填充该对象,以使其可用于您的项目中的任何位置。例如:
    • Android Property ID: UA-XXXXXXX-1
    • iOS Property ID: UA-XXXXXXX-2
    • Other Property ID: UA-XXXXXXX-3
    • App Name: MyGame
    • Bundle ID: com.example.games
    • App Version: 1.0
    • Dispatch Period: 5
    • Sample Frequency: 100
    • Debug Mode: VERBOSE
    • Anonymize IP: false
    • Dry Run: false
  3. 将填充的 GAv3 从“项目”视图向上拖放到对象层次结构

跟踪对象

配置 GAv3 预设件后,您就可以开始使用 Google Analytics(分析)跟踪对象,具体步骤如下:

  1. 确定要跟踪的 GameObject(例如 Player 对象),然后在对象层次结构视图中点击该对象。如果您要跟踪的对象上尚未附加任何脚本,请使用“检查器”视图中的添加组件按钮新建一个脚本。
  2. 在类中创建一个公共变量,以保存 GoogleAnalyticsV3 对象。例如:
    public GoogleAnalyticsV3 googleAnalytics;
  3. 保存脚本并返回到 Unity 窗口。
  4. 在您要跟踪的 GameObject“检查器”视图中,您会看到自己创建的脚本以及一个名为 Google Analytics(或您所选择的变量名称)且需要填充的字段。将 GAv3 对象从对象层次结构视图中拖到该字段上。
  5. 现在,您就可以开始跟踪这一 GameObject 了。使用相同的预设件对其他希望跟踪的对象重复该过程。

后续步骤

  • 查看 API 参考,了解您可以发送给 Google Analytics(分析)的匹配类型。
  • 阅读移动应用实现指南,了解如何使用 Google Analytics(分析)来衡量用户互动并回答关于游戏使用的问题。

资源