上报渠道埋点

业务场景

渠道侧要求【必接】的数据打点

请根据接入的渠道上报

支付宝【必接】

  • 小游戏初次出现游戏画面后,开发者需要在资源加载完成后上报,上报 {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

参数名称类型说明必传/可选最低版本
eventTypeEVENT_TYPE事件类型【枚举值见:EVENT_TYPE】必传
extendstring扩展字段可选
actionCodestring行为码可选
eventNamestring事件名【eventType=8,上报埋点事件名】可选

EVENT_TYPE eventType

事件类型字段名称值(int)说明extend 要求
游戏加载完成EVENT_TYPE_LOAD_COMPLETEED5资源加载完即上报
进入游戏游玩界面EVENT_TYPE_ENTER_GAME6用户可以进行游戏交互的界面/主界面
游戏行为上报EVENT_TYPE_ACTIONCODE7行为码【支付宝/美团】长度不超过 100,标识在游戏内需唯一
游戏内部埋点EVENT_TYPE_GAME_REPORT8设首、复访功能埋点【支付宝】
支付回调EVENT_TYPE_PAY_CALLBACK9需上报支付成功的相关信息

错误码

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 即可