Android 客户端开发

本文将引导您完成 Android 客户端开发,包括:

  1. 接入移动分析组件

  2. 记录事件日志

  3. 上报日志

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(也称为 业务码业务类型),是业务的唯一标识。示例代码中设置为 Pay,意为支付业务。

bizType 影响客户端日志的文件名;日志文件名规则为 时间戳_包名-进程_bizType

logId

事件 ID,是事件的唯一标识。更多信息,参见 教程场景说明

params

用于存储事件关联的属性,输出格式:params.put("param-key", "param-value")

  • param-key:对应属性 ID。更多信息,参见 教程场景说明

  • param-value:对应属性的值。在客户端以字符串形式存储;在实际分析中,服务端支持自动转化为字符型、整型、浮点型。

3. 上报日志

默认情况下,当客户端本地日志缓存到一定条数或程序压后台超过一定时间后,本地日志会自动上报给移动分析服务器。在开发测试时,您可以调用以下接口,强制将本地日志立刻上报给服务器:

import com.mpaas.mas.adapter.api.MPLogger;
MPLogger.uploadAll();

相关链接