Android 事件

事件分析目前包括两种类型的事件分析,有时长的事件统计和无时长的事件统计。

  • 事件分析的eventId和attribue参数,需要先在百度移动统计网页上进行配置,详细配置步骤参见参数申请部分。
  • eventLabel参数,无需在web端配置,可以直接SDK传入即可,但是eventLabel应该传入的是有限的数据(即数据可枚举,比如性别等有实际含义可枚举的数据)。

无时长事件分析

记录一次事件的发生。

eventId请在网站上创建和对应的attribute的key请在网站上创建,未创建的evenId和key将无法统计。

举例:为了统计购买的行为发生次数,在购买按钮响应事件函数中埋点StatService.onEvent(this, "购买", "图书")

  1. @param eventId 事件Id,提前在网站端创建
  2. @param eventLabel 事件标签,附加参数,不能为空字符串
  3. @param acc 事件发生次数
  4. @param attributes 事件属性,对应的key需要在网站上创建,注意:keyvalue只接受String
  1. // 不指定事件发生次数,默认为1
  2. StatService.onEvent(Context context, String eventId, String label);
  3. // 指定事件发生次数
  4. StatService.onEvent(Context context, String eventId, String label, int acc);
  5. // 如果需要传入自定义事件属性参数,调用此方法
  6. StatService.onEvent(Context context, String eventId, String label, int acc, Map<String, String> attributes) ;

固定时长事件分析

记录一次固定时长事件的发生,适用于可以提前预知事件发生的时长的情况。

eventId请在网站上创建和对应的attribute的key请在网站上创建,未创建的evenId和key将无法统计。

举例:为了统计图片查看时长,假定浏览时长3000ms,在图片点击放大响应事件函数中埋点StatService.onEventDuration(this, "浏览", "图片", 3000)

  1. @param eventId 事件Id,提前在网站端创建
  2. @param eventLabel 事件标签,附加参数,不能为空字符串
  3. @param duration 已知的自定义事件时长,单位为毫秒(ms
  4. @param attributes 事件属性,对应的key需要在网站上创建,注意:keyvalue只接受String
  1. StatService.onEventDuration(Context context, String eventId, String label, long milliseconds);
  2. // 如果需要传入自定义事件属性参数,调用此方法
  3. StatService.onEventDuration(Context context, String eventId, String label, long milliseconds, Map<String, String> attributes);

自定义时长事件分析

记录一次事件发生的起始和结束,并自动计算事件发生的时长。其中eventId和label均相同的配对调用,才是一次有效调用。

eventId请在网站上创建和对应的attribute的key请在网站上创建,未创建的evenId和key将无法统计。

举例:为了统计视频播放时长,在视频开始播放和暂停分别埋点:StatService.onEventStart(this, "视频A", "动漫")StatService.onEventEnd(this, "视频A", "动漫")

  1. @param eventId 事件Id,提前在网站端创建
  2. @param eventLabel 事件标签,附加参数,不能为空字符串
  3. @param attributes 事件属性,对应的key需要在网站上创建,注意:keyvalue只接受String
  1. // 先调用start
  2. StatService.onEventStart(Context context, String eventId, String label);
  3. // 无需传入事件属性数据,调用
  4. StatService.onEventEnd(Context context, String eventId, String label);
  5. // 传入事件属性数据,调用
  6. StatService.onEventEnd(Context context, String eventId, String label, Map<String, String> attributes);