适用于 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 Prefab 对象(位于 Project ViewAssets/Plugins/GoogleAnalyticsV3 中)。
  2. “Inspector”(检查器)视图将显示附加到预设件的脚本组件,并列出了一些媒体资源。 使用项目的正确值填充这些属性。这将填充该对象,使其可以在项目中的任何位置使用。例如:
    • 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 对象),然后在对象层次结构视图中点击该对象。如果您要跟踪的对象上尚未附加任何脚本,请使用“Inspector”(检查器)视图中的“Add Component”(添加组件)按钮创建一个新脚本。
  2. 在类中创建一个公共变量,以保存 GoogleAnalyticsV3 对象。例如:
    public GoogleAnalyticsV3 googleAnalytics;
  3. 保存脚本并返回到 Unity 窗口。
  4. 在您要跟踪的 GameObject“检查器”视图中,您会看到自己创建的脚本以及一个名为 Google Analytics(或您所选择的变量名称)且需要填充的字段。将 GAv3 对象从对象层次结构视图中拖到该字段上。
  5. 现在,您可以开始跟踪该 GameObject。使用同一预制件对您要跟踪的其他对象重复此流程。

后续步骤

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

资源