关卡上报

提示

1.3版本SDK对于关卡打点做了诸多优化，接入更加方便。主要改动：

1. SDK将会记录trackLevelStart的level和mode(默认为"主玩法")参数以及开始时间，后续所有打点的level、mode和useTime字段可以不传
2. SDK将会根据调用的trackLevelRevive和trackLevelProgress自动统计数值，后续所有打点的reviveCount、revive和progress字段可以不传

关卡开始

version>=1.0.0

Unity

>=1.3
public static void TrackLevelStart(LevelStartEventParam param);
<1.3
public static void TrackLevelStart(LevelEventParam param);

CocosCreator

export function trackLevelStart(params: LevelStartEventParam): void;

Android

public static void trackLevelStart(LevelEventParam param);

iOS

+ (void)trackLevelStart:(LevelEventParam *)param;

LevelStartEventParam参数

参数	类型	说明	默认值
level	number	关卡	必传
mode	string	模式	'主玩法'

关卡失败

version>=1.0.0

Unity

public static void TrackLevelLose(LevelEventParam param);

CocosCreator

export function trackLevelLose(params: LevelLoseParam): void;

Android

public static void trackLevelLose(LevelEventParam param);

iOS

+ (void)trackLevelLose:(LevelEventParam *)param;

LevelLoseParam参数

参数	类型	说明	默认值
level	number	关卡	<1.3必传，>=1.3会填充trackLevelStart的值
mode	string	关卡模式	<1.3默认为主玩法，>=1.3会填充trackLevelStart的值
progress	number	进度，百分制，整数	<1.3必传，>=1.3会根据trackLevelProgress计算
useTime	number	用时，单位秒，整数	<1.3必传，>=1.3会自动计算
revive	boolean	是否复活	<1.3默认为false,>=1.3则根据trackLevelRevive计算
reviveCount	number	复活次数	1.3新增，会根据trackLevelRevive计算

关卡通关

version>=1.0.0

Unity

public static void TrackLevelPass(LevelEventParam param);

CocosCreator

export function trackLevelPass(params: LevelPassParam): void;

Android

public static void trackLevelPass(LevelEventParam param);

iOS

+ (void)trackLevelPass:(LevelEventParam *)param;

LevelPassParam参数

参数	类型	说明	默认值
level	number	关卡	<1.3必传，>=1.3会填充trackLevelStart的值
mode	string	关卡模式	<1.3默认为主玩法，>=1.3会填充trackLevelStart的值
useTime	number	用时，单位秒，整数	<1.3必传，>=1.3会自动计算
revive	boolean	是否复活	<1.3默认为false,>=1.3则根据trackLevelRevive计算
reviveCount	number	复活次数	1.3新增，会根据trackLevelRevive计算

关卡退出

version>=1.1.0

Unity

public static void TrackLevelQuit(LevelQuitEventParam param);

CocosCreator

export function trackLevelQuit(params: LevelQuitEventParam): void;

Android

public static void trackLevelOperate(LevelEventParam param);

iOS

+ (void)trackLevelOperate:(LevelEventParam *)param;

LevelQuitEventParam参数

参数	类型	说明	默认值
level	number	关卡	<1.3必传，>=1.3会填充trackLevelStart的值
mode	string	关卡模式	<1.3默认为主玩法，>=1.3会填充trackLevelStart的值
progress	number	进度，百分制，整数	<1.3必传，>=1.3会根据trackLevelProgress计算
useTime	number	用时，单位秒，整数	<1.3必传，>=1.3会自动计算
revive	boolean	是否复活	<1.3默认为false,>=1.3则根据trackLevelRevive计算
reviveCount	number	复活次数	1.3新增，会根据trackLevelRevive计算
quitType	string	退出类型	选填

关卡重玩

version>=1.1.0

Unity

public static void TrackLevelReplay(LevelReplayEventParam param);

CocosCreator

export function trackLevelReplay(params: LevelReplayEventParam): void;

Android

public static void trackLevelReplay(LevelEventParam param);

iOS

+ (void)trackLevelReplay:(LevelEventParam *)param;

LevelReplayEventParam参数

参数	类型	说明	默认值
level	number	关卡	<1.3必传，>=1.3会填充trackLevelStart的值
mode	string	关卡模式	<1.3默认为主玩法，>=1.3会填充trackLevelStart的值
progress	number	进度，百分制，整数	<1.3必传，>=1.3会根据trackLevelProgress计算
useTime	number	用时，单位秒，整数	<1.3必传，>=1.3会自动计算
revive	boolean	是否复活	<1.3默认为false,>=1.3则根据trackLevelRevive计算
reviveCount	number	复活次数	1.3新增，会根据trackLevelRevive计算
replayType	string	重玩类型	选填

关卡复活

version>=1.1.2

Unity

public static void TrackLevelRevive(LevelReviveParam param);

CocosCreator

export function TrackLevelRevive(params: LevelReviveParam): void;

Android

public static void trackLevelPass(LevelEventParam param);

iOS

+ (void)trackLevelPass:(LevelEventParam *)param;

LevelReviveParam参数

参数	类型	说明	默认值
level	number	关卡	<1.3必传，>=1.3会填充trackLevelStart的值
mode	string	关卡模式	<1.3默认为主玩法，>=1.3会填充trackLevelStart的值
useTime	number	用时，单位秒，整数	<1.3必传，>=1.3会自动计算
reviveCount	number	复活次数	1.3新增，会根据trackLevelRevive计算

关卡进度

version>=1.1.0

Unity

public static void TrackLevelProgress(LevelProgressEventParam param);

CocosCreator

export function trackLevelProgress(params: LevelProgressEventParam): void;

Android

public static void trackLevelProgress(LevelEventParam param);

iOS

+ (void)trackLevelProgress:(LevelEventParam *)param;

LevelProgressEventParam参数

参数	类型	说明	默认值
level	number	关卡	<1.3必传，>=1.3会填充trackLevelStart的值
mode	string	关卡模式	<1.3默认为主玩法，>=1.3会填充trackLevelStart的值
useTime	number	用时，单位秒，整数	<1.3必传，>=1.3会自动计算
progress	number	进度	必填

道具使用

version>=1.0.0

Unity

public static void trackLevelPropUse(params: LevelPropUseParam);

CocosCreator

export function trackLevelPropUse(params: LevelPropUseParam): void;

Android

public static void trackLevelPropUse(LevelPropUseParam param);

iOS

+ (void)trackLevelPropUse:(LevelPropUseParam *)param;

LevelPropUseParam参数

参数	类型	说明	默认值
level	number	关卡	<1.3必传，>=1.3会填充trackLevelStart的值
mode	string	关卡模式	<1.3默认为主玩法，>=1.3会填充trackLevelStart的值
progress	number	进度，百分制，整数	<1.3必传
prop	string	道具名称	必传

关键操作

version>=1.0.0

Unity

public static void TrackLevelOperate(LevelEventParam param);

CocosCreator

export function trackLevelOperate(params: LevelOperateParam): void;

Android

public static void trackLevelOperate(LevelEventParam param);

iOS

+ (void)trackLevelOperate:(LevelEventParam *)param;

LevelOperateParam参数

参数	类型	说明	默认值
level	number	关卡	<1.3必传
mode	string	模式	<1.3默认为
progress	number	进度，百分制，整数	<1.3必传，>=1.3会根据trackLevelProgress计算
operate	string	操作名称	<1.3必传