说明

本接口用于向支付宝平台上报游戏关键业务节点数据，支付宝渠道必接。

通过 reportGameBizData 上报加载完成、创角、进入游玩、授权等标准事件，以及可选的自定义事件。

注意

以下标准事件需在对应业务节点按时上报，否则可能影响支付宝侧数据验收与流量分发。

输入

参数	类型	必传	描述
eventType	String	是	事件类型，见下方枚举
eventData	Object	否	事件附加数据，部分事件类型需要传入

eventType 事件枚举

值	含义	调用时机
loadingCompleted	加载完成	进入首个可交互场景时
characterCreated	创角完成	玩家首次创建角色时
gamePlay	进入游玩界面	玩家进入主玩法界面时
authorized	授权完成	SDK 登录成功后会自动上报，一般无需手动调用
customEvent	自定义事件	按需上报，需传入 eventName 与 eventData

eventData 说明

事件类型	字段	类型	必传	描述
characterCreated	initial	Boolean	否	是否首次创角，首次创角建议传 true
customEvent	eventName	String	是	自定义事件 ID
customEvent	eventData	Object	否	自定义事件数据

输出

无

示例代码

const mzfSdk = window.mzfSdk; // 或 globalThis.mzfSdk

// 1. 加载完成（进入首个可交互场景时）
await mzfSdk.reportGameBizData('loadingCompleted');

// 2. 创角完成
await mzfSdk.reportGameBizData('characterCreated', { initial: true });

// 3. 进入游玩界面
await mzfSdk.reportGameBizData('gamePlay');

// 4. 授权完成（一般不用手动调，SDK 登录成功会自动报）
await mzfSdk.reportGameBizData('authorized');

// 5. 自定义事件（可选）
await mzfSdk.reportGameBizData('customEvent', {
  eventName: '事件ID',
  eventData: { key: 'value' }
});