APK 马甲包事件对接

来源：非凡包网产品说明文档 更新日期：2026-04-12 用途：说明 H5 与 Android 马甲包之间的埋点事件通信机制和外链跳转方案

---

概述

非凡包网 H5 前端通过 WebView 的 jsBridge 对象与 Android 马甲包进行通信，实现用户行为埋点推送和外链跳转功能。马甲包需要在 WebView 中注入 jsBridge 对象，H5 端通过回调函数传递事件数据。

---

1. 埋点事件推送

1.1 通信机制

H5 通过以下方式调用马甲包注入的 jsBridge：

window.jsBridge?.postMessage(eventName, params)

1.2 参数说明

参数	类型	说明
eventName	String	事件名称（见下方事件列表）
params	String	JSON 字符串，包含用户基础信息

基础参数结构：

{
  "uid": 123456,
  "phone": "55124123",
  "email": "xxxx@xxx.com",
  "cid": "64kr9"
}

1.3 Android 端接入代码

第 1 步：注入 JsBridge

webView.addJavascriptInterface(new JsInterface(), "jsBridge");

第 2 步：实现 postMessage 回调

public class JsInterface {
    @JavascriptInterface
    public void postMessage(String name, String data) {
        Log.e("TAG", "postMessage name==" + name);
        Log.e("TAG", "postMessage data==" + data);
    }
}

1.4 埋点事件列表

事件名称	eventName	额外参数	备注
登录	login	—	基础参数
登出	logout	—	基础参数
点击注册	registerClick	—	空对象 {}
注册成功	register	—	基础参数
点击充值	rechargeClick	amount, currency	充值金额和币种
首充成功 *	firstRecharge	amount, currency, order_sn	后端确认后返回
充值成功 *	recharge	amount, currency, order_sn	后端确认后返回
进入游戏	enterGame	—	基础参数

注意：带 * 标记的事件由后端确认后才返回，会有些许延迟。

1.5 事件参数示例

点击充值 (rechargeClick)：

{
  "uid": 123456,
  "phone": "55124123",
  "email": "xxxx@xxx.com",
  "cid": "64kr9",
  "amount": "200",
  "currency": ""
}

充值成功 (recharge / firstRecharge)：

{
  "uid": 123456,
  "phone": "55124123",
  "email": "xxxx@xxx.com",
  "cid": "64kr9",
  "amount": "200",
  "currency": "IDRK",
  "order_sn": "P32483732878723"
}

---

2. 外链跳转

2.1 通信机制

同样通过 jsBridge.postMessage 实现，事件名固定为 openWindow：

window.jsBridge?.postMessage("openWindow", params)

2.2 参数说明

参数	类型	说明
eventName	String	固定值 openWindow
params	String	JSON 字符串，包含基础参数 + 目标 URL

参数示例：

{
  "uid": 123456,
  "phone": "55124123",
  "email": "xxxx@xxx.com",
  "cid": "64kr9",
  "url": "http://xxx.com/xxx/xxx"
}

马甲包收到 openWindow 事件后，应使用系统浏览器或新 WebView 打开 url 字段指定的链接。

---

技术要点速查

项目	说明
注入对象名	jsBridge
回调方法	postMessage(eventName, params)
参数格式	JSON 字符串
延迟事件	firstRecharge、recharge（后端确认）
外链事件	openWindow，额外携带 url 字段

---

交叉引用： - APK 包管理 → 01-APK包管理 - 渠道配置 → 03-渠道配置 - Adjust 配置知识 → 09-Adjust配置知识整理