本文将引导您完成 Android 客户端开发,包括:
1. 接入移动分析组件
参见 Android 接入文档 接入移动分析组件。
2. 记录事件日志
下面通过代码示例指导如何记录事件日志,并对涉及的相关参数进行说明。
示例代码
在下面的代码示例中,客户端将记录事件对应的业务 ID、事件 ID、支付时间、用户 ID 以及支付方式。
import com.mpaas.mas.adapter.api.MPLogger;
import java.util.HashMap;
import java.util.Map;
// 业务 ID
String bizType = "Pay";
// 事件 ID
String logId = "PayResults";
// 添加属性
Map<String, String> params = new HashMap<>(4);
// 属性:支付时间。Key 对应属性 ID;Value 对应属性值
params.put("pay_time", String.valueOf(System.currentTimeMillis()));
// 属性:用户 ID
params.put("user_id", "the-userId");
// 属性:支付方式
params.put("payment_method", "alipay");
// 打印日志
MPLogger.event(logId, bizType, params);
参数说明
bizType(业务 ID)
bizType
用于设置 业务 ID(也称为 业务码、业务类型),是业务的唯一标识。示例代码中设置为Pay
,意为支付业务。bizType
影响客户端日志的文件名;日志文件名规则为时间戳_包名-进程_bizType
。
logId(事件 ID)
logId
用于设置 事件 ID,是事件的唯一标识。更多信息,参见 教程场景说明。params(事件属性)
params
用于存储事件关联的属性。其中,params.put("param-key", "param-value")
:param-key
:对应属性 ID。更多信息,参见 教程场景说明。param-value
:对应属性的值。在客户端以字符串形式存储;在实际分析中,服务端支持自动转化为字符型、整型、浮点型。
3. 上报日志
默认情况下,当客户端本地日志缓存到一定条数或程序压后台超过一定时间后,本地日志会自动上报给移动分析服务器。在开发测试时,您可以调用以下接口,强制将本地日志立刻上报给服务器:
import com.mpaas.mas.adapter.api.MPLogger;
MPLogger.uploadAll();