# 关卡分析打点

------

#### **简介**

关卡分析，为开发者提供小游戏详细的关卡数据，分析各关卡玩家的通关状况，帮助开发者从数据角度衡量游戏设计的合理性，调节难易度，观察各关卡道具使用情况和奖励获取状况，对比分析各个指标，通过量化玩家数据，提高游戏体验。

#### **后台使用**

接入关卡分析接口后，登录后台->头部tab切换到【游戏数据】->【产品分析】->【关卡分析】可查看关卡进入用户数据、失败次数、失败率、平均完成时间等）：

![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_020.png)



#### **接入API**：

| **名称**         | **功能说明**                                                 |
| ---------------- | ------------------------------------------------------------ |
| PCSDK.stat.event | 自定义事件打点，使用前请[前往后台](http://pre-data.d3games.com/index.html#/login)进行添加自定义事件key |



1. **event**

   ```javascript
   PCSDK.stat.event(event_key: string , event_source: string , opts?: { ext_val?: string | number} ): Promise<any>
   ```

   定义：自定义事件打点，可在游戏任何位置定义事件打点

   参数：

   ```
   event_key: string 必传，后台配置的事件key
   
   event_source: string 必传，触发该事件所在页面位置，例如：结算页面、排行榜界面、签到页面。。。
   
   opts?: object 选传，自定义扩展参数，一些特定的事件想传递更多信息，此参数使用请咨询相关对接人员目前只支持对象一个key（evt_val），多个扩展参数使用'|'连接
   {
        ext_val: '100|1000'
   }
   ```
   示例：

   ```javascript
    // 签到功能
    private  onSign() {
        PCSDK.stat.event(EventKeys.FunctionSign, '主界面');
    }
   
    // 开始加载资源
    private loadRes() {
      	PCSDK.stat.event(EventKeys.LoadingExhibition, '加载界面');
        LoaderManager.I.setCallback(this.onLoadedMain, this.onProgressMain, null, this).loadMain();
    }
   
    // 升级领奖
    private onReward(e: Laya.Event) {
        PCSDK.stat.event(EventKeys.LvUpRewards, '升级界面');
        SDKTools.shareDispatch(ShareKey.LevelUpDiamond, {
            success: this.handleDoubleReward,
            context: this
        });
    }
   ```