下面,是针对一个典型的电商产品,在后台服务端,使用 Java SDK 向神策分析系统发送数据的样例。

样例主要展示数据的记录能力,使用者需要根据自己的需求和具体的产品形态,来设计相应的 EventProperty

// 使用 ConcurrentLoggingConsumer 初始化 SensorsAnalytics
// 将数据输出到 /data/sa 下的 access.log.2017-01-11 文件中,每天一个文件。需要配合 LogAgent 导入工具,把产生的数据导入到神策分析系统中。
final SensorsAnalytics sa = new SensorsAnalytics(
new SensorsAnalytics.ConcurrentLoggingConsumer("/data/sa/access.log"));

/*
在这个Demo中,我们以一个典型的电商产品为例,描述一个用户从匿名访问网站,到下单购买商品,再到申请售后服务,
这样一个整个环节,使用神策分析(以下简称SA)的产品,应该如何记录日志。

特别需要注意的是,这个Demo只是描述SA的数据记录能力,并不是说使用者要完全照搬这些Event和Property的设计,
使用者还是需要结合自己产品的实际需要,来做相应的设计和规划
*/

// 1. 用户匿名访问网站
String cookieId = "ABCDEF123456789"; // 用户未登录时,可以使用产品自己生成的cookieId来标注用户
Map<String, Object> properties = new HashMap<String, Object>();
// 1.1 访问首页
/*
前面有$开头的property字段,是SA提供给用户的预置字段
对于预置字段,已经确定好了字段类型和字段的显示名
*/
properties.clear();
properties.put("$time", new Date()); // 这条event发生的时间,如果不设置的话,则默认是当前时间
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("Channel", "baidu"); // 用户是通过baidu这个渠道过来的
sa.track(cookieId, false, "ViewHomePage", properties); // 记录访问首页这个event

// 1.2 搜索商品
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("KeyWord", "XX手机"); // 搜索引擎引流过来时使用的关键词
sa.track(cookieId, false, "SearchProduct", properties); // 记录搜索商品这个event

// 1.3 浏览商品
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("ProductName", "xx手机"); // 商品名称
properties.put("ProductType", "智能手机"); // 商品类别
properties.put("ShopName", "XX官方旗舰店"); // 店铺名称
sa.track(cookieId, false, "ViewProduct", properties); // 记录浏览商品这个event

// 2. 用户决定注册了
String registerId = "123456"; // 用户注册时,分配给用户的注册Id

// 2.1 通过,trackSignUP,把匿名ID和注册ID贯通起来
sa.trackSignUp(registerId, cookieId);

// 刷新一下,让埋点数据落到指定目录文件中
sa.flush();

// 2.2 用户注册时,填充了一些个人信息,可以用Profile接口记录下来
Map<String, Object> profiles = new HashMap<String, Object>();
profiles.put("$city", "武汉"); // 用户所在城市
profiles.put("$province", "湖北"); // 用户所在省份
profiles.put("$name", "昵称123"); // 用户的昵称
profiles.put("Gender", "male"); // 用户的性别
profiles.put("Birthday", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").parse(
"1984-11-03 " + "00:00:00")); // 用户的出生日期,特别注意,这个地方填入年龄是不合适的,因为年龄会随着时间而变化
profiles.put("RegisterChannel", "baidu"); // 用户的注册渠道
sa.profileSet(registerId, true, profiles);    // 此时传入的是注册ID了



// 3. 用户注册后,进行后续行为
// 3.1 提交订单和提交订单详情
// 这个订单里面包含一个手机和两个手机膜
// 订单的信息
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ShipPrice", 10.0); // 运费
properties.put("OrderTotalPrice", 1234.0); // 订单的总价格,默认是元
sa.track(registerId, true, "SubmitOrder", properties); // 注意,此时使用的已经是注册ID了
// 订单中手机这个商品的信息
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "XX手机"); // 商品名称
properties.put("ProductType", "智能手机"); // 商品类别
properties.put("ShopName", "XX官方旗舰店"); // 店铺名称
properties.put("ProductUnitPrice", 1200.0); // 商品单价
properties.put("ProductAmount", 1.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 1200.0); // 商品总价
sa.track(registerId, true, "SubmitOrderDetail", properties);
// 订单中手机膜这个商品的信息
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "5寸钢化膜"); // 商品名称
properties.put("ProductType", "手机配件"); // 商品类别
properties.put("ShopName", "XX手机外设店"); // 店铺名称
properties.put("ProductUnitPrice", 12.0); // 商品单价
properties.put("ProductAmount", 2.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 24.0); // 商品总价
sa.track(registerId, true, "SubmitOrderDetail", properties);

