上报渠道埋点
业务场景
渠道侧要求【必接】的数据打点
请根据接入的渠道上报
支付宝【必接】
- 小游戏初次出现游戏画面后,开发者需要在资源加载完成后上报,上报
{eventType:5}
- 成功进入游戏游玩界面,指玩家完成了一切前置环节,处于 可以体验游戏内容 的主页面状态,上报
{eventType:6}
- 游戏行为上报,上报
{eventType:7,extend:'全局唯一标识',actionCode:'行为码'}
- 设首、复访埋点上报,规则请看,上报
{eventType:8,eventName:'事件名'}
抖音【必接】
- feed 直玩,达到指定场景,上报
{eventType:6}
美团【必接】
- 游戏行为上报,上报
{eventType:7,extend:'全局唯一标识',actionCode:'行为码'}
流程图
无
接口介绍
reportChannelGameInfo(info: EworldSDK.ChannelGameInfo): void
调用示例
// feed 直玩,达到指定场景,上报
const info = {
eventType: EVENT_TYPE.EVENT_TYPE_ENTER_GAME,
extend: 'xxx',
actionCode: 'xxx',
eventName: 'xxx',
};
SDKManager.reportChannelGameInfo(info);
参数说明
入参: ChannelGameInfo info
参数名称 | 类型 | 说明 | 必传/可选 | 最低版本 |
---|---|---|---|---|
eventType | EVENT_TYPE | 事件类型【枚举值见:EVENT_TYPE】 | 必传 | |
extend | string | 扩展字段 | 可选 | |
actionCode | string | 行为码 | 可选 | |
eventName | string | 事件名【eventType=8,上报埋点事件名】 | 可选 |
EVENT_TYPE eventType
事件类型 | 字段名称 | 值(int) | 说明 | extend 要求 |
---|---|---|---|---|
游戏加载完成 | EVENT_TYPE_LOAD_COMPLETEED | 5 | 资源加载完即上报 | |
进入游戏游玩界面 | EVENT_TYPE_ENTER_GAME | 6 | 用户可以进行游戏交互的界面/主界面 | |
游戏行为上报 | EVENT_TYPE_ACTIONCODE | 7 | 行为码【支付宝/美团】 | 长度不超过 100,标识在游戏内需唯一 |
游戏内部埋点 | EVENT_TYPE_GAME_REPORT | 8 | 设首、复访功能埋点【支付宝】 | |
支付回调 | EVENT_TYPE_PAY_CALLBACK | 9 | 需上报支付成功的相关信息 |
错误码
无
FAQ
Q: 行为码上报后,领奖失败了
A: 请注意extend
在全局的唯一性,不能重复
Q: 美团的行为码不需要补充游戏的 APPID?
A: 美团 actionCode 由【游戏中心】运营同学为「游戏行为」分配的 唯一编码,SDK 会默认在后面补全游戏 ID,例如:完整的 actioncode 是 zcylt_game_shizhou_every_10_mgc1234567,mgc1234567 是游戏 ID,CP 只需传入 zcylt_game_shizhou_every_10 即可