本文介绍如何添加报活日志。
报活日志分为两类:
设备报活:用于统计应用的装机量。
用户报活:用于统计应用的用户量。
您可以在移动分析控制台的 数据概览 页面中查看活跃用户、新增用户、活跃账号等指标。
设备报活埋点
mPaaS 框架会自动上报,开发者无需处理。如需关闭框架的自动上报,可通过在 AndroidManifest.xml
中添加以下配置(基线 10.1.68.30 及以上版本支持)实现:
<meta-data
android:name="report.launch.switch"
android:value="off" />
关闭自动上报后,可根据需求选择时机上报,代码如下:
MPLogger.reportClientLaunch();
应用从后台回到前台时,若距离上次设备报活超过上报间隔时间(默认为 30 分钟),将再次报活。
您可以自定义上报间隔时间(单位为毫秒),代码如下:
MPLogger.setReportClientLaunchInterval(long interval);
若在上报间隔时间内多次调用设备报活,仅首次有效。
用户报活埋点
用户报活的代码如下:
MPLogger.reportUserLogin(String userId);
userId
是您应用登录系统中用户的标识,您可以在用户登录成功后或在其他成功获取 userId
的情况下调用用户报活接口。
调用用户报活接口后,userId
就成功设置在代码中(即成功设置 userId
)。除此之外,您还可以调用下方设置用户 ID 的方法,单独设置 userId
。
设置用户 ID 的代码如下:
MPLogger.setUserId(String userId);
设置 userId
后,可便于在 mPaaS 控制台进行 实时发布 > 白名单 发布时使用该 userId
。
当用户退出登录时,请调用 MPLogger.setUserId(null)
清空 userId
,以确保相关数据的准确性。