Skip to main content
Version: 2.0.0

事件埋点

一、 关卡进度事件​

关卡进度事件用于分析用户在游戏中的关卡行为，其中包括关卡开始，关卡结束等事件。

tip
关卡类游戏必须调用关卡进度事件。

1、游戏每局开始时调用「关卡开始事件」: LevelEnter
2、游戏每局结束时调用「关卡结束事件 」: LevelEnd

  • 当局游戏成功: Level_Success
  • 当局游戏失败: Level_Fail
  • 在未结算前，用户选择马上结束当局游戏并重新开始。如在当局游戏内点击重试: Level_Retry
  • 在未结算前，用户选择马上退出游戏并返回游戏列表界面或主界面。如在当局游戏内点击返回或退出按钮: Level_Back

关卡开始事件​

HCSDKManager.Instance.LevelEnter("1"); 
   
HCSDKManager.Instance.LevelEnter(1);

HCSDKManager.Instance.LevelEnter("S_1");

HCSDKManager.Instance.LevelEnter("S_1",new Dictionary<string, object>() {{ "s_id", 9 },{ "s_type","10"} });

调用时机： 游戏每局开始时调用。

API:
void LevelEnter(int level,Dictionary<string, object> extraInfos = null);
void LevelEnter(string level,Dictionary<string, object> extraInfos = null);

NameisRequiredTypeDescription
levelYint/stringlevel为正在进行的关卡序号值。
具体值请参看产品需求文档中"关卡进度事件接入"
extraInfosNDictionary拓展字段
具体值请参看产品需求文档中"关卡进度事件接入"

关卡结束事件​

HCSDKManager.Instance.LevelEnd("1", StageResult.Level_Success); 

HCSDKManager.Instance.LevelEnd(1, StageResult.Level_Success);

HCSDKManager.Instance.LevelEnd("S_1", StageResult.StageFail);

HCSDKManager.Instance.LevelEnd(3, StageResult.Level_Retry);

HCSDKManager.Instance.LevelEnd("S_2", StageResult.Level_Back);

HCSDKManager.Instance.LevelEnd("S_2", StageResult.Level_Success,new Dictionary<string, object>() {{ "s_id", 9 },{ "s_type","10"} });

调用时机： 游戏每局结束时调用。

API:
void LevelEnd(int _level, StageResult _stageResult,Dictionary<string, object> extraInfos = null);
void LevelEnd(string _level, StageResult _stageResult,Dictionary<string, object> extraInfos = null);

NameisRequiredTypeDescription
levelYint/stringlevel为正在进行的关卡序号值。
具体值请参看产品需求文档中"关卡进度事件接入"
stageResultYStageResultLevel_Success: 当局游戏成功

Level_Fail: 当局游戏失败

Level_Retry: 在未结算前，用户选择马上结束当局游戏并重新开始。如在当局游戏内点击重试。

Level_Back: 在未结算前，用户选择马上退出游戏并返回游戏列表界面或主界面。如在当局游戏内点击返回或退出按钮。
extraInfosNDictionary拓展字段
具体值请参看产品需求文档中"关卡进度事件接入"

二、设置公共事件属性（只用于报到数数）​

Dictionary<string, object> superProperties = new Dictionary<string, object>();
superProperties["channel"] = "ta";//字符串
superProperties["age"] = 1;//数字
superProperties["isSuccess"] = true;//布尔
superProperties["birthday"] = DateTime.Now;//时间
superProperties["object"] = new Dictionary<string, object>() { { "key", "value" } };//对象
superProperties["object_arr"] = new List<object>() { new Dictionary<string, object>() { { "key", "value" } } };//对象组
superProperties["arr"] = new List<object>() { "value" };//数组

HCSDKManager.Instance.SetSuperProperties(superProperties);

三、设置用户属性（只用于报到数数）​

Dictionary<string, object> userProperties = new Dictionary<string, object>();
userProperties["user_name"] = "TA";

HCSDKManager.Instance.SetUserProperties(userProperties);

四、自定义事件上报​

HCSDKManager.Instance.LogEvent("Event01");

HCSDKManager.Instance.LogEvent("Event02", "key01","value01",TrackEventPlatform.Firebase);

HCSDKManager.Instance.LogEvent("Event03", "key01", "value01", "key02", "value02",TrackEventPlatform.TD);

HCSDKManager.Instance.LogEvent("Event04", new Dictionary<string, object>() { { "key01", "value01" } });

默认上报Firebase/数数，如需单独上报某一个统计平台需通过 TrackEventPlatform 枚举控制