// 3.2 支付订单和支付订单详情
// 整个订单的支付情况
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ShipPrice", 10.0); // 运费
properties.put("OrderTotalPrice", 1234.0); // 订单的总价格,默认是元
properties.put("PaymentMethod", "AliPay"); // 支付方式
properties.put("AllowanceAmount", 30.0); // 补贴金额
properties.put("PaymentAmount", 1204.0); // 实际支付的订单金额
sa.track(registerId, true, "PayOrder", properties);
// 手机这个商品的支付情况
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "XX手机"); // 商品名称
properties.put("ProductType", "智能手机"); // 商品类别
properties.put("ShopName", "XX官方旗舰店"); // 店铺名称
properties.put("ProductUnitPrice", 1200.0); // 商品单价
properties.put("ProductAmount", 1.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 1200.0); // 商品总价
properties.put("ProductAllowanceAmount", 30.0); // 假设这个补贴是在手机上的折扣
properties.put("ProductPaymentAmount", 1170.0); // 手机实际支付了这么多
properties.put("PaymentMethod", "AliPay"); // 与订单保持一致
sa.track(registerId, true, "PayOrderDetail", properties);
// 手机膜这个商品的支付情况
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "5寸钢化膜"); // 商品名称
properties.put("ProductType", "手机配件"); // 商品类别
properties.put("ShopName", "XX手机外设店"); // 店铺名称
properties.put("ProductUnitPrice", 12.0); // 商品单价
properties.put("ProductAmount", 2.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 24.0); // 商品总价
properties.put("ProductAllowanceAmount", 0.0); // 手机膜上并没有补贴
properties.put("ProductPaymentAmount", 24.0); // 手机膜实际支付了这么多
properties.put("PaymentMethod", "AliPay"); // 与订单保持一致
sa.track(registerId, true, "PayOrderDetail", properties);

// 3.3 假设这个用户支付后反悔了,要取消订单
// 整个订单的取消情况
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ShipPrice", 10.0); // 运费
properties.put("OrderTotalPrice", 1234.0); // 订单的总价格,默认是元
properties.put("PaymentMethod", "AliPay"); // 支付方式
properties.put("AllowanceAmount", 30.0); // 补贴金额
properties.put("PaymentAmount", 1204.0); // 实际支付的订单金额
properties.put("CancelReason", "地址填写错误"); // 取消订单的原因
properties.put("CancelTiming", "AfterPay"); // 取消订单的时机
sa.track(registerId, true, "CancelOrder", properties);
// 手机这个商品的支付情况
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "XX手机"); // 商品名称
properties.put("ProductType", "智能手机"); // 商品类别
properties.put("ShopName", "XX官方旗舰店"); // 店铺名称
properties.put("ProductUnitPrice", 1200.0); // 商品单价
properties.put("ProductAmount", 1.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 1200.0); // 商品总价
properties.put("ProductAllowanceAmount", 30.0); // 假设这个补贴是在手机上的折扣
properties.put("ProductPaymentAmount", 1170.0); // 手机实际支付了这么多
properties.put("PaymentMethod", "AliPay"); // 与订单保持一致
properties.put("CancelReason", "地址填写错误"); // 取消订单的原因
properties.put("CancelTiming", "AfterPay"); // 取消订单的时机
sa.track(registerId, true, "CancelOrderDetail", properties);
// 手机膜这个商品的支付情况
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "5寸钢化膜"); // 商品名称
properties.put("ProductType", "手机配件"); // 商品类别
properties.put("ShopName", "XX手机外设店"); // 店铺名称
properties.put("ProductUnitPrice", 12.0); // 商品单价
properties.put("ProductAmount", 2.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 24.0); // 商品总价
properties.put("ProductAllowanceAmount", 0.0); // 手机膜上并没有补贴
properties.put("ProductPaymentAmount", 24.0); // 手机膜实际支付了这么多
properties.put("PaymentMethod", "AliPay"); // 与订单保持一致
sa.track(registerId, true, "CancelOrderDetail", properties);

