数据上报

1.创建角色信息

提示

• 玩家创建游戏角色的时候，调用此接口上报角色数据
• 必接，否则渠道审核不通过

接入代码示例

Java

OmniSDKRoleInfo sdkRoleInfo = OmniSDKRoleInfo.builder()
        .userId(userId)
        .roleId(roleId)
        .roleLevel(roleLevel)
        .roleName(roleName)
        .serverId(serverId)
        .serverName(serverName)
        .extJson(extJson)
        .build();
OmniSDKCreateRoleEvent event = new OmniSDKCreateRoleEvent(sdkRoleInfo);
OmniSDKv3.getInstance().track(event);

参数描述

OmniSDKCreateRoleEvent

参数	类型	说明
roleInfo	OmniSDKRoleInfo	玩家角色信息

OmniSDKRoleInfo

参数	类型	说明
userId	String	OmniSDK 返回的 用户userId
roleId	String	角色ID
roleLevel	String	角色等级
roleName	String	角色名称
roleVipLevel	String	角色VIP等级
serverId	String	大区 ID
serverName	String	大区 名称
extJson	String	扩展参数

2.进入游戏

提示

• 登录完成后，进入游戏界面时，调用此接口上报角色数据。
• 必接，否则渠道审核不通过

接入代码示例

Java

OmniSDKRoleInfo sdkRoleInfo = OmniSDKRoleInfo.builder()
        .userId(userId)
        .roleId(roleId)
        .roleLevel(roleLevel)
        .roleName(roleName)
        .serverId(serverId)
        .serverName(serverName)
        .extJson(extJson)
        .build();
OmniSDKEnterGameEvent event = new OmniSDKEnterGameEvent(sdkRoleInfo);
OmniSDKv3.getInstance().track(event);

参数描述

OmniSDKEnterGameEvent

参数	类型	说明
roleInfo	OmniSDKRoleInfo	玩家角色信息

3.角色升级

提示

• 角色升级，或者其他信息有变化情况下，都可以调用此接口上报角色信息
• 必接，否则渠道审核不通过

接入代码示例

Java

OmniSDKRoleInfo sdkRoleInfo = OmniSDKRoleInfo.builder()
        .userId(userId)
        .roleId(roleId)
        .roleLevel(roleLevel)
        .roleName(roleName)
        .serverId(serverId)
        .serverName(serverName)
        .extJson(extJson)
        .build();
OmniSDKRoleLevelUpEvent event = new OmniSDKRoleLevelUpEvent(sdkRoleInfo);
OmniSDKv3.getInstance().track(event);

参数描述

OmniSDKRoleLevelUpEvent

参数	类型	说明
roleInfo	OmniSDKRoleInfo	玩家角色信息

4.游戏发货成功

提示

• 在收到 支付成功结果 之后，上报支付该事件
• 必接

接入代码示例

Java

OmniSDKPurchaseEvent event = OmniSDKPurchaseEvent.builder()
        .userId(userId)
        .orderId(orderId)
        .productId(productId)
        .productDesc(productDesc)
        .productUnitPrice(productUnitPrice)
        .productName(productName)
        .currency(currency)
        .gameServerId(gameServerId)
        .gameRoleVipLevel(gameRoleVipLevel)
        .gameRoleLevel(gameRoleLevel)
        .gameRoleName(gameRoleName)
        .gameRoleId(gameRoleId)
        .gameOrderId(gameOrderId)
        .extJson(extJson)
        .purchaseQuantity(purchaseQuantity)
        .purchaseAmount(purchaseAmount)
        .build();
OmniSDKv3.getInstance().track(event);

参数描述

OmniSDKPurchaseEvent

参数	类型	说明
userId	String	OmniSDK 返回的用户 userId
orderId	String	OmniSDK 返回的用户 userId
productId	String	商品 Id
productName	String	商品名称
productDesc	String	商品描述
productUnitPrice	Double	商品单价： 单位：元、美元，比如 9.99 美元，0.99 港币等
purchaseQuantity	Int	实际购买数量：不传默认为1
purchaseAmount	Double	实际支付总额： 单位：元、美元
gameOrderId	String	游戏订单 ID：不可重复的字符串
gameServerId	String	服务器 ID： 必须为纯数字，且不能超过 2147483647（应用宝渠道要求）
gameZoneId	String	大区 ID
gameRoleId	String	角色 ID
gameRoleLevel	String	角色等级
gameRoleVipLevel	String	角色 VIP 等级
currency	String	实际支付的国际标准货币代码：比如 CNY (人民币) / USD (美元)
extJson	String	透传扩展参数： JSON 格式；无传空字符串

5.自定义买量付费事件(选接)

提示

• 此方法不同于 支付成功上报信息，具体看运营需求，针对特殊游戏场景。
• 举例：玩家角色升级 50 级，上报付费为10 元的付费事件

接入代码示例

Java

OmniSDKRoleInfo sdkRoleInfo = OmniSDKRoleInfo.builder()
        .userId(userId)
        .roleId(roleId)
        .roleLevel(roleLevel)
        .roleName(roleName)
        .serverId(serverId)
        .serverName(serverName)
        .extJson(extJson)
        .build();
OmniSDKRevenueEvent event = OmniSDKRevenueEvent.builder()
       .roleInfo(sdkRoleInfo)
       .consumeNum(consumeNum)
       .build();
OmniSDKv3.getInstance().track(event);

参数描述

OmniSDKRevenueEvent

参数	类型	说明
roleInfo	OmniSDKRoleInfo	玩家角色信息
consumeNum	Int	上报付费金额 单位元。比如 要上报2元的付费事件，consumeNum = 2