标准事件

Note: Gaming Services Analytics is now available as a preview package. Gaming Services Analytics is an improved offering that allows you to easily understand game performance and player behaviors so you can make strategic decisions. Check out the documentation.

使用标准事件可以在五个主要方面跟踪用户体验和玩家行为：

• 应用程序 (Application)：跟踪应用程序用户界面中基本元素的使用情况
• 进度 (Progression)：跟踪玩家在应用程序或游戏中的进度
• 入门 (Onboarding)：跟踪玩家与应用程序或游戏最早进行的交互
• 参与度 (Engagement)：跟踪与社交分享、成就相关的重要活动
• 变现 (Monetization)：跟踪与收入相关的事件以及游戏内的经济情况

标准事件列表涵盖可用于跟踪游戏和应用程序的一系列内容。例如，大多数游戏都有玩家进度的概念，其中可能包括完成的猜谜、参与过的比赛、获得的 RPG 类经验或其他一些概念。通过跟踪标准进度事件，可更好地了解玩家停止进度的位置以及最终停止玩游戏的位置。

大多数标准事件都会定义必需参数和可选参数。这些参数可在发送 Analytics 事件时提供有关游戏状态的其他信息。您也可以定义自己的自定义参数。设置关于事件的参数可让您过滤事件发生时收集的数据。在 Analytics Dashboard 上可以查看标准事件和自定义事件的可视化工具，包括 Data Explorer、Funnel Analyzer 和 Segment Builder。

Unity Analytics 将它接收的标准事件和自定义事件的数量限制为每个用户每小时 100 个。换言之，如果玩游戏的单个用户设法在一小时内触发超过 100 个标准事件或自定义事件，Analytics 就会丢弃多余的事件。

应用程序事件

应用程序事件跟踪玩家在游戏本身之外与应用程序的交互（例如，在菜单中或者关卡之前或之后的过场动画屏幕中进行的交互）。通过分析应用程序事件可以查看玩家是否按照预期经常使用用户界面的基本部分。

进度事件

进度事件跟踪玩家在游戏中的进度。分析标准进度事件可以监控玩家在游戏中的进度。

入门事件

入门事件跟踪首次用户体验 (FTUE)。分析标准入门事件可以监控教程的有效性。

参与事件

参与事件有助于了解玩家是否参与游戏，以及他们是否执行与用户留存和游戏传播高度相关的操作。

变现事件

变现事件跟踪收入和游戏经济以帮助您平衡资源并改善收入来源。

脚本标准事件

要从脚本分发标准事件，请添加以下命名空间：

using UnityEngine.Analytics;

注意：使用 Unity Asset Store 的 Standard Events SDK 时，请改用命名空间 UnityEngine.Analytics.Experimental。

现在您可以使用 AnalyticsEvent 类来分发标准事件。每个标准事件都有相应的静态函数。例如，要发送 game_start 事件，请调用以下函数：

AnalyticsEvent.GameStart();

许多标准事件都有必需参数，有一些事件具有可选参数。您还可以在字典中添加自己的附加参数。例如，如果想要跟踪玩家使用 ScreenVisit 事件访问了哪些屏幕，但也想跟踪他们从哪个屏幕进行访问，则可以在字典对象中传递该信息：

public static void ReportScreenVisit(string screenName, string currentScreenName)
{
    AnalyticsEvent.ScreenVisit(screenName, new Dictionary<string, object>
    {
        { "from_screen", currentScreenName }
    });
}

必需参数、可选参数（仅统计您使用的参数）和附加参数的总数不得超过十个。换言之，如果一个事件函数有 2 个必需参数，并且您设置了 2 个可选参数中的 1 个，则还可以将包含最多 7 个附加键/值对的字典传递给该函数。如果在同一事件中同时设置了 2 个可选参数，则该字典只能包含最多 6 个键/值对。

标准事件代码示例

以下类提供的示例使用标准 MonoBehaviour 事件函数来分发与开始和结束关卡相关的标准事件。

Awake 函数分发 level_start 事件。本示例同时提供关卡名称和关卡索引，但只有一个是必需参数。本示例还使用来自 Scene 对象的名称和索引，但是您可以使用不同值。

OnDestroy 函数会基于当前关卡状态值来分发一个level_complete、level_fail、level_skip或level_quit事件（在一个真实游戏中，这个值将会在当前关卡的其他代码中通过这个例子里定义的 SetLevelPlayState() 函数来设置）。这个例子使用一个叫“customParams”的字典向这些事件里添加了一些额外的参数。

using System.Collections.Generic;
using UnityEngine;
using UnityEngine.SceneManagement;
using UnityEngine.Analytics;

public class LevelEventManager : MonoBehaviour {
    public enum LevelPlayState {InProgress, Won, Lost, Skip, Quit}

    private Scene thisScene;
    private LevelPlayState state = LevelPlayState.InProgress;
    private int score = 0;
    private float secondsElapsed = 0;
    private int deaths = 0;

    void Awake () {
        thisScene = SceneManager.GetActiveScene();
        AnalyticsEvent.LevelStart(thisScene.name, 
                                      thisScene.buildIndex);
    }

    public void SetLevelPlayState(LevelPlayState newState){
        this.state = newState;
    }

    public void IncreaseScore(int points){
        score += points;
    }

    public void IncrementDeaths(){
        deaths++;
    }

    void Update(){
        secondsElapsed += Time.deltaTime;
    }

    void OnDestroy(){
        Dictionary<string, object> customParams = new Dictionary<string, object>();
        customParams.Add("seconds_played", secondsElapsed);
        customParams.Add("points", score);
        customParams.Add("deaths", deaths);

        switch(this.state){
        case LevelPlayState.Won:
            AnalyticsEvent.LevelComplete(thisScene.name,
                                             thisScene.buildIndex, 
                                             customParams);
            break;
        case LevelPlayState.Lost:
            AnalyticsEvent.LevelFail(thisScene.name,
                                         thisScene.buildIndex, 
                                         customParams);
            break;
        case LevelPlayState.Skip:
            AnalyticsEvent.LevelSkip(thisScene.name,
                                         thisScene.buildIndex, 
                                         customParams);
            break;
        case LevelPlayState.InProgress:
        case LevelPlayState.Quit:
        default:
            AnalyticsEvent.LevelQuit(thisScene.name,
                                         thisScene.buildIndex, 
                                         customParams);
            break;
        }
    }
}

请注意，本示例仅使用一次 OnDestroy() 中创建的自定义参数字典。但是，在分发频繁使用这种字典的事件时，应创建该字典的单个实例并重复使用它，而不是每次创建一个新字典。重复使用字典对象可减少未来必须进行垃圾回收的内存分配。请参阅 Analytics 事件参数以了解更多信息。

• 2018–03–02 页面已发布

• 截至 2018–03–02，服务与 Unity 5.2 之后的版本兼容，但是版本兼容性可能会发生变化

• 5.2 中的新功能