开发

获取打点数据说明

功能说明

将打点信息传递给宿主app,宿主app可以通过自己的打点数据传输通道上报到自己的数据平台

接口说明

SwanAppStatisticProvider中进行注册和反注册监听小程序数据信息。在StatisticListener#onEventStat(String statTag, String statisticData)中存在两个参数,statTag固定为swanLauncherTag,statisticData中数据含义请参考参数说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/**
* 注册获取小程序数据的监听
* @param listener 回调信息
*/
public void registerStatisticProviderListener(StatisticListener listener) {
this.listener = listener;
if (DEBUG) {
Log.d(TAG, "registerStatisticProviderListener");
}
}

/**
* 反注册监听,释放对象
*/
public void unRegisterStatisticProviderListener() {
listener = null;
if (DEBUG) {
Log.d(TAG, "unRegisterStatisticProviderListener");
}
}

1
2
3
4
5
6
7
8
9
10
11
12
/**
* 注册监听对象
*/
public interface StatisticListener {
/**
* 主进程中返回数据信息给到宿主
*
* @param statTag 数据点位
* @param statisticData 数据内容
*/
void onEventStat(String statTag, String statisticData);
}

参数说明

statisticData中的参数请参考下表

参数名 描述
from swan(小程序)
type show(页面展现) click(点击) launch(小程序启动) pageshow(页面展现)
value downloadstart(开始下载) downloadsuccess(下载成功) downloadfail(下载失败)download_fail(下载失败) unzipstart(开始解压) unzipend(解压完成)appready(小程序准备就绪) pageready(页面准备就绪) loadmaster(加载Master) success(成功) fail(失败) cancel(取消)realcancel(页面回退) realsuccess(页面展示) repeatlaunch(同一小程序短时间重复调起)arrivesuccess(FCP到达点) arrivecancel(FCP未到达) naarrsuccess(NA截图方式到达点) fmparrsuccess(FMP到达点) narendersuccess(NA渲染成功)
source 启动小程序的来源 NA(源默认值) remote-debug(远程调试) adb-debug(无线调试)
ext
以下为 ext 中参数
coreState swancore预加载状态 0(未知) 1(成功) 2(失败) 3(正在加载中) 4(触发重试) 5(重试成功) 6(重试失败)
packageState 包状态 0(使用远程包) 1(maxAge - 使用远程包) 2(本地包错误 - 使用远程包) 3(maxAge - 使用本地包) 4(使用本地包) 5(使用预置包) 99(待maxAge检查)
isDownloading 是否正在下载小程序包 1(是) 0(否) “”(空值)
launchType 启动类型 1(冷启动) 2(热启动)
pre_source 前一个小程序的调起来源,小程序间跳转时,获取上个小程序调起来源
pre_appid 前一个小程序appid,小程序间跳转时,获取上个小程序信息
extension_ver 小程序extensionjs版本号
isReloadApp 是否重启打开小程序 1(是) 0(否)
swan 小程序swanjs版本号
appversion 当前小程序版本号
thirdversion 当前小程序版本名称
launchRefer 宿主调起入口区分
net 网络状态 no(无网) wifi(WIFI) 2g(2G 网络) 3g(3G 网络) 4g(4G 网络) 5g(5G 网络) unknow(未知)
needdown 是否需要下载小程序包1(需要)0(不需要)””(空值)
scheme 本次启动的 scheme
page 启动的页面路径
launchid 本次启动的 uuid 用于打点之间串联,每次启动会生成新的
successtime 调起成功距起点的时长单位毫秒
appid 小程序的 appKey