// 4. 假设用户并没有取消订单,然后成功完成了配送
// 手机这个商品的配送情况
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "XX手机"); // 商品名称
properties.put("ProductType", "智能手机"); // 商品类别
properties.put("ShopName", "XX官方旗舰店"); // 店铺名称
properties.put("ProductUnitPrice", 1200.0); // 商品单价
properties.put("ProductAmount", 1.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 1200.0); // 商品总价
properties.put("ProductAllowanceAmount", 30.0); // 假设这个补贴是在手机上的折扣
properties.put("ProductPaymentAmount", 1170.0); // 手机实际支付了这么多
properties.put("PaymentMethod", "AliPay"); // 与订单保持一致
properties.put("SupplyTime", 49.0); // 订单运送用了49小时
properties.put("SupplyMethod", "顺丰"); // 通过顺丰运送的
sa.track(registerId, true, "ReceiveProduct", properties);
// 手机膜这个商品的配送情况
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "5寸钢化膜"); // 商品名称
properties.put("ProductType", "手机配件"); // 商品类别
properties.put("ShopName", "XX手机外设店"); // 店铺名称
properties.put("ProductUnitPrice", 12.0); // 商品单价
properties.put("ProductAmount", 2.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 24.0); // 商品总价
properties.put("ProductAllowanceAmount", 0.0); // 手机膜上并没有补贴
properties.put("ProductPaymentAmount", 24.0); // 手机膜实际支付了这么多
properties.put("PaymentMethod", "AliPay"); // 与订单保持一致
properties.put("SupplyTime", 98.0); // 订单运送用了98小时
properties.put("SupplyMethod", "圆通"); // 通过顺丰运送的
sa.track(registerId, true, "ReceiveProduct", properties);


// 5. 假设产品有质量问题,用户申请了售后服务
// 5.1 手机申请了维修
// 提交了售后服务
properties.clear();
properties.put("$os", "Windows"); // 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
properties.put("$os_version", "8.1"); // 操作系统的具体版本
properties.put("$ip", "123.123.123.123"); // 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
properties.put("OrderId", "SN_123_AB_TEST"); // 订单ID
properties.put("ProductName", "XX手机"); // 商品名称
properties.put("ProductType", "智能手机"); // 商品类别
properties.put("ShopName", "XX官方旗舰店"); // 店铺名称
properties.put("ProductUnitPrice", 1200.0); // 商品单价
properties.put("ProductAmount", 1.0); // 商品数量,可以是个数,也可以是重量
properties.put("ProductTotalPrice", 1200.0); // 商品总价
properties.put("ProductAllowanceAmount", 30.0); // 假设这个补贴是在手机上的折扣
properties.put("ProductPaymentAmount", 1170.0); // 手机实际支付了这么多
properties.put("PaymentMethod", "AliPay"); // 与订单保持一致
properties.put("ServiceContent", "维修"); // 手机申请了维修
properties.put("ServiceStatus", "新提交"); // 售后服务的状态
sa.track(registerId, true, "ServiceAfterSale", properties);
// 产品被收到,开始维修了,记录一条新的数据
properties.put("ServiceStatus", "维修中"); // 售后服务的状态
sa.track(registerId, true, "ServiceAfterSale", properties);
// 维修完成了,再记录一条新的数据
properties.put("ServiceStatus", "维修完成"); // 售后服务的状态
sa.track(registerId, true, "ServiceAfterSale", properties);

// 刷新一下,让埋点数据落到指定目录文件中
sa.flush();
JAVA