报活日志

本文介绍如何添加报活日志。

报活日志分为两类:

  • 设备报活:用于统计应用的装机量。

  • 用户报活:用于统计应用的用户量。

您可以在移动分析控制台的 数据概览 页面中查看活跃用户、新增用户、活跃账号等指标。

设备报活埋点

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,以确保相关数据的准确